Appearance
在 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/opencode2. 检查安装结果
bash
opencode --version3. 创建配置目录,写入第三方 provider
- 创建
~/.config/opencode目录,并在该目录下创建opencode.json。 - 注意:API Key 在配置完参数后,启动 opencode 时进行输入。
- 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.baseURL | https://agentrouter.orgClaude 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-astraAnthropic: claude-opus-5、claude-opus-4-8 支持 OpenAI 及 Anthropic智谱: glm-5.3 支持 OpenAI 及 AnthropicDeepseek: 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"
}
OPENCODESETTINGS4. 测试与验证
bash
# 启动 opencode
opencode
# 输入命令查看模型列表
/model