OpenCode

OpenCode 支持在配置文件中添加自定义 Provider。推荐使用 OpenAI-compatible adapter，并通过环境变量读取 Key。

配置状态

推荐协议： OpenAI Chat Completions 兼容
配置格式核对： 2026-07-15（OpenCode 官方 Providers 文档）
运行验证： 待验证

1. 安装

请按 OpenCode 官方安装文档选择安装方式。安装后记录版本：

opencode --version

2. 配置环境变量

export GETROUTER_API_KEY="YOUR_API_KEY"

3. 添加 Provider

编辑当前版本使用的 opencode.json，将以下内容合并到现有配置：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "getrouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "GetRouter",
      "options": {
        "baseURL": "https://getrouter.ai/v1",
        "apiKey": "{env:GETROUTER_API_KEY}"
      },
      "models": {
        "MODEL_ID": {
          "name": "GetRouter Model"
        }
      }
    }
  },
  "model": "getrouter/MODEL_ID"
}

将两处 MODEL_ID 替换为同一个准确模型 ID。

最终请求路径

OpenAI-compatible adapter 通常从 baseURL 追加 Chat Completions 路径：

POST https://getrouter.ai/v1/chat/completions

4. 验证

在测试项目中启动 OpenCode，确认模型显示为 getrouter/MODEL_ID。先执行只读任务，再测试编辑、命令和工具调用。

常见问题

现象	处理
Provider 不存在	检查 JSON 层级、Schema 和当前版本的 Provider 字段
环境变量没有展开	从设置变量的同一终端重启 OpenCode
模型路径错误	Provider 前缀应为 `getrouter/`，模型 ID 与配置键一致
404	查看最终 URL，排除重复 `/v1`
普通对话成功但 Agent 失败	检查工具调用兼容性和模型能力

#OpenCode

#1. 安装

#2. 配置环境变量

#3. 添加 Provider

#最终请求路径

#4. 验证

#常见问题