К основному содержанию
правило CX Codex

bash-guard.en — правило для Claude Code: что делает и как установить

Правило bash-guard.en для Claude Code запрещает опасные команды терминала и настраивает таймауты фоновых задач.

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

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/bash-guard.en.md
Открыть на GitHub

Что делает bash-guard.en

Правило ограничивает выполнение команд bash в среде ИИ-агентов. Оно блокирует pkill -f, фоновые циклы ожидания и sleep, требуя использовать таймауты и фоновые процессы с метками вроде # long-running-ok.

Для подзапросов Claude Code команды дольше 290 секунд автоматически уходят в фон. Загрузки через сеть направляются через прокси при установленной переменной HOOK_PROXY, а для прямых скачиваний требуется метка # direct-ok.

Перед слиянием пул-реквеста проверяются записи верификации, а тестовые сообщения не отправляются в командные чаты.

Какие задачи решает

  • предотвратить завершение рабочей оболочки через pkill -f
  • ограничить время выполнения фоновых команд таймаутами
  • заблокировать циклы опроса через sleep и gh watch
  • направить сетевые загрузки через корпоративный прокси

Примеры запросов агенту

  • Запусти фоновую сборку проекта с таймаутом и меткой
  • Проверь команду bash на соответствие правилам безопасности
  • Настрой выполнение долгих тестов в фоновом режиме

Как установить bash-guard.en

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

.claude/rules/bash-guard.en.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о bash-guard.en

Как установить bash-guard.en в Claude Code?

Сохраните файл правила в .claude/rules/bash-guard.en.md.

Что делает bash-guard.en?

Правило запрещает опасные вызовы терминала, управляет таймаутами долгих команд и блокирует бесконечные циклы ожидания у агентов.

Что нужно для работы bash-guard.en?

Для работы требуется поддерживаемая среда разработки вроде Claude Code, Cursor или Windsurf.

Исходный текст

bash-guard.en.md · Apache-2.0
- Commands (bash-guard): no `pkill -f` (it kills the shell running it); use `kill $(pgrep -f '[x]yz')` or a pid file. Background commands need a timeout (`timeout <s> <cmd>`; on macOS `perl -e 'alarm shift; exec @ARGV' <s> <cmd>`) and no `| tail`/`| head`; end a long-running service with `# long-running-ok`. With HOOK_PROXY set, downloads go through the proxy; add `# direct-ok` when a direct download is really needed.
- Reject foreground gh watch, sleep >=60 seconds and sleep polling loops. DSH also rejects any foreground sleep, repeated polls/read-only commands and a fourth sequential single read-only step. Batched reads, child sessions and outing turns have scoped exemptions. DSH network installs/fetches require a timed background task. Missing session history never fabricates counts.
- A Claude Code subagent's foreground command with a timeout over 290 seconds gets it cut to 290 seconds (a subagent's prompt cache lasts 5 minutes); what does not finish moves to the background by itself. Do not poll it then: deliver with the log path and the next step. Dispatch work that waits 5–60 minutes to a long-task subagent (1-hour cache, not capped). A while … sleep loop inside perl/python counts as polling too.
- In the main session a foreground remote, install/download, CI or build/test command with a timeout over 5 minutes is capped to 290 seconds and moves to the background if it runs longer; start such commands in the background. A test command piped into `tail/head` gets `set -o pipefail` added: judge by the exit code.
- `for … sleep … break` polling and `caffeinate -w` also count as waiting in the foreground. Before a PR merge, merge-gate checks the recorded real-entry verification; no test messages go to the team chat channels on the list.

- Other CLIs do not inherit the Claude long-task cache policy. Start work expected to exceed five minutes in the native background, report its log/task ID, and end the turn: DSH run_in_background (timeoutMs can promote to background), Grok block_until_ms=0, Gemini is_background, or the session ID returned by Codex exec_command. Do not poll with wait/sleep. DSH child timeouts above 290000 ms are denied with capped retry arguments; Grok child block_until_ms is capped at 290000.

© zuiho-kai · Apache-2.0 · zuiho-kai/bothouse

Похожие правила IDE

Все правила IDE по теме «Настройка агента: память, контекст, субагенты» →
ai-bash-guard davila7 Хук ai-bash-guard для Claude Code проверяет bash-команды перед выполнением и блокирует деструктивные паттерны с объяснением. 80установок notify-before-bash davila7 Хук notify-before-bash выводит оповещение в консоль перед каждым запуском Bash-команды в Claude Code. Помогает отслеживать обращения ассистента к системному терминалу. 243установок guard garrytan Скилл guard для Claude Code включает полный режим защиты от опасных действий агента. Инструмент предупреждает о деструктивных командах и запрещает изменять файлы вне выбранной папки. CX Codex +1 389установок bash-defensive-patterns Ryan Snodgrass Скилл bash-defensive-patterns для Claude Code помогает писать Bash-скрипты с обработкой ошибок и безопасной работой с данными. Включается при создании CI/CD-скриптов и системных утилит. CX Codex +1 13 409установок bash-pro rmyndharis Скилл bash-pro для Claude Code помогает писать и проверять Bash-скрипты для автоматизации, CI/CD и системных задач. Подсказывает, как защитить скрипт от небезопасной обработки аргументов и ошибок. CX Codex +1 123установок claude-code-bash-patterns secondsky Скилл claude-code-bash-patterns обучает агента безопасно запускать CLI-команды, связывать их через && и настраивать хуки pretooluse. Помогает избежать сбоев при сборке и запретить опасный вызов rm -rf. CX Codex +1 414установок

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

Весь набор →
codemap-inject.en Правило codemap-inject.en для Claude Code подключает карты кодовой базы к задачам субагентов по ключевым словам. Субагент изучает карту перед работой и возвращает новые символы для её обновления. CX Codex +1 ★ 262звёзд репо choice-ask-guard.en Правило choice-ask-guard.en для Claude Code проверяет вопросы агента по уже принятым решениям и задаёт только незакрытые вопросы. CX Codex +1 ★ 262звёзд репо param-source-guard.en Правило param-source-guard.en для Claude Code обязывает указывать источник для всех числовых параметров в коде. Оно проверяет новые лимиты, пороги и окна на наличие комментария с происхождением данных. CX Codex +1 ★ 262звёзд репо wiki-context.en Правило wiki-context.en для Claude Code читает релевантные подсказки из wiki и строки с уроками для текущей сессии. CX Codex +1 ★ 262звёзд репо _head.en Правило _head.en для Claude Code управляет перехватом вызовов инструментов через хуки. Оно запрещает модели обходить блокировки и регламентирует переключение проверок по прямой команде. CX Codex +1 ★ 262звёзд репо dispatch-review-guard.en dispatch-review-guard.en — правило для Claude Code, которое проверяет отметки ревью перед отправкой задачи субагенту. CX Codex +1 ★ 262звёзд репо long-task Субагент long-task для Claude Code ведёт задачи с ожиданием от 5 до 60 минут. Он запускает долгие команды в фоне и передаёт работу дальше после длительной паузы. CX Codex ★ 262звёзд репо model-switch Скилл model-switch для Claude Code управляет выбором модели и параметрами рассуждений в bothouse. Меняет настройки в ответ на прямые запросы пользователя. CX Codex +1 ★ 262звёзд репо

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

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