OpenCode 接入 API 使用教程

基本介绍

OpenCode 是一款专为终端打造的 AI 编码代理工具，通过优化的键盘操作流程为命令行用户提供高效的开发体验。其客户端/服务器分离架构不仅支持本地运行，还可通过移动应用实现远程控制。

可通过下面的 NPM 命令安装 OpenCode 官方 CLI 程序

此外 OpenCode 官网 https://opencode.ai 也提供应用程序插件等其他安装方式。

先不要直接启动 OpenCode，而是在终端中执行以下命令：

然后在服务商列表中，选择 other（在最下面，可以直接搜索）。

系统会提示你输入 Provider ID：
请填写一个唯一标识名（例如 wolfai），后续配置需与之严格一致。

接着输入 API Key 令牌：
可填写任意内容（如 admin），因为实际密钥可通过配置文件安全引用（见下一步）。

这一步的作用是让 OpenCode 在本地凭证管理器中注册一个自定义服务商，便于后续引用密钥。

打开 OpenCode 配置目录（文件路径因系统而异）：

macOS / Linux: ~/.config/opencode/

Windows: Users\你的用户名.config\opencode

在该目录下创建或编辑配置文件：opencode.json，文件内容如下：

保存配置文件后，重启并运行 OpenCode：

在聊天界面输入命令：

即可在模型列表中看到你配置的中转站及其模型（如 “GPT-5.2”）。选择后即可正常使用！

Provider ID 必须一致：配置文件中的键名（如 deeprouter）必须与 auth login 时输入的 ID 完全相同（区分大小写）。

API 令牌：令牌分组建议使用 Default 默认分组（所有模型可用），打开无限额度，永不过期，其他全部保持默认即可。

API 地址格式：确保 baseURL 正确。可先用 curl 或 Postman 测试是否响应 /v1/models。

模型 ID 要匹配：models 下的键（如 gpt-5）必须与 WolfAI 实际支持的模型 ID 一致。

若修改配置后未生效，请尝试完全退出 OpenCode 并重新启动。