代理程式

代理程式窗格決定哪些程式碼代理程式可在工作區中使用，以及每一個如何登入。Bromure Agentic Coding 隨附五個代理程式——Claude Code、Codex、Grok Build、Kimi Code 與 Oh My Pi——並且可依工作區啟用其中任意子集。此窗格的副標題清楚說明其運作模式：啟用你想要在此工作區中使用的每個代理程式；標記為 Primary 的那一個會在第一個分頁中自動啟動，而其他已啟用的代理程式雖然已安裝並完成驗證，但你需要從新分頁中依需求執行它們。

你在此處輸入的任何憑證都絕不會傳到 VM。沙箱內的代理程式收到的是一把誘餌金鑰；主機代理伺服器會在傳輸過程中將誘餌換成真實值。該傳輸邊界——以及下方各驗證模式所依賴的訂閱註冊與權杖交換機制——正是憑證章節的主題。

編輯工作區視窗的代理程式窗格：Claude Code 卡片已啟用並標記為 Primary，顯示 API 權杖、訂閱、Bedrock 與本機模型驗證選項，Codex、Grok Build、Kimi Code 與 Oh My Pi 則收合在下方

啟用代理程式並選擇主要代理程式

每個代理程式都是一張卡片，右上角有一個啟用開關。將其開啟以顯示該代理程式的驗證選項；將其關閉則會收合卡片並將該代理程式從工作區中移除。

已啟用的代理程式中，一律會有一個是 Primary，以橘色星形標籤標示。當工作階段開啟時，主要代理程式會在第一個終端機分頁中自動啟動；其他已啟用的代理程式雖已安裝並完成驗證，但會等到你從新分頁啟動它們為止。若要改換另一個代理程式為主要，請先啟用它，然後在其卡片上按一下 Make primary——先前的主要代理程式會被降級，但仍保留自己的驗證。停用目前的主要代理程式時，會自動將另一個已啟用的代理程式升級為主要，而最後剩下的一個代理程式無法停用：工作區永遠至少有一個。

驗證模式

當代理程式啟用時，會有一組單選按鈕用來選擇它如何驗證。提供哪些模式取決於代理程式——Bedrock 為 Claude Code 專屬，而 Oh My Pi 僅支援 API 金鑰（其服務條款不允許重複使用 OAuth 訂閱）：

模式Claude CodeCodexGrok BuildKimi CodeOh My Pi
API 權杖是是是是是
訂閱（互動式登入）是是是是—
Bedrock（AWS）是————
本機模型是是是是是

API 權杖

將提供者的 API 金鑰貼入安全欄位——其預留位置文字會標明提供者：Anthropic API key、OpenAI API key、xAI API key、Moonshot API key，或在 Oh My Pi 的情況下，你所選提供者的金鑰（見下文）。金鑰會加密儲存在主機上；VM 只會看到一個誘餌，代理伺服器會在送往該提供者的請求上將其改寫為真實值。Require approval to use 核取方塊（預設關閉）將在下方的 Require approval to use 中說明。

新啟用的代理程式預設採用此模式。

訂閱（互動式登入）

以你付費的訂閱（Claude、ChatGPT/Codex、Grok 或 Kimi）而非 API 金鑰為代理程式登入。內嵌的 Register… 按鈕會執行一次性的互動式登入流程；完成後，該模式旁會出現綠色印記，並附有 Re-register… 與 Forget 控制項。真實的 OAuth 權杖會保留在主機上並於該處更新，而 VM 收到的則是假值——目前該交換是否啟用會顯示於追蹤窗格中，並可在該處重設。

這是 Claude Code 的出廠範本預設值。

Bedrock（AWS）——僅限 Claude Code

使用你在 Credentials → AWS 下設定的 AWS 憑證，將 Claude Code 透過 Amazon Bedrock 進行路由。Default Model ID 欄位會覆寫 Claude Code 所請求的 Bedrock 模型——例如 us.anthropic.claude-sonnet-4-6-v1:0；留空則使用 Claude Code 的內建預設值。Codex 或 Grok Build 不提供 Bedrock。

Oh My Pi 的提供者選擇器

Oh My Pi（omp）與提供者無關，因此它的卡片多了一個 Provider 選擇器：Anthropic (Claude)（預設值）、OpenAI、xAI (Grok)、z.ai (GLM) 或 Custom (OpenAI-compatible)。選擇一個提供者並貼上其 API 金鑰；選擇 Custom 會顯示一個基底 URL 欄位，可指向任何 OpenAI 相容端點（https://…/v1）。選填的 Model 欄位可固定 omp 啟動時所用的模型（像 opus 或 gpt-5.2 這類模糊名稱也可以）。切換提供者——或將工作區改為 本機模型——只需一次點按，並於下一個工作階段生效。

本機模型

完全針對由主機提供、且不涉及任何雲端提供者的裝置端模型執行代理程式。此選項會呈灰色——標示為 — download a model in Local Models——直到在本機模型窗格中至少安裝一個模型為止。一旦有可用的模型，代理程式便會透過其基底 URL 環境變數（ANTHROPIC_BASE_URL、OPENAI_BASE_URL 或 XAI_BASE_URL）指向本機引擎，並提供在本機模型中所選取的模型。此引擎、裝置端路由與混合式後援請參閱本機模型章節。

附註： 為工作區開啟 Enable local models 會自動將每個已啟用的代理程式釘選為本機模型，而再次將其關閉則會還原每個代理程式先前的模式。你通常會從本機模型窗格設定裝置端推論，而非逐一設定各個代理程式。

Require approval to use

在 API 權杖模式下，Require approval to use 核取方塊會加入一道同意關卡：在代理伺服器將誘餌金鑰換成真實金鑰之前，主機會彈出一個對話方塊，讓你可以允許此次使用一次、允許一小段時間，或允許在該工作階段的其餘期間內使用。此選項預設關閉。相同的逐憑證核准模式在整個憑證窗格中反覆出現。

設定參考

設定說明
Enable（每個代理程式）讓代理程式可在此工作區中使用。預設：Claude Code 開啟且為主要；Codex、Grok Build、Kimi Code 與 Oh My Pi 關閉。
Primary / Make primary標示會在第一個分頁中自動啟動的代理程式。預設：Claude Code。最後一個已啟用的代理程式無法關閉。
驗證模式單選：API 權杖 / 訂閱（互動式登入） / Bedrock（AWS）（僅限 Claude Code） / 本機模型（需要已安裝的本機模型）。預設：出廠範本中 Claude Code 為訂閱（互動式登入）；新啟用的代理程式預設為 API 權杖。
API 金鑰權杖模式下用於提供者金鑰的安全欄位（ANTHROPIC_API_KEY / OPENAI_API_KEY / XAI_API_KEY；Kimi 的金鑰會寫入其 config.toml，Oh My Pi 的則寫入所選提供者的變數）。以誘餌形式注入 VM；在傳輸過程中交換。預設：空白。
Require approval to use核取方塊（權杖模式）。在每次誘餌→真實金鑰交換前顯示同意對話方塊。預設：關閉。
Default Model ID僅限 Bedrock 模式。覆寫 Bedrock 模型 id，例如 us.anthropic.claude-sonnet-4-6-v1:0。預設：空白（代理程式的內建預設值）。
Register… / Re-register… / Forget僅限訂閱模式。執行或清除互動式登入註冊。預設：未註冊。
Provider / Base URL / Model僅限 Oh My Pi。上游提供者（預設為 Anthropic (Claude)）、選擇 Custom 時的 OpenAI 相容基底 URL，以及選填的模型覆寫值。

提示： 每個代理程式都會從 VM 內部自行保持最新——在終端機分頁中執行它自己的更新命令（claude update、codex update 等）。更新會依需求取得，並在同一工作區的各次工作階段之間保留。

相關章節

  • 憑證——金鑰、訂閱權杖與 AWS 憑證如何保存在主機上，並在傳輸過程中由假值換成真實值。
  • 本機模型——支撐本機模型驗證模式的裝置端引擎。
  • Fusion——多模型窗格從你在此處設定的代理程式擷取其各條分支。
  • 追蹤——用於訂閱模式的訂閱權杖交換狀態列。