代理程式

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

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

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

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

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

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

驗證模式

當代理程式啟用時,會有一組單選按鈕用來選擇它如何驗證。提供哪些模式取決於代理程式——Bedrock 為 Claude Code 專屬:

模式Claude CodeCodexGrok Build
API 權杖
訂閱(互動式登入)
Bedrock(AWS)
本機模型

API 權杖

將提供者的 API 金鑰貼入安全欄位——其預留位置文字會標明提供者:Anthropic API keyOpenAI API keyxAI API key。金鑰會加密儲存在主機上;VM 只會看到一個誘餌,代理伺服器會在送往該提供者的請求上將其改寫為真實值。Require approval to use 核取方塊(預設關閉)將在下方的 Require approval to use 中說明。

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

訂閱(互動式登入)

以你付費的訂閱(Claude、ChatGPT/Codex 或 Grok)而非 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。

本機模型

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

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

Require approval to use

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

設定參考

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

相關章節

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