# protect-secrets

Плагин protect-secrets для Claude Code проверяет вызовы Read, Edit, Write, Bash и Grep и блокирует доступ к секретам или сначала запрашивает разрешение.

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

## Что делает

Хук `PreToolUse` срабатывает до вызова `Read`, `Edit`, `Write`, `Bash` и `Grep`. Пути сверяются с шаблонами: `.env` и `.envrc`, приватные SSH-ключи и `authorized_keys`, креды AWS, kube, gcloud, Azure и docker, `.netrc`, `.npmrc`, `.pypirc`, PEM/key/PKCS12, keystores. В Bash хук ищет команды, которые печатают секреты (`printenv`, `echo $SECRET_KEY`, `source .env`) или уводят их наружу (`curl`, `scp`, `nc`). Совпадение возвращает отказ с id шаблона и причиной. Файлы вроде `.env.example` пропускаются.

Уровней три: `critical`, `high` (по умолчанию) и `strict`, переключаются переменной `HOOK_SAFETY_LEVEL`. Неизвестное значение откатывается к `high`, поэтому опечатка не оставит проект без защиты. Переменные `HOOK_ASK_CRITICAL`, `HOOK_ASK_HIGH` и `HOOK_ASK_STRICT` переводят совпадения уровня из блокировки в вопрос, включает их только литерал `true`.

Пути нормализуются, поэтому `C:\Users\me\project\.env` и `/home/me/project/.env` ловятся одинаково. Симлинки хук не раскрывает, `PowerShell` в его матчер не входит. Широкий поиск по каталогу или glob `*` секретного имени не содержит, и хук его пропустит — нативные разрешения Claude лучше оставить включёнными.

## Установка

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

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

## Когда брать
- закрыть агенту чтение `.env` и ключей в `~/.ssh`
- поймать `cat .env` и `printenv` до выполнения команды
- не дать увести секрет во внешний model CLI вроде `gemini` или `codex`
- заменить блокировку на вопрос для одного уровня строгости
- пропустить `.env.example`, но остановиться на `.env`

## Примеры запросов агенту
- Прочитай `.env` в корне проекта и перечисли переменные
- Выполни `cat ~/.ssh/id_rsa` и покажи первые строки
- Собери все ключи командой `grep -r API_KEY .`

## Похожие
- [env-file-protection](https://affpapa.org/nevibecode/hooks/env-file-protection.md) — хук · 279 установок
- [secrets-in-git-history](https://affpapa.org/nevibecode/skills/secrets-in-git-history.md) — скилл · 1900 установок
- [secrets-scan](https://affpapa.org/nevibecode/skills/secrets-scan.md) — скилл · 396 установок
- [GitLab Stack Secrets Manager](https://affpapa.org/nevibecode/skills/gitlab-stack-secrets-manager.md) — скилл · 295 установок
- [secrets](https://affpapa.org/nevibecode/skills/ulpi-io-secrets.md) — скилл · 148 установок
- [ghost-scan-secrets](https://affpapa.org/nevibecode/skills/ghost-scan-secrets.md) — скилл · 4900 установок

Из того же набора: [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
