Air Router

外观

OpenCode 接入 ​

OpenCode 是面向终端的开源编程 Agent，可以通过自定义 Provider 使用 Air Router。

1. 安装 OpenCode ​

bash
curl -fsSL https://opencode.ai/install | bash
bash
npm install -g opencode-ai
powershell
scoop install opencode
powershell
choco install opencode

验证安装：

bash
opencode --version

2. 保存 API Key ​

bash
export AIR_ROUTER_API_KEY="sk-your-key"
powershell
$env:AIR_ROUTER_API_KEY="sk-your-key"

3. 创建配置文件 ​

OpenCode 支持用户级和项目级配置：

范围路径
用户级~/.config/opencode/opencode.json
当前项目项目根目录的 opencode.json

首次接入建议使用用户级配置。将 your-model-id 替换为 Air Router 控制台中的实际模型 ID：

json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "air-router/your-model-id",
  "provider": {
    "air-router": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Air Router",
      "options": {
        "baseURL": "https://www.air-router.com/v1",
        "apiKey": "{env:AIR_ROUTER_API_KEY}"
      },
      "models": {
        "your-model-id": {
          "name": "Air Router Model"
        }
      }
    }
  }
}

配置中的三处名称必须对应：

  • Provider ID：air-router
  • 模型定义键：your-model-id
  • 默认模型：air-router/your-model-id

4. 启动并验证 ​

进入项目目录后运行：

bash
opencode

在 OpenCode 中执行 /models，确认可以看到 Air Router Model，然后选择它并发送一个简单任务。

排查配置时可以使用：

bash
opencode debug config
opencode auth list

常见问题 ​

模型没有出现在 /models ​

检查 models 中的键是否已经替换为真实模型 ID，以及顶层 model 是否使用 air-router/模型ID 格式。

提示缺少 API Key ​

确认 OpenCode 启动所在的终端已经设置 AIR_ROUTER_API_KEY。{env:AIR_ROUTER_API_KEY} 是环境变量引用，不应替换为真实密钥。

请求格式不兼容 ​

本页使用 @ai-sdk/openai-compatible，对应 Chat Completions 兼容方式。不要把其他 Provider 的专用 npm 包直接套用到 Air Router 配置。