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

config-guard — плагин для Claude Code: что делает и как установить

Плагин config-guard для Claude Code блокирует правку агентом файлов с его ограничениями: настроек, скриптов хуков и манифестов плагинов. Чтение разрешено.

MIT ★ 586 обновлён 2026-10-26

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

Что делает config-guard

Плагин ставит хук PreToolUse на Bash, Edit, MultiEdit и Write. Перед каждым вызовом цель сверяется с набором защищённых путей, а совпадение возвращается отказом с id правила и причиной. Чтение не блокируется: агенту нужно читать настройки, чтобы работать.

Уровней три, каждый включает предыдущий. critical закрывает цепочку enforcement: .claude/settings.json, settings.local.json, managed-settings.json, всё под .claude/hooks/ и hooks.json. high по умолчанию добавляет .mcp.json, .claude-plugin/ и CLI-формы claude config set, claude mcp add, claude plugin install. strict берёт ещё CLAUDE.md, .claude/rules/, .claude/agents/, .claude/commands/. Без HOOK_SAFETY_LEVEL=strict эти файлы агент правит свободно.

Создание защищённого файла тоже считается мутацией: так прятали payload в .claude/settings.json. Симлинки разворачиваются до проверки, поэтому запись через ln -s в /tmp не пройдёт. Оговорка: это не полный разборщик shell. Однострочники вида python -c, git checkout конфига, chmod и пути из переменных проходят мимо. Осознанную правку разрешает CONFIG_GUARD_ALLOW=true, а переменные HOOK_ASK_* меняют отказ на вопрос. Решения пишутся в ~/.claude/hooks-logs/, сетевых вызовов нет.

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

  • закрыть агенту запись в settings.json и скрипты хуков
  • поймать создание .mcp.json или манифеста плагина на лету
  • выбрать уровень строгости под свой проект
  • пропустить одну осознанную правку конфига, не снимая защиту
  • посмотреть, какие попытки правки конфига агент уже сделал

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

  • Добавь в .claude/settings.json новый хук для линтера
  • Подключи MCP-сервер через claude mcp add и покажи список
  • Убери из CLAUDE.md правило про табы

Как установить config-guard

Через маркетплейс плагинов

/plugin marketplace add karanb192/claude-code-hooks
/plugin install config-guard@claude-code-hooks

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о config-guard

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

Сначала добавьте маркетплейс: /plugin marketplace add karanb192/claude-code-hooks. Потом поставьте плагин: /plugin install config-guard@claude-code-hooks. После этого перезапустите Claude.

Что делает config-guard?

Блокирует правки файлов, на которых держатся ограничения агента: настроек с хуками и разрешениями, самих скриптов хуков, hooks.json, .mcp.json и конфига плагинов. Чтение этих файлов разрешено.

Что config-guard не ловит?

Однострочники интерпретаторов вроде python -c, git checkout или git restore конфига, chmod и пути, собранные из переменных. Командные строки Bash сверяются как текст, поэтому редирект через симлинк-каталог не разворачивается.

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

config-guard · MIT
# config-guard

> Who guards the guards: blocks the agent from tampering with its own guardrail configuration, so no other hook can be switched off from inside a session.

A `PreToolUse` hook fires before every `Bash`, `Edit`, `MultiEdit`, and `Write` call and denies any mutation of the files that wire your guardrails: settings files that register hooks and permissions, the hook scripts themselves, `hooks.json` manifests, `.mcp.json`, and plugin config. Reads always pass (agents legitimately read settings); only writes, in-place edits, moves, copies onto, symlink swaps, and deletes are stopped, plus the `claude config set`, `claude mcp add`, and `claude plugin install` CLI forms that rewrite agent config without naming a settings path. Creating a protected file that does not exist yet also counts as mutation: that was the CVE-2026-25725 persistence vector, and the Aug 2026 CHAINDROP npm worm hid its payload in `.claude/settings.json` the same way. Edit/MultiEdit/Write paths are resolved through symlinks before checking, so a write through `ln -s ~/.claude /tmp/x` is still caught.

## Install

```
/plugin marketplace add karanb192/claude-code-hooks   # once per machine
/plugin install config-guard@claude-code-hooks
```

Restart Claude Code, done. (Or from a shell: `claude plugin install config-guard@claude-code-hooks`.)

## What it does

| Event | Matcher | What happens |
|-------|---------|--------------|
| PreToolUse | `Bash\|Edit\|MultiEdit\|Write` | Checks the target path (Edit/MultiEdit/Write) or command string (Bash) against the protected set for the active safety level; returns `permissionDecision: "deny"` (or `"ask"` in ask mode) with the pattern id and reason, `{}` otherwise. |

Three safety levels, each including the previous:

| Level | Protects |
|-------|----------|
| `critical` | The enforcement chain: `.claude/settings.json`, `.claude/settings.local.json`, `managed-settings.json`, anything under `.claude/hooks/`, `hooks.json` manifests. |
| `high` (default) | Plus the config supply chain: `.mcp.json`, `.claude-plugin/`, and `claude config set\|add\|remove`, `claude mcp add\|add-json\|add-from-claude-desktop\|remove`, `claude plugin install\|uninstall\|enable\|disable\|update\|marketplace` (list/get forms stay allowed). |
| `strict` | Plus instruction files that steer the agent: `CLAUDE.md`, `CLAUDE.local.md`, `.claude/rules/`, `.claude/agents/`, `.claude/commands/`. |

## Configuration

All optional, set via environment variables:

| Variable | Default | Purpose |
|----------|---------|---------|
| `HOOK_SAFETY_LEVEL` | `high` | Safety level: `critical`, `high`, or `strict`. Invalid values fall back to `high`. Env-only on purpose: plugin updates overwrite installed files, so never edit the script. |
| `CONFIG_GUARD_ALLOW` | unset | Escape hatch for an intentional, human-approved config change: the literal string `true` lets the call through (anything else still denies). Export it for one shell call, or prefix a single hook command with it in settings.json. |
| `HOOK_ASK_CRITICAL` | unset | `true` prompts the user instead of denying for `critical`-level matches. |
| `HOOK_ASK_HIGH` | unset | `true` prompts instead of denying for `high`-level matches. |
| `HOOK_ASK_STRICT` | unset | `true` prompts instead of denying for `strict`-level matches. |

Ask mode is strictly per level and opt-in: everything defaults to deny.

## Known limits

Deliberately not a full shell parser: a mutation verb and a protected path in the same Bash command block it even if the verb technically targets another argument. Interpreter one-liners (`python -c "open(...).write(...)"`), `git checkout/restore` of a config path, `chmod`, and paths built from variables (`"$DIR/settings.json"`) are not caught. Shell command strings are matched as text, so a Bash redirect through a symlinked directory is not resolved. PreToolUse only sees the agent's own tool calls; out-of-band changes are covered by its sibling [config-watch](https://github.com/karanb192/claude-code-hooks) (ConfigChange event) in the root repo.

## Data & privacy

Logs decisions (pattern id, tool, truncated target, session id) to `~/.claude/hooks-logs/`. No network calls; everything stays on your local machine.

## Uninstall

```
/plugin uninstall config-guard@claude-code-hooks
```

Part of [claude-code-hooks](https://github.com/karanb192/claude-code-hooks).

© Karan Bansal · MIT · karanb192/claude-code-hooks

Похожие плагины

Все плагины по теме «Безопасность» →
config-safety-reviewer alirezarezvani Субагент config-safety-reviewer проверяет конфиги на захардкоженные значения, неверные таймауты и лимиты пулов; его включают перед изменениями конфигурации. CX Codex ★ 788звёзд репо safety-guard affaan-m Скилл safety-guard для Claude Code просит агента подтверждать опасные команды и ограничивает запись выбранной папкой. Применяется при миграциях, деплоях и автономной работе. CX Codex +1 6 200установок guard garrytan Скилл guard для Claude Code включает полный режим защиты от опасных действий агента. Инструмент предупреждает о деструктивных командах и запрещает изменять файлы вне выбранной папки. CX Codex +1 389установок nah manuelschipper Плагин nah для Claude Code проверяет команды и операции агента перед выполнением и останавливает те, что точно разрушат систему. Срабатывает на команды Bash, правки файлов, вызовы MCP-инструментов. ★ 494звёзд репо HOL Guard hashgraph-online HOL Guard — MCP-сервер для Claude Code и других ИИ-агентов, который локально проверяет команды, чтение файлов и вызовы MCP-инструментов до исполнения. CX Codex +1 ★ 1 118звёзд репо gh-guard sbom-tool Плагин gh-guard настраивает защиту CI/CD в GitHub Actions для Rust-проектов. Он выявляет уязвимости цепочки поставок и создаёт проверенные конфигурации безопасности. ★ 15звёзд репо

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

Весь набор →
format-code Плагин format-code для Claude Code форматирует файл сразу после записи или изменения: ruff для Python, prettier для JS, TS, JSON, MD, YAML и HTML. ★ 586звёзд репо auto-stage Плагин auto-stage для Claude Code автоматически добавляет изменённые ассистентом файлы в индекс Git, устраняя ручной вызов git add перед коммитом. ★ 586звёзд репо config-watch Плагин config-watch показывает в сессии любое изменение настроек или скиллов, случившееся посреди работы, либо блокирует его. Для случаев, когда установщик или npm-скрипт правит конфиг во время сессии. ★ 586звёзд репо subagent-spawn-cap Плагин subagent-spawn-cap считает спавны субагентов за сессию: спрашивает разрешение на 20-м, потом каждые 10, а на 60-м отказывает. Возвращает лимит, который Claude убрал в 2.1.224. ★ 586звёзд репо case-insensitive-guard Плагин case-insensitive-guard для Claude Code перехватывает опасные файловые команды и блокирует удаление не того пути из-за регистра букв. Срабатывает на командах Bash вроде rm -rf. ★ 586звёзд репо protect-tests Плагин protect-tests останавливает «липовый зелёный» результат: не даёт агенту удалять, переименовывать или отключать тесты через skip/xfail вместо того, чтобы чинить код. Работает с pytest, jest, Go, JUnit, RSpec и другими фреймворками. ★ 586звёзд репо git-safety Плагин git-safety для Claude Code перехватывает вызовы Bash и блокирует опасные команды git и gh CLI до выполнения. ★ 586звёзд репо protect-secrets Плагин protect-secrets для Claude Code проверяет вызовы Read, Edit, Write, Bash и Grep и блокирует доступ к секретам или сначала запрашивает разрешение. ★ 586звёзд репо

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

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