К основному содержанию
хук

helix — хук для Claude Code: перехват событий и промптов

Хук helix для Claude Code перехватывает системные события сессии и промпты рабочего процесса HelixHarness. Запускает сценарии на старте, смене директории и вызове инструментов.

Apache-2.0 ★ 454 обновлён 2026-11-17

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add didi/helixharness
/plugin install helix@helixharness-marketplace
Открыть на GitHub

Что делает 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-marketplace

2Вручную: положить файлы

.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

Похожие хуки

Все хуки по теме «Настройка агента: память, контекст, субагенты» →
huggingface-tool-builder huggingface Скилл huggingface-tool-builder для Claude Code и других платформ: создаёт переиспользуемые скрипты под Hugging Face API — автоматизирует поиск моделей, обогащение данных и цепочки запросов. CX Codex +1 1 800установок helix-mcp-server JoomShaper MCP-сервер для Joomla-шаблона Helix Ultimate: собирает макеты, мега-меню, каркас кода и аудиты прямо из чата с агентом. CX Codex +1 ★ 64звёзд репо telegram acedatacloud Управляет личным аккаунтом Telegram через Telethon и MTProto. Помогает читать непрочитанные сообщения, искать переписки, скачивать медиа и отправлять ответы. CX Codex +1 189установок script-generator transilienceai Скилл script-generator генерирует готовые скрипты на Python, Bash и PowerShell с проверкой синтаксиса и защитой от зависания. Сам код агент никогда не запускает. CX Codex +1 176установок dangerous-command-blocker davila7 Хук dangerous-command-blocker перехватывает вызовы Bash в Claude Code и блокирует опасные команды вроде rm -rf / или запись в .git/. Защищает проект от случайного удаления данных. 1 316установок openclaw-model-switch daymade Скилл openclaw-model-switch сменяет модель по умолчанию и чинит конфигурацию в OpenClaw. Помогает при ошибках авторизации токена, сбоях маршрутизации и неподдерживаемых уровнях thinking. CX Codex +1 387установок

Из того же набора3

Ещё в каталоге

Спонсоры проекта

Компании, которые помогают держать аналитику открытой