在 Aider 中使用 Routic

将 Aider 的 AI 后端切换到 Routic,以更低的成本使用主流编程模型。

原理

Aider 支持 --openai-api-base 指向任何 OpenAI 兼容接口,也支持 --anthropic-api-base 指向 Anthropic 兼容接口。Routic 两种格式均支持。

前置条件

  • 已安装 Aider(pip install aider-installpip install aider-chat
  • 已获取 Routic 的 Base URLAPI 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

相关文档