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

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

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

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

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

Что делает 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 лучше оставить включёнными.

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

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

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

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

Как установить protect-secrets

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

/plugin marketplace add karanb192/claude-code-hooks
/plugin install protect-secrets@claude-code-hooks

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

Вопросы о protect-secrets

Как установить protect-secrets в Claude Code?

Добавьте маркетплейс: /plugin marketplace add karanb192/claude-code-hooks, затем поставьте плагин: /plugin install protect-secrets@claude-code-hooks. После установки перезапустите Claude.

Что делает protect-secrets?

Ставит PreToolUse-хук перед Read, Edit, Write, Bash и Grep и отклоняет вызовы, которые читают, меняют или отправляют наружу .env, SSH-ключи, облачные креды и keystores. В отказе указан id сработавшего шаблона.

Чем уровень strict отличается от high?

high стоит по умолчанию и ловит секретные файлы, дампы переменных и передачу секретов во внешнюю модель. strict включается через HOOK_SAFETY_LEVEL и добавляет конфиги баз, known_hosts, .gitconfig и любые файлы, уходящие в model CLI или model API.

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

protect-secrets · MIT
# protect-secrets

> Secrets firewall: stops Claude from reading, modifying, or exfiltrating sensitive files (.env, SSH keys, cloud credentials) before the tool call runs.

A `PreToolUse` hook fires before every `Read`, `Edit`, `Write`, `Bash`, and `Grep` call. File tools and searches are checked against sensitive-path patterns (.env and .envrc, SSH private keys and authorized_keys, AWS/kube/gcloud/azure/docker credentials, .netrc/.npmrc/.pypirc, PEM/key/PKCS12 files, keystores, vault tokens); Bash commands are checked against secret-exposing patterns (cat/less/head on secrets, `printenv` and bare `env` dumps, `echo $SECRET_KEY`-style variable prints, sourcing .env, `/proc/*/environ`) and exfiltration patterns (curl/wget uploads, scp/rsync/nc of secrets, plus cp/mv/rm/truncate on them). A match returns `permissionDecision: "deny"` (or `"ask"`, see below) with the pattern id and reason, so you always know exactly which rule fired. Template files like `.env.example`, `.env.sample`, and `.env.template` are explicitly allowlisted. Path matching is separator-agnostic, so a Windows `C:\Users\me\project\.env` is treated exactly like `/home/me/project/.env`.

## Install

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

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

## What it does

| Event | Runs | What happens |
|-------|------|--------------|
| PreToolUse (`Read\|Edit\|Write\|Bash\|Grep`) | sync (must decide before the tool runs) | Matches the file path (Read/Edit/Write), the search target (Grep) or the command (Bash) against tiered sensitive patterns; on a hit, denies or asks with the pattern id and reason. Everything else passes through untouched. |

## Search and Windows coverage

`Grep` checks `path`, `glob`, and the legacy `include` field, plus each filter joined to the search directory. For example, `path: C:\Users\me\.aws` with `glob: credentials` is blocked. Every candidate is checked at the configured safety level; an allowed template or an inactive rule cannot hide another sensitive target. When several targets match, the most severe rule wins.

The guard normalizes backslashes in file and search targets, including relative paths, UNC paths, and mixed separators. It does not resolve symlinks, expand globs, or change filename case rules. Bash command strings keep their existing checks because backslashes there can be shell escapes. `PowerShell` calls are outside this plugin's matcher.

**Broad searches can still expose secrets.** A directory-only search, a pattern-only search, or a glob such as `*` need not name a sensitive file. This hook does not enumerate the files a search will read or filter its output. Use the [native permissions and sandbox controls](#native-pairing) alongside it.

## Safety levels

Patterns are tiered; each level includes everything below it:

| Level | Blocks | Use case |
|-------|--------|----------|
| `critical` | SSH keys, AWS creds, .env files, PEM/key/PKCS12 files | Maximum flexibility |
| `high` (default) | + secrets/credentials files, env dumps, secret-variable echoes, exfiltration, copy/move/delete of secrets, secrets fed to an external model CLI or model API ([delegation sinks](#delegation-sinks)) | Recommended |
| `strict` | + database configs, known_hosts, .gitconfig, recursive greps for passwords, any file contents fed to an external model | Maximum safety |

## Configuration

All optional, set via environment variables (in the hook command, or exported where Claude Code runs):

| Variable | Default | Purpose |
|----------|---------|---------|
| `HOOK_SAFETY_LEVEL` | `high` | Safety level: `critical`, `high`, or `strict`. Invalid values fall back to `high`, so a typo can never silently disable the guard. |
| `HOOK_ASK_CRITICAL` | unset (deny) | Literal string `true` makes `critical`-level matches prompt you instead of blocking. |
| `HOOK_ASK_HIGH` | unset (deny) | Same, for `high`-level matches. |
| `HOOK_ASK_STRICT` | unset (deny) | Same, for `strict`-level matches. |

Ask mode is strictly opt-in and per level: only the literal string `true` enables it, and enabling it for one level never softens another. A common setup: keep `critical` on deny, set `HOOK_ASK_STRICT=true` so cautionary patterns prompt instead of blocking.

## Delegation sinks

Token-saver plugins such as Spotify's [shunt](https://github.com/spotify/portal-ai-plugins/tree/main/plugins/shunt) route file contents to a worker model from a Bash call with no redaction ([write-up](https://engineering.atspotify.com/2026/9/portal-by-spotify-cut-my-claude-code-token-usage-by-90)). On Google's unpaid tier the [Gemini API terms](https://ai.google.dev/gemini-api/terms) let that content be used to "provide, improve, and develop Google products and services" and be read by human reviewers. These patterns keep secrets, and at `strict` any file, away from such a sink.

| Level | Pattern id | Catches | Example |
|-------|-----------|---------|---------|
| `high` | `model-cli-secret-file` | A secret file (the `critical` and `high` names above) reaching a model CLI via `<`, `$(...)`, a file flag, or a pipe from a reader | `gemini -p "review" < .env` |
| `high` | `model-cli-secret-var` | A secret-named variable (`$OPENAI_API_KEY`, `$GH_PAT`; `$AUTHOR` and `$KEYWORDS` are prose) passed to a model CLI | `gemini -p "$GEMINI_API_KEY"` |
| `high` | `model-api-secret-body` | A request to a model API host with a secret file or secret var in its body (`-d @`, `-F x=@`, `-T`, `< file`, httpie `x=@`) | `curl https://api.openai.com/v1/chat/completions -d "prompt=$OPENAI_API_KEY"` |
| `strict` | `model-cli-file-input` | Any file contents reaching a model CLI (reader pipe, `<`, `$(cat ...)`, per-CLI file flags, gemini `@path`) | `cat src/*.ts \| gemini -p "summarize"` |
| `strict` | `model-api-file-body` | Any file body sent to a model API host | `curl https://api.openai.com/v1/chat/completions -d @body.json` |

Strict is opt-in: many people pipe code to a second model on purpose, so the default only fires when secret material is on the wire. An older pattern wins when it matches first (`cat .env | gemini` is `cat-env`). Not caught by design: `gemini --version`, `curl https://api.openai.com/v1/models`, a key in an `Authorization` header with an inline body, heredocs and herestrings, prose that names a secret file inside a quoted prompt, a secret used by an earlier command in the pipeline, local models such as `ollama`. Out of reach for a regex on the command string: variable indirection (`K=$KEY; gemini "$K"`), credential emitters (`$(gh auth token)`), scripts that open the connection themselves, file names outside the list above.

Sinks: [gemini](https://github.com/google-gemini/gemini-cli), [codex](https://github.com/openai/codex), [llm](https://github.com/simonw/llm), [sgpt](https://github.com/TheR1D/shell_gpt), [aichat](https://github.com/sigoden/aichat), [openai](https://github.com/openai/openai-cli), [mods](https://github.com/charmbracelet/mods) (archived upstream), [fabric](https://github.com/danielmiessler/Fabric); matched behind env assignments, `sudo`, `npx`, `uvx`, `bunx`, `pnpm dlx`, `env`, `timeout`, `nice`, `nohup`, `exec`, `command`, `time`, `xargs`, a path or an npm scope. API hosts in `curl`, `curlie`, `wget`, `http`, `https`, `xh`: `generativelanguage.googleapis.com`, `aiplatform.googleapis.com`, `api.openai.com`, `*.openai.azure.com`, `api.anthropic.com`, `openrouter.ai`, `api.mistral.ai`, `api.groq.com`, `api.together.xyz`, `api.deepseek.com`, `api.x.ai`, `api.cohere.com`, `api.perplexity.ai`, `api.fireworks.ai`, `api.cerebras.ai`, `router.huggingface.co`, `bedrock-runtime.<region>.amazonaws.com`, `integrate.api.nvidia.com`, `api.deepinfra.com`.

To allow one flow, set `HOOK_ASK_HIGH=true` (or `HOOK_ASK_STRICT=true`): the match becomes a prompt that names the pattern id. Known false positives: `llm keys set openai --value "$OPENAI_API_KEY"` at high; `codex -i image.png` and `fabric -a image.png` at strict.

### Native pairing

This hook sees the command string only, so a script that opens files itself is opaque to it. Two native controls close that gap: `Read` deny rules in `permissions.deny` also apply to Bash `cat`, reader commands and `< file` redirects (the redirect half since [2.1.257](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md), see the [permissions docs](https://code.claude.com/docs/en/permissions#read-and-edit)), and the sandbox network allowlist (`sandbox.network.allowedDomains` with `strictAllowlist`, see the [sandboxing docs](https://code.claude.com/docs/en/sandboxing#network-isolation)) makes an unlisted model host unreachable whatever the command looks like.

```json
{
  "permissions": { "deny": ["Read(.env)", "Read(.env.*)", "Read(~/.ssh/**)", "Read(~/.aws/**)", "Read(**/*.pem)"] },
  "sandbox": { "enabled": true, "network": { "allowedDomains": ["github.com", "registry.npmjs.org"], "strictAllowlist": true } }
}
```

## Data & privacy

Logs each deny/ask decision to `~/.claude/hooks-logs/<date>.jsonl`: pattern id, level, tool, target (file path or the command's first 100 chars), session id, and cwd. Grep decisions record the rule and tool, without a target field. The home directory comes from `HOME`, then `USERPROFILE`, then the operating system. It makes no network calls, so everything stays on your local machine.

## Uninstall

```
/plugin uninstall protect-secrets@claude-code-hooks
```

Part of [claude-code-hooks](https://github.com/karanb192/claude-code-hooks); pairs well with `block-dangerous-commands` for comprehensive safety.

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

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

Все плагины по теме «Безопасность» →
env-file-protection davila7 Хук env-file-protection для Claude Code, который запрещает агенту перезаписывать файлы .env*. Срабатывает на каждом вызове инструмента Write, если имя файла начинается с .env. 279установок secrets-in-git-history UseOSINT Скилл secrets-in-git-history учит агента искать ключи, токены и адреса в истории git и на GitHub, а не только в текущем коде. CX Codex +1 1 900установок secrets-scan jwynia Скилл secrets-scan ищет захардкоженные ключи, пароли и токены в исходниках. Пригодится перед пушем или при аудите чужого репозитория. CX Codex +1 396установок GitLab Stack Secrets Manager rknall Скилл GitLab Stack Secrets Manager держит пароли и ключи GitLab-стека в ./secrets и Docker secrets, проверяет права файлов и ищет секреты в .env, compose и git. CX Codex +1 295установок secrets ulpi-io Скилл для работы с локальными секретами сервисов через CLI secrets: добавить, ротировать, включить или выключить интеграцию, не показывая значения. CX Codex +1 148установок ghost-scan-secrets ghostsecurity Скилл ghost-scan-secrets ищет утёкшие API-ключи, токены и пароли в кодовой базе проекта. Пригодится перед коммитом или при аудите репозитория на скрытые секреты. CX Codex +1 4 900установок

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

Весь набор →
config-guard Плагин config-guard для Claude Code блокирует правку агентом файлов с его ограничениями: настроек, скриптов хуков и манифестов плагинов. Чтение разрешено. ★ 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звёзд репо bounty-board Плагин bounty-board превращает TODO и FIXME в вашем коде в растущие по возрасту XP-бонусы. Плагин сканирует репозиторий, оценивает долг в очки и подсказывает три самых прибыльных задачи прямо в сессии. ★ 586звёзд репо dead-end-registry Плагин dead-end-registry сохраняет отменённые решения и предупреждает, если вы или модель снова пытаетесь пойти по тупиковому пути. Помогает не тратить токены на повторные ошибки. ★ 586звёзд репо standup-autopilot Плагин standup-autopilot собирает задачи, тесты, PR и блокеры из транскриптов сессий и оформляет сводку для дейли. Открытые блокеры возвращаются в следующую сессию. ★ 586звёзд репо pr-provenance-stamp Плагин pr-provenance-stamp дописывает в тело пулл-реквеста квитанцию: число промптов, оценку расхода, коды возврата тестов и долю строк, написанных агентом. ★ 586звёзд репо

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

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