# 在 OpenCode 中使用 OAIRoute
> 终端里的编程代理，没有图形界面
> 提供方写进 ~/.config/opencode/opencode.json
> 切换厂商只改模型名
## 第一步：获取 API Key
在 [OAIRoute 控制台](https://api.oairoute.com/keys) 创建。
## 第二步：写入配置文件
OpenCode 从 `~/.config/opencode/opencode.json` 读取提供方。把下面的 JSON 存进去，把 Key 换成你自己的：
```
{
  "provider": {
    "oairoute": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://api.oairoute.com/v1",
        "apiKey": "YOUR_OAIROUTE_KEY"
      },
      "models": {
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" },
        "gpt-4o-mini": { "name": "GPT-4o mini" }
      }
    }
  }
}
```
## 第三步：启动并验证
在终端里执行 `opencode`，用模型切换器选中刚配的 `oairoute` 提供方，再随便问一句确认能通。
## 配置项说明
| 字段 | 填什么 |
|---|---|
| npm | @ai-sdk/openai-compatible，OpenCode 用它加载兼容层 |
| options.baseURL | https://api.oairoute.com/v1 |
| options.apiKey | 你的 OAIRoute Key |
| models | 想在下拉里出现的模型 ID，键名就是模型 ID |
> **Note:**
> models 只影响下拉里显示什么，不限制实际能调用的模型。想用没列出来的模型，直接填模型 ID 也能走通。
## 常见问题
**配置改了没生效**
确认文件路径正确：macOS / Linux 是 `~/.config/opencode/opencode.json`，Windows 跟随你的 XDG 配置目录。
**流式或工具调用异常**
检查 `npm` 字段是否写成了 `@ai-sdk/openai-compatible`，以及 baseURL 是否以 `/v1` 结尾。
**返回 401**
Key 没填对，或填成了 ark 站的 Key。两站 Key 不通用。