Aider AI 评测：安装教程、模型配置与 API 费用

核验日期：2026 年 10 月 16 日。 本文依据 Aider 文档、PyPI 当前发布元数据，以及各模型提供商的在线文档与价格进行核验。这是一篇基于文档的评估，包含成本测算，并非实际运行代码得出的基准测试。选择的关键在于能否灵活切换模型、控制上下文、审查变更、委派任务，以及总共消耗多少 API 用量。

Aider AI 是什么？

Aider 是一款开源程序，负责将语言模型连接到工作目录中的文件。你在终端描述要做的修改，Aider 会提供代码仓库上下文，让模型生成修改，应用这些修改，并通常将其记录到 Git 中。Git 是用于跟踪代码变更的版本控制系统。Aider 客户端在本地运行，但使用云端模型时，发送的上下文仍会传给云端。Apache 2.0 许可证覆盖的是客户端，并不附赠模型订阅，也不会让商业模型变成开源模型。

Aider AI 编程助手适合谁？

Aider 适合能够挑选相关文件、识别问题补丁，并运行项目检查的开发者。对偶尔需要改代码、只想按模型用量付费的技术型创业者，或希望在不同模型提供商之间沿用同一套编辑流程的工程师，它尤其有吸引力。

下表比较的是文档所描述的工作流，并非实测的代码准确率。Claude Code 是 Anthropic 的编程智能体；OpenAI Codex CLI 是具备审查和任务委派工具的终端智能体；Cursor 则将编辑器与本地、云端智能体结合起来。

这些只是与本文读者相关的入门选择，并非完整套餐列表，也不代表可以无限使用。Aider 没有一个用量增长后就必须升级的低价客户端套餐：实际限制来自模型提供商账号，或运行本地模型的机器。

需要更完整的终端工作流，选 Claude Code

如果需求不只是修改代码，还包括排查故障、查询外部系统、运行命令和准备拉取请求，Claude Code 更合适。它的官方概览 介绍了 Git 操作、子智能体，以及 Model Context Protocol 集成；后者用于将智能体连接到外部工具与数据。Aider 也能运行命令并利用输出，但要把这些能力组织成更完整的工作流，你需要自己做更多工作。

如果首要需求是在同一个客户端里切换 Claude、Gemini 和本地模型，就不必优先考虑 Claude Code。只有当你愿意为这套集成工作流付费时，它才有价值；只是盯着一个小补丁的开发者，可能更喜欢 Aider 的专注。Claude 免费套餐不包含 Pro 所列的 Code 使用权益。

看重审查与任务委派，选 Codex CLI

从文档来看，Codex CLI 覆盖的操作范围更广：专门的代码审查、可复用的技能、插件、子智能体、权限控制，以及将任务交给 Codex Cloud 的命令。对希望让智能体先调查代码仓库、再审查结果的创业者，这些集成功能很合适。OpenAI 的 CLI 文档 对这些能力有直接说明。

Codex 也支持 API 密钥认证，因此，仅凭“不想订阅”还不足以决定选谁。真正的区别在于这种认证方式附带哪些能力：API 密钥方式不包含通过账号使用时提供的云端功能。如果你更看重在不同模型提供商之间切换，而非集成的审查与任务交接体验，就选 Aider。

Aider vs Cursor：看你习惯在哪里工作

如果你希望智能体就在编辑器旁边，并在同一界面里完成代码搜索、终端执行和浏览器验证，Cursor 更合适。它的 Agent 文档 还区分了检查点与永久 Git 历史：检查点是用于撤销智能体修改的临时快照。如果你习惯直接通过 Git 审查变更，Aider 的自动提交会更顺手。

需要在离开笔记本电脑后继续推进任务时，Cursor Cloud Agents 提供隔离的虚拟机，以及截图、视频和日志等产物。这种运行环境并不在 Aider 的本地结对编程流程之内。Cursor 更便宜的 Plus 套餐不含云端智能体，Premium 的第三方模型用量也需额外付费。当编辑器或远程环境能够省下原本需要你自己维护的工作时，为 Cursor 付费才有意义。

如果还想按源码开放程度和部署方式比较更多选择，可以阅读开源 AI 编程智能体指南。

以 Git 为核心，让范围明确的修改更容易审查

Aider 最擅长的流程是：提出一个小改动，查看清晰的 diff，再运行测试。自动提交在普通代码仓库中留下检查点，因此，审查或撤销结果都能融入已有的开发习惯。

Aider 安装：使用专用安装器

Aider 当前的安装指南 推荐使用专用安装器：

python -m pip install aider-install
aider-install

安装器会创建独立的 Python 环境，并可为 Aider 安装 Python 3.12。这里需要区分：运行安装器的 Python，与运行应用的 Python，不必是同一个。这样可以避免将 Aider 的依赖混入你的应用环境。

PyPI 当前包版本为 0.86.2。GitHub 的 Releases 页面 仍将 0.86.0 标为最新发布条目。讨论安装器实际分发的版本时，应以软件包版本为准；这两个页面反映的发布信息不能混为一谈。

Aider 入门教程：写一个函数和配套测试

Aider 的使用指南 从阶乘程序入手，并允许指定尚不存在的文件名。下面沿用文档中的做法，增加一个测试文件，让结果有明确的验收检查。这是建议练习，并非一次已成功运行的实测记录。

对于已有应用，将示例文件换成这次改动实际需要的少量文件。“拒绝已过期的重置令牌，并补上回归测试”比“改进身份验证”更适合作为起点。前者明确告诉你，一个正确的 diff 应该证明什么。

Git 历史很有用，但要先了解自动提交行为

Aider 会自动提交自己做的修改；如果要编辑的文件中已有你尚未提交的变更，它也可能先把这些变更提交一次。这样能将人工修改与生成的修改分开，但如果你原以为所有未完成工作都会保持未提交状态，就可能感到意外。Git 文档 解释了这种行为及其控制选项。

如果更愿意自己准备最终提交，可使用 --no-auto-commits。否则，应将这些自动生成的提交视为工作过程记录，合并前仍要审查。自动提交只能证明变更已被记录，不能证明变更正确。

仓库映射帮助定位上下文，不能替代上下文

Aider 的仓库映射不必发送每个文件的完整内容，就能提供代码结构。它会突出重要的类、函数与调用签名，也就是用于说明代码如何衔接的名称和参数，再通过基于图的排序过程，为当前对话选出相关部分。Aider 文档给出的默认映射预算是 1k tokens，某些情况下会动态扩展。

以修改结账流程为例。映射可以显示支付处理程序调用了现有的税费服务，帮助模型复用该服务。但仅凭函数名称，无法确定服务如何进行舍入。如果舍入行为会影响补丁，就应提供实现代码或相关测试。

实际操作时，可以先问相关行为位于何处，检查它建议的文件，再只添加需要编辑的文件。对于只需作为参考、不应加入可编辑文件集合的资料，使用 /read-only；不再需要某个文件时，使用 /drop。这些都是文档列出的对话内命令。

这种方式让有经验的开发者能够有效控制任务范围。同时也意味着，有了仓库映射，并不等于模型已经完整理解大型仓库。映射帮助定位相关代码，实际行为仍由文件、配置、数据和测试共同决定。

自选模型，也意味着自行负责兼容性

Aider 可以连接多种托管模型和本地模型。不过，它的模型文档 也提醒：模型可能生成看似合理的代码，却无法输出 Aider 能够应用的编辑内容。“几乎任何模型”描述的是连接的灵活性，不代表代码质量相当，也不保证支持每一项新 API 功能。

Claude：指定仍可用的模型 ID，别照搬旧快捷方式

Aider 会读取 ANTHROPIC_API_KEY，其 Anthropic 配置页面 介绍了如何选择和列出模型。不过，该页面仍将 Claude 3.7 Sonnet 列为默认模型，而 Anthropic 已于 2026 年 2 月 19 日停用该模型。到了 10 月，照抄旧示例已不是可靠的配置方式。

设置好密钥后，可以通过明确指定提供商的方式，选择仍在提供服务的 Claude Sonnet 5.5：

aider --model anthropic/claude-sonnet-5-5 \
  --weak-model anthropic/claude-sonnet-5-5 \
  --edit-format diff

这里是将 Aider 文档中的提供商语法应用到 Anthropic 当前的模型 ID，并非声称兼容性已经实测。如果安装的版本缺少该模型的设置，或拒绝某个 API 参数，可通过 Aider 的高级模型配置 补充相应设置。主模型和弱模型的名称都要检查：只更新主模型，可能让辅助请求仍然指向已停用的模型。

GPT：设置 OpenAI 密钥，并明确指定模型

Aider 会读取 OPENAI_API_KEY；其 OpenAI 连接页面 介绍了 --model 和 --list-models openai/。当前的高级设置页面包含 GPT-5.5 配置，使用 diff 编辑格式并支持仓库映射：

aider --model gpt-5.5 --weak-model gpt-5.5

OpenAI 文档仍列有 GPT-5.5 的 API 访问方式。至于通过 ChatGPT 认证的 Codex 会话能否使用它，则是另一项产品决策。API 密钥与订阅账号登录是不同的计费和访问路径。下文的成本示例只采用 API 标准标价。

Gemini：带上提供商前缀

Aider 会读取 GEMINI_API_KEY。其 Gemini 配置说明 介绍了 gemini 快捷方式；明确写出模型 ID，更容易核对实际打算使用的模型：

aider --model gemini/gemini-2.5-pro \
  --weak-model gemini/gemini-2.5-pro

文档为该模型列出了 diff-fenced 配置。这里选择它，是为了给出可复现的配置，并不表示它是 Google 最新的模型，也不表示它对所有仓库都是最佳选择。

Aider 本地模型配置：连接 Ollama

Aider 的 Ollama 说明 推荐使用 ollama_chat/ 前缀。安装 Ollama 并启动服务后，可以用以下 Bash 命令选择要在本地运行的模型：

read -r -p 'Ollama model name: ' AIDER_LOCAL_MODEL
ollama pull "$AIDER_LOCAL_MODEL"
export OLLAMA_API_BASE=http://127.0.0.1:11434
aider --model "ollama_chat/$AIDER_LOCAL_MODEL" \
  --weak-model "ollama_chat/$AIDER_LOCAL_MODEL"

选择硬件能够支持的模型，并检查其上下文配置。本地推理免去了这些调用的云端 API token 费用，但硬件、电费和运维时间仍然是成本。把模型端点留在本地，与仅在本地运行 Aider 客户端，也是两回事。

对话模式与编辑格式，分别解决什么问题？

Aider 的对话模式决定交互方式，编辑格式则决定模型如何描述文件修改。混淆二者可能造成代价不小的错误：把 architect 模式当成只读规划模式，但它实际上可以修改文件。

文档列出的四种对话模式 是：

• code： 默认模式，按请求修改代码。
• ask： 用于讨论和提问，不编辑文件。
• architect： 先发起规划请求，再发起编辑请求，两步可以使用不同模型。
• help： 用于询问 Aider 的使用和配置方法。

在问题前加上 /ask，可以让这一条消息以只读方式处理。使用 /chat-mode ask 则会让后续消息持续处于该模式，直到你再次切换。面对不熟悉的计费模块，可以先讨论必须保持不变的业务约束，再用 /code 实现已确认的修改。这样，你就能在编辑开始前亲自审查方案。

当你希望将方案设计与补丁编写分开时，architect 模式会有帮助。它涉及两次模型请求，因此可能增加延迟与费用。编辑阶段选择更便宜的模型，并不意味着整个任务必然更便宜：规划请求、重复发送的上下文，以及重试，都要计入成本。

编辑格式的名称 也各有明确含义：

• whole 返回每个被修改文件的完整内容。因此，即使只改一个长文件中的很小一处，也可能生成很长的回复。
• diff 为发生变化的区域返回搜索与替换块。
• diff-fenced 使用类似格式，但将文件名放在代码围栏内；Aider 主要对 Gemini 模型采用这种格式。
• udiff 使用 Aider 简化过的统一差异格式。
• editor-diff 和 editor-whole 在 architect 模式的编辑阶段使用专门面向编辑任务的提示词。

通常应保留文档为相应模型指定的默认格式。有明确的兼容性需求时，再用 --edit-format 调整；architect 模式的编辑阶段则用 --editor-edit-format。切换格式不能代替检查生成的代码。

Aider 免费吗？API 费用怎么算？

Aider 客户端没有订阅费。使用自己的密钥时，真正有意义的数字，是得到一个通过验收的补丁所需全部请求的提供商费用。不知道上下文、输出、重试次数及所用模型，就无法给“修一个 bug”定出可信的统一价格。

为了让比较可以复现，这里使用 Aider 当前模型设置中列出的两个模型：OpenAI GPT-5.5 和 Google Gemini 2.5 Pro。它们是有文档配置的选择，并非最新模型排名。按 2026 年 10 月 16 日核验的厂商标准标价：

• GPT-5.5 每百万输入 tokens 为 $5，每百万输出 tokens 为 $30。
• 对不超过 200,000 tokens 的提示词，Gemini 2.5 Pro 每百万输入 tokens 为 $1.25，每百万输出 tokens 为 $10。其输出计费包含思考 tokens。

以下是假设的任务预算，并非实测任务成本。 每一行都汇总一次尝试中的全部请求。假设文本未命中缓存、所有调用使用同一模型、采用普通全球处理方式、不使用付费外部工具，且不计折扣和税费。即使累计用量更大，每次请求的输入也应保持在 200,000 tokens 以内。输出应统计提供商实际计费的部分，而不只是终端中可见的文字。

第一行中，GPT-5.5 的计算为 20,000 / 1,000,000 × $5 + 2,000 / 1,000,000 × $30 = $0.160。Gemini 则为 20,000 / 1,000,000 × $1.25 + 2,000 / 1,000,000 × $10 = $0.045。其余各行采用相同公式，只是累计用量更大。

按中间一档预算，每月尝试 100 次，费用分别为 $80 或 $22.50。这是预算推算，不是对能获得多少有效修改的承诺。如果提交说明使用了另一种弱模型，或 architect 模式的编辑阶段使用其他模型，就要分别计算这些调用，再加到总额中。

缓存会影响账单，单次提示词更大时也可能适用不同费率。在决定订阅还是按 API 用量付费之前，应与提供商的用量记录核对。Aider 本地显示的费用可以作为反馈，但不是最终账单。

Aider 编程助手有哪些局限？

当一次看似成功的编辑掩盖了验证缺失或计费假设错误时，Aider 的局限就尤为重要。

默认跳过提交前钩子。 Git 文档说明，除非启用 --git-commit-verify，否则 Aider 提交时会使用 --no-verify。因此，仓库中的格式检查、敏感信息检查或其他提交前规则，可能在自动提交过程中根本没有运行。如果这些规则很重要，就应启用验证，并在合并前保留独立检查。自动提交虽然方便，但这是其默认 Git 工作流的一项明确限制。

自动 lint 不等于已经配置好自动测试。 Aider 默认会对编辑过的文件做 lint 检查，但自动测试需要设置测试命令，并启用 auto-test 选项。对于上面的入门项目，可以这样启动：

aider --model gemini/gemini-2.5-pro \
  --weak-model gemini/gemini-2.5-pro \
  --git-commit-verify \
  --test-cmd 'python -m unittest -v' --auto-test \
  factorial.py test_factorial.py

在实际仓库中，应使用项目既有的测试命令。Aider 通过命令的退出状态判断是否失败。文档还提醒：格式化工具如果在修改文件后返回非零状态，可能被误判为真正的错误。反馈流程配置不当，就可能把 tokens 花在错误的修复方向上。

未知模型可能显示误导性的成本。 Aider 的模型警告页面 指出，不熟悉的模型可能被当作上下文无限、token 成本为零。这只是回退假设，并不意味着推理免费。模型元数据可以配置，但计费仍以提供商为准。对于为了控制成本而选择 Aider 的读者，这一点尤其需要留意。

上下文仍要由你筛选。 把所有文件都加进来，只会增加模型要处理的内容，并不能证明它理解了这次修改。Aider 的 token 限制指南 建议移除不必要的文件、缩小请求范围；它的计数是估算值，只会报告提供商返回的超限错误，而不会自行强制执行这些限制。仓库映射预算并不是费用上限。

本地编辑流程不等于托管任务服务。 你可以在 Aider 周围运行命令、搭建自动化，但远程环境、共享审查队列和运行管理控制仍需额外建设。只想监督一次代码修改的开发者，可以接受这种取舍；希望把调查任务交出去、让它整夜运行的创业者，则应认真考虑托管的云端工作流。

评测结论：Aider 适合你愿意亲自把关的代码修改

如果你看重不受单一模型提供商绑定，习惯在终端工作，并希望 AI 修改记录在普通 Git 历史中，Aider 是很有竞争力的选择。范围明确的维护、小功能开发，以及能够写清验收标准并审查结果的重构，都适合用它起步。

当你希望连推进整个工作流的责任也交给智能体时，选择就会改变。 看重集成的终端与外部工具体验，可选 Claude Code；看重审查与云端交接，可选 Codex；看重编辑器内工作流和托管远程智能体，可选 Cursor。如果它们省下的配置与监督工作，超过使用 Aider 灵活客户端所需的投入，付费就有意义。

下次工作时，挑一个范围集中的问题，确定验收测试，启用相关检查，并记录从开始到最终接受 diff 的全部提供商费用。如果这套流程可控又经济，就继续用 Aider；如果配置模型、管理上下文耗掉了原本想让智能体节省的时间，就换一个选择。

常见问题

订阅邮件通讯，即可获取 AI 业务工作流审查清单，并持续收到实用的工具评测。