Aider接入教程编程 Agent

Aider 通过 OpenAI 兼容 API 使用 Claude 和 GPT

（文中价格随实时价格表更新）

简短回答

要在 Aider 中使用 APIVAI，先设置两个环境变量：OPENAI_API_BASE=https://api.apivai.com/v1，以及填入 APIVAI 密钥的 OPENAI_API_KEY；然后用带 openai/ 前缀的模型 ID 启动 Aider，例如 aider --model openai/claude-sonnet-4-6。这条 OpenAI 兼容路线用一个密钥就能同时调用 Claude 和 GPT。如果只用 Claude，也可以走 Anthropic 路线：ANTHROPIC_API_BASE=https://api.apivai.com（不带 /v1），ANTHROPIC_API_KEY 填同一个密钥，再加 --model anthropic/claude-sonnet-4-6。截至 2026-10-07，通过 APIVAI 使用 Claude Sonnet 4.6 每百万输入 / 输出 token 为 $1.04 / $5.22，官方标价为 $3.00 / $15.00。

Aider 是什么？

Aider 是一个在终端里运行的开源 AI 结对编程工具。你在 git 仓库里启动它，把文件加入对话，描述想要的修改；Aider 会直接改文件，并把结果提交到 git。Aider 通过 LiteLLM 库调用模型，因此可以使用任何 OpenAI 兼容 API，包括 APIVAI。费用按 token 从预付余额中扣除，没有订阅。

Aider 里应该选哪种接入方式？

Aider 根据模型名的前缀决定使用哪种 API 格式：

路线模型名Base URL 变量密钥变量可用模型
OpenAI 兼容（推荐）openai/<model-id>OPENAI_API_BASE=https://api.apivai.com/v1OPENAI_API_KEYClaude 和 GPT
Anthropicanthropic/<model-id>ANTHROPIC_API_BASE=https://api.apivai.comANTHROPIC_API_KEY仅 Claude

如果你希望一套配置覆盖所有模型、在 Claude 和 GPT 之间随意切换，选 OpenAI 兼容 路线。如果你主要用 Claude，并想用 Aider 的 --cache-prompts 选项，选 Anthropic 路线：它利用 Claude 的提示缓存，让重复发送的上下文（仓库地图和对话中的文件）按更便宜的缓存读取价计费。两条路线用的是同一个 APIVAI 密钥。

注意 /v1：OpenAI 的 Base URL 以 /v1 结尾，Anthropic 的 Base URL 不带 /v1，因为 LiteLLM 会自动在后面加上 /v1/messages。ANTHROPIC_API_BASE 是 LiteLLM 的环境变量，不在 Aider 自己的选项参考里，但由于 Aider 的所有模型请求都经过 LiteLLM，这个变量同样生效。两种格式的详细说明见 OpenAI 兼容 API 页面和 文档。

如何一步步配置 Aider 与 APIVAI？

第 1 步：获取 APIVAI 密钥

  1. 在 apivai.com 注册
  2. 充值余额，最低 $10，支持银行卡、加密货币、支付宝和微信支付
  3. 在 Dashboard 创建密钥（可以单独设置预算上限）并复制

第 2 步：安装 Aider

Aider 文档推荐用这个安装器：

python -m pip install aider-install
aider-install

第 3 步：设置 Base URL 和密钥

macOS 或 Linux：

export OPENAI_API_BASE=https://api.apivai.com/v1
export OPENAI_API_KEY=your-apivai-key

Windows：

setx OPENAI_API_BASE https://api.apivai.com/v1
setx OPENAI_API_KEY your-apivai-key

执行 setx 后要新开一个终端窗口：执行命令的那个窗口读不到新值。

第 4 步：在项目中启动 Aider

cd /path/to/your/project
aider --model openai/claude-sonnet-4-6 --edit-format diff

openai/ 前缀后面的模型 ID 要一字不差。想用 GPT，就用 --model openai/gpt-5.5 启动，或者在会话中用 /model openai/gpt-6-sol 切换。

为什么要加 --edit-format diff：Aider 会根据模型名选择编辑格式。遇到不认识的模型名时，它会退回到 whole 格式，让模型把每个改动的文件整份重写，输出 token 会多很多。diff 只发送改动的代码块，适合当前的 Claude 和 GPT 模型。

第 5 步（可选）：把设置写进 .env 文件

Aider 会读取主目录、git 仓库根目录和当前目录下的 .env 文件。有了这个文件，直接运行 aider 即可：

OPENAI_API_KEY=your-apivai-key
AIDER_OPENAI_API_BASE=https://api.apivai.com/v1
AIDER_MODEL=openai/claude-sonnet-4-6
AIDER_WEAK_MODEL=openai/claude-haiku-4-5
AIDER_EDIT_FORMAT=diff

弱模型（weak model）负责写提交信息和压缩对话历史，用便宜的模型可以省钱，又不影响代码质量。别把密钥提交进 git：把文件放在主目录，或者把 .env 加进 .gitignore。

另一种方式：Claude 走 Anthropic 路线

export ANTHROPIC_API_KEY=your-apivai-key
export ANTHROPIC_API_BASE=https://api.apivai.com
aider --model anthropic/claude-sonnet-4-6 --cache-prompts

Windows 下按第 3 步的方法用 setx。一定要传 --model：不传的话 Aider 会选它自己的默认模型，不一定是你想要的。

设置一览

字段值
OPENAI_API_BASE（或 AIDER_OPENAI_API_BASE）https://api.apivai.com/v1
OPENAI_API_KEY你的 APIVAI 密钥
--modelopenai/claude-sonnet-4-6
--weak-modelopenai/claude-haiku-4-5
--edit-formatdiff
ANTHROPIC_API_BASE（Anthropic 路线）https://api.apivai.com
ANTHROPIC_API_KEY（Anthropic 路线）你的 APIVAI 密钥

Aider 应该选哪个模型？

以下为 2026-10-07 每百万输入 / 输出 token 的价格。模型列表会随时间变化，请从 GET https://api.apivai.com/v1/models 或 价格页 获取 ID，不要照抄旧名称。

模型Aider --model输入输出适用场景
Claude Sonnet 4.6openai/claude-sonnet-4-6$1.04$5.22日常编码，性价比最高
Claude Sonnet 5.5openai/claude-sonnet-5-5$0.69$3.47日常编码，更新的 Sonnet
Claude Opus 5.5openai/claude-opus-5-5$1.39$6.96疑难 bug、大型重构
Claude Haiku 4.5openai/claude-haiku-4-5$0.35$1.74弱模型、小改动
GPT-5.5openai/gpt-5.5$0.77$4.56GPT 备选
GPT-6 Lunaopenai/gpt-6-luna$0.0144$0.0768非常便宜的任务

比较稳妥的默认组合是：主模型用 Claude Sonnet 4.6，弱模型用 Claude Haiku 4.5。遇到难题时，可以用 Aider 的 architect 模式，让强模型做规划、便宜的模型写修改，例如 aider --architect --model openai/claude-opus-5-5 --editor-model openai/claude-sonnet-4-6。

Aider 配合 APIVAI 要花多少钱？

Aider 每次请求都会发送仓库地图、对话中的文件和此前的全部对话。假设用 Claude Sonnet 4.6，典型请求约 15,000 输入 token、1,500 输出 token（思考 token 计入输出）：

  • 一次请求： $0.0234（官方价 $0.0675）。
  • 一个工作日 60 次请求：$1.41（官方价 $4.05）。
  • 一个月 22 个这样的工作日（1,320 次请求）：$30.93（官方价 $89.10）。

同样一个月用 Claude Haiku 4.5 约为 $10.38，用 GPT-6 Luna 约为 $0.437。想再省一些，可以用 /drop 移除不再需要的文件，用 /clear 清掉过长的历史，并在 Anthropic 路线上开启 --cache-prompts。Dashboard 会列出每次请求的 token 和费用；Claude API 价格对比 列出了所有模型与官方价格的对照。

Aider 常见错误怎么解决？

  • 401 / AuthenticationError： 密钥错误、已删除或预算用完，或者当前终端没有设置该变量。Windows 上执行 setx 后要新开窗口。
  • 404 / NotFoundError： Base URL 写错了。OPENAI_API_BASE 必须以 /v1 结尾且只出现一次（不能是 /v1/v1，也不能缺）。ANTHROPIC_API_BASE 不能带 /v1。
  • “LLM Provider NOT provided”： 模型名缺少前缀。要写 openai/claude-sonnet-4-6，而不是 claude-sonnet-4-6。
  • Model not found： 前缀后面的 ID 必须与 GET /v1/models 返回的 ID 完全一致，不能用显示名称。
  • 回复为空或被截断： 思考功能默认开启，思考 token 会占用输出上限。在 .aider.model.settings.yml（主目录或仓库根目录）里为所有模型调高上限：
- name: aider/extra_params
  extra_params:
    max_tokens: 8192
  • 429： 默认限制为每个密钥每分钟 60 次请求。稍等片刻，或联系客服提高限额。
  • “Unknown context window size and costs, using sane defaults”： 对 Aider 不认识的模型来说这个提示无害，可以用 --no-show-model-warnings 隐藏。也因为这个原因，Aider 自己显示的费用可能是 $0.00，真实数字以 Dashboard 为准。

常见问题

能在同一个 Aider 会话里同时用 Claude 和 GPT 吗？

可以。走 OpenAI 兼容路线时，一个密钥和一个 Base URL 就能覆盖两类模型；用 /model openai/gpt-5.5 或 /model openai/claude-sonnet-4-6 切换即可。

需要 Anthropic 或 OpenAI 账号吗？

不需要。只要一个 APIVAI 密钥和预付余额。没有订阅，只按实际使用的 token 付费。

Claude 走 Anthropic 路线更好吗？

它可以开启 --cache-prompts，让重复发送的仓库地图和文件更便宜。如果你还要用 GPT 模型，OpenAI 兼容路线更简单。

APIVAI 会保存我的代码吗？

不会。请求和响应的内容不记录日志，只保留模型、token 数和费用等用量数据用于计费。

这个密钥还能用在哪里？

任何支持 OpenAI 兼容或 Anthropic 接口的工具都可以，例如 VS Code 和 JetBrains 中的 Continue，或者 Claude Code（见 Claude Code 配置指南）。

创建账号，充值 $10 起，把密钥填进 Aider 即可。

准备好了吗？

30 秒获取 API 密钥，按量付费使用 Claude 和 GPT