# Aider 接入 OpenAI 兼容 API：配置与编辑验证

> 配置 Aider 自定义 API，区分 openai/ 客户端前缀与服务端模型 ID，处理模型元数据警告，并核算合格代码修改的成本。

_发布 2026-09-29 · 更新 2026-09-29 · [KeepRouter Editorial](https://keeprouter.com/editorial-policy#editorial-team) · 5 分钟阅读_

![按任务风险、上下文与模型验收检查整理的 Claude Code 工作负载路由表](https://keeprouter.com/editorial/blog/cut-claude-code-costs.png)

_衡量完整编码任务，包括上下文、重试与复核。示意图，不代表实测节省。_

Aider 可通过 `OPENAI_API_BASE`、`OPENAI_API_KEY` 和带 `openai/` 前缀的模型参数连接兼容服务。这个前缀用于选择客户端集成，不一定是服务端模型 ID 的一部分。先在测试仓库检查真实文件修改，不能只看聊天回复。

## 配置目标服务

[Aider 兼容 API 文档](https://aider.chat/docs/llms/openai-compat.html)说明了基础地址与模型前缀。按官方方式安装后，在独立环境中配置。下面假设 Key 和型号已通过安全方式放进环境：

```bash
export OPENAI_API_BASE=https://keeprouter.com/v1
export OPENAI_API_KEY="$KEEPROUTER_API_KEY"
aider --model "openai/$KEEPROUTER_MODEL"
```

从[实时目录](/models)选择 `KEEPROUTER_MODEL`。不要把另一个 Router 的型号前缀直接拼到 KeepRouter ID 上。[API Key 说明](https://aider.chat/docs/config/api-keys.html)列出了支持的凭证保存方式。含真实凭证的配置不进入 Git，也不发到问题报告里。

## 模型警告需要理解，而不是隐藏

自定义 ID 可能没有已知价格、上下文或编辑配置。[官方警告说明](https://aider.chat/docs/llms/warnings.html)区分模型元数据与行为设置。警告不一定表示 API 不通，但忽略它可能使估算失真。

| 信息 | 用途 | 应使用的依据 |
| --- | --- | --- |
| 上下文 | 控制可发送内容 | 具体型号线路限制 |
| 输入、输出价格 | 费用估算 | 当前服务价格及单位 |
| 编辑格式 | 解释模型提出的修改 | Aider 支持的设置 |
| 推理参数 | 控制请求行为 | 型号和端点共同支持 |

不要编一个上下文数值消除提示。手工填写价格时特别确认单位是每 token 还是每百万 token；账单核对仍以实际 API 费用为准。

## 用同时包含正例和反例的任务

在小项目的独立分支中，只提供相关代码和测试：

```text
解析器读取逗号分隔的整数。
增加每个数值两侧空白的支持。
空元素仍然无效："1,,2" 必须失败。
只改解析器与对应测试。
先解释预期，再提出修改。
```

这比“改进解析器”更容易验收。检查模型有没有在去掉空白时顺便允许空元素，或者改变原有错误语义。独立运行测试，保存真实 diff 和运行结果。

## 区分 API 错误与编辑错误

认证、型号不存在时先修连接。收到文本却应用不了补丁时，再检查编辑格式和模型响应。重复提交同一个格式错误只会增加调用。

模型可能写对代码，却没有按客户端需要的形式表达补丁；也可能补丁成功应用但行为错误。两类结果分开记录，才能判断是客户端配置还是模型质量问题。

先提供必要源文件、测试与依赖接口。整仓库输入可能增加费用和干扰，过少上下文又会使模型猜测接口。应围绕指定修改控制范围。

## 比较完整尝试的成本

例如用六个小修改做起步样本，记录合格补丁、应用失败、修正次数、总费用与人工审核时间。六个任务不足以形成性能排名，困难案例仍需重复检查。

不同候选保持仓库版本和任务文本一致，不能让后一个模型直接继承前一个模型的分析。辅助模型调用同样计入成本。

可参考[代码任务成本方法](/zh/blog/cut-claude-code-costs)，并使用[计算器](/tools/api-cost-calculator)估算预算。免费文本连接成功只说明基本访问可用，付费代码型号仍需通过真实的小编辑任务。

## 常见问题

### openai/ 是 KeepRouter 型号的一部分吗？

它在 Aider 命令中用于选择集成。前缀后填写目标目录 ID，不能默认原始 API 请求也需要该前缀。

### 未知模型价格警告能忽略吗？

可以与连通性测试分开处理，但不能相信缺少元数据的估算。按文档配置，并核对实际服务费用。

### Aider 回复了代码但没有修改文件怎么办？

检查编辑格式、模型设置和实际响应。文字回答不等于补丁应用，要查看文件 diff 与测试结果。

## 参考的一手资料

_本文最近复核 2026-09-29_

1. [Aider compatible endpoints](https://aider.chat/docs/llms/openai-compat.html)
2. [Aider model warnings](https://aider.chat/docs/llms/warnings.html)
3. [Aider key configuration](https://aider.chat/docs/config/api-keys.html)

## 继续阅读

- [Cline 接入 OpenAI 兼容 API：模型、工具与费用](https://keeprouter.com/zh/blog/cline-openai-compatible-api.md)
- [Continue API 配置：分清聊天与自动补全角色](https://keeprouter.com/zh/blog/continue-chat-autocomplete-models.md)
- [不用静态价格快照，比较 Claude Code 模型成本](https://keeprouter.com/zh/blog/cut-claude-code-costs.md)

## 找到适合任务的模型

选择服务或编写接入代码前，先确认型号可用性、输入类型与计价单位。

[比较模型与价格](https://keeprouter.com/models)

[创建 Key，测试免费模型](https://keeprouter.com/login?returnTo=%2Fconsole%2Fkeys%3Fmodel%3Dfree)

免费测试使用 free 模型；其他付费型号需要足够预付额度。

[全部文章](https://keeprouter.com/zh/blog.md) · [模型与价格](https://keeprouter.com/models.md)