2026 年 11 月 9 日,AI 安全公司 Apiiro 公開了一項調查結果:Claude Code 的設定檔正在公開的 GitHub 倉庫中大量外洩,內容包含資料庫密碼、API 令牌與 root 登入資訊等敏感資料。根據少數派派早報的整理,這類被上傳到公開倉庫的設定檔超過 10 萬個,其中約 1,100 個、來自 63 個組織的檔案確實含有金鑰——而這些金鑰中有 215 個,是 gitleaks 和 TruffleHog 這兩款常用掃描工具沒有抓出來的。

如果你或你的團隊正在用 Claude Code、Codex 這類 AI coding 工具,這件事和你直接相關:問題出在工具的「記住我的選擇」機制:它會把敏感命令原封不動寫進設定檔,設定檔又很可能就在你的某個倉庫裡。這篇整理事件經過、成因,以及一份可以今天下班前做完的檢查清單。

快速結論

今晚就做三件事:檢查 .gitignore、清 settings.local.json 裡的授權規則、掃一次所有倉庫含 fork

個人開發者

風險等級取決於你有沒有按過「Yes, and don't ask again」。按過的話,你的設定檔裡很可能存著含敏感資訊的原始命令,請立刻檢查並清理。

團隊管理者

在 CI 加金鑰掃描只是基本盤——本次事件有 215 個金鑰是常用工具沒抓到的,還要配合倉庫層 .gitignore 規範與定期 fork 稽核。

已確認外洩

刪檔案不夠,fork 會保留副本。正確順序是:撤銷並輪換金鑰 → 清除 git 歷史 → 檢查所有 fork → 通報受影響服務。

事件經過

根據 Ars Technica 與少數派的報導,Apiiro 在 11 月 9 日揭露的攻擊面其實很單純:Claude Code 在使用者審批 shell 命令時,如果選擇「Yes, and don't ask again」,這條授權會作為規則寫入本機的 .claude/settings.local.json。規則有時以模式記錄,但很多情況下會原樣寫入命令本身——包括命令裡嵌入的資料庫密碼、API 令牌等敏感資訊。

問題是這個檔案會不會進 Git。Anthropic 的文件說它會被加入開發者的全域 .gitignore,但這個保護不會體現在倉庫層面:倉庫被複製到其他機器、或資料夾是後來才變成 Git 倉庫時,這個檔案就可能被誤傳。Apiiro 還指出,Claude Code 在很多情況下會在使用者不介入時自行提交對該檔案的修改,讓風險更難靠人工把關。

幾個值得記住的數字:超過 10 萬個這類設定檔出現在公開 GitHub 倉庫;約 1,100 個檔案(來自 63 個組織)含有金鑰;215 個金鑰躲過了 gitleaks 與 TruffleHog 的掃描;檔案刪除後,金鑰仍可能留在原專案的分叉中。這個問題最早在 2025 年 8 月就有人在 Claude Code 的錯誤回報中提出,但相關回報都在 60 天無活動後被關閉。

Claude Code 團隊的 Boris Cherny 在 Hacker News 上回應,團隊正在研究如何防止這個問題,並指出這類設定檔基本上不應提交到 Git 倉庫,相關情況似乎只出現在「檔案被手動建立並提交」的場景。他建議使用者採用 auto 模式與金鑰掃描工具,也透露團隊正在考慮在未來版本內建金鑰掃描。

為什麼 .gitignore 擋不住

很多人看到新聞的第一反應是:「我的 .gitignore 有擋啊?」這正是本次事件最容易誤判的地方。Anthropic 加入的是開發者本機的全域 .gitignore,它有幾個結構性漏洞:

  • 不影響既有倉庫:已經初始化、已有自己 .gitignore 的專案不會自動繼承這條規則。
  • 跨機器複製會失效:倉庫被 clone 到另一台沒設全域 .gitignore 的機器(例如 CI、同事的電腦、新裝的開發機),保護就消失。
  • 事後變倉庫的資料夾:先在資料夾裡用 Claude Code、之後才 git init 或上傳的情況,檔案會跟著進版控。
  • 追蹤後的 .gitignore 無效:一旦檔案已經被 commit 過,之後才補 .gitignore 並不會把它移出版控。
  • 工具自動提交:Apiiro 觀察到 Claude Code 會在使用者不介入時提交對該檔案的修改,人工把關的窗口很小。
重點:.gitignore 只能預防新建檔案進版控;已經進版控的檔案,唯一的解法是清歷史+輪換金鑰。

個人開發者檢查清單

照順序做,約 20 分鐘可以完成個人部分:

  1. 找出所有 .claude 目錄:在常用專案根目錄執行檢查,確認 .claude/settings.local.json 是否存在、內容有哪些授權規則。特別注意含資料庫連線字串、token、密碼的命令。
  2. 檢查每個倉庫的 .gitignore:確認專案層級的 .gitignore 有 .claude/settings.local.json(建議連 .claude/settings.json 裡的本機段落一起檢視),別只依賴全域設定。
  3. 檢查遠端倉庫實際狀態:本機的 .gitignore 不代表遠端乾淨。直接上 GitHub 確認目標檔案不存在於任何 branch 與歷史。
  4. 清理「don't ask again」規則:把不再需要的寬鬆授權規則刪掉,尤其是寫死整條命令的那種。權限寧可每次確認,也不要讓敏感命令常駐設定檔。
  5. 掃描 git 歷史:用 gitleaks 或 TruffleHog 對所有倉庫(含舊專案)掃一遍——但記住本次事件的教訓:掃不到不代表沒有,215 個金鑰就是這樣漏掉的,敏感段落仍要人工檢視。
  6. 檢查 fork 與 mirror:曾經公開過的倉庫,即時刪檔也擋不住既有 fork。確認金鑰是否輪換過才是治本。

團隊導入建議

  • 把設定檔擋在 CI:在 CI 加入檢查,只要 PR 出現 .claude/settings.local.json 就擋下,不等 gitignore。
  • 統一金鑰掃描策略:pre-commit hook 加 gitleaks/TruffleHog,但同時公告「掃描工具非萬能」,要求開發者不要把真實金鑰寫進任何會被工具讀取的命令。
  • 建立輪換 SOP:確認外洩後的金鑰撤銷流程,以及負責通報雲端服務商(資料庫、API 提供者)的窗口,演練一次比寫十份文件有用。帳號層的防護可以搭配本站的密碼管理器與 2FA 指南。
  • 重新評估權限模式:Boris Cherny 建議的 auto 模式搭配審計,比累積大量「don't ask again」規則更可控。團隊內部可以約定哪些命令類型永遠不許設成永久放行。
  • AI 工具使用的整體盤點:如果團隊同時使用多種 AI 開發工具,背景常駐行程與權限邊界也值得一併盤點,可參考本站的AI 程式工具背景常駐 daemon 盤點與Codex / Claude Code 一週工作流實錄。

懷疑已洩漏怎麼辦

如果檢查後發現設定檔真的進過公開倉庫,順序很重要,請嚴格照以下順序處理:

  1. 先撤銷並輪換金鑰:資料庫密碼、API token、SSH 金鑰全部換掉。這一步先做,因為刪檔案阻止不了已經被複製的副本。
  2. 再清 git 歷史:用 BFG Repo-Cleaner 或 git filter-repo 把檔案從所有歷史中移除,並 force push。注意這會影響協作者,需要先協調。
  3. 處理 fork 與快取:聯繫 GitHub 支援清除快取檢視;對已存在的 fork,除了金鑰作廢沒有完全可靠的移除方式,這就是為什麼第一步是輪換。
  4. 檢查使用紀錄:查詢相關服務的存取紀錄,確認金鑰在被發現前有沒有異常呼叫。
  5. 對內通報:若屬於公司資產,依資安流程通報,不要只修自己的 repo。

常見問題

.claude/settings.local.json 是什麼?

Claude Code 用來記住使用者授權決定的本機設定檔,例如哪些 shell 命令可以永久放行。問題在於「永久放行」的規則常常原樣記錄整條命令,命令裡若有密碼或 token,就會跟著進檔案。

我設了 .gitignore,為什麼還是有風險?

Anthropic 加的是全域 .gitignore,不保證每個倉庫、每台機器都生效。倉庫被 clone 到沒有該設定的環境、或資料夾後來才變成 Git 倉庫時,檔案仍可能被提交。確認方式很簡單:直接看你的 GitHub 遠端頁面上有沒有這個檔案。

檔案刪掉了還需要換金鑰嗎?

需要。Apiiro 明確指出檔案刪除後,金鑰仍可能留在 fork 與歷史裡。只要檔案曾經公開過,金鑰就應視為已外洩,輪換是唯一可靠的止血方式。

用 gitleaks / TruffleHog 掃過沒問題,就安全了嗎?

不能這樣假設。本次事件中,外洩金鑰有 215 個是這兩款工具沒識別的。掃描工具是必要的第一層,但敏感命令仍要人工檢視,權限規則也要定期清理。

Claude Code 官方有解法嗎?

Boris Cherny 表示團隊正在研究防範機制,並考慮未來內建金鑰掃描;他目前的建議是使用 auto 模式、搭配金鑰掃描工具,並避免把這類設定檔提交進任何 Git 倉庫。在官方機制到位前,本文的檢查清單就是你能做的防護。

結論

這次事件的本質更接近一筆資安債:AI 工具的便利機制(記住授權)與開發者既有習慣(設定檔亂放、依賴全域 .gitignore)疊加出來的結果。工具本身正在改進,但金鑰一旦公開就無法收回。今晚花 20 分鐘跑完檢查清單、把該輪換的金鑰換掉,是比等待官方修補更實際的做法。資料來源:少數派派早報、Ars Technica 原始報導。