11 月 6 日,安全公司 Apiiro 公布了一份针对 Claude Code 权限文件的普查:他们在公开 GitHub 上找到 104,185 份 .claude/settings.local.json,分布在 103,617 个仓库;其中 1,122 份(约 1.1%)至少包含一个密码、密钥或 token,合计 1,379 个不同的凭证。研究者没有逐一验证这些凭证是否仍然有效,但被通知的公司里有一家确认,自己的密钥在被通知前一直是可用的。
这些密码的来源,是 Claude Code 的一个高频交互:模型请求执行一条 shell 命令,用户选择了「是的,不再询问」。
一条允许规则是怎么带出密码的
Claude Code 默认在执行大多数 shell 命令前询问用户。用户选择「Yes, and don't ask again」之后,它会把这次批准以 allow 规则的形式写进项目目录下的 .claude/settings.local.json。规则只覆盖弹窗里那条命令:有时是 npm test * 这样的模式,有时是一条完整命令。当批准的对象是完整命令时,命令里的密码随规则原样落盘,明文 JSON。
Apiiro 用最新模型 Opus 5.5 和 Fable 5.1 复现了这个行为。PGPASSWORD=xxx psql ...、sshpass -p xxx、mysql -p xxx 这类命令一旦被「不再询问」,密码就进了项目文件。
按官方文档的设计,这个文件应当留在本地:Claude Code 第一次在 git 仓库里写这个文件时,会把它加进用户的全局 git 排除列表,此后这台机器上的所有仓库都会忽略它。

全局排除只保护一台机器
问题出在这道防线的覆盖范围。全局排除写在单个用户的 git 配置里,不随项目走。研究方在 Hacker News 讨论中梳理了三类穿透场景:
- 项目目录被整体拷贝到另一台机器或新容器,全局排除不会跟着走,文件在那里是普通未跟踪文件,
git add .会把它收进提交; - 项目自己的
.gitignore从来不会被写入这条规则,防护不随仓库分发; - 已经被跟踪的文件不受任何 ignore 规则约束,事后删除文件也清不掉 git 历史和 fork 里的旧版本。
提交行为本身就不少见。在 Apiiro 追踪的 1,105 个含密钥仓库中,539 个存在 Claude 共同署名的提交修改过这个文件,署名模型从 Sonnet 4.5 一路到 Opus 5.5。相当一部分文件,是代理自己执行 git commit 时带进仓库的。
1,379 个凭证的构成
| 类别 | 数量 |
|---|---|
| 数据库密码 | 379 |
| 公网服务器 SSH 登录 | 43 |
| GitHub / GitLab / npm token | 42 |
| AWS 密钥 | 23 |
| 合计(当前副本) | 1,379 |
超过三分之一的凭证可以直接打开一个数据库。文件主人中有 63 个组织,以各种规模的软件公司为主。Apiiro 点名的两个最重案例:一家数据库厂商自己的管理级云密钥,和一份医疗记录数据库的 owner 密码。
计数口径也有交代:一个值要被算作密钥,要么匹配已知密钥格式,要么是一段密码或 token 紧挨着公网服务器地址出现,并且需要再过一道 AI 复核。
扩散范围也不止当前文件。git 历史里还躺着 734 个额外密钥,分布在 509 个仓库,多数是文件后来删了、历史还在;74 个仓库的 211 个 fork 原样带着密钥。团队共享、有意提交的 .claude/settings.json 同样没能幸免:76,011 份里 298 份含密钥,多藏在 allow 规则里。把代理聊天记录也算上,Apiiro 给出的总账是 1,994 个仓库、2,539 个凭证。
截至 11 月 2 日,所有含密钥文件都还躺在各自仓库的默认分支上;一半仓库里,这份文件已经存在至少 217 天。
扫描器漏掉的 215 份
Apiiro 用 gitleaks 和 TruffleHog(关闭验证步骤)扫了全部 1,122 份含密钥文件:gitleaks 标记 564 份,TruffleHog 标记 643 份,215 份两者都没有报出来。
漏报的多数是写在命令里的密码。扫描器按已知密钥格式匹配,PGPASSWORD= 后面跟的普通单词、sshpass -p 的参数、mysql -p 的口令,在扫描器眼里和一条寻常命令行没有区别。
这个盲区有现实的利用先例。2025 年 9 月的 Shai-Hulud 蠕虫在被感染的机器上运行 TruffleHog 找密钥,扫描器把过半文件标为含密钥:在开发者机器上翻密钥文件,已经是恶意软件的现成打法。
一年前的报告与官方回应
这个行为并非无人知晓。2025 年 8 月 11 日,就有人向 anthropics/claude-code 仓库报告被批准的命令连同 API key 原样存进 settings.local.json。这份报告在 60 天无活动后,于 2026 年 1 月 3 日被自动化 bot 关闭,状态为 not planned。Apiiro 引用的四份相关报告全部被同一个 bot 关闭,最近一份关闭于研究发布前一天,没有一份得到 Anthropic 的人工回复。
研究发布后,Claude Code 团队的 Boris Cherny 在 Hacker News 讨论区回应:Claude Code 历史上没有做密钥清理,团队正在对几个方向做原型,包括让 auto mode 拦住这类命令、内置基础密钥扫描。他还提到团队已开源 agent 无关的沙箱项目 sandbox-runtime。作为参照,Apiiro 对比了 16 个编码代理的文档,Claude Code 是其中唯一被证实默认把完整批准命令保存进项目文件的。
轮换优先,清理在后
Apiiro 给开发者的处置顺序:
- 在组织内搜索
.claude/settings.local.json和.claude/settings.json,包括已删除该文件仓库的 git 历史; - 先轮换这些文件里出现过的每一个密码、token 和密钥,再动手清理;
- 执行
git rm --cached .claude/settings.local.json,把文件写进项目自己的.gitignore; - 打开本机项目里的这个文件(哪怕从未提交过),删掉所有含密钥的规则;
- 密钥不进命令:写成
$DB_URL这样的变量引用,allow 规则里留下的就只是变量名; - 批准模式而非单条命令,例如
Bash(npm run:*)。
安全团队侧,Apiiro 的建议是把 .claude/、.cursor/、.gemini/、.specstory/ 和各类 agent 记忆文件一律当作 .env 级别的秘密容器处理,纳入 pre-commit 与 CI 扫描(覆盖 git 历史),并把 .claude/settings.local.json 加进组织的 .gitignore 模板。排查时优先处理配了公网服务器地址的凭据,那是真正能被远程登录的部分。
从未进过 GitHub 的副本同样算数:这个文件是项目目录里的普通 JSON,可能留在 npm 包、Docker 镜像、zip 归档或同步盘里。
来源:Apiiro 研究报告、The Hacker News 报道(2026-11-07)、Claude Code 官方 settings 文档、Hacker News 讨论(含 Boris Cherny 回应)