OpenCode 接入 AIGoCode：全局配置里的 Key 分组、适配器和模型如何对齐

OpenCode 换协议，要一起核对分组、适配器和地址

把 AIGoCode 接进 OpenCode，不是只在配置里填入一把 Key。官方教程分别提供 OpenAI、Claude 和 Gemini 三份全局配置，每份都有对应的 Key 分组、npm 适配器、baseURL 和模型标识。

本文帮助你从其中一份配置开始接入，并在切换协议时检查这些字段是否仍然配套。它只讨论 OpenCode 的全局配置流程，不把 Cherry Studio 的端点框或其他 CLI 的 Key 分组照搬过来。

先关闭 OpenCode，找到全局配置文件

官方 OpenCode 教程要求：若 OpenCode 正在运行，先关闭，再打开全局配置文件。

Windows 的文件位置是 %USERPROFILE%.config\opencode\opencode.json；macOS 与 Linux 使用 ~/.config/opencode/opencode.json。目录或文件不存在时先创建。教程说明，这份全局配置会被 OpenCode 的不同启动方式共同读取，保存后需要重新打开 OpenCode。

如果文件已经有内容，动手前建议自行保留副本、核对已有设置。教程给出了完整配置示例，本文不会把“完整示例”理解成允许不检查就丢弃你自己的配置。实际合并时应保证仍是合法配置，并保留与你当前任务有关的其他设置。

按所选协议核对四组信息

下面是本轮官方示例的字段对照。模型名描述的是教程用例，不是你账号可以使用的完整模型清单。

先选定接入方式，再去对应分组创建 Key，将示例中的 sk-your-api-key 替换为自己的密钥。该字符串是占位符，不是可以直接调用的真实 Key。

不要只把顶层 model 从一种模型改成另一种，却留下原协议的适配器、分组或请求地址。检查配置时，把上表的一整行作为同一组来核对。

顶层 model 与 provider 下的模型项也要对齐

三份官方配置都使用 aigocode 作为 provider 的标识。以 OpenAI 用例为例，顶层 model 写成 aigocode/gpt-6-astra，而 provider 下 aigocode 的 models 中登记 gpt-6-astra，并用 name 给出显示名称 GPT-6 Astra。

阅读配置时，分别检查 provider 标识、模型键和显示名称，别因为界面上的显示名看起来正确，就跳过实际模型标识。Claude 与 Gemini 的示例采用相同的组织方式，但对应各自的模型键。

这段对照只说明官方示例里的字段关系。若你要换成示例以外的模型，应先核对当前文档与实际支持情况，不从一个成功示例推断所有模型都可用。需要了解示例模型名的基本区别，可以接着看本站模型名怎么填。

OpenCode 的这里填协议地址，不直接套用根地址规则

AIGoCode Base URL 文档提醒，客户端会因实现方式不同而要求根地址或协议地址，具体应按对应工具教程填写。OpenCode 本轮示例中，OpenAI、Claude 的 options.baseURL 是带 /v1 的地址，Gemini 则带 /v1beta。

因此，不要把另一个桌面客户端要求的根地址直接套到这份配置上，也不要在这里追加 /messages 或 /chat/completions 等完整接口路径。保留所选 OpenCode 示例给出的 baseURL，再继续验证。

保存、重开、新建会话，再去核对用量

保存后重新打开 OpenCode，新建会话并发送一条不含敏感信息的消息。官方给出两个验证条件：OpenCode 能正常回复，并且 AIGoCode 的用量记录出现这次请求。

核对时可以记下发送时间、所用模型和这次请求对应的用量记录，不需要公开密钥或完整对话。只有界面打开，或者配置文件成功保存，都不能替代这次实际请求验证。本文没有替你执行该验证，也不承诺固定回复。

若模型不可用，官方要求确认 Key 来自对应分组，并检查配置中的 Key 和请求地址。遇到 401、403、429 时，转到错误码说明；也可先读本站认证与额度分开排查。先确认哪一组字段与教程不同，再逐项改动，避免同时换掉全部配置后失去对照。