首页 / 指南 / 将 Aider 与免费 LLM API 配合使用

将 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/auto

Aider 会依次在你的主目录、git 仓库根目录和当前目录中查找 .aider.conf.yml。最后加载的文件优先级最高。因此,项目文件可以为某个仓库更改模型。

第 3 步:选择模型

Aider 每个请求都会发送你的文件和仓库映射。它的主要编辑循环不需要工具调用,因为它从模型的文本中读取编辑内容。更重要的是大上下文窗口和良好的指令遵循能力。下表列出了目前上下文至少为 128K 的免费模型。

适用于 Aider 的免费模型:上下文 128K 以上,按智能水平排序
模型免费提供方上下文免费额度(最优惠)工具视觉
GLM 5.3APINex, UnoRouter1M5 请求/分钟
10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account
是否
GLM 5.3 FlashAPINex, BlazeAPI, NVIDIA NIM 另外 1 个1M40 请求/分钟
40 RPM
是是
Gemini 3.8 FlashAPINex, Google AI Studio1M5 请求/分钟
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
是是
Qwen3.8 Flash NextAMD Radeon Cloud, BlazeAPI, ElectronHub262KRecurring daily account allowance是否
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring credit是是
Deepseek V4.1 FlashAPINex1M5 请求/分钟
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
否否
Gemini 3.7 FlashGoogle AI Studio1M10 请求/分钟
20 请求/天
250,000 令牌/分钟
~3M
是是
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring credit是是
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 请求/分钟
50 请求/天
50 req/day account-wide (1,000 after a $10 purchase)
是是
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 请求/分钟
50 请求/天
Shared rate limit
是否
DeepSeek V4 Flash 0731ElectronHub, Router91M10,000 credits/month (~$1), shared; account-anniversary reset否否
Qwen3.8 27BBlazeAPI, ElectronHub, Gizmo 另外 3 个262K30 请求/分钟
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
通过一个密钥使用以上每一个模型。 FreeLLMAPI 是一个开源的自托管路由器。它将所有这些免费套餐放在一个兼容 OpenAI 的端点之后,并在某个套餐被限速时自动切换。 浏览目录 或 立即开始.

常见问题

我可以免费使用 Aider 吗?

可以。Aider 是开源软件。使用 openai-api-base 和 openai/ 模型前缀将其指向 FreeLLMAPI。网关使用免费服务商额度,因此推理费用为 $0。

如何将 Aider 与兼容 OpenAI 的 API 配合使用?

设置 OPENAI_API_BASE 和 OPENAI_API_KEY,然后运行 aider --model openai/。必须使用 openai/ 前缀。你也可以将相同的值写入 .aider.conf.yml。

使用免费模型时应选择哪种编辑格式?

强模型使用 diff,因为它发送的 token 更少。如果编辑无法应用,请使用 whole。对于弱模型,它更简单,但每次都会发送完整文件。

“Unknown context window size and costs, using sane defaults”是什么意思?

Aider 不认识该模型名称,因此使用默认值。此警告通常无害。添加带有上下文窗口的 .aider.model.metadata.json 即可消除该警告。

哪个免费模型最适合 Aider?

请使用上下文窗口大且具备良好指令遵循能力的模型。本页的表格列出了目前上下文为 128K 或更大的最强免费模型。

相关指南

来源

全部指南 · 浏览所有免费模型