homie — хук для Claude Code: что делает и установка
Хук homie проверяет вызовы инструментов, запрашивает подтверждение для рискованных действий и очищает результаты от секретов.
Apache-2.0 ★ 1 596 обновлён 2026-10-29
.claude/settings.jsonЧто делает homie
В homie входят хуки для Claude Code и Codex. Они запускаются до и после вызовов инструментов, а также при отправке запроса. Конфигурация Codex вызывает hooks/codex.mjs; правила проверок находятся в lib/holds.mjs.
Хук приостанавливает защищённые изменения, production deploy, платные вызовы сверх бюджета и действия с неясной стоимостью, пока человек не введёт proceed <code>. Некоторые действия он блокирует: например, коммит файла больше 5 MB из games/ или запись в Stripe, которая раскрывает webhook secret. Секреты удаляются из результатов инструментов, которые читает модель.
Если стоимость платного вызова нельзя проверить заранее, потребуется подтверждение. Для Claude Code настройки хука добавляют в .claude/settings.json.
Какие задачи решает
- Запросить подтверждение перед production deploy
- Заблокировать опасную запись в Stripe
- Остановить коммит крупного файла из
games/ - Удалить секреты из результатов инструментов
Примеры запросов агенту
- Опубликуй студию в production и сначала запроси у меня подтверждение.
- Добавь этот файл в
games/и проверь, не превышает ли он 5 MB.
Как установить homie
Вручную: положить файлы
.claude/settings.jsonБлок hooks: событие (PreToolUse, PostToolUse, Stop…) → команда. Личные — ~/.claude/settings.json
По шагам, с командами для каждой платформы: Хуки Claude Code: что это, где настраивать и как запретить опасную команду
Вопросы о homie
Как установить homie в Claude Code?
Добавьте настройки хука в .claude/settings.json.
Что делает homie?
Проверяет действия инструментов, останавливает некоторые рискованные операции и удаляет секреты из результатов, которые читает модель.
Работает ли homie с Codex?
Да. Для Codex предусмотрен обработчик hooks/codex.mjs, который использует правила из lib/holds.mjs.
Исходный текст
codex.json · Apache-2.0
Hooks bundle shipped with the homie plugin for Claude Code.
Makes and remixes multiplayer web games, music and video, then publishes them from a studio site with public rooms on your own Cloudflare account.
Triggers on: PreToolUse, PostToolUse, UserPromptSubmit.
```json
{
"description": "Homie's holds in Codex (hooks/codex.mjs, deciding with lib/holds.mjs, the module the Claude Code mod asks): an edit to a file the studio protects, a production deploy, a change to the studio's Cloudflare account outside its deploy and a paid call past the budget or whose cost cannot be read first wait for the person's own \"proceed <code>\"; a change to a locked art decision, an unlicensed asset in a public game's deploy, a file over 5 MB under games/ into git and a Stripe write that would hand back a webhook secret are refused; and secrets come out of every tool result the model reads.",
"hooks": {
"PreToolUse": [
{
"matcher": "^(Bash|apply_patch|mcp__.+)$",
"hooks": [
{ "type": "command", "command": "node \"${PLUGIN_ROOT}/hooks/codex.mjs\" pre", "timeout": 90, "statusMessage": "Homie: checking this call" }
]
}
],
"UserPromptSubmit": [
{
"hooks": [
{ "type": "command", "command": "node \"${PLUGIN_ROOT}/hooks/codex.mjs\" prompt", "timeout": 10 }
]
}
],
"PostToolUse": [
{
"hooks": [
{ "type": "command", "command": "node \"${PLUGIN_ROOT}/hooks/codex.mjs\" post", "timeout": 30 }
]
}
]
}
}
```
© Homie · Apache-2.0 · hashgraph-online/awesome-codex-plugins