helix — хук для Claude Code: перехват событий и промптов
Хук helix для Claude Code перехватывает системные события сессии и промпты рабочего процесса HelixHarness. Запускает сценарии на старте, смене директории и вызове инструментов.
Apache-2.0 ★ 454 обновлён 2026-11-17
/plugin marketplace add didi/helixharness
/plugin install helix@helixharness-marketplaceЧто делает helix
Хук связывает жизненный цикл сессии с Python-обработчиком плагина HelixHarness. При наступлении событий запускается скрипт scripts/python_hook_bootstrap.sh, который передаёт управление файлу hosts/claude-code/hook_entry.py через Bash.
Набор реагирует на события SessionStart, CwdChanged, SessionEnd, сопоставляет вызовы навыков через PreToolUse с фильтром Skill и перехватывает пользовательские запросы по шаблону ^helix: в UserPromptExpansion. На выполнение каждой команды отведён таймаут 3 секунды, поэтому окружению требуются рабочие интерпретаторы sh и Python.
Какие задачи решает
- Перехватывать запуск и завершение рабочих сессий
- Обрабатывать события смены текущего рабочего каталога
- Фильтровать вызовы навыков перед выполнением инструмента
- Разворачивать префиксы команд вида helix: в промптах
Примеры запросов агенту
- helix: запланируй шаги для рефакторинга модуля
- Запусти сессию с отслеживанием изменений каталога
- Выполни задачу через навыки плагина HelixHarness
Как установить helix
1Через маркетплейс плагинов
/plugin marketplace add didi/helixharness/plugin install helix@helixharness-marketplace2Вручную: положить файлы
.claude/settings.jsonБлок hooks: событие (PreToolUse, PostToolUse, Stop…) → команда. Личные — ~/.claude/settings.json
По шагам, с командами для каждой платформы: Хуки Claude Code: что это, где настраивать и как запретить опасную команду
Вопросы о helix
Как установить helix в Claude Code?
Выполните команду /plugin marketplace add didi/helixharness, затем установите пакет через /plugin install helix@helixharness-marketplace и проверьте конфигурацию в файле .claude/settings.json.
Что делает хук helix?
Он регистрирует обработчики событий SessionStart, CwdChanged, SessionEnd, PreToolUse и UserPromptExpansion, перенаправляя их в hook_entry.py.
Что нужно для работы хука helix?
Требуются командная оболочка Bash, утилита sh и установленный Python, так как скрипты запускаются через внутренний бутстрап с таймаутом 3 секунды.
Исходный текст
hooks.json · Apache-2.0
Hooks bundle shipped with the helix plugin for Claude Code.
HelixHarness workflow plugin for Claude Code and Codex with commands and reusable skills
Triggers on: PreToolUse, SessionStart, SessionEnd.
```json
{
"hooks": {
"SessionStart": [
{
"hooks": [
{
"type": "command",
"command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/python_hook_bootstrap.sh\" SessionStart \"${CLAUDE_PLUGIN_ROOT}/hosts/claude-code/hook_entry.py\"",
"timeout": 3,
"shell": "bash"
}
]
}
],
"CwdChanged": [
{
"hooks": [
{
"type": "command",
"command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/python_hook_bootstrap.sh\" CwdChanged \"${CLAUDE_PLUGIN_ROOT}/hosts/claude-code/hook_entry.py\"",
"timeout": 3,
"shell": "bash"
}
]
}
],
"SessionEnd": [
{
"hooks": [
{
"type": "command",
"command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/python_hook_bootstrap.sh\" SessionEnd \"${CLAUDE_PLUGIN_ROOT}/hosts/claude-code/hook_entry.py\"",
"timeout": 3,
"shell": "bash"
}
]
}
],
"PreToolUse": [
{
"matcher": "Skill",
"hooks": [
{
"type": "command",
"command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/python_hook_bootstrap.sh\" PreToolUse \"${CLAUDE_PLUGIN_ROOT}/hosts/claude-code/hook_entry.py\"",
"timeout": 3,
"shell": "bash"
}
]
}
],
"UserPromptExpansion": [
{
"matcher": "^helix:",
"hooks": [
{
"type": "command",
"command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/python_hook_bootstrap.sh\" UserPromptExpansion \"${CLAUDE_PLUGIN_ROOT}/hosts/claude-code/hook_entry.py\"",
"timeout": 3,
"shell": "bash"
}
]
}
]
}
}
```
© HelixHarness contributors · Apache-2.0 · didi/helixharness