cqbase.net · 中英双语

CQBase 上下文库

Context & Query Base

工作流

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 或提交说明。

  1. 按上一节完成 aider-install,并进入一个 Git 仓库。若目录还不是仓库,Aider 官方行为是会询问是否初始化,请先自己决定。
  2. 若不想每次修改都自动提交,先加上 --no-auto-commits。官方默认是自动提交,关闭方式见 Git integration。
  3. 明确点名两个文件后启动,例如:
aider --no-auto-commits README.md CHANGELOG.md
  1. 在对话里发送: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.
  2. 预期效果: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 默认行为有变,以官网为准。

订阅 CQBase 周刊

每周一封,介绍本周新收录的公开 AI 技能、提示词、MCP 和用法。可随时退订。我们不会把邮箱交给第三方作其营销之用。