---
title: "secret-guard"
url: "https://claudemods.dev/zh-tw/builds/secret-guard-80ba09"
source: "https://github.com/ShriD5/claude-mods/tree/main/secret-guard"
source_type: "github"
repo: "https://github.com/ShriD5/claude-mods/tree/main/secret-guard"
author: "ShriD5"
author_handle: "ShriD5"
stars: 2
category: "安全與隱私"
categories: ["security"]
tags: ["credential-detection", "hooks", "plugin", "secrets", "security"]
permission_level: 2
scan_complete: true
install: "claude plugin marketplace add ShriD5/claude-mods\nclaude plugin install secret-guard"
added: "2026-10-05T01:59:37.153Z"
updated: "2026-10-04T18:19:52Z"
locale: "zh-tw"
content_locale: "zh-tw"
---

# secret-guard

透過 tool.call hook 阻擋 Write、Edit、MultiEdit、NotebookEdit 與 Bash 重新導向把看似真實的憑證寫入檔案，同時允許佔位符、開發預設值與 .env 檔案。

## Description

secret-guard 加入 tool.call hook，檢查檔案工具即將寫入的文字，以及 Bash 指令重新導向至檔案的內容；發現看似真實的憑證就拒絕呼叫。它會偵測 AWS、Anthropic/OpenAI、GitHub、Slack、Stripe、Google 金鑰、私鑰區塊，以及含內嵌密碼的資料庫 URL。佔位符（xxxx、process.env.X、EXAMPLE 金鑰）、開發預設值（localhost、example.com、postgres:postgres）、檔案中已有的秘密與 .env 系列檔案會放行，但 .env.example/.sample/.template 仍受保護。CLAUDE.md 與 AGENTS.md 會接受更嚴格檢查。遭阻擋時會告訴 Claude 發現的內容與行號，要求改用環境變數且不回顯秘密。可使用 claude --plugin-dir ./secret-guard 或市集安裝，並執行 /secret-guard 查看依類型整理的阻擋結果。

## Install

```
claude plugin marketplace add ShriD5/claude-mods
claude plugin install secret-guard
```

## Original README

# secret-guard

Stops Claude from writing secrets into files. When a Write, Edit, MultiEdit or NotebookEdit would put a real-looking credential into a file, or a Bash command would `echo`, `printf`, `tee` or heredoc one into a file, the call is refused. Claude is told what it found and on which line, and to read the value from an environment variable instead, with the value kept in a gitignored `.env`. The secret itself is never repeated back.

```
🔒 secret-guard blocked a GitHub token in config.ts
```

It catches:

- AWS access keys (`AKIA…`, `ASIA…`)
- Anthropic keys (`sk-ant-…`), OpenAI keys (`sk-proj-…`, legacy `sk-…`), and other long `sk-…` keys
- GitHub tokens (`ghp_`, `gho_`, `ghu_`, `ghs_`, `ghr_`, `github_pat_`)
- Slack tokens (`xoxb-`, `xoxp-`, …) and Slack webhook URLs
- Stripe live keys (`sk_live_`, `rk_live_`)
- Google API keys (`AIza…`)
- private key blocks (`-----BEGIN … PRIVATE KEY-----` with a key body)
- database URLs with an inline password (`postgres://`, `mysql://`, `mongodb+srv://`, `redis://`, `amqp://`)

It lets these through:

- **Placeholders**: `xxxx`, `your-key-here`, `<api-key>`, `${VAR}`, `process.env.X`, `AKIA…EXAMPLE`, low-variety strings.
- **Dev defaults**: database URLs to `localhost` or a docker service name, documentation hosts like `example.com`, and default passwords like `postgres:postgres`.
- **Secrets the file already holds**: editing next to an existing key isn't blocked.
- **Env files**: `.env`, `.env.local`, `.env.production` and `.dev.vars`, which is where the deny message tells Claude to put secrets. `.env.example`, `.env.sample` and `.env.template` are still guarded, because those get committed.

**CLAUDE.md and AGENTS.md get extra-strict checks.** In those files any credential-named assignment with a random-looking value (`api_key: "q8Zr…"`) is blocked too. The deny reason also tells Claude why: these files are often committed and public, and in a public sample of 25,784 CLAUDE.md files, 275 contained real-looking secrets.

Run `/secret-guard` to see how many secrets it has blocked so far, broken down by type.

## Install

```sh
claude --plugin-dir ./secret-guard
```

or add this repo as a marketplace and install it with `/plugin`.

## Options

None. The rules live in `hooks/detect.ts`. Each one is a regex for a format a real service issues, followed by placeholder checks.

## How it works

A `tool.call` hook reads the text a file tool is about to write, or the files a Bash command redirects into, and runs the detector on it. If anything new turns up, it answers `{ deny }` so the tool never runs. The running count is kept in `$.store`.
