首次配置直接在一个终端设置 Base URL 和 Key，再用 openai/模型ID 启动新会话。已经在使用 Aider 时，不需要改动原 .aider.conf.yml，可用独立测试终端临时切换。
选择配置方式
- 首次配置：在当前终端设置连接并启动 Aider。
- 替换已有：使用独立测试终端，不改原配置。
- 对话协助：不提供。当前 Aider 会话不能修改启动它的父进程环境变量。
前置条件
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"Windows PowerShell：
$env:OPENAI_API_BASE = "https://router-api.xiu.ai/v1"
$env:OPENAI_API_KEY = "YOUR_XIUROUTER_API_KEY"环境变量只影响从这个终端启动的新进程。再从测试目录启动：
aider --model openai/YOUR_MODEL_IDAider 用 openai/ 选择 OpenAI-compatible provider，发给 XiuRouter 的模型值仍是 YOUR_MODEL_ID。
验证
- 先在一个可撤销的测试仓库启动 Aider。
- 让它只读取一个文件并总结，不修改内容。
- 再让它修改一个测试文件并查看 diff。
- 在 XiuRouter 控制台“检查实际请求”核对 Key、模型、
/v1/chat/completions和成功状态。
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_KEYPowerShell 关闭测试终端即可取消本次临时变量。关闭当前 Aider 会话后重新启动，确认恢复原 provider。测试 Key 不再使用时，在 XiuRouter 撤销。
来源与核对日期
内容核对于 2026-08-31。Aider 收到完整回复，并在 XiuRouter“检查实际请求”中出现对应模型、接口和成功状态后，基础接入才算完成。