Aider 可以使用 OpenAI-compatible API。把 OPENAI_API_BASE 指向 XiuRouter,并用 openai/模型ID 选择模型。
前置条件
aider --version可以正常输出版本。- 已创建一把 Aider 专用 XiuRouter API Key。
- 已选择一个支持工具或代码任务的模型 ID。
设置连接
在启动 Aider 的同一终端中设置:
export OPENAI_API_BASE="https://router-api.xiu.ai/v1"
export OPENAI_API_KEY="YOUR_XIUROUTER_API_KEY"再从测试目录启动:
aider --model openai/YOUR_MODEL_IDAider 用 openai/ 选择 OpenAI-compatible provider,发给 XiuRouter 的模型值仍是 YOUR_MODEL_ID。
验证
- 先在一个可撤销的测试仓库启动 Aider。
- 让它只读取一个文件并总结,不修改内容。
- 再让它修改一个测试文件并查看 diff。
- 在 XiuRouter“使用记录”核对模型、状态、Token 和费用。
Aider 可能不知道自定义模型的上下文窗口和编辑格式。普通文本成功后,仍需验证实际代码编辑;不要根据模型名称猜这些元数据。
常见失败
| 现象 | 处理 |
|---|---|
| 请求仍发往 OpenAI 官方地址 | 确认 OPENAI_API_BASE 在启动 Aider 的同一环境中 |
401 |
检查 OPENAI_API_KEY 是否为有效 XiuRouter API Key |
| Aider 找不到模型 | 使用 openai/YOUR_MODEL_ID,并确认 Key 能从 /v1/models 看到该模型 |
| 对话成功但编辑失败 | 更换已验证工具或代码编辑能力的模型 |
回滚
unset OPENAI_API_BASE
unset OPENAI_API_KEY关闭当前 Aider 会话后重新启动,确认恢复原 provider。测试 Key 不再使用时,在 XiuRouter 撤销。
来源与核对日期
本文按 Aider 当前 OpenAI-compatible 环境变量和 XiuRouter Chat Completions 入口核对,日期为 2026-08-19。本轮未运行真实 Aider 计费任务。