[控场AI]
· 5 分钟阅读· 2,767 字

Claude Code配置文件泄露密钥:千余仓库中招

Claude Code配置文件泄露密钥:千余仓库中招

Apiiro 发现 1122 个公开 Claude Code 配置文件泄露真实密钥,提醒 AI 工具本地配置的安全风险。

安全公司 Apiiro 扫描发现,超过 1,122 个公开仓库中的 Claude Code `settings.local.json` 文件包含真实 API 密钥和访问令牌。该文件由用户点击「Yes, and don't ask again」自动生成,用于记录本地权限决策,本应仅限本地使用,却因被提交到公开仓库而暴露敏感信息。Anthropic 回应称该文件不应提交到版本控制系统,但这也引发了对工具默认安全设计的讨论。文章提供了 10 分钟清理指南,包括检查文件、清理 Git 历史、添加 .gitignore 和轮换密钥,并指出随着 AI 工具普及,开发者需将自动生成的配置文件纳入代码卫生审计范围。

一个被忽视的配置文件,正在泄露你的密钥

安全公司 Apiiro 最近发现,超过一千个公开的 Claude Code settings.local.json 文件中包含真实密钥。这些文件通常由用户在 Claude Code 中点击「Yes, and don't ask again」时自动生成,用于记住本地权限决策,却因为被提交到公开仓库而暴露了敏感信息。

Claude Code settings.local.json Secrets: Check Your Repos

这个发现提醒我们:AI 编程工具的便利性背后,可能隐藏着开发者未曾留意的安全盲区。

settings.local.json 里到底存了什么?

Claude Code 是 Anthropic 推出的命令行 AI 编程助手。为了减少重复确认,它允许用户将某些操作标记为「始终允许」,这些决策会写入项目根目录下的 settings.local.json。

问题在于,这个文件存储的不仅仅是权限偏好。根据 Apiiro 的分析,部分文件包含了 API 密钥、访问令牌和其他凭证信息。当开发者将这些文件提交到公开仓库时,密钥就暴露在了互联网上。

更微妙的是,许多开发者可能根本不知道这个文件的存在,或者误以为它像 .gitignore 中的文件一样不会被提交。

Apiiro 发现了什么

Apiiro 在公开仓库中扫描了 Claude Code 的 settings.local.json 文件,确认了 1,122 个文件包含真实密钥。这个数字来自实际扫描结果,而非推测。

这意味着,在 GitHub 等平台上,有超过一千个项目的敏感信息可能已经被泄露。攻击者可以通过简单的搜索找到这些文件,进而利用其中的密钥访问相关服务。

Apiiro 将这一发现归类为「真实密钥泄露」,强调这些不是测试用的假密钥,而是能够实际访问系统的凭证。

密钥轮换(Secret Rotation) 是应对凭证泄露的核心补救措施:一旦密钥(如 API Key、访问令牌)被公开,应立即在对应服务平台(如 AWS、GitHub、OpenAI 控制台)撤销旧密钥并生成新密钥,使旧密钥立即失效。仅从 Git 历史中删除文件并不足够,因为搜索引擎爬虫、代码扫描机器人或恶意用户可能早已抓取并缓存了泄露内容;Git 历史中的对象也可能长期留存于 fork、镜像和缓存中。轮换应视为泄露后的强制步骤,且需同步更新所有依赖该密钥的本地环境变量、CI/CD 配置和部署环境,避免服务中断。

Anthropic 的回应

针对这一发现,Anthropic 做出了回应。根据原始报道,Anthropic 表示 settings.local.json 的设计初衷是本地使用,不应该被提交到版本控制系统。

这一回应将责任部分指向了用户行为,但也引发了一个问题:工具是否应该在设计上提供更好的保护?例如,自动将 settings.local.json 加入 .gitignore,或者在文件包含敏感信息时发出警告。

目前,Claude Code 用户需要自行确保这个文件不被提交。对于已经提交的文件,需要手动清理并轮换密钥。

10 分钟清理指南

如果你使用 Claude Code,可以按照以下步骤检查并清理:

  1. 检查本地文件:在项目根目录查看是否存在 settings.local.json,打开确认是否包含密钥或令牌。
  2. 检查 Git 历史:运行 git log --all -- settings.local.json 查看该文件是否曾被提交。如果存在,需要从历史中移除。
  3. 添加到 .gitignore:确保 settings.local.json 被列入 .gitignore,防止未来误提交。
  4. 轮换已泄露的密钥:如果文件曾经被推送到公开仓库,立即在相关服务平台撤销并重新生成密钥。
  5. 使用工具辅助:可以考虑使用 git-secrets 或 gitleaks 等工具在提交前扫描敏感信息。

整个清理过程大约需要 10 分钟,但前提是及时发现。对于已经公开的仓库,密钥可能已经被爬虫抓取,轮换是必须的。

从 Git 历史中移除文件 与普通删除不同:git rm 仅删除最新提交中的文件,历史提交中的内容仍可通过 git log 找回。要彻底清除,需要使用 git filter-repo(推荐)或 BFG Repo-Cleaner 重写历史,然后强制推送并通知协作者重新克隆。由于重写历史会影响所有分支和标签,操作前应备份仓库,并意识到已泄露到公开仓库的内容可能已被第三方抓取,因此清理历史必须与密钥轮换同步进行,不能仅依赖历史清除。

更大的图景:AI 工具的本地配置风险

这不是 AI 编程工具第一次因本地配置文件引发安全问题。随着越来越多的 AI 工具采用本地配置来存储偏好、缓存或凭证,类似的暴露风险正在增加。

开发者通常被教导不要将 .env 文件提交到仓库,但对 settings.local.json 这类新兴工具生成的配置文件缺乏警惕。工具厂商有责任在设计时考虑默认安全性,例如自动忽略敏感文件或在文档中明确警告。

对于开发者而言,定期审计仓库中的配置文件,尤其是那些由工具自动生成的文件,应该成为代码卫生的一部分。

git-secrets 与 gitleaks 是两类常用的提交前敏感信息扫描工具。git-secrets 通过 Git hooks 在 commit 或 push 阶段匹配预设正则(如 AWS 密钥格式),阻止包含敏感信息的提交;gitleaks 则支持扫描整个仓库历史,内置大量凭证模式,并可集成到 CI 流水线中作为门禁。两者互补:前者侧重本地提交拦截,后者侧重历史审计与持续检测。对于 AI 工具生成的配置文件,建议将已知的敏感文件名(如 settings.local.json)加入扫描规则,形成默认防护。

现在就该做的事

如果你使用 Claude Code,花几分钟检查一下你的仓库。搜索 settings.local.json,确认它没有被提交,并检查 Git 历史中是否曾经包含过它。如果发现泄露,立即轮换密钥。

安全无小事,尤其是当 AI 工具让开发变得更高效的同时,也带来了新的攻击面。

#Claude Code#settings.local.json#密钥泄露#Apiiro#Anthropic#代码安全#配置文件
分享:

相关推荐