代理程式
代理程式窗格決定哪些程式碼代理程式可在工作區中使用,以及每一個如何登入。Bromure Agentic Coding 隨附三個代理程式——Claude Code、Codex 與 Grok Build——並且可依工作區啟用其中任意子集。此窗格的副標題清楚說明其運作模式:啟用你想要在此工作區中使用的每個代理程式;標記為 Primary 的那一個會在第一個分頁中自動啟動,而其他已啟用的代理程式雖然已安裝並完成驗證,但你需要從新分頁中依需求執行它們。
你在此處輸入的任何憑證都絕不會傳到 VM。沙箱內的代理程式收到的是一把誘餌金鑰;主機代理伺服器會在傳輸過程中將誘餌換成真實值。該傳輸邊界——以及下方各驗證模式所依賴的訂閱註冊與權杖交換機制——正是憑證章節的主題。
啟用代理程式並選擇主要代理程式
每個代理程式都是一張卡片,右上角有一個啟用開關。將其開啟以顯示該代理程式的驗證選項;將其關閉則會收合卡片並將該代理程式從工作區中移除。
已啟用的代理程式中,一律會有一個是 Primary,以橘色星形標籤標示。當工作階段開啟時,主要代理程式會在第一個終端機分頁中自動啟動;其他已啟用的代理程式雖已安裝並完成驗證,但會等到你從新分頁啟動它們為止。若要改換另一個代理程式為主要,請先啟用它,然後在其卡片上按一下 Make primary——先前的主要代理程式會被降級,但仍保留自己的驗證。停用目前的主要代理程式時,會自動將另一個已啟用的代理程式升級為主要,而最後剩下的一個代理程式無法停用:工作區永遠至少有一個。
驗證模式
當代理程式啟用時,會有一組單選按鈕用來選擇它如何驗證。提供哪些模式取決於代理程式——Bedrock 為 Claude Code 專屬:
| 模式 | Claude Code | Codex | Grok Build |
|---|---|---|---|
| API 權杖 | 是 | 是 | 是 |
| 訂閱(互動式登入) | 是 | 是 | 是 |
| Bedrock(AWS) | 是 | — | — |
| 本機模型 | 是 | 是 | 是 |
API 權杖
將提供者的 API 金鑰貼入安全欄位——其預留位置文字會標明提供者:Anthropic API key、OpenAI API key 或 xAI 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_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 關閉。 |
| 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 | 僅限訂閱模式。執行或清除互動式登入註冊。預設:未註冊。 |