OpenCode 配置

OpenCode 可以配置自定义 OpenAI-compatible provider。下面的默认示例使用本站 /v1/chat/completions。

1. 设置令牌

export NEWAPI_API_KEY="sk-替换为你的令牌"

2. 配置 ~/.config/opencode/opencode.json

先调用 /v1/models，再把示例中所有 YOUR_MODEL_ID 替换为实际模型名：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "fq-hx/YOUR_MODEL_ID",
  "small_model": "fq-hx/YOUR_MODEL_ID",
  "provider": {
    "fq-hx": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "NewAPI",
      "options": {
        "baseURL": "https://newapi.fq-hx.com/v1",
        "apiKey": "{env:NEWAPI_API_KEY}",
        "timeout": 600000
      },
      "models": {
        "YOUR_MODEL_ID": {
          "name": "YOUR_MODEL_ID"
        }
      }
    }
  }
}

启动 OpenCode 后运行 /models，选择 NewAPI 下的模型。

如果使用的是只支持 Responses API 的模型，根据 OpenCode 官方说明将 provider 的 npm 改为：

"npm": "@ai-sdk/openai"

具体 provider 能力仍应通过实际请求验证。不要在配置中写死真实令牌；{env:NEWAPI_API_KEY} 会在运行时读取环境变量。

常见问题

现象	优先检查
找不到 provider	provider ID 与 model 中的 fq-hx/ 前缀是否一致
找不到模型	models 对象的键是否与 /v1/models 返回值完全一致
返回 401	启动进程是否能读取 NEWAPI_API_KEY
工具调用失败	模型是否支持工具；provider 应走 Chat Completions 还是 Responses
能对话但无法编辑代码	检查 OpenCode 权限和模型工具调用能力

官方资料

• OpenCode Providers
• OpenCode Config