跳到主要內容
maxstudioNews
AI 自動化DEV Community (Claude Code)約 2 分鐘

阻止 Claude Code 覆寫敏感檔案:使用 PreToolUse 寫入防護

為避免 Claude Code 不小心覆寫包含機密資訊的檔案,本文介紹如何設定一個 PreToolUse 寫入防護。透過一個簡單的 shell 腳本和設定檔,可以阻止 AI 代理寫入 .env 或金鑰等敏感路徑。這項措施能有效提升開發環境的安全性,防止潛在的資料洩漏。

阻止 Claude Code 覆寫敏感檔案:使用 PreToolUse 寫入防護
圖片來源:DEV Community (Claude Code)

雖然權限拒絕規則可以阻止 Claude Code 讀取 .env 和金鑰檔案,但仍存在一個漏洞:寫入或編輯指令可能會建立或覆寫這些路徑。一個小型的 PreToolUse 鉤子(hook)可以彌補這個漏洞。

這個鉤子腳本的內容如下,請將其儲存為 .claude/hooks/block-secret-writes.sh 並賦予執行權限(chmod +x)。它會從標準輸入讀取工具呼叫的 JSON,並解析出檔案路徑。接著,腳本會檢查該路徑是否包含敏感關鍵字,例如 .env、.pem、.key、private.key、id_rsa、wallet 或 credentials 等。

如果路徑符合這些模式,腳本會輸出錯誤訊息到標準錯誤輸出,並以結束碼 2 退出,從而阻止寫入操作並告知 Claude Code 不應寫入敏感資料。

接著,您需要在 .claude/settings.json 中註冊這個鉤子,確保它只在檔案的寫入或編輯操作(Write|Edit)時執行。這項設定會指定當發生這些操作時,呼叫之前建立的 block-secret-writes.sh 腳本,以啟用寫入防護功能。

當 Claude Code 嘗試儲存一個符合上述模式的路徑時,這個鉤子腳本會以結束碼 2 退出。如此一來,寫入操作將永遠不會發生,並且標準錯誤輸出的訊息會回傳給 Claude Code。這讓 Claude Code 能夠解釋為何操作被阻止,而不是重複嘗試。

建議將此寫入防護與針對 .env、~/.ssh/ 和 ~/.aws/ 的讀取拒絕規則搭配使用,讀取拒絕規則阻止讀取,而這個鉤子則阻止寫入。請保持模式列表的精確性,如果專案確實將 .key 副檔名用於非敏感檔案,應新增允許例外,而非刪除整個鉤子。

將這個鉤子提交到版本控制中,確保所有團隊成員都能獲得相同的安全防護。最後,請使用無害的測試檔案(例如 example.env)進行測試,而非真實的機密資料。

想要了解完整的設定嗎?我將可直接複製使用的 Claude Code 配置(包含 CLAUDE.md 範本、斜線指令、鉤子和權限規則)儲存在 Vildanden Agent Config 中。這裡提供一個免費範例:https://justly-mia-429.rehost.page/

Share

覺得值得一看?分享給朋友。

以上為 AI 自動翻譯導讀。原文版權歸 DEV Community (Claude Code) 所有, 建議透過「閱讀原文」前往原始網站,以取得最完整資訊並支持原作者。

Newsletter

不用每天追,AI 重點每週寄給你

43 個來源、每 2 小時更新,太多看不完。電子報每週挑最值得看的幾則,附上 Max 的看法。

每週一封。Email 只用來寄電子報,每封信都能一鍵退訂。