工作流
Aider
在终端里和仓库结对的编码代理,Apache-2.0,支持多家模型。
Aider-AI/aider 是 Apache-2.0 的终端结对编程工具,站点在 aider.chat。它让你在仓库里指定文件,和模型一起改这些文件,并可以对接不同的模型供应商。它比新一代“全自动代理”更强调你点名要改的范围。
第一次先把地图限制在两个文件里,看生成的差异是不是你要的。确认差异以后再提交。不要让它在没人看 diff 的情况下连续改很多目录。
本页是导读,不是原文。
注意(核验日期 2026-11-15):仓库未归档。README 没有废弃或停更声明,仍按在维护的产品介绍,但最近推送停在 2026-05-22 22:02 Asia/Shanghai,约 6 个月。README 仍主推 Claude 3.7 Sonnet 和 o3-mini 等较旧型号。本次没有查到它已被 Claude Code 官方技能取代的声明。
解决什么问题
Aider-AI/aider 是在终端里和仓库结对编程的工具,站点在 aider.chat,代码库使用 Apache-2.0。你指定要改的文件,模型在这个范围内提出修改,Aider 再把改动写回仓库。它强调由你划定上下文,而不是放任一个全自动代理在整棵目录树上自行游荡。
官方说明它能连接多家模型供应商和本地模型,并会给仓库做一份代码地图,方便在较大项目里工作。它和 Git 集成很深:默认会把每次修改自动提交,并提供 /diff、/undo 等命令。第一次使用时,请把范围限制在少数文件,并亲自看 diff。
适合谁
适合习惯在终端工作、希望自己点名文件再让模型改代码的人,也适合已有测试和 linter、希望每次修改后自动跑检查的仓库。如果你主要在 Cursor 或 Claude Code 的图形界面里工作,Aider 不是同一类产品,不必为了「有代理」而同时装上。
请只在你有权修改的仓库里使用,并把密钥放进环境变量或命令行参数,不要写入对话或提交到 Git。它会改文件并可能自动提交,所以不适合在没人看 diff 时对多个目录连续动手。
怎么装
核验日期为 2026-11-16(Asia/Shanghai)。命令以官方 Installation 和仓库 README 为准。推荐入口是先安装 aider-install,再让它在独立环境中安装 Aider:
python -m pip install aider-install
aider-install官方写明:本机已有 Python 3.8–3.13 时可用上述方式起步;aider-install 会把 Aider 装进单独环境,必要时再装一个 Python 3.12。当天 PyPI 上 aider-chat 0.86.2 的 requires_python 为 >=3.10,<3.13,安装页又写 pipx 和直接 pip 可用于 3.9–3.12。这几处并不完全相同,本文并列写出,不自行统一。若用 uv,官方示例是:
uv tool install --force --python python3.12 --with pip aider-chat@latest官方不建议把系统包管理器里的 Aider 当作首选,理由是依赖常常不正确。直接 pip install -U --upgrade-strategy only-if-needed aider-chat 可以使用,但文档建议放进虚拟环境。
进入仓库后,README 仍用这些较旧的型号作为起步示例:
cd /to/your/project
# DeepSeek
aider --model deepseek --api-key deepseek=<key>
# Claude 3.7 Sonnet
aider --model sonnet --api-key anthropic=<key>
# o3-mini
aider --model o3-mini --api-key openai=<key>密钥可改用环境变量,不必每次写在命令行。可用型号以 Connecting to LLMs 为准,不要把 README 示例当成当天所有供应商的最新推荐。
一个实际例子
下面只在两个你自己指定的文件上请求一次小改动,用来确认安装、模型和 Git 集成是否可用。请在实验分支上做。本次没有实跑,因此不编造 diff 或提交说明。
- 按上一节完成
aider-install,并进入一个 Git 仓库。若目录还不是仓库,Aider 官方行为是会询问是否初始化,请先自己决定。 - 若不想每次修改都自动提交,先加上
--no-auto-commits。官方默认是自动提交,关闭方式见 Git integration。 - 明确点名两个文件后启动,例如:
aider --no-auto-commits README.md CHANGELOG.md- 在对话里发送:
Add a one-sentence project overview to README.md only if that section is missing. Do not edit CHANGELOG.md. Show the diff and wait for me to approve a commit. - 预期效果:Aider 只在你纳入的文件范围内提出修改,你能用
/diff看到变更,并在检查后再决定是否/commit。如果输出改动了未点名的文件,或在你检查前就提交,先停下来用/undo或 Git 历史恢复,再检查启动参数。
常见坑
- 未重新核验维护状况就把它当成正在积极迭代的产品。仓库未归档,README 也没有停更声明,但最近推送停在 2026-05-22 22:02(Asia/Shanghai),约 6 个月。README 仍主推 Claude 3.7 Sonnet、o3-mini 等较旧型号。最后一次推送曾把较新的 Claude 名称(含 opus 4.5)补进 Anthropic 模型列表,但首页推荐语没有改成更新的主力型号。本次没有查到它已被 Claude Code 官方技能取代的声明。
- 忽略自动提交。默认会把 Aider 的修改做成 Git 提交,并且默认跳过 pre-commit hook(
--no-verify)。若需要 hook,官方提供--git-commit-verify;不想自动提交时使用--no-auto-commits。 - 混淆 Python 版本要求。安装页、
aider-install、pipx / pip 和 PyPI 上aider-chat的requires_python并不完全一致。遇到安装失败时,以你选择的安装方式和当天 PyPI 元数据为准。 - 不限制文件地图,就让它在很多目录里连续修改。本文建议第一次先限制在两个文件,并亲自看 diff。
- 把 API 密钥写进脚本或仓库。优先使用环境变量。
- 在脏工作区里直接开跑,却没准备好它会先提交已有改动(dirty commit)。可按文档使用
--no-dirty-commits。
FAQ
Aider 还在积极维护吗?
到 2026-11-16 为止,仓库未归档,README 仍按在维护的产品介绍,但最近推送已过去约 6 个月。本次没有看到官方停用声明,也没有看到它被 Claude Code Agent Skills 取代的说明。若要跟最新模型同步,请看 LLM 文档 和发行说明,不要只依赖 README 首页的示例型号。
README 推荐的型号是不是已经过时?
首页在核验当天仍突出 Claude 3.7 Sonnet、o3-mini 等较旧型号,这与仓库约 6 个月未再推送的情况一致。最后一次提交曾扩充 Anthropic 模型名单,因此软件未必只能用这些旧名,但 README 不能当作当前推荐榜。能连哪些模型,以官方 LLM 文档为准。
怎样关闭自动提交?
启动时加上 --no-auto-commits。若还要阻止它先提交已有脏文件,使用 --no-dirty-commits。完全不用 Git 的开关是 --no-git,官方不建议,除非你有备份。详见 Git integration。
应该用哪种方式安装?
官方首选是 python -m pip install aider-install 然后 aider-install,也可用文档中的 uv、pipx 或安装脚本。直接 pip 时请用虚拟环境。系统包管理器里的版本往往依赖不正确,官方不把它当作推荐路径。
Python 版本到底要多少?
安装页写 aider-install 可在本机 Python 3.8–3.13 上起步,并可能另装 3.12;pipx 与直接 pip 写的是 3.9–3.12;当天 PyPI 上 aider-chat 0.86.2 的 requires_python 是 >=3.10,<3.13。这几处没有完全对齐。本文不自行规定唯一范围,请按你使用的安装器核对。
来源与许可
仓库 Aider-AI/aider 使用 Apache-2.0 许可。本文依据 2026-11-16 查阅的 README、安装文档、Git 集成说明 和 PyPI 元数据,用自己的话写成,供 CQBase 上下文库使用。核验当天最近推送为 2026-05-22 22:02(Asia/Shanghai)。若安装命令、模型名单或 Git 默认行为有变,以官网为准。