將 Claude Code 與 Agent Redactor 搭配使用
-
設定 Agent Redactor(請先執行此步驟)
在設定 Claude Code 之前,請先啟動本機遮蔽代理,以便 Claude Code 透過它進行連線。在 Profiles 側邊欄中選取或建立一個設定檔。將 Local URL 設定為
http://localhost:8080/(或您偏好的連接埠),將 Forward To 設定為您的真實供應商端點(例如https://openrouter.ai/api/),並貼上您的真實 API Key。金鑰在本機加密,絕不會離開您的電腦。按一下 Save All Settings,並確認連接埠顯示為可用。 -
選擇您的遮蔽規則
在資料離開您的電腦之前,決定要遮蔽哪些內容。您可以啟用 AI Powered Detection Model 並勾選需要偵測的 PII 類別,新增 Regex Patterns 和 Keywords 進行確定性符合,或使用三者的任意組合。選擇權在您。Regex 和 Keywords 也適用於 AI 模型可能遺漏的特定專案機密。
-
將 Claude Code 指向 Agent Redactor(永久)
Claude Code 從其設定檔讀取環境變數。在 Windows 上開啟位於
C:\Users\<you>\.claude\settings.json(其他系統為~/.claude/settings.json)的使用者設定檔,並新增以下env區塊,同時保留您現有的設定:{ "env": { "ANTHROPIC_BASE_URL": "http://localhost:8080/", "ANTHROPIC_AUTH_TOKEN": "dummy-key-to-bypass-login", "ANTHROPIC_MODEL": "anthropic/claude-haiku-4.5", "ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-haiku-4.5", "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-haiku-4.5", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-4.5", "ANTHROPIC_DEFAULT_FABLE_MODEL": "anthropic/claude-haiku-4.5", "CLAUDE_CODE_SUBAGENT_MODEL": "anthropic/claude-haiku-4.5", "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1048576", "CLAUDE_CODE_EFFORT_LEVEL": "max" } }- ANTHROPIC_BASE_URL: 必須與 Agent Redactor 中的 Local URL 完全一致。
- ANTHROPIC_AUTH_TOKEN: 任何預留位置值都有效。Agent Redactor 已安全保管您的真實 API 金鑰,並在上游注入。
- ANTHROPIC_MODEL 和模型覆寫:將
anthropic/claude-haiku-4.5替換為您供應商的確切模型名稱。全部設定可確保 Claude Code、其子代理和背景工作都使用同一模型。
檔案中的其他項目(如
theme或autoUpdatesChannel)與此無關,請保持原樣。 -
替代方案:臨時工作階段變數
如果您不想修改設定檔(例如只想測試一次代理),請在終端機中設定這些變數。它們僅在目前終端機工作階段期間有效。
PowerShell (Windows):
$env:ANTHROPIC_BASE_URL = "http://localhost:8080/"
$env:ANTHROPIC_AUTH_TOKEN = "dummy-key-to-bypass-login"
$env:ANTHROPIC_MODEL = "anthropic/claude-haiku-4.5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "anthropic/claude-haiku-4.5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "anthropic/claude-haiku-4.5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "anthropic/claude-haiku-4.5"
$env:ANTHROPIC_DEFAULT_FABLE_MODEL = "anthropic/claude-haiku-4.5"
$env:CLAUDE_CODE_SUBAGENT_MODEL = "anthropic/claude-haiku-4.5"
$env:CLAUDE_CODE_AUTO_COMPACT_WINDOW = "1048576"
$env:CLAUDE_CODE_EFFORT_LEVEL = "max"
bash (Linux):
export ANTHROPIC_BASE_URL="http://localhost:8080/"
export ANTHROPIC_AUTH_TOKEN="dummy-key-to-bypass-login"
export ANTHROPIC_MODEL="anthropic/claude-haiku-4.5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-haiku-4.5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-haiku-4.5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-4.5"
export ANTHROPIC_DEFAULT_FABLE_MODEL="anthropic/claude-haiku-4.5"
export CLAUDE_CODE_SUBAGENT_MODEL="anthropic/claude-haiku-4.5"
export CLAUDE_CODE_AUTO_COMPACT_WINDOW="1048576"
export CLAUDE_CODE_EFFORT_LEVEL="max"
關閉終端機後,變數即消失,Claude Code 將恢復其正常設定。
-
啟動 Claude Code 並安全地工作
開啟一個新終端機(以載入新設定)並啟動 Claude Code:
claude
歡迎畫面應顯示您選擇的模型正透過 API 使用計費執行。現在,所有外送要求在接觸網際網路之前,都會先透過 Agent Redactor 在本機過濾。在下方範例中,模型可以看到姓名在提示詞到達之前已被遮蔽。
Claude Code 正透過代理執行。模型收到的是遮蔽後的預留位置,而不是真實姓名。
驗證遮蔽
查看 Agent Redactor 中的 Session Redactions 面板,精確了解攔截了哪些內容。