文档
编程工具
OpenCode

在 OpenCode 中使用 Airoutly

在 opencode.json 里把 Airoutly 添加为 OpenAI 兼容提供方，Airoutly 上的所有对话模型都能通过它调用。

Base URL: https://api.airoutly.com/v1
Key 变量: AIROUTLY_API_KEY
可用模型: 模型页上的所有对话模型

1. 安装 OpenCode

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

npm install -g opencode-ai

# 官方推荐在 WSL 中使用；原生安装：
scoop install opencode

2. 添加提供方

把 Airoutly 写进 ~/.config/opencode/opencode.json（对所有项目生效）或项目根目录的 opencode.json，两个文件会合并。

opencode.json

{
"$schema": "https://opencode.ai/config.json",
"provider": {
  "airoutly": {
    "npm": "@ai-sdk/openai-compatible",
    "name": "Airoutly",
    "options": {
      "baseURL": "https://api.airoutly.com/v1",
      "apiKey": "{env:AIROUTLY_API_KEY}"
    },
    "models": {
      "claude-sonnet-4-5": { "name": "Claude Sonnet 4.5" },
      "gpt-5": { "name": "GPT-5" }
    }
  }
},
"model": "airoutly/claude-sonnet-4-5"
}

models 下的每个键必须是模型页上的准确模型 ID。

3. 选择模型

model 用 airoutly/<模型 ID> 设置默认模型；在 OpenCode 里输入 /models 可以切换。

常见问题

Key 没错却返回 401

如果没有设置 AIROUTLY_API_KEY，{env:AIROUTLY_API_KEY} 会被替换成空字符串，而且不会提示。请在启动 OpenCode 的终端里导出这个变量。

用命令行检查配置

运行 opencode models airoutly 列出模型，再运行 opencode run -m airoutly/gpt-5 “hi”。