代理
代理窗格决定工作区中可使用哪些编码代理，以及每个代理如何登录。Bromure Agentic Coding 内置三个代理——Claude Code、Codex 和 Grok Build——可按工作区启用其中任意子集。窗格的副标题直白地说明了这一模型：启用你希望在此工作区中使用的每个代理；标记为主代理的那个会在第一个标签页中自动启动，其他已启用的代理会被安装和验证，但需要你在新标签页中按需运行。
你在此处输入的任何凭据都不会传入 VM。沙箱内的代理拿到的是诱饵密钥；宿主机代理服务器会在传输过程中将诱饵替换为真实值。该传输边界——以及下述各身份验证模式所依赖的订阅注册与令牌交换机制——是凭据一章的主题。
启用代理并选择主代理
每个代理都是一张卡片，右上角有一个启用开关。将其打开以显示该代理的身份验证选项；将其关闭以折叠卡片并从工作区中移除该代理。
始终有一个已启用的代理作为主代理，以橙色星形标记表示。会话打开时，主代理会在第一个终端标签页中自动启动；其他已启用的代理会被安装和验证，但要等到你从新标签页启动它们时才运行。要提升另一个代理，请先启用它，然后在其卡片上点按设为主代理——之前的主代理会被降级，但保留自己的身份验证。禁用当前主代理时，会自动提升另一个已启用的代理，且最后剩下的一个代理无法被禁用：工作区始终至少有一个代理。
身份验证模式
启用代理后，会有一组单选按钮用于选择其身份验证方式。提供哪些模式取决于代理——Bedrock 为 Claude Code 独有：
| 模式 | Claude Code | Codex | Grok Build |
|---|---|---|---|
| API 令牌 | 是 | 是 | 是 |
| 订阅（交互式登录） | 是 | 是 | 是 |
| Bedrock (AWS) | 是 | — | — |
| 本地模型 | 是 | 是 | 是 |
API 令牌
将提供商的 API 密钥粘贴到安全字段中——其占位符会标明提供商名称：Anthropic API key、OpenAI API key 或 xAI API key。密钥经加密存储在宿主机上；VM 始终只能看到诱饵，代理服务器会在发往该提供商的请求中将其重写为真实值。使用前需批准复选框（默认关闭）将在下方使用前需批准中说明。
新启用的代理默认采用此模式。
订阅（交互式登录）
使用你的付费订阅（Claude、ChatGPT/Codex 或 Grok）而非 API 密钥登录代理。内嵌的注册…按钮会运行一次性的交互式登录流程；完成后，模式旁会出现一个绿色印章，并附带重新注册…和忘记控件。真实的 OAuth 令牌保留在宿主机上并在那里刷新，而 VM 拿到的是伪造值——该交换当前是否生效会显示出来，并可在追踪窗格中重置。
这是 Claude Code 的出厂模板默认值。
Bedrock (AWS)——仅限 Claude Code
使用你在凭据 → AWS 下配置的 AWS 凭据，通过 Amazon Bedrock 路由 Claude Code。默认模型 ID 字段可覆盖 Claude Code 请求的 Bedrock 模型——例如 us.anthropic.claude-sonnet-4-6-v1:0；留空则使用 Claude Code 的内置默认值。Codex 或 Grok Build 不提供 Bedrock。
本地模型
让代理完全对接由宿主机提供的设备端模型运行，不涉及任何云提供商。在本地模型窗格中至少安装一个模型之前，该选项会显示为灰色——标注为**——请在本地模型中下载一个模型**。一旦有可用模型，代理会通过其基础 URL 环境变量（ANTHROPIC_BASE_URL、OPENAI_BASE_URL 或 XAI_BASE_URL）指向本地引擎，并提供在本地模型中选定的模型。引擎、设备端路由和混合回退在本地模型一章中介绍。
注意：为工作区打开启用本地模型会自动将每个已启用的代理固定为本地模型，再次关闭它则会恢复每个代理之前的模式。你通常应从本地模型窗格设置设备端推理，而非逐个代理设置。
使用前需批准
在 API 令牌模式下，使用前需批准复选框会加入一道许可关卡：在代理服务器将诱饵密钥替换为真实密钥之前，宿主机会弹出一个对话框，让你允许使用一次、允许一小段时间或允许在本次会话的剩余时间内使用。它默认关闭。同样的逐凭据批准模式在整个凭据窗格中反复出现。
设置参考
| 设置 | 说明 |
|---|---|
| 启用（每个代理） | 使该代理在此工作区中可用。默认：Claude Code 开启并作为主代理；Codex 和 Grok Build 关闭。 |
| 主代理 / 设为主代理 | 标记在第一个标签页中自动启动的代理。默认：Claude Code。最后一个已启用的代理无法关闭。 |
| 身份验证模式 | 单选：API 令牌 / 订阅（交互式登录） / Bedrock (AWS)（仅限 Claude Code）/ 本地模型（需已安装本地模型）。默认：出厂模板中 Claude Code 为订阅（交互式登录）；新启用的代理默认为 API 令牌。 |
| API 密钥 | 令牌模式下提供商密钥的安全字段（ANTHROPIC_API_KEY / OPENAI_API_KEY / XAI_API_KEY）。作为诱饵注入 VM；在传输过程中交换。默认：空。 |
| 使用前需批准 | 复选框（令牌模式）。每次诱饵→真实密钥交换前的许可对话框。默认：关闭。 |
| 默认模型 ID | 仅 Bedrock 模式。覆盖 Bedrock 模型 id，例如 us.anthropic.claude-sonnet-4-6-v1:0。默认：空（代理的内置默认值）。 |
| 注册… / 重新注册… / 忘记 | 仅订阅模式。运行或清除交互式登录注册。默认：未注册。 |