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

Claude Code或泄露密码:14000份GitHub文件中的密钥风险

Claude Code或泄露密码:14000份GitHub文件中的密钥风险

Claude Code 明文存储含密码命令,超千份密钥泄露至公开 GitHub。

安全公司 Aipro 扫描公开 GitHub 发现,Claude Code 会将用户批准过的含密码命令明文存入本地 `Claude Settings Local JSON` 文件,而自带的全局 gitignore 保护在文件被 Git 跟踪后失效。扫描的 14000 多份相关文件中,1122 份包含真实密钥,总计 1379 个,其中 379 个是数据库密码;一半受影响仓库的默认分支上文件存在至少 217 天。该问题在 2025 年 8 月被报告但遭自动关闭,至 11 月 10 日的 2.1.322 版本仍无修复。文章建议立即轮换已公开密码、用 `git filter-repo` 清理历史,并避免将密码直接写入命令。

一个被忽略的本地文件,正在公开你的密码

当你在 Claude Code 里批准一条包含数据库密码的命令时,工具会把它记下来——完整命令,明文密码,存进项目目录下的 Claude Settings Local JSON 文件。这个设计初衷只是“记住你批准过的命令”,不是模型主动决定保存密钥。但安全公司 Aipro 在 11 月 1 日到 3 日扫描公开 GitHub 默认分支时发现:14000 多份相关文件中,1122 份包含真实密钥,总计 1379 个密钥,其中数据库密码就有 379 个。

工具自己的存储方式

问题的核心不在于 Claude Code 是否“故意”存储密码,而在于它的保护机制存在盲区。自带的保护只是把这个文件加入你电脑的全局 gitignore,却不会进入仓库级别的忽略名单。一旦文件被 Git 跟踪,全局忽略就失效了——密码随代码一起推上公开仓库。

扫描数据揭示了什么

Aipro 的扫描结果给出了几个值得警惕的数字。在受影响的仓库中,一半的默认分支上这个文件至少存在了 217 天。这意味着密钥暴露不是几小时的疏忽,而是长达数月的持续暴露。很多开发者可能根本不知道这个文件的存在,更不会想到它会被提交。

Apiro 的扫描范围

379 个数据库密码的规模说明,受影响的不只是个人实验项目。数据库凭据一旦泄露,攻击者可以直接连接生产环境,绕过应用层的所有防护。而 1122 份含真实密钥的文件背后,是 1122 个可能被利用的入口。

为什么保护机制没有生效

Claude Code 的全局 gitignore 设计假设了一个前提:开发者不会把本地配置文件提交到仓库。但现实是,很多人用 git add . 一把梭,或者项目本身没有完善的 .gitignore 规则。文件一旦进入版本历史,全局忽略就形同虚设。

文件在默认分支上存在至少 217 天

更关键的是,扫描工具本身也会漏掉命令中嵌入的密码。这意味着即使你用工具做自查,也不一定能发现所有泄露点。密码写在命令参数里,而不是独立的配置文件字段中,检测难度更高。

全局 gitignore 与仓库级 .gitignore 的区别

全局 gitignore 是 Git 的一项本地配置,通常位于 ~/.config/git/ignore 或通过 core.excludesFile 指定,它只对当前用户生效,且仅影响未被跟踪的文件。仓库级 .gitignore 则位于项目根目录,随仓库分发,对所有协作者生效。关键差异在于:全局忽略不会写入仓库,也不会阻止已跟踪文件的变更被提交。一旦某个文件被 git add 加入索引,Git 就会持续跟踪它,此时无论全局还是仓库级的忽略规则都不再起作用——忽略规则只对“未跟踪”文件有效。因此,Claude Code 将敏感文件加入全局 gitignore 的做法,只能防止误 git add 之前的意外纳入,却无法在文件已被跟踪后提供任何保护。真正的防护需要仓库级 .gitignore 配合预提交钩子(pre-commit hook)或秘密扫描工具,在提交阶段拦截敏感信息。

问题被报告过,但被自动流程关闭

2025 年 8 月,有人在 GitHub 上报告过这个问题,但后来被自动流程关闭。Claude Code 负责人在 11 月 7 日表示正在研究防护方案。到 11 月 10 日的 2.1.322 版本,更新日志中还没有对应的修复条目。

GitHub 上的报告被自动关闭

这个时间线暴露了一个常见问题:安全报告的流转机制可能把真实漏洞当成普通 issue 处理掉。从 8 月到 11 月,三个月的窗口期内,那些已经提交到公开仓库的文件仍然处于暴露状态。

现在应该做什么

如果你用过 Claude Code 并且批准过含密码的命令,按以下顺序处理:

先轮换已公开的密码。 这是最紧急的一步。数据库密码、API key、任何出现在命令里的凭据,都应该立即更换。不要先清理文件再轮换——清理需要时间,而密码暴露的每一分钟都是风险。

再清理 Git 历史中的文件。 从当前分支删除文件还不够,如果它已经进入提交历史,需要用 git filter-repo 等工具重写历史,或者联系平台方协助清除。

以后别把密码直接写进命令。 用环境变量、密钥管理服务或者 .env 文件(确保在 .gitignore 里)来传递凭据。命令里出现明文密码,就可能被任何记录命令的工具捕获。

对于团队来说,这件事的教训不只是关于 Claude Code。任何会记录命令历史的开发工具,都可能成为凭据泄露的通道。审查工具的本地存储行为,应该成为引入新工具时的常规动作。

git filter-repo 的作用与使用前提

git filter-repo 是 Git 官方推荐的历史重写工具,用于从提交历史中彻底删除文件或敏感内容。它比已废弃的 git filter-branch 更快、更安全,但操作具有破坏性:会重写所有相关提交的哈希值,导致协作者需要重新克隆或强制重置。使用前必须备份仓库,并通知所有协作者。基本命令为 git filter-repo --path <文件路径> --invert-paths,执行后需强制推送(git push --force)到远程。需要注意的是,即使本地历史被清理,远程平台(如 GitHub)可能仍保留缓存或通过 fork 传播,因此必须联系平台方彻底清除,并优先轮换已暴露的凭据——历史清理不能替代密码轮换,因为密钥可能已被第三方抓取。

#Claude Code#密码泄露#GitHub密钥#数据库密码#AI编程工具安全#Git忽略规则#密钥轮换
分享:

相关推荐