OpenCode 接入 | Jerry API 文档

文档编程工具OpenCode

1. 安装 OpenCode

Terminal

npm install -g opencode-ai
opencode --version

2. 准备环境变量

macOS / Linux

export JERRY_API_KEY="YOUR_JERRY_API_KEY"

Windows PowerShell

$env:JERRY_API_KEY="YOUR_JERRY_API_KEY"

3. 添加 Provider

在项目根目录创建 opencode.json，或者将相同内容放到 OpenCode 的全局配置文件中。

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "jerryapi": {
      "npm": "@ai-sdk/openai",
      "name": "Jerry API",
      "options": {
        "baseURL": "https://www.jerryapi.com/v1",
        "apiKey": "{env:JERRY_API_KEY}"
      },
      "models": {
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5.4-mini": {
          "name": "GPT-5.4 mini"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  }
}

Provider ID 要保持一致

如果你之后使用 /connect 保存凭据，输入的 Provider ID 也应是 jerryapi，否则凭据和配置无法匹配。

4. 启动与选模型

Terminal

cd /path/to/your/project
opencode

进入 OpenCode 后运行 /models，选择 Jerry API / GPT-5.4。发送一个项目概览任务，再到 Jerry API 后台核对使用记录。

/models 中能看到 Jerry API 的三个模型
模型选择后可以正常生成并调用工具
使用记录中的模型名与当前选择一致

使用 /connect 保存凭据

不想通过环境变量提供密钥时，也可以在 OpenCode 内运行 /connect：

选择 Other
在 Provider 列表中选择自定义提供方。
输入 Provider ID
填写 jerryapi。
输入 API Key
粘贴 Jerry API Key，完成后保留上面的 opencode.json Provider 配置。

如果使用 /connect，可以从 JSON 中移除 options.apiKey，避免配置来源重复。

常见问题

现象	检查项
模型列表没有 Jerry API	确认配置文件位置正确、JSON 没有语法错误，并重启 OpenCode
提示找不到环境变量	在启动 OpenCode 的同一终端中设置 `JERRY_API_KEY`
凭据存在但仍然 401	运行 `opencode auth list`，检查 Provider ID 是否是 `jerryapi`
请求路径 404	`baseURL` 只写到 `/v1`，不要手动附加 `/responses`

核对使用记录用 CC Switch 管理