认证与服务选择
连接常见 API Key 服务或订阅 OAuth,并识别名称、权限和版本差异。
多数托管服务遵循同一流程:在提供商控制台创建 Key,运行 /connect 搜索对应服务,输入凭据,再使用 /models。浏览器订阅授权与 API Key 则可能使用不同身份和计费方式,按连接菜单选择。
普通常见服务
官方目录为下列服务给出上述 API Key 流程:302.AI、Baseten、Cerebras、Cortecs、DeepSeek、Deep Infra、FrogBot、Fireworks AI、GMI Cloud、Groq、IO.NET、Moonshot AI、MiniMax、Nebius Token Factory、Together AI、Venice AI、Scaleway、OVHcloud AI Endpoints、SCX.ai 等。
它们的 Key 不可相互替换,示例型号也不是保证可用的最新目录。创建凭据时选择自己实际使用的服务,并通过连接后的模型列表确认。
有些入口有额外条件:
| 服务 | 需要注意 |
|---|---|
| Hugging Face | token 需要调用 Inference Providers 的权限 |
| STACKIT | 创建 token 前需要客户账号、用户账号与项目 |
| Z.AI | GLM Coding Plan 用户应选择 Z.AI Coding Plan |
| NVIDIA | 可在菜单输入 Key,或使用 NVIDIA_API_KEY;自建 NIM 可配置 baseURL |
| OpenCode Zen / Go | 分别选择菜单中的服务,完成账户和计费设置后使用对应 Key |
OpenAI
/connect 选择 OpenAI 后,官方列出 ChatGPT Plus/Pro 浏览器认证和 Manually enter API Key 两种方法。选择与自己账户权益相符的方式,再检查 /models,不能由认证成功推断所有 OpenAI 型号均可使用。
对 ChatGPT OAuth,OpenCode 会转发工作区凭据中提供的 compute residency 要求,而不是维护一份固定地区列表。存储数据的地区不等于推理计算地区,不应从 data residency at rest 推断区域推理已启用。
GitHub Copilot
在 /connect 搜索 GitHub Copilot,根据界面显示的设备代码访问 GitHub 设备授权页,完成授权后选择模型。代码每次由当前流程生成,不能使用文档中的演示值。
OpenCode 文档提醒部分模型可能需要 Pro+。实际账号、组织政策与可用目录仍需在当前会话核对,不把个人 Copilot 订阅解释成任意兼容 API Key。
Anthropic 的版本差异
Providers 页前段仍提到 Claude Pro/Max 浏览器选项,但后面的更新说明表示相关插件从 OpenCode 1.3.0 起不再内置,并指出 Anthropic 不允许这类订阅接入。
因此本页不将旧的 Pro/Max 步骤整理成现行可用流程。采用该页仍展示的手工 API Key 入口,或按当前官方支持方式配置;不要以旧教程或第三方插件存在来推断订阅授权受到支持。
xAI
/connect 选择 xAI 后,可以选择 SuperGrok Subscription 进行 device-code OAuth,或选择 Manually enter API Key。OAuth 流程会显示验证链接和代码,授权后保存并自动刷新 token。
官方把订阅条件限定为包含 Grok API access 的相应套餐,不是所有 Grok 或 X Premium 账号都自动具有相同权限。订阅登录无需再设置单独的 XAI_API_KEY;Key 方式仍使用自己的 API 凭据。
排查
认证失败时先确认连接菜单、Key 来源和实际套餐,再核对网络与模型 ID。opencode auth list 用于检查 OpenCode 保存的认证;需要环境身份、角色或部署资源的服务,应转到相应专门流程。