跳到主要内容
博客
返回博客

Claude Code settings.local.json 中的机密:检查、轮换与预防

当 Claude Code 请求运行一条 shell 命令,而你选择「Yes, and don't ask again」时,它会把这条命令原样作为一条权限规则保存到 .claude/settings.local.json 中。如果命令里包含密码、令牌或连接字符串,这个文件现在就以明文保存着它。2026 年 11 月 5 日,安全公司 Apiiro 报告称,GitHub 上有 1,122 份公开的此类文件包含真实机密;Anthropic 的 Claude Code 负责人表示,团队正在研究修复方案。如果你用 Claude Code 开发并推送到 GitHub,本指南提供一个五分钟检查、轮换凭据的顺序、清理方法、如何让机密远离审批,以及还应该检查哪些其他智能体文件。即使没有 Soloop 账户,本指南也同样有用;它不构成安全审计。

简短回答

你永久批准的每条 Bash 命令都会逐字保存在代码仓库根目录的 .claude/settings.local.json 中。Claude Code 第一次在某个代码仓库中写入该文件时,会把它加入你的全局 git 忽略列表,这覆盖了你在自己工作的机器上的常见情况。它不覆盖在忽略规则生效之前已被提交的文件、后来才成为代码仓库的文件夹、另一台机器上的克隆,或有人故意添加的文件,而且这条忽略规则从不随代码仓库一起传递。

检查该文件是否被跟踪,或是否出现在你的 git 历史中。如果它曾经包含已到达远程仓库的机密,请先轮换该机密;删除文件并不会把它从历史、复刻(fork)或克隆中移除。然后取消跟踪该文件,把它加入代码仓库自己的 .gitignore,从你的本地副本中删除包含机密的规则,并且不再把机密直接输入命令。

机密是如何进入这个文件的

让 Claude Code 检查预发布环境登录为何失败,或者运行一次迁移,它提出的命令可能需要你配置文件中的某个凭据,例如 PGPASSWORD= 后面的数据库密码,或 curl 调用中的 bearer 令牌。Claude Code 在运行 shell 命令之前会先询问。经过多次提示后,你很容易在没有注意到其中机密的情况下批准一长串命令。「Yes, and don't ask again」会运行这条命令,并把它连同机密一起保存为一条允许规则,这样就不会再询问你。

Apiiro 用 Anthropic 当前的模型 Opus 5.5 和 Fable 5.1 复现了这一问题,并把它描述为 Claude Code 的行为,而不是模型的行为。在它追踪到的 1,105 个含真实机密的代码仓库中,有 539 个出现过由 Claude 共同署名的提交修改了该文件。自 2025 年 8 月起,Claude Code 用户就已在 GitHub issue 中报告过这一机制。

审批保存在哪里

对一条 Bash 命令选择「Yes, and don't ask again」会把一条允许规则保存到 .claude/settings.local.json,Claude Code 将该文件放在代码仓库根目录。Claude Code 第一次在某个代码仓库中写入该文件时,会把 **/.claude/settings.local.json 加入你的全局 git excludes 文件;如果你手动创建该文件,就必须自己忽略它。

Claude Code 文档:Settings
规则有效期

对 Bash 命令的「don't ask again」审批按代码仓库和命令永久有效。/permissions 会列出每条规则及其来源的设置文件。

Claude Code 文档:Permissions
规模

103,617 个代码仓库中有 104,185 份公开副本;其中 1,122 份(1.1%)包含真实机密,去重后为 1,379 个;若计入历史、共享设置文件和智能体对话记录,则 1,994 个代码仓库中共有 2,539 个机密。真实机密指已知的密钥格式或紧邻公共主机的密码,而不是经过测试的凭据。

Apiiro,2026 年 11 月 5 日

发现了什么

去重后的机密中,超过三分之一可以直接打开数据库:379 个数据库密码和 122 个 Supabase service-role 密钥,另有 103 个 Supabase 账户令牌。其余包括 API 和 AI 模型密钥、43 个 SSH 登录凭据、42 个 GitHub、GitLab 和 npm 令牌、23 个 AWS 密钥和 6 个私钥。大多数属于个人开发者;有 63 个组织受到影响,从学生团体到初创公司和代理机构都有。

文件越大,泄露越多:超过 8 KB 的文件中每十个就有一个包含真实机密,而小于 500 字节的文件中不到五百分之一。在受影响代码仓库的中位数中,该文件已公开 217 天。早期版本在 509 个代码仓库中包含 734 个当前副本已不再显示的机密,通常是因为文件被删除了,但其中的内容没有被轮换。

settings.local.json 还是 settings.json?

.claude/settings.json 是共享的项目文件:你有意提交它,让协作者获得相同的权限和钩子。.claude/settings.local.json 只属于你在某个项目中的个人设置,永远不应被提交。两者都可以包含允许规则,因此两者都不要放入机密;Apiiro 在 76,011 份公开的共享设置文件中发现有 298 份包含真实机密。

五分钟检查

在你推送过的每个代码仓库根目录下运行这些命令。它们只读取,不会修改任何内容。这些命令已在 macOS 上用 git 测试过。

  1. 该文件现在是否被跟踪?git ls-files -- '*settings.local.json' 会列出任意深度下被跟踪的副本。没有输出表示没有副本被跟踪。
  2. 它是否曾被提交?git log --all --oneline -- '*settings.local.json' 会列出每一个涉及它的提交,包括后来删除它的提交。只要有输出,就说明其内容存在于历史中。
  3. 是否有机密进入了历史?git log --all -p -- '*settings.local.json' | grep -nE 'PGPASSWORD=|sshpass -p|mysql .*-p[^ ]|[Bb]earer |://[^:/ ]+:[^@ ]+@' 会显示命令中带密码、带 bearer 请求头或连接字符串中带密码的行。这只是一个粗略的过滤器:还要自己阅读规则,查找 API 密钥。
  4. 是什么忽略了它?git check-ignore -v .claude/settings.local.json 会指出忽略它的文件和行。如果它指向你的全局 excludes 文件,而不是代码仓库的 .gitignore,那么这项保护只存在于这台机器上。
  5. 你的本地副本里有什么?find ~ -path '*/.claude/settings*.json' -not -path '*/node_modules/*' 2>/dev/null 会列出你电脑上的每一份副本。逐个打开并阅读其允许列表,或者在 Claude Code 中运行 /permissions。
  6. 在 GitHub 上,在你的账户或组织的代码中搜索 settings.local.json,并检查受影响代码仓库的所有复刻。

优先轮换什么

把任何到达过远程仓库的内容都视为已暴露,即使该代码仓库现在是私有的或文件已经不在了。从可以在任何地方针对公共主机使用的凭据开始。对每一个凭据:签发新凭据,更新使用它的地方,吊销旧凭据,并检查服务商的访问日志中是否有你不认识的使用记录。

轮换在 settings.local.json 中发现的凭据的顺序
维度为什么优先该怎么做
数据库密码和 Supabase service-role 密钥可直接读写你的数据;这是 Apiiro 发现的最常见类别。修改密码或轮换密钥,更新应用的环境变量,然后审查近期连接。
云密钥(AWS 及类似服务)除了读取数据,还可以创建资源并产生费用。停用该密钥,创建一个只具备所需最小权限的新密钥,并检查账单和活动日志。
SSH 登录凭据和私钥对公共主机的服务器登录权限,有时是 root。修改密码或从 authorized_keys 中移除该密钥,优先使用基于密钥的登录,并审查近期登录记录。
GitHub、GitLab 和 npm 令牌可以用你的名义推送代码或发布软件包。吊销该令牌,创建一个权限范围更窄的新令牌,并检查近期推送和软件包版本。
API 和 AI 模型密钥通常会产生计费用量,并能访问该服务保存的任何内容。在服务商控制台中轮换密钥,并在服务商支持的情况下设置用量上限。

清理代码仓库和你的机器

  1. 在不删除你自己副本的前提下取消跟踪该文件:git rm --cached .claude/settings.local.json,然后提交。
  2. 把 **/.claude/settings.local.json 加入代码仓库自己的 .gitignore,让这条规则随每个克隆一起传递,然后同样提交。
  3. 打开每一份本地副本,删除每条包含机密的规则,或在 /permissions 中移除它。一条规则一旦批准,就会一直保留,直到有人删除它。
  4. 决定是否重写历史。让已暴露的机密失效的是轮换;重写历史会从你的代码仓库中移除旧值,但不会从已经存在的复刻或克隆中移除。
  5. 检查该文件可能不经过 git 而流出的其他途径:已发布的 npm 软件包、复制了整个文件夹构建的 Docker 镜像、zip 压缩包或同步文件夹。

阻止下一次泄露

长期的解决办法是让机密远离你批准的命令。把凭据放在环境变量或机密管理工具中,并按名称引用它们,这样保存的规则记录的是 $DATABASE_URL,而不是密码。把例行任务封装进脚本并批准该脚本,或者批准 Bash(npm run *) 这样的模式,而不是批准一长串字面命令。

示意性示例,并非真实凭据。之前:"Bash(PGPASSWORD=example-not-real psql -h db.example.com -U app -c \"select 1\")" 被连同密码一起保存。之后:一个名为 db:check 的 package 脚本运行 psql "$DATABASE_URL" -c "select 1",该变量保存在你未被跟踪的 .env 中,保存下来的规则是 "Bash(npm run db:check)"。

  • 把 **/.claude/settings.local.json 加入每个代码仓库的 .gitignore,以及你会复用的任何项目模板。
  • 添加 Read(./.env) 和 Read(./.env.*) 这样的拒绝规则,让 Claude Code 的文件工具不读取你的机密文件。
  • 在选择「Yes, and don't ask again」之前读完整条命令;当命令包含凭据时,只批准一次。
  • 安装一个拒绝已暂存 settings.local.json 的 pre-commit 钩子(可在下方复制)。
  • 保持你的代码托管平台提供的机密扫描处于开启状态;公开的 GitHub 代码仓库会被自动扫描。
  • 在 pre-commit 或 CI 中使用一个也能捕获命令中密码的扫描工具,而不仅仅是已知的密钥格式。

复制 pre-commit 钩子

在每个代码仓库中把它保存为 .git/hooks/pre-commit,并使其可执行。它会阻止任何暂存了该文件的提交,无论文件位于代码仓库的哪个位置。钩子只存在于你的本地克隆中,因此上面的 .gitignore 规则仍然必不可少。

下载 Markdown

检查智能体写入的其他文件

同样的习惯,即把机密输入到随后会被智能体记录下来的命令中,也会通过其他文件泄露。Apiiro 检查了 GitHub 上的这些公开文件;请把 .claude/、.cursor/、.gemini/ 和 .specstory/ 等智能体文件夹以及智能体记忆文件,像 .env 一样视为可能包含机密。

共享的 .claude/settings.json

76,011 份文件中有 298 份包含真实机密,大多以完整命令行的形式出现在允许规则中。

智能体聊天记录

87 个代码仓库中的 120 份文件,来自 .specstory、aider 和 Cursor 的导出(共检查 2,523 份)。

智能体记忆文件

9 个代码仓库,出现在 MEMORY.md 等文件中(共检查 1,200 份)。

交接和部署笔记

33 份文件(共检查 2,095 份);其中含机密的文件有三分之一由智能体写入。

Anthropic 怎么说

2026 年 11 月 7 日,Anthropic 的 Claude Code 负责人 Boris Cherny 在 Hacker News 上回复称,Claude Code 过去一直没有清除机密,但团队正在研究预防措施,并提到让 auto mode 捕获这种情况以及基础的内置机密扫描,作为准备做原型的方案。根据 Apiiro 的总结,他还表示 Claude Code 在创建该文件时会将其加入 gitignore,因此他认为那些暴露的副本是手动创建并提交的,并建议使用代码托管平台提供的机密扫描。

截至 2026 年 11 月 10 日,我们尚未看到已发布的修复。在修复发布且你完成更新之前,请假定这里描述的行为仍然存在。

复制检查清单

每个代码仓库使用一份。记录你发现了什么、轮换了什么,以便日后客户或协作者询问时你能回答。

下载 Markdown

Soloop 能做什么

Soloop 不会扫描代码仓库中的机密、读取你的 Claude Code 设置或轮换凭据。这些工作请使用上面的命令、你的代码托管平台的机密扫描以及各服务商的控制台。

Soloop 用于完成开发之后的工作:根据 Soloop 手册,它可以附带资料来源调研市场,通过已连接的账户撰写和发布 X 帖子和回复,通过已连接的 Gmail 账户发送外联邮件,并在你完成设置和付款后准备 Google Ads 搜索广告系列,默认情况下各项操作都会等待你的审批。不要把机密粘贴到任何 AI 工具的提示中,包括 Soloop。

资料来源、局限与更新

Claude Code 的 Settings 和 Permissions 文档以及 Apiiro 的报告于 2026 年 11 月 10 日查阅。Apiiro 的数据来自 2026 年 11 月 1 日至 3 日对 GitHub 的只读搜索;它没有测试任何凭据是否有效。Anthropic 的回应引自 Apiiro 对 Hacker News 讨论串的总结。命令、轮换顺序、示例和钩子属于在一个示例代码仓库上测试过的编辑建议,不是安全审计,也不是 Anthropic 的声明。

本指南将在 2027 年 2 月 10 日之前复审;如果 Claude Code 推出机密扫描或更改审批的保存位置,会更早复审。

产品能力

Soloop 手册描述了附带资料来源的调研、通过已连接账户在 X 上发帖、Gmail 外联,以及在完成设置和付款后运行 Google Ads 搜索广告系列;默认先审批。它不扫描代码仓库。

Soloop 产品手册