debug-window — хук для Claude Code: окно лога отладки
Открывает окно с живым хвостом лога отладки, когда Claude запущен с флагом --debug или -d, и закрывает его по концу сессии.
npx claude-code-templates@latest --hook development-tools/debug-windowЧто делает debug-window
Хук привязан к двум событиям: SessionStart запускает .claude/hooks/debug-window.sh, SessionEnd вызывает тот же скрипт. Пока сессия идёт, окно показывает, как дописывается лог отладки. Закрывать его руками не нужно.
Если хочется оставить окно после завершения сессии, в settings.json задаётся DEBUG_WINDOW_AUTO_CLOSE_DISABLE=1. Без этого переменная не выставлена, и окно гаснет вместе с сессией.
Автор тестировал на Intel Mac. Заявлены macOS, Linux и Windows через Git Bash или Cygwin — на других платформах поведение не проверено, так что это повод проверить у себя, прежде чем полагаться на хук в рабочем процессе.
Какие задачи решает
- увидеть лог отладки Claude прямо во время сессии
- не открывать терминал вручную ради хвоста лога
- получить лог при запуске с
--debugили-d - оставить окно лога открытым после завершения сессии
- не закрывать окно лога руками каждый раз
Примеры запросов агенту
- запусти Claude с
--debug, чтобы открылось окно лога - включи
-dи покажи, что пишется в лог отладки - как оставить окно лога открытым после конца сессии?
Как установить debug-window
1Через claude-code-templates
npx claude-code-templates@latest --hook development-tools/debug-window2Вручную: положить файлы
.claude/settings.jsonБлок hooks: событие (PreToolUse, PostToolUse, Stop…) → команда. Личные — ~/.claude/settings.json
По шагам, с командами для каждой платформы: Хуки Claude Code: что это, где настраивать и как запретить опасную команду
Вопросы о debug-window
Как установить debug-window в Claude?
Выполните npx claude-code-templates@latest --hook development-tools/debug-window, затем проверьте .claude/settings.json — туда прописываются хуки SessionStart и SessionEnd.
Что делает debug-window?
При старте сессии с флагом --debug или -d открывает окно с живым хвостом лога отладки и закрывает его, когда сессия заканчивается.
Как оставить окно лога открытым после сессии?
Добавьте DEBUG_WINDOW_AUTO_CLOSE_DISABLE=1 в settings.json. Тогда окно не закроется автоматически по SessionEnd.
Исходный текст
debug-window.json · MIT
{
"description": "Auto Debug Log Viewer. Opens a live-tailing debug log window when Claude Code starts with --debug or -d flag. The window closes automatically on session end. To keep the debug window open after session ends, set DEBUG_WINDOW_AUTO_CLOSE_DISABLE=1 in your settings.json. Tested on Intel Mac. Supports macOS, Linux, and Windows (Git Bash/Cygwin). Contributions from other platform users are welcome.",
"hooks": {
"SessionStart": [
{
"matcher": "*",
"hooks": [
{
"type": "command",
"command": ".claude/hooks/debug-window.sh"
}
]
}
],
"SessionEnd": [
{
"hooks": [
{
"type": "command",
"command": ".claude/hooks/debug-window.sh"
}
]
}
]
}
}
© davila7 · MIT · davila7/claude-code-templates
