將 Claude Code 與 Agent Redactor 搭配使用

先決條件: 安裝 Agent Redactor 並保持其運作. 還需要安裝 Claude Code,並使其在 PATH 中可用。
  1. 設定 Agent Redactor(請先執行此步驟)

    在設定 Claude Code 之前,請先啟動本機遮蔽代理,以便 Claude Code 透過它進行連線。在 Profiles 側邊欄中選取或建立一個設定檔。將 Local URL 設定為 http://localhost:8080/(或您偏好的連接埠),將 Forward To 設定為您的真實供應商端點(例如 https://openrouter.ai/api/),並貼上您的真實 API Key。金鑰在本機加密,絕不會離開您的電腦。按一下 Save All Settings,並確認連接埠顯示為可用。

  2. 選擇您的遮蔽規則

    在資料離開您的電腦之前,決定要遮蔽哪些內容。您可以啟用 AI Powered Detection Model 並勾選需要偵測的 PII 類別,新增 Regex Patterns 和 Keywords 進行確定性符合,或使用三者的任意組合。選擇權在您。Regex 和 Keywords 也適用於 AI 模型可能遺漏的特定專案機密。

  3. 將 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)與此無關,請保持原樣。

  4. 替代方案:臨時工作階段變數

    如果您不想修改設定檔(例如只想測試一次代理),請在終端機中設定這些變數。它們僅在目前終端機工作階段期間有效。

    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 將恢復其正常設定。

  5. 啟動 Claude Code 並安全地工作

    開啟一個新終端機(以載入新設定)並啟動 Claude Code:

    claude

    歡迎畫面應顯示您選擇的模型正透過 API 使用計費執行。現在,所有外送要求在接觸網際網路之前,都會先透過 Agent Redactor 在本機過濾。在下方範例中,模型可以看到姓名在提示詞到達之前已被遮蔽。

    Claude Code 工作階段,模型回覆稱使用者的姓名已在系統訊息中被遮蔽,無法讀取
    Claude Code 正透過代理執行。模型收到的是遮蔽後的預留位置,而不是真實姓名。

驗證遮蔽

查看 Agent Redactor 中的 Session Redactions 面板,精確了解攔截了哪些內容。

Agent Redactor 顯示 Statistics 面板:Requests: 1、PII: 2,Session Redactions 列出攔截的 PII,包括 private_person Bob
Statistics 面板顯示 "Requests: 1, PII: 2",Session Redactions 列出被攔截的值及其時間戳記和類型。
提示:在您的設定檔中使用 Regex Patterns 和 Keywords,以攜獲 AI 模型可能遺漏的特定專案機密,例如內部主機名稱、專屬 ID 或專案代號。