---
title: "将 Aider 接入 XiuRouter"
description: "使用 OpenAI-compatible 环境变量为 Aider 配置 XiuRouter Base URL、API Key 和模型。"
image: "https://docs.xiu.ai/og.png"
---

> XiuAI 文档索引
> 完整文档索引：https://docs.xiu.ai/llms.txt
> 阅读前先通过索引确认当前可用页面。

# 将 Aider 接入 XiuRouter

Aider 可以使用 OpenAI-compatible API。把 `OPENAI_API_BASE` 指向 XiuRouter，并用 `openai/模型ID` 选择模型。

## 前置条件

- `aider --version` 可以正常输出版本。
- 已创建一把 Aider 专用 XiuRouter API Key。
- 已选择一个支持工具或代码任务的模型 ID。

## 设置连接

在启动 Aider 的同一终端中设置：

```bash
export OPENAI_API_BASE="https://router-api.xiu.ai/v1"
export OPENAI_API_KEY="YOUR_XIUROUTER_API_KEY"
```

再从测试目录启动：

```bash
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` 看到该模型 |
| 对话成功但编辑失败 | 更换已验证工具或代码编辑能力的模型 |

## 回滚

```bash
unset OPENAI_API_BASE
unset OPENAI_API_KEY
```

关闭当前 Aider 会话后重新启动，确认恢复原 provider。测试 Key 不再使用时，在 XiuRouter 撤销。

## 来源与核对日期

本文按 Aider 当前 OpenAI-compatible 环境变量和 XiuRouter Chat Completions 入口核对，日期为 2026-08-19。本轮未运行真实 Aider 计费任务。

源文件：https://docs.xiu.ai/router/integrations/aider/index.mdx