文档

文档

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 安装都无需更改。

~/.zshrc
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-5
必须带有 openai/ 前缀,且 /v1 后缀应放在基础 URL 中。省略此前缀会让 Aider 根据自身的提供商列表解析 ID,从而报出“未知模型”错误;省略 /v1 则会导致请求完全无法匹配路由。

分步操作

  1. 在 /app/keys 创建密钥并复制——它只会显示一次。
  2. 在启动 Aider 的 shell 中导出 OPENAI_API_BASE 和 OPENAI_API_KEY,或按下方所示将它们写入 ~/.aider.conf.yml。
  3. 在你的仓库目录中使用 aider --model openai/claude-sonnet-5 启动 Aider。
  4. Aider 会在启动时打印已解析的模型。如果该行显示的是你指定的 ID,则端点已配置成功。

Aider 自身的参考文档见 OpenAI 兼容 API 页面。

避免将其写入 shell 配置文件

这两个值也可以保存在 Aider 的配置文件中;如果你会按项目切换端点,这种方式更合适。

~/.aider.conf.yml
# ~/.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 的美元计价,顺序为输入 / 输出。

模型 IDKunavo 输入 / 输出适用场景
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同一个密钥,也可使用不同模型系列——适合作为复杂差异的第二意见
Aider 每次交互都会重新发送仓库映射和已编辑文件,因此 token 支出取决于上下文大小,而非编辑内容的大小。因此,提示词缓存是这里最重要的优化手段;同时使用 --model 和 --weak-model openai/claude-haiku-4-5 是成本最低的搭配:强模型负责编辑,弱模型负责撰写提交说明和摘要。费用按 token 从预付余额中扣除,且无月费——详情见 计费说明。

常见问题

如何通过 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 上,每次请求的费用可在用量视图中查看,从预付余额中扣除,且无月费。