CodeNomad 提供商与账户
提供商认证属于所连接的 OpenCode 服务，而非浏览器设备或单个 CodeNomad 项目。模型显示偏好、订阅配额和网页搜索选择有不同作用域。
连接模型或搜索提供商
- 打开工作区，然后打开设置 → 提供商。模型默认展开；搜索提供商请展开网页搜索。
- 在该组中选择选择提供商，然后选择连接。
- 对于模型提供商，完成提供的原生认证方式：API 密钥、OAuth 或命令。对于 OAuth，使用打开授权页面，仅在要求时提交授权码。搜索提供商通过 API 密钥连接。
- 完成后检查已配置提供商行。模型会在连接、账户更改和重新连接后重新读取；网页搜索还提供刷新。
仅搜索集成显示在网页搜索下，而非模型下。保存认证不会选择模型或更改默认搜索提供商。API 密钥和 OAuth 凭据由活动 OpenCode 服务器保存。浏览器收到连接元数据，而非保存的凭据秘密。来自环境变量的连接在此界面中只读：请更改其所属环境，而非尝试在此断开。
授权窗口被阻止时，使用流程中的打开授权页面、在此标签页打开或复制链接。不要在诊断信息中公开授权链接或授权码。
选择和管理账户
- 在提供商行中使用活动账户选择已保存凭据。
- 使用添加账户认证另一条连接。
- 管理其他已保存账户时，先选择它，再使用重命名账户或移除账户。重命名使用账户名称和保存；移除账户会立即执行，无需确认。
选择、重命名和移除会影响该集成在整个 OpenCode 服务中的状态，包括其他项目和客户端。移除凭据可能导致那些客户端无法认证；不会删除对话历史或撤销提供商远程账户。环境连接不能作为可写的已保存凭据选择，也不能在此移除。操作失败时，CodeNomad 会重新读取账户：请再次检查活动账户后再操作。
自动选择限制
在受支持集成中保存多个凭据后，自动选择账户可选择启用基于配额的选择，在下一条提示词/自定义命令通过 CodeNomad 接纳前执行。设置按集成保存在 CodeNomad 配置中；产生的账户选择作用于整个服务。
| 符合条件的集成 | 符合条件的账户类型 |
|---|---|
| OpenAI / Codex | Codex 浏览器/设备 OAuth 订阅账户，不包括 OpenAI 按量付费密钥，也不包括 OpenAI 不提供用量的 ChatGPT 登录方式。 |
| OpenCode Go | Go 密钥，或仅用于 Go 提供商的 OpenCode Console 登录/密钥，不包括 Zen 按量付费额度。 |
| Anthropic | OpenCode 的 Claude Pro/Max OAuth 登录，不是 Claude Code 登录。 |
| GitHub Copilot | 可读取高级请求配额的 OAuth；企业端点凭据不是可读取候选。 |
| 编码计划 | 基于密钥的 zai-coding-plan、zhipuai-coding-plan、kimi-for-coding、minimax-coding-plan、minimax-cn-coding-plan。 |
仅当前账户配额耗尽才触发切换；仅有额度更充足的替代账户不会触发。读取会检查显式保存的凭据，不激活候选或交换刷新令牌。Codex、Copilot 和编码计划要求候选明确可用。Go、Console 和 Claude 可以使用配额未知的候选，除非近期原生配额失败将其标记为耗尽。OpenCode Go 用量端点和 Console OAuth 用量仍未获上游验证，因此不保证可用。
这不是运行中的故障转移。它既不重试失败请求，也不重放提示词、命令或修改操作。不会轮换环境连接、任意提供商、按量付费余额或外部 Claude Code 登录。准备选择期间会尊重手动账户更改；不存在跨客户端账户锁。发生配额/认证错误时，请检查活动账户，刷新用量，必要时通过凭据所属方登录，然后再有意识地发送。
模型可见性、收藏和思考
- 选择模型提供商旁的管理模型。
- 按名称/ID 搜索并更改可见性；全部显示和全部隐藏影响该提供商的选择器列表。
- 在对话的模型选择器中使用添加到收藏或从收藏移除；显示所有模型会退出仅收藏筛选。
- 使用输入框中的思考选择所选模型提供的变体。
可见性和收藏用于组织 CodeNomad 选择器；不会卸载模型、移除凭据或阻止其他 OpenCode 客户端使用它们。隐藏模型不等于断开账户。思考选择后续发送的模型变体，而非对话中已有推理的可见性。使用管理模型 → 全部显示恢复隐藏模型。
用量、Token 数和过期登录
使用右侧面板的用量查看活动对话的提供商计划窗口、重置时间和受支持余额。这些提供商读数不同于每条消息的令牌和成本估算：订阅配额不是根据可见对话计算的账单。缺失、过时或未知读数不是零用量，也不能证明还有容量。设置 → 高级中的提供商额度余额控制补充余额显示。
OpenAI 不为某一种 ChatGPT 登录方式提供用量：此时用量面板会说明这一点，而不显示配额窗口。聊天仍可正常使用，重新连接同一登录也不会恢复该读数。
用量跟随所选原生凭据。通过 anthropic/claude 使用 Claude 时，采用 OpenCode 的 Anthropic OAuth。claude-code 提供商使用守护进程主机上的 Claude Code 登录，包括其 WSL 发行版：先用 CLAUDE_CODE_OAUTH_TOKEN，再用已存储登录，文件存储由 CLAUDE_SECURESTORAGE_CONFIG_DIR / CLAUDE_CONFIG_DIR 或 ~/.claude 决定；本地 macOS 可使用钥匙串。CodeNomad 不会用一种 Claude 登录替代另一种。
提供商登录过期时，通过其所属方——OpenCode、Claude Code 或 Codex CLI——刷新/登录，再刷新 CodeNomad。CodeNomad 不交换外部所有的刷新令牌。CodeNomad 服务器登录过期是另一回事：重新连接/登录 CodeNomad，不要假定失败的提供商请求会重发。参阅故障排查。
可选用量环境变量
启动前在 CodeNomad 后端进程环境中设置以下变量。它们是用量读取器凭据，而非浏览器设置或模型选择控件。更改会话环境变量编辑器不会更新运行中后端供这些读取器使用的 process.env。更改时请以目标环境重启后端；不要仅为用量读取器变量重启共享 OpenCode 服务。
| 用量集成 | 环境变量 |
|---|---|
| Cursor | CURSOR_ACCESS_TOKEN，回退到 CURSOR_TOKEN |
| Ollama Cloud | OLLAMA_CLOUD_COOKIE |
| OpenCode Go 补充用量 | 同时使用 OPENCODE_GO_WORKSPACE_ID 和 OPENCODE_GO_AUTH_COOKIE |
| ZenMux | ZENMUX_PLATFORM_API_KEY——平台密钥，不同于推理密钥 |
| exe.dev | EXE_DEV_USAGE_TOKEN |
| Command Code | 原生凭据不可用时回退到 COMMAND_CODE_API_KEY |
不要让令牌/cookie 出现在 Shell 历史、截图和报告中。可选读取器依赖提供商 API 和凭据有效性；配置变量不保证有可用配额数据。
网页搜索默认值和项目覆盖
- 在设置 → 提供商中展开网页搜索；如果搜索集成需要 API 密钥，请用其密钥连接。
- 为全局配置选择默认搜索。
- 使用用于当前项目为活动 Location 覆盖。悬停或聚焦该选择器，可查看带有最终有效结果的此项目的搜索。
更改自动保存。默认 / 继承使用继承配置或已保存原生选择；项目覆盖优先于全局。已禁用在所选范围关闭搜索；自动选择提供商请求原生自动选择提供商。网页搜索仅在展开时加载其连接和选项。断开连接会移除已保存的搜索密钥；由环境变量提供的连接标为只读，且没有断开连接。
即使提供商选择按项目生效，搜索凭据仍在服务全局共享。保存密钥不会将它选为默认搜索。读写失败时，请先刷新再重试；不要盲目替换配置。原生配置详情请参阅 OpenCode 文档和 OpenCode 设置。