在 Aider 中使用 DeepSeek、Claude 或任何兼容 OpenAI 的模型

开始配置

1. 安装 Aider。Aider 0.86 支持 Python 3.10 到 3.12，它自带的安装程序 aider-install 会为其配置匹配的 Python。我们是在 Python 3.12 虚拟环境中使用 pip install aider-chat 安装的。

python -m pip install aider-install
aider-install

2. 用两个环境变量指向该 API,并在所有模型名前加上 openai/,Claude 的模型也一样。弱模型只负责写 commit message 和摘要，用便宜的就够了。

export OPENAI_API_BASE="https://api.zurelay.com/v1"
export OPENAI_API_KEY="zr_live_..."
aider --model openai/claude-sonnet-5-5 --weak-model openai/deepseek-v4.1-flash
# or all on DeepSeek
aider --model openai/deepseek-v4.1-flash --weak-model openai/deepseek-v4.1-flash

3. 告诉 Aider 这些模型的信息。在你的主目录中放入这两个文件，即可消除它的警告，并设置编辑格式和费用显示(见下一节)。价格为 Zurelay 当前的按 token 计价。

{
  "openai/deepseek-v4.1-flash": {
    "max_input_tokens": 1000000,
    "input_cost_per_token": 0.00000003,
    "output_cost_per_token": 0.00000012,
    "cache_read_input_token_cost": 0.00000000074,
    "litellm_provider": "openai",
    "mode": "chat"
  },
  "openai/claude-sonnet-5-5": {
    "max_input_tokens": 1000000,
    "input_cost_per_token": 0.00000079,
    "output_cost_per_token": 0.00000395,
    "cache_read_input_token_cost": 0.000000079,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

- name: openai/deepseek-v4.1-flash
  edit_format: diff
  use_repo_map: true
- name: openai/claude-sonnet-5-5
  edit_format: diff
  use_repo_map: true
  weak_model_name: openai/deepseek-v4.1-flash

4. 将配置保存在 ~/.aider.conf.yml 中，这样普通的 aider 一启动就会读取它。里面包含你的密钥，请不要提交到 git。

model: openai/claude-sonnet-5-5
weak-model: openai/deepseek-v4.1-flash
openai-api-base: https://api.zurelay.com/v1
openai-api-key: zr_live_...

Aider 对新模型的常见误判

Aider 通过完整名称查找模型，而在 0.86.2 版本中，它既不认识 openai/claude-sonnet-5-5，也不认识 openai/deepseek-v4.1-flash。如果没有上面的文件：

• 每次启动都会提示: Unknown context window size and costs, using sane defaults,然后询问是否打开文档。在元数据文件中添加一个 max_input_tokens 条目即可停止提示。
• 它使用整文件编辑格式，模型会把每个修改过的文件完整返回。文件较大时，这会消耗更多输出 token，速度也更慢。edit_format: diff则让模型只返回搜索替换块；在我们的测试中，两个模型都能顺利应用这些修改。如果某个模型的编辑总是应用失败，请对该模型改回使用whole。
• 它不显示费用。使用元数据文件中的价格后，Aider 的费用行与我们的账单一致：一次 Claude 编辑，它显示 $0.0036，Zurelay 实际计费 $0.00357。

Claude:用 openai/ 还是 anthropic/?

Aider 也可以通过 Anthropic 格式访问 Claude:--model anthropic/claude-sonnet-5-5 搭配 ANTHROPIC_API_BASE=https://api.zurelay.com(不带 /v1)，并将 ANTHROPIC_API_KEY 设为同一个密钥。这样可以正常使用，Aider 也能识别该模型。但使用 --cache-prompts 时，两次运行都只是在写入提示缓存，从未读取，每次编辑约花费 $0.0035。而通过 openai/,第二次编辑无需任何设置，就从缓存中读取了 3,682 个提示 token 中的 2,863 个，花费 $0.0025。我们会对所有模型都使用 openai/。

我们的测试花了多少钱

在一个全新的 git 仓库里对一个小型 Python 文件进行多次编辑，每次编辑都由 Aider 提交。每次编辑包含两个请求：主模型负责修改代码，DeepSeek V4.1 Flash 负责生成提交信息。Zurelay 计费如下:

Aider 自带的提示词很短，加上 repo map 大约只有 2,800 到 3,700 个 token,所以用 DeepSeek 改一天代码也只要几美分。通过 anthropic/ 进行的两次编辑不在表中。

注意事项

• Aider 的费用统计没有计入 openai/ 模型的缓存命中：它显示这次编辑花了 $0.0045,而我们实际只被收取了 $0.0025。Zurelay 的用量页面显示的才是真实费用。
• 在 Windows 上，Aider 的聊天功能需要真正的控制台。在 Git Bash 中它会输出 Can't initialize prompt toolkit: Found xterm-256color；请改用 PowerShell、命令提示符或 Windows Terminal。单次执行的 --message 在任何环境下都能运行。
• Aider 会从你的主目录、git 仓库根目录和当前目录读取 .aider.conf.yml、.aider.model.settings.yml 和 .aider.model.metadata.json。我们测试的是主目录。

与之搭配使用的模型价格

各模型厂商与 Zurelay 的每 1M token 价格:

在 2026年11月3日 上测试，使用 Aider 0.86.2,Python 3.12,系统为 Windows,对接 Zurelay 的 API。简要配置请见文档中的 Aider。Aider 官方文档:OpenAI 兼容 API和模型设置。