---
site: "zyx.tw"
title: "我用鑰匙圈傳入密碼，隔開模型讀取與程式使用"
description: "密碼只在執行時帶入，但程式仍能接觸密碼值。"
url: "https://www.zyx.tw/map/beyond/what-an-agent-has-seen"
---

# 我用鑰匙圈傳入密碼，隔開模型讀取與程式使用

紀錄 031，經驗 L2，849 字，2 分鐘，v2.0.0，更新 2026-11-16

我把密碼存進 macOS 鑰匙圈，這是系統儲存密碼的地方。Claude Code 需要密碼時，我只提供名稱，不把密碼值貼進對話。

這個做法使用我自製的 secret-mod，負責密碼表單與輸出遮罩。表單把密碼存入鑰匙圈，遮罩則隱藏指令輸出中的密碼值。

## 先填表單，再用名稱指定

context 是一次請求送給模型的全部內容。模型讀過的內容會留在 context，也會寫入電腦上的對話紀錄；進入 context 的密碼無法收回，所以我讓密碼值只在工具與指令之間傳遞，不經過模型。

需要新密碼時，我讓 Claude Code 開啟表單，再填入密碼。可以這樣交代：「開啟密碼表單，金鑰存入鑰匙圈，對話只留下名稱。」

下面比較貼進對話與填入表單兩種方式，呈現密碼留下的位置，以及存入鑰匙圈後如何使用。圖中的 子 agent 是 Claude Code 另外派出去做事的 agent；Mod 則是修改 Claude Code 介面的擴充。

**選擇密碼的傳入方式。 貼進對話**

留下的位置:
- 目前對話的紀錄
- 派工時若傳入密碼，也會進入子 agent 的紀錄

對話紀錄是電腦上的檔案。貼入的密碼會留在紀錄裡。

**選擇密碼的傳入方式。 填入表單**

留下的位置:
- 鑰匙圈
- 對話只留下名稱

使用方式:
- Claude Code 用名稱指定密碼
- 指令輸出中的密碼值會被遮住

例如，secret-mod 是保管密碼的 Mod。表單把值直接存進鑰匙圈。值不經過對話。

## 密碼在執行時才進入指令

從需要新密碼到執行指令，順序是：Claude Code 開啟表單，我填入密碼並存進鑰匙圈。Claude Code 接著用名稱指定密碼，把指令交給表單工具執行。工具透過環境變數帶入密碼，也就是讓執行中的指令用變數名稱取用值；輸出若含密碼值，工具會先遮住，再交回結果。

指令文字只寫變數名稱，因此對話紀錄不需要包含實際密碼。這個流程讓密碼不經過模型，但執行指令的程式仍可接觸密碼。

下面的圖把名稱、密碼值與遮罩後的輸出分成不同路徑，標出模型、工具、鑰匙圈與指令之間各自傳遞什麼。

```text
╭─────────╮  name only   ╭─────────────╮  lookup   ╭──────────╮
│  MODEL  │ ───────────> │ SECRET TOOL │ ────────> │ KEYCHAIN │
│ context │ <─────────── │             │ <──────── │          │
╰─────────╯  masked text ╰──────┬──────╯   value   ╰──────────╯
                                │ env var
                         ╭──────┴──────╮
                         │   COMMAND   │
                         ╰─────────────╯
```

Figure: The model sends only the name of a secret to a tool. The tool looks the value up in the keychain, passes it to the command as an environment variable, and returns the output to the model with the value masked.

1. Name: 模型只送出密碼的名稱與要執行的指令。
2. Lookup: 工具用名稱向鑰匙圈取出密碼值。
3. Run: 密碼值放進指令的環境變數。指令的文字裡沒有密碼。
4. Mask: 指令的輸出先遮住密碼值，才回到模型。

## 遮罩有邊界，已貼出的密碼要更換

遮罩只能比對工具自己帶入的已知密碼值。指令若把密碼編碼後輸出，遮罩就比對不到；所以交代執行工作時，也要要求不要印出密碼。

表單也不會禁止 Claude Code 透過指令讀取鑰匙圈。若要禁止讀取 .env 這類檔案，可以另用 deny 規則。這是 Claude Code 內建的權限規則，可禁止讀取指定檔案，與自製的表單、遮罩功能不同。

已經貼進對話的密碼需要更換；更換後，舊密碼仍留在紀錄裡。鑰匙圈的備份見 備份。

## 先判斷要隔開哪一種接觸

如果你也使用 macOS，而且目標是避免密碼留在對話紀錄，這個做法適合參考。

如果你的要求是連執行中的程式都不能讀到密碼，這套做法就不符合需求。

## 來源

- [Security](https://code.claude.com/docs/en/security), Claude Code docs
- [The Twelve-Factor App: Config](https://12factor.net/config), 12factor.net
- [Best practices](https://code.claude.com/docs/en/best-practices), Claude Code docs

## 地圖

- 相關：[工具讀回的內容可能被當成指令，防護要限制讀取與傳送的組合](https://www.zyx.tw/map/harness/untrusted-input.md)
- 相關：[權限規則先拒絕、再詢問、最後放行，沒有命中才交給模式](https://www.zyx.tw/map/harness/permission-gates.md)
- 相關：[我把記憶留在筆電，讓 Git 自動保存備份](https://www.zyx.tw/map/beyond/backup-memory-and-keys.md)
- 回到：[延伸](https://www.zyx.tw/map.md)
