雖然權限拒絕規則可以阻止 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/