跳到正文

将 Aider 接入 XiuRouter

使用 OpenAI-compatible 环境变量为 Aider 配置 XiuRouter Base URL、API Key 和模型。

更新于 查看 Markdown

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_ID

Aider 用 openai/ 选择 OpenAI-compatible provider,发给 XiuRouter 的模型值仍是 YOUR_MODEL_ID

验证

  1. 先在一个可撤销的测试仓库启动 Aider。
  2. 让它只读取一个文件并总结,不修改内容。
  3. 再让它修改一个测试文件并查看 diff。
  4. 在 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 计费任务。

导航

输入关键词开始搜索

↑↓ 移动↵ 打开Esc 关闭