在 Aider 中使用 Routic
将 Aider 的 AI 后端切换到 Routic,以更低的成本使用主流编程模型。
原理
Aider 支持 --openai-api-base 指向任何 OpenAI 兼容接口,也支持 --anthropic-api-base 指向 Anthropic 兼容接口。Routic 两种格式均支持。
前置条件
- 已安装 Aider(
pip install aider-install或pip install aider-chat) - 已获取 Routic 的 Base URL 和 API Key
方式一:让 AI 帮你配(最快)
告诉你的 AI Agent:
帮我配置 Aider 使用 Routic 作为 AI 后端。
把以下信息发给它:
通过配置文件(推荐):编辑 ~/.aider.conf.yml,添加以下内容:
openai-api-key: sk-YOUR_KEY_HERE
openai-api-base: https://api.routic.ai/v1
model: deepseek-v3
openai-api-base必须带/v1后缀。
或者通过环境变量(写入 ~/.bashrc 或 ~/.zshrc):
export OPENAI_API_KEY="sk-YOUR_KEY_HERE"
export OPENAI_BASE_URL="https://api.routic.ai/v1"
Agent 配好后,把 sk-YOUR_KEY_HERE 替换成你的实际密钥。
方式二:手动配置
命令行参数(快速验证)
aider \
--openai-api-key sk-YOUR_KEY_HERE \
--openai-api-base https://api.routic.ai/v1 \
--model deepseek-v3
--openai-api-base必须带/v1后缀。
配置文件(推荐持久化)
编辑 ~/.aider.conf.yml:
openai-api-key: sk-YOUR_KEY_HERE
openai-api-base: https://api.routic.ai/v1
model: deepseek-v3
之后在项目目录直接运行 aider 即可。
环境变量
export OPENAI_API_KEY="sk-YOUR_KEY_HERE"
export OPENAI_BASE_URL="https://api.routic.ai/v1"
旧版 Aider 读
OPENAI_API_BASE(无_URL),以实际版本文档为准。
使用 Anthropic 格式(Claude 模型)
export ANTHROPIC_BASE_URL="https://api.routic.ai"
aider \
--anthropic-api-key sk-YOUR_KEY_HERE \
--model claude-3-5-sonnet-20241022
ANTHROPIC_BASE_URL不带/v1,Aider 会自动拼接。
验证
aider --message "请回复 pong" --no-git
看到正常响应即成功。
选择模型
--model 的值必须与 Routic 模型目录 中的在售名称完全一致。
| 用途 | 推荐模型 |
|---|---|
| 日常编程(速度/价格平衡) | deepseek-v3 |
| 复杂推理 | deepseek-r1 |
| 快速小改 | deepseek-v3.1 |
常见问题
Model not found
模型名必须与目录完全一致,不要用简称。
响应正常但 Aider 报不支持 function call
切换到支持函数调用的模型(见模型目录的能力矩阵)。
不同项目用不同模型
在各项目根目录分别创建 .aider.conf.yml,项目级配置覆盖全局 ~/.aider.conf.yml。