文档
Aider
Aider 会读取 OPENAI_API_BASE 和 OPENAI_API_KEY。将它们指向 Kunavo,在模型 ID 前加上 openai/,即可通过一个 --model 参数切换 Claude 和 GPT。
只需两个环境变量和一个前缀。将 OPENAI_API_BASE 设为 https://api.kunavo.com/v1,将 OPENAI_API_KEY 设为你的 sk-kn-… 密钥,然后使用 --model openai/<id> 运行 Aider。仓库和 Aider 安装都无需更改。
export OPENAI_API_BASE=https://api.kunavo.com/v1
export OPENAI_API_KEY=sk-kn-...
# The openai/ prefix is required — it tells Aider to speak the OpenAI
# protocol to OPENAI_API_BASE instead of resolving the id as a known model.
aider --model openai/claude-sonnet-5openai/ 前缀,且 /v1 后缀应放在基础 URL 中。省略此前缀会让 Aider 根据自身的提供商列表解析 ID,从而报出“未知模型”错误;省略 /v1 则会导致请求完全无法匹配路由。分步操作
- 在
/app/keys创建密钥并复制——它只会显示一次。 - 在启动 Aider 的 shell 中导出
OPENAI_API_BASE和OPENAI_API_KEY,或按下方所示将它们写入~/.aider.conf.yml。 - 在你的仓库目录中使用
aider --model openai/claude-sonnet-5启动 Aider。 - Aider 会在启动时打印已解析的模型。如果该行显示的是你指定的 ID,则端点已配置成功。
Aider 自身的参考文档见 OpenAI 兼容 API 页面。
避免将其写入 shell 配置文件
这两个值也可以保存在 Aider 的配置文件中;如果你会按项目切换端点,这种方式更合适。
# ~/.aider.conf.yml — same two values, without exporting them each shell.
openai-api-base: https://api.kunavo.com/v1
openai-api-key: sk-kn-...
model: openai/claude-sonnet-5调试 Aider 前先验证
一个请求就能确定故障来自端点、密钥还是 Aider 的模型解析。如果返回的是包含模型 ID 的 JSON 列表,那么同一个基础 URL 和密钥在 Aider 中也能正常工作;之后若仍有错误,问题就在 openai/ 前缀。
# Settles whether a failure is the endpoint, the key, or Aider.
# A JSON list of model ids means the same base URL will work in Aider.
curl -sS https://api.kunavo.com/v1/models \
-H "Authorization: Bearer sk-kn-..."选择模型
Kunavo 上的每个文本模型都可以通过 openai/<id> 访问——完整列表见 模型页面,也可以通过 GET /v1/models 实时获取。费率以每 1M token 的美元计价,顺序为输入 / 输出。
| 模型 ID | Kunavo 输入 / 输出 | 适用场景 |
|---|---|---|
claude-haiku-4-5 | $0.70 / $3.50 | 价格最低的 Claude——适合 Aider 的仓库映射和提交说明请求 |
claude-sonnet-5 | $1.40 / $7.00 | 编辑任务在质量与价格之间的默认平衡选择 |
claude-opus-5 | $3.50 / $17.50 | 质量最高的 Claude 档位——适用于架构级更改 |
gpt-5-6-terra | $0.70 / $4.20 | 同一个密钥,也可使用不同模型系列——适合作为复杂差异的第二意见 |
常见问题
如何通过 OpenAI 兼容 API 使用 Aider?
将 OPENAI_API_BASE 设为端点的基础 URL,将 OPENAI_API_KEY 设为你的密钥,然后在模型 ID 前加上 openai/ 启动 Aider,例如 `aider --model openai/claude-sonnet-5`。Kunavo 的基础 URL 是 https://api.kunavo.com/v1。此前缀不可省略:否则 Aider 会尝试在自己的提供商表中解析该 ID,而不是将其发送到你的端点。
Aider 可以通过 OpenAI 兼容端点使用 Claude 模型吗?
可以。Aider 使用 OpenAI 协议与 OPENAI_API_BASE 指向的服务通信,因此只要 Claude 模型以该格式提供,就无需 Anthropic 凭据即可访问——模型 ID 只是 /v1/models 列表中的另一个字符串。在 Kunavo 上,Claude 和 GPT 的 ID 共用同一个密钥,因此切换模型只需更改 --model 参数,无需更改配置。
为什么 Aider 提示模型未知?
几乎总是因为缺少 openai/ 前缀。Aider 会将不带前缀的 ID 视为自己应该识别的模型,无法识别时就会报错;`openai/<id>` 则会告诉它将该 ID 直接传给 OPENAI_API_BASE。第二常见原因是基础 URL 缺少 /v1 后缀,这会导致连接或 404 错误,而不是模型未知错误。
Aider 会显示一次会话的费用吗?
Aider 会打印 token 数量和每次交互的预估费用,这些数据根据其自身的模型元数据计算得出。对于自定义端点,该估算可能不准确,因为 Aider 不知道你端点的费率。token 数量可作为可靠参考,实际扣费请以你的提供商为准。在 Kunavo 上,每次请求的费用可在用量视图中查看,从预付余额中扣除,且无月费。