Skip to content

在 OpenCode 中使用 AgentRouter ​

OpenCode 通过 ~/.config/opencode/opencode.json 配置第三方 provider 接入 AgentRouter,支持在 provider 下创建多个 provider,并在每个 provider 下添加多个 model。

安装与配置步骤 ​

1. 安装 OpenCode ​

bash
curl -fsSL https://opencode.ai/install | bash

npm install -g opencode-ai

brew install anomalyco/tap/opencode

2. 检查安装结果 ​

bash
opencode --version

3. 创建配置目录,写入第三方 provider ​

  1. 创建 ~/.config/opencode 目录,并在该目录下创建 opencode.json。
  2. 注意:API Key 在配置完参数后,启动 opencode 时进行输入。
  3. OpenCode 支持在 provider 下创建多个 provider,并支持在 provider 下添加多个 model。

字段说明:

配置项填写内容 / 说明
npm指定 Vercel AI SDK 的 provider 包,决定请求体格式、鉴权头、接口路径:
- @ai-sdk/anthropic → Anthropic 原生协议:POST /v1/messages,鉴权头 x-api-key,请求体是 Claude 结构
- @ai-sdk/openai-compatible → OpenAI chat 协议:POST /v1/chat/completions,Authorization: Bearer xxx
- @ai-sdk/openai → OpenAI Responses 协议:POST /v1/responses
name对外展示 provider 名称
options.baseURLhttps://agentrouter.org
Claude Opus 系列优先使用 Anthropic + Use custom base URL,Base URL 不加 /v1;其他通用模型使用 OpenAI Compatible,Base URL 加 /v1。两类方法并行,不要混用
models支持的模型是动态调整的,会随资源情况上下线,请始终以 https://ps.air-outer.com/console/personal 展示的列表为准。

Agent Router 当前提供以下模型:
OpenAI:gpt-5.6-sol、gpt-6-astra
Anthropic:claude-opus-5、claude-opus-4-8 支持 OpenAI 及 Anthropic
智谱:glm-5.3 支持 OpenAI 及 Anthropic
Deepseek:deepseek-v4-flash 支持 OpenAI 及 Anthropic

各模型支持端点可参考 https://ps.air-outer.com/pricing。

模型名必须与定价页完全一致(含连字符写法)。填错或填已下线的模型会直接报 503 无可用渠道。
model默认会话初始模型

参考示例:

bash
# 创建目录
mkdir -p ~/.config/opencode

# 写入配置
cat > ~/.config/opencode/opencode.json <<'OPENCODESETTINGS'
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "AgentRouter-openai-gateway": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AgentRouter-openai-gateway",
      "options": {
        "baseURL": "https://agentrouter.org/v1"
      },
      "models": {
        "deepseek-v4-flash": {
          "name": "DeepSeek V4 Flash"
        },
        "glm-5.3": {
          "name": "GLM 5.3"
        }
      }
    },
    "AgentRouter-anthropic-gateway": {
      "npm": "@ai-sdk/anthropic",
      "name": "AgentRouter-anthropic-gateway",
      "options": {
        "baseURL": "https://agentrouter.org"
      },
      "models": {
        "claude-opus-5": {
          "name": "Claude Opus 5"
        },
        "claude-opus-4-8": {
          "name": "Claude Opus 4-8"
        }
      }
    }
  },
  "model": "AgentRouter-openai-gateway/deepseek-v4-flash"
}
OPENCODESETTINGS

4. 测试与验证 ​

bash
# 启动 opencode
opencode

# 输入命令查看模型列表
/model