command-logger — хук для Claude Code: что делает и как установить
Записывает вызовы инструментов Claude Code с датой и путями к файлам в текстовый лог для отладки и аудита сессий.
npx claude-code-templates@latest --hook development-tools/command-loggerЧто делает command-logger
Хук перехватывает событие PreToolUse для любого инструмента. Перед тем как Claude Code выполнит действие, в файл ~/.claude/command-log.txt дописывается строка со штампом даты, переменными $CLAUDE_TOOL_NAME и $CLAUDE_TOOL_FILE_PATH.
Внутри нет сторонних демонов или сетевых запросов. Запись идёт обычной командой echo через шелл, поэтому логирование работает прямо на локальной машине без дополнительных зависимостей. Если папка ~/.claude/ недоступна на запись, запись в лог завершится с ошибкой шелла.
Какие задачи решает
- вести локальный аудит вызовов инструментов
- сохранять хронологию обращений к файлам
- отслеживать действия ассистента при отладке сценариев
Примеры запросов агенту
- Запусти проверку проекта и покажи статус
- Отредактируй конфиг и проверь запись в логе
Как установить command-logger
1Через claude-code-templates
npx claude-code-templates@latest --hook development-tools/command-logger2Вручную: положить файлы
.claude/settings.jsonБлок hooks: событие (PreToolUse, PostToolUse, Stop…) → команда. Личные — ~/.claude/settings.json
По шагам, с командами для каждой платформы: Хуки Claude Code: что это, где настраивать и как запретить опасную команду
Вопросы о command-logger
Как установить command-logger в Claude Code?
Выполните в терминале команду npx claude-code-templates@latest --hook development-tools/command-logger либо вставьте блок хука в .claude/settings.json.
Что делает command-logger?
При каждом вызове инструмента хук добавляет запись с текущей датой, именем инструмента и путём к целевому файлу в ~/.claude/command-log.txt.
Куда сохраняются логи и нужны ли сторонние утилиты?
Лог пишется в домашнюю директорию в файл ~/.claude/command-log.txt средствами стандартной команды echo без внешних библиотек.
Исходный текст
command-logger.json · MIT
{
"description": "Log all Claude Code commands to a file for audit and debugging purposes. Simple logging that records tool usage with timestamps.",
"hooks": {
"PreToolUse": [
{
"matcher": "*",
"hooks": [
{
"type": "command",
"command": "echo \"[$(date)] Tool: $CLAUDE_TOOL_NAME | File: $CLAUDE_TOOL_FILE_PATH\" >> ~/.claude/command-log.txt"
}
]
}
]
}
}
© davila7 · MIT · davila7/claude-code-templates
