教程2026-11-08 · 智涌AI

Claude Code 权限自查:别把密钥写进 allow 规则

Claude Code 权限规则密钥自查头图:四步从审 allow 规则、搜 git 历史到先轮换再停跟踪

你在 Claude Code 的权限弹窗里点了「Yes, and don't ask again」,本意是少被打断。官方权限文档写明:对 Bash 命令和 WebFetch 域名,这条批准会永久写进仓库根目录的 .claude/settings.local.json。规则有时是 npm test * 这种模式,有时就是你刚批准的那一整条命令——密码、token 会原样躺在 JSON 里。The Hacker News 在 2026 年 11 月 7 日转述应用安全公司 Apiiro 的公开扫描:GitHub 上 104,185 份该文件中,有 1,122 份(约 1.1%)至少含一个密钥,合计 1,379 个不同密钥。

前置条件

本文按 2026 年 11 月 8 日查阅的 Claude Code 官方权限、设置与安全文档整理;公开扫描数字来自当天核对过的 The Hacker News 2026 年 11 月 7 日报道(转述 Apiiro)。权限规则怎么写、deny 先于 ask 再先于 allow,见站内 Claude Code 权限配置教程。这篇只写「不再询问」把整条命令写进文件之后,怎么自查和收场。你需要能打开自己的项目,本机装了 git。下面的检索命令可以在仓库根目录直接复制。

「不再询问」到底写进了什么

官方权限表把工具分成几类,保存行为并不一样:

工具类型默认要不要问点「Yes, and don't ask again」之后
工作区内只读(读文件、Grep)不问不适用
Bash 命令要问(内置只读命令除外)按仓库、按命令永久保存
改文件要问只管到本次会话结束,不写进文件
WebFetch要问(一批预批文档域名除外)按仓库、按域名永久保存
WebSearch要问按仓库永久保存

永久保存时,规则写到 git 仓库根目录的 .claude/settings.local.json。你在子目录或 worktree 里启动,官方说明也会解析回主检出的根目录,这条规则对整个仓库的后续会话生效。弹窗只在能完整展示批准范围时才提供「不再询问」;批准组合命令时,它会给每个需要批准的子命令各存一条规则,单次最多 5 条,而不会把整串 && 存成一条。

设置文档里还有一件容易误会的事。Claude Code 第一次在某个 git 仓库里写出这个文件时,会把 **/.claude/settings.local.json 加进你本机的全局 git excludes(core.excludesFile,或未配置时的 ~/.config/git/ignore)。这只保护你这台电脑上还没提交的副本。它不会改项目自己的 .gitignore;换机器、别人克隆、已经提交进去的文件,都不在这层保护里。你如果是手工建的这个文件、而 Claude Code 还没写过它,需要自己把它加进 .gitignore。文件一旦被 git 跟踪,就会被当成仓库提供的配置,allow 规则也要等工作区信任对话框通过才生效。

全局 git excludes 只护住你这一台电脑上还没提交的文件。已经进仓库、进历史、进 fork 的副本,它管不到。

第一步:先看当前工作区里的 allow 列表

在仓库根目录执行:

ls -la .claude/settings.local.json .claude/settings.json 2>/dev/null
ls -la ~/.claude/settings.json 2>/dev/null
git ls-files --error-unmatch .claude/settings.local.json 2>/dev/null \
  && echo "TRACKED" || echo "NOT_TRACKED_OR_MISSING"

git ls-files --error-unmatch 能告诉你这个文件现在是不是被索引跟踪。磁盘上有文件,并不等于 git 在跟踪它。跟踪状态才决定它会不会跟着 commit 走。

把 allow 列表打到终端(自己看,别把输出贴进工单、聊天或模型对话):

python3 -c '
import json
from pathlib import Path
for p in [Path(".claude/settings.local.json"), Path(".claude/settings.json")]:
    if not p.exists():
        print("missing", p)
        continue
    data = json.loads(p.read_text())
    allow = data.get("permissions", {}).get("allow", [])
    print("==", p, "allow", len(allow), "==")
    for rule in allow:
        print(rule)
'

然后用下面这条只读检索,标出「整条命令里可能夹了密码或 token」的行。模式来自 The Hacker News 转述的常见落点:PGPASSWORD=、sshpass -p、mysql -p,以及常见云厂商和代码托管 token 前缀。

grep -nE 'PGPASSWORD=|sshpass -p|mysql -p|--password |AKIA[0-9A-Z]{16}|ghp_|glpat-|npm_[A-Za-z0-9]{10,}|xox[baprs]-' \
  .claude/settings.local.json .claude/settings.json 2>/dev/null

2026 年 11 月 8 日,本机用一份不含真实密钥的示例 JSON 跑过上面两条命令:示例里的 PGPASSWORD=example-not-a-secret 被检索命中,Bash(npm run test *) 和 Bash(git log *) 没有命中。看到命中行,先记下对应的密码、token、云密钥,进入下一步轮换;先别急着删文件。普通的 --password 参数名也会被标出来,要自己看上下文。

第二步:在 git 历史里把已经删掉的副本也找出来

当前工作区是干净的,旧提交里仍可能有完整文件。Apiiro 的扫描里,另有 734 个密钥出现在 509 个仓库的旧版本中,这些密钥已经不在任何当前副本里,通常是因为文件后来被删了。在仓库根目录:

git log --all --full-history --pretty=format:'%h %ad %an %s' --date=short \
  -- .claude/settings.local.json .claude/settings.json

git log -p --all --full-history -- .claude/settings.local.json .claude/settings.json

-p 会把历史里的文件内容打到终端,里面可能就是明文密钥。在本地看完就关掉,不要重定向到会同步到云端的笔记,也不要贴给聊天机器人。组织层还可以在 GitHub 代码搜索里查 filename:settings.local.json path:.claude,以及共享的 .claude/settings.json。The Hacker News 转述:76,011 份共享设置文件里有 298 份也含密钥,多半写在 allow 规则中。把共享文件、历史版本和已提交的 Agent 对话记录算上,总数是 1,994 个仓库里的 2,539 个密钥。

一半被发现含密钥的文件,在仓库默认分支上至少待了 217 天;报道撰写时(文中称「截至周一」)这些含密钥文件仍在默认分支上。1,122 份含密钥文件对应 1,379 个不同密钥,其中 379 个是数据库密码,另有 43 个面向公开服务器的 SSH 登录、42 个 GitHub / GitLab / npm token、23 个 AWS 密钥;超过三分之一能直接连数据库。被点名的所有者里有 63 个组织。在研究者追溯到的 1,105 个仓库中,539 个仓库里有一次把 Claude 列为共同作者的提交改过该文件。

第三步:先轮换,再停止跟踪

顺序不能反。文件删了,旧提交和 fork 里的副本还在。The Hacker News 转述的处置顺序是:

  1. 把文件和历史里出现过的密码、token、云密钥,全部在原厂轮换或吊销。
  2. 停止跟踪:git rm --cached --ignore-unmatch .claude/settings.local.json。
  3. 把 .claude/settings.local.json 写进项目自己的 .gitignore,让保护跟着仓库走。
  4. 打开本机上的文件,删掉每一条含密钥的 allow 规则。
  5. 以后命令里用 $DB_URL 这类环境变量或密钥管理器引用,不要把明文写进命令行。
  6. 批准时优先选命令模式,例如 Bash(npm run:*),不要为一条带参数的完整命令点「不再询问」。
echo '.claude/settings.local.json' >> .gitignore
git rm --cached --ignore-unmatch .claude/settings.local.json
git add .gitignore

如果这个文件已经进过远程历史,停跟踪只影响之后的提交。要从旧提交里拿掉敏感内容,按 GitHub 官方文档「从仓库中删除敏感数据」处理,并通知协作者重新克隆;fork 里的副本要单独处理。密钥轮换本身可参考站内 AI 开发平台密钥泄露自查。

第四步:改规则时避开两种极端

官方建议把星号放在子命令后面:Bash(git log *) 只放行 git log;Bash(git *) 等于放行所有 git 子命令,包括 push,也匹配 git -c ... 这种能拉起外部程序的写法。启动时如果 allow 规则把星号写在子命令前面,Claude Code 会给出警告。

你点了什么 / 写了什么文件里留下的规则结果
只点一次 Yes不写文件下次同样的命令还会问
对带明文密码的整条命令点「不再询问」整条命令进入 allow密钥落盘,跟踪后会进仓库
手写 Bash(npm run test *),或批准 npm test * 这种模式模式,通常不含密钥同类测试命令不再问
手写 Bash(git *) 或 Bash(curl *)过宽模式把危险子命令一并放行

安全文档也提醒:网络命令如 curl、wget 默认不会自动批准。要停掉它们,写进 permissions.deny。Bash 规则匹配的是命令文本,换一种写法(绝对路径、sh -c、git -C)就对不上,所以它不是围着程序的安全边界;需要操作系统层隔离时,用官方的沙箱。

共享的 .claude/settings.json 适合放团队统一的窄规则,例如 Bash(npm run lint)、Bash(npm run test *),以及 Read(./.env)、Read(./.env.*) 这类 deny。个人例外和「不再询问」留下的规则,留在未被跟踪的 settings.local.json 里。

常见坑

完成标准

最后

打开你正在用的项目,先跑上面的 git ls-files 和 git log --all --full-history。只要历史里出现过 .claude/settings.local.json,就按出现过的密钥去原厂轮换,再回来改规则和 .gitignore。

关注公众号「智涌AI速递」

每天的 AI 快讯、实用教程和 AI项目实测,也会同步发到微信公众号。在微信里搜索「智涌AI速递」就能关注;不用微信的话,可以用 RSS 订阅本站。