change-tracker — хук для Claude Code: что делает и как установить
Хук записывает изменения файлов в журнал с датой и временем. Он пригодится, когда нужно отслеживать действия Claude Code.
npx claude-code-templates@latest --hook development-tools/change-trackerЧто делает change-tracker
change-tracker подключается к событиям PostToolUse в Claude Code. После Edit или MultiEdit он добавляет в журнал путь изменённого файла, а после Write записывает созданный файл. Каждая строка содержит дату, время и тип действия.
Команды хука записывают данные в ~/.claude/changes.log. Лог пополняется при срабатывании инструментов, поэтому путь к файлу фиксирован и журнал нужно искать именно там. Если ~/.claude/changes.log недоступен для записи, хук не сможет добавить новую строку.
Для установки используется команда npx claude-code-templates@latest --hook development-tools/change-tracker, после чего задействуется конфигурация .claude/settings.json.
Какие задачи решает
- отследить, какие файлы изменил Claude Code
- зафиксировать время редактирования файла
- отличить созданные файлы от изменённых
- собрать простой журнал действий агента
Примеры запросов агенту
- Измени
src/app.jsи добавь запись о файле в журнал. - Создай
config/local.json, затем проверь, что событие записалось. - Обнови несколько файлов через
MultiEditи покажи журнал изменений.
Как установить change-tracker
1Через claude-code-templates
npx claude-code-templates@latest --hook development-tools/change-tracker2Вручную: положить файлы
.claude/settings.jsonБлок hooks: событие (PreToolUse, PostToolUse, Stop…) → команда. Личные — ~/.claude/settings.json
По шагам, с командами для каждой платформы: Хуки Claude Code: что это, где настраивать и как запретить опасную команду
Вопросы о change-tracker
Как установить change-tracker в Claude Code?
Запустите npx claude-code-templates@latest --hook development-tools/change-tracker, затем подключите конфигурацию через .claude/settings.json.
Что делает change-tracker?
Хук отслеживает вызовы Edit, MultiEdit и Write в Claude Code. Он записывает изменённые и созданные файлы вместе с датой и временем в ~/.claude/changes.log.
Какие действия записывает change-tracker?
После Edit и MultiEdit появляется запись об изменённом файле, а после Write — о созданном. Для журнала используется событие PostToolUse.
Исходный текст
change-tracker.json · MIT
{
"description": "Track file changes in a simple log. Records which files were modified and when for easy tracking of Claude Code activity.",
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|MultiEdit",
"hooks": [
{
"type": "command",
"command": "echo \"[$(date '+%Y-%m-%d %H:%M:%S')] File modified: $CLAUDE_TOOL_FILE_PATH\" >> ~/.claude/changes.log"
}
]
},
{
"matcher": "Write",
"hooks": [
{
"type": "command",
"command": "echo \"[$(date '+%Y-%m-%d %H:%M:%S')] File created: $CLAUDE_TOOL_FILE_PATH\" >> ~/.claude/changes.log"
}
]
}
]
}
}
© davila7 · MIT · davila7/claude-code-templates