我用鑰匙圈傳入密碼,隔開模型讀取與程式使用
經驗 L2 849 字 2 分鐘 v2.0.0 更新 2026-11-16
我把密碼存進 macOS 鑰匙圈,這是系統儲存密碼的地方。Claude Code 需要密碼時,我只提供名稱,不把密碼值貼進對話。
這個做法使用我自製的 secret-mod,負責密碼表單與輸出遮罩。表單把密碼存入鑰匙圈,遮罩則隱藏指令輸出中的密碼值。
先填表單,再用名稱指定
context 是一次請求送給模型的全部內容。模型讀過的內容會留在 context,也會寫入電腦上的對話紀錄;進入 context 的密碼無法收回,所以我讓密碼值只在工具與指令之間傳遞,不經過模型。
留下的位置
- 目前對話的紀錄
- 派工時若傳入密碼,也會進入子 agent 的紀錄
密碼在執行時才進入指令
從需要新密碼到執行指令,順序是:Claude Code 開啟表單,我填入密碼並存進鑰匙圈。Claude Code 接著用名稱指定密碼,把指令交給表單工具執行。工具透過環境變數帶入密碼,也就是讓執行中的指令用變數名稱取用值;輸出若含密碼值,工具會先遮住,再交回結果。
指令文字只寫變數名稱,因此對話紀錄不需要包含實際密碼。這個流程讓密碼不經過模型,但執行指令的程式仍可接觸密碼。
下面的圖把名稱、密碼值與遮罩後的輸出分成不同路徑,標出模型、工具、鑰匙圈與指令之間各自傳遞什麼。
模型只送出密碼的名稱與要執行的指令。
遮罩有邊界,已貼出的密碼要更換
遮罩只能比對工具自己帶入的已知密碼值。指令若把密碼編碼後輸出,遮罩就比對不到;所以交代執行工作時,也要要求不要印出密碼。
表單也不會禁止 Claude Code 透過指令讀取鑰匙圈。若要禁止讀取 .env 這類檔案,可以另用 deny 規則。這是 Claude Code 內建的權限規則,可禁止讀取指定檔案,與自製的表單、遮罩功能不同。
已經貼進對話的密碼需要更換;更換後,舊密碼仍留在紀錄裡。鑰匙圈的備份見 備份。
先判斷要隔開哪一種接觸
如果你也使用 macOS,而且目標是避免密碼留在對話紀錄,這個做法適合參考。
如果你的要求是連執行中的程式都不能讀到密碼,這套做法就不符合需求。
來源
- Security Claude Code docs
- The Twelve-Factor App: Config 12factor.net
- Best practices Claude Code docs