将 Aider 与免费 LLM API 配合使用
Aider 是一款适用于终端的开源结对编程工具。它会编辑你 git 仓库中的文件并进行提交。本指南通过 FreeLLMAPI 将 Aider 连接到免费模型。文中还介绍了对免费模型很重要的 Aider 设置:编辑格式、弱模型和仓库映射大小。
代码、模型名称和目录中的实时标签以英文显示。
第 1 步:安装 FreeLLMAPI
FreeLLMAPI 是一个开源网关。它在你的电脑上通过 Docker 运行。它用一个兼容 OpenAI 的密钥汇集 45 个服务商的免费额度。
在 macOS 或 Linux 上安装
curl -fsSL https://freellmapi.co/install.sh | bash打开 http://localhost:3001。在 Keys 页面至少添加两个免费服务商的密钥。从同一页面复制你的统一密钥。
第 2 步:连接 Aider
设置命令会写入 ~/.aider.conf.yml。它会先备份现有文件。
一条命令
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key>
aider该命令写入的文件如下所示:
~/.aider.conf.yml
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"必须使用 openai/ 前缀。它告诉 Aider 将模型名称发送到兼容 OpenAI 的 API。如果要使用环境变量而不使用文件,请执行以下操作:
仅使用环境变量
export OPENAI_API_BASE=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>
aider --model openai/autoAider 会依次在你的主目录、git 仓库根目录和当前目录中查找 .aider.conf.yml。最后加载的文件优先级最高。因此,项目文件可以为某个仓库更改模型。
第 3 步:选择模型
Aider 每个请求都会发送你的文件和仓库映射。它的主要编辑循环不需要工具调用,因为它从模型的文本中读取编辑内容。更重要的是大上下文窗口和良好的指令遵循能力。下表列出了目前上下文至少为 128K 的免费模型。
| 模型 | 免费提供方 | 上下文 | 免费额度(最优惠) | 工具 | 视觉 |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 请求/分钟 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | 是 | 否 |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM 另外 1 个 | 1M | 40 请求/分钟 40 RPM | 是 | 是 |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 请求/分钟 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | 是 | 是 |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | 是 | 否 |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | 是 | 是 |
| Deepseek V4.1 Flash | APINex | 1M | 5 请求/分钟 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | 否 | 否 |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 请求/分钟 20 请求/天 250,000 令牌/分钟 ~3M | 是 | 是 |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | 是 | 是 |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 请求/分钟 50 请求/天 50 req/day account-wide (1,000 after a $10 purchase) | 是 | 是 |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 请求/分钟 50 请求/天 Shared rate limit | 是 | 否 |
| DeepSeek V4 Flash 0731 | ElectronHub, Router9 | 1M | 10,000 credits/month (~$1), shared; account-anniversary reset | 否 | 否 |
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo 另外 3 个 | 262K | 30 请求/分钟 250 请求/天 70,000 令牌/分钟 ~6M | 是 | 是 |
显示 12 个(共 184 个匹配的免费模型)。 查看所有模型.
数据来自 FreeLLMAPI 目录(版本 2026.11.19,检查于 2026-11-19)。免费额度经常变化。该目录每天检查一次。
使用 openai/auto 让路由器选择模型。使用 openai/auto:smart 优先选择智能水平最高的模型。如需固定某个模型,请使用 openai/ 加上 GET /v1/models 返回的目录 ID。
你也可以在命令行中为单次会话设置模型。以下示例对编辑使用最强的模型,对提交信息和聊天历史摘要使用快速模型:
单次会话的模型
aider --model openai/auto:smart --weak-model openai/auto:fast如需使用计划好的配置,请在 FreeLLMAPI 控制台中创建备用链,例如名为 coding 的链。然后使用 --model openai/auto:coding。未知的配置名称会返回 400 错误,因此请求不会在未经通知的情况下转到其他链。
适用于免费模型的 Aider 设置
Aider 了解知名模型的设置。像 auto 这样的网关模型是未知的,因此需要你自行设置这些值。
| 设置 | 作用 | 免费模型的建议值 |
|---|---|---|
edit-format | 模型用于发送编辑的格式:whole、diff、diff-fenced 或 udiff | 强模型使用 diff。弱模型使用 whole,因为它更简单,但会发送更多 token。 |
weak-model | 用于提交信息和聊天历史摘要的模型 | openai/auto:fast,这样小任务不会占用强模型的配额 |
map-tokens | 仓库映射的 token 数量。0 表示关闭。 | 在小型免费额度上使用 1024 或更小的值 |
architect | 一个模型负责规划修改,另一个编辑器模型负责编写编辑内容 | 可选。这会使请求数量翻倍。 |
~/.aider.conf.yml,包含免费模型的设置
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"
weak-model: "openai/auto:fast"
edit-format: diff
map-tokens: 1024如需为 Aider 提供网关模型的上下文窗口,请添加 .aider.model.metadata.json 文件。键名为完整的模型名称。Aider 会在与配置文件相同的位置查找此文件。
~/.aider.model.metadata.json
{
"openai/auto": {
"max_input_tokens": 128000,
"max_output_tokens": 8192,
"litellm_provider": "openai",
"mode": "chat"
}
}速率限制与故障转移
免费额度有每分钟和每天的限制。FreeLLMAPI 会统计每个密钥的使用量。当某个服务商返回 429 错误时,路由器会将请求发送到你的备用链中的下一个模型。Aider 不会看到该错误,并会继续运行。
- 添加四个或更多服务商的密钥。服务商越多,每日可用的请求越多。
- 只使用
/add添加你要修改的文件。每个文件都会包含在每个请求中。 - 在任务之间使用
/clear,以发送更短的聊天历史。较短的历史也能降低每分钟的 token 数。 - 使用
/drop移除不再需要的文件。
故障排除
| 问题 | 原因 | 解决方法 |
|---|---|---|
| “Model openai/auto: Unknown context window size and costs, using sane defaults.” | Aider 不认识该网关模型 | 此警告通常无害。如需消除,请添加 .aider.model.metadata.json。 |
| 编辑未能应用 | 模型未遵循编辑格式 | 使用 --edit-format whole,或换用更强的模型 |
401 “Invalid API key” | Aider 发送了不同的密钥,例如来自另一个配置文件 | 检查主目录、git 根目录和当前目录中的配置文件 |
| Aider 调用了 api.openai.com | 使用了 openai/ 前缀,但未设置 base URL | 设置 openai-api-base 或 OPENAI_API_BASE |
| “All models rate-limited after N attempts” | 所有密钥都已达到限制 | 添加更多服务商的密钥,或减少 map-tokens |
常见问题
我可以免费使用 Aider 吗?
可以。Aider 是开源软件。使用 openai-api-base 和 openai/ 模型前缀将其指向 FreeLLMAPI。网关使用免费服务商额度,因此推理费用为 $0。
如何将 Aider 与兼容 OpenAI 的 API 配合使用?
设置 OPENAI_API_BASE 和 OPENAI_API_KEY,然后运行 aider --model openai/
使用免费模型时应选择哪种编辑格式?
强模型使用 diff,因为它发送的 token 更少。如果编辑无法应用,请使用 whole。对于弱模型,它更简单,但每次都会发送完整文件。
“Unknown context window size and costs, using sane defaults”是什么意思?
Aider 不认识该模型名称,因此使用默认值。此警告通常无害。添加带有上下文窗口的 .aider.model.metadata.json 即可消除该警告。
哪个免费模型最适合 Aider?
请使用上下文窗口大且具备良好指令遵循能力的模型。本页的表格列出了目前上下文为 128K 或更大的最强免费模型。
相关指南
- 在 OpenCode 中使用免费 LLM API
- 将 Codex CLI 与免费模型配合使用
- 最佳免费编程模型 API
- 免费兼容 OpenAI 的 API Base URL
- 上下文为 100 万 token 的免费 LLM API
来源
- Aider docs: OpenAI-compatible APIs (检查于 20 November 2026)
- Aider docs: YAML config file (检查于 20 November 2026)
- Aider docs: options reference (检查于 20 November 2026)
- Aider docs: edit formats (检查于 20 November 2026)
- Aider docs: model warnings (检查于 20 November 2026)
- Aider docs: advanced model settings (检查于 20 November 2026)
- FreeLLMAPI CLI generators (检查于 20 November 2026)