# config-watch

Плагин config-watch показывает в сессии любое изменение настроек или скиллов, случившееся посреди работы, либо блокирует его. Для случаев, когда установщик или npm-скрипт правит конфиг во время сессии.

- плагин · `type=plugin` · Claude Code · ★ 586 у репозитория
- Автор: Karan Bansal
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/karanb192/claude-code-hooks/tree/HEAD/plugins/config-watch
- Обновлён: 2026-10-26
- Проверка безопасности: автоматическая, 2026-11-16 (текст и 4 файла скриптов) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/plugins/config-watch

## Что делает

Плагин ставит хук на событие `ConfigChange`. Оно срабатывает, когда посреди сессии меняются настройки (user, project, local, policy) или файлы скиллов. Установщик, npm postinstall или другой процесс правит конфиг за спиной Claude, а вы получаете `systemMessage` с именем источника и, если payload его содержит, путём к файлу. По умолчанию хук только предупреждает и выходит с кодом 0.

С `CONFIG_WATCH_BLOCK=true` хук выходит с кодом 2 и пишет причину в stderr, изменение не применяется. Исключение — `policy_settings`: хуки не могут их блокировать, там всегда предупреждение. ConfigChange срабатывает и на ваши собственные правки через `/config` или редактор, поэтому блокировку включают на ужесточённой машине, а не по умолчанию.

Схему payload в документации не описали, так что скрипт разбирает его с запасом: принимает `source`, `config_source` или `matcher` и `file_path` либо `path`. Каждое событие вместе с сырым payload уходит в `~/.claude/hooks-logs/<date>.jsonl`. Сетевых вызовов нет, скрипт использует только `fs` и `path`. В паре с config-guard работа делится: тот закрывает записи самого агента, этот — внешний путь.

## Установка

### Claude Code (родная платформа)

**Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add karanb192/claude-code-hooks
```
В чате агента (не в терминале):
```text
/plugin install config-watch@claude-code-hooks
```

## Когда брать
- заметить, что установщик переписал `.claude/settings.json` посреди сессии
- остановить npm postinstall, который меняет настройки на ходу
- увидеть, какой источник вызвал изменение конфига
- разобрать сырой payload `ConfigChange` из лога
- прикрыть внешние правки, пока config-guard стережёт записи агента

## Примеры запросов агенту
- Включи блокировку изменений конфига: поставь `CONFIG_WATCH_BLOCK=true` и перезапусти сессию.
- Покажи, какие события `ConfigChange` записались в `~/.claude/hooks-logs/<date>.jsonl`.
- Разберись, кто переписал настройки, и посмотри сырой payload в логе хука.

## Похожие
- [config-safety-reviewer](https://affpapa.org/nevibecode/agents/config-safety-reviewer.md) — субагент · ★ 788 у репозитория
- [config-codex-cli](https://affpapa.org/nevibecode/skills/config-codex-cli.md) — скилл · 1300 установок
- [GitLab Stack Config Generator](https://affpapa.org/nevibecode/skills/gitlab-stack-config-generator.md) — скилл · 303 установки
- [ccam-config](https://affpapa.org/nevibecode/plugins/ccam-config.md) — плагин · ★ 1198 у репозитория
- [config](https://affpapa.org/nevibecode/rules/config.md) — правило · ★ 78316 у репозитория
- [openship-config](https://affpapa.org/nevibecode/skills/openship-config.md) — скилл · ★ 1216 у репозитория

Из того же набора: [karanb192/claude-code-hooks](https://affpapa.org/nevibecode/by/karanb192/claude-code-hooks.md) — 28 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
