# Aider

Canonical: https://cqbase.net/zh/entry/aider
Chinese: https://cqbase.net/zh/entry/aider
English: https://cqbase.net/en/entry/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](https://github.com/Aider-AI/aider) 是在终端里和仓库结对编程的工具，站点在 [aider.chat](https://aider.chat/)，代码库使用 Apache-2.0。你指定要改的文件，模型在这个范围内提出修改，Aider 再把改动写回仓库。它强调由你划定上下文，而不是放任一个全自动代理在整棵目录树上自行游荡。

官方说明它能连接多家模型供应商和本地模型，并会给仓库做一份代码地图，方便在较大项目里工作。它和 Git 集成很深：默认会把每次修改自动提交，并提供 `/diff`、`/undo` 等命令。第一次使用时，请把范围限制在少数文件，并亲自看 diff。

## 适合谁

适合习惯在终端工作、希望自己点名文件再让模型改代码的人，也适合已有测试和 linter、希望每次修改后自动跑检查的仓库。如果你主要在 Cursor 或 Claude Code 的图形界面里工作，Aider 不是同一类产品，不必为了「有代理」而同时装上。

请只在你有权修改的仓库里使用，并把密钥放进环境变量或命令行参数，不要写入对话或提交到 Git。它会改文件并可能自动提交，所以不适合在没人看 diff 时对多个目录连续动手。

## 怎么装

核验日期为 2026-11-16（Asia/Shanghai）。命令以官方 [Installation](https://aider.chat/docs/install.html) 和仓库 README 为准。推荐入口是先安装 `aider-install`，再让它在独立环境中安装 Aider：

```bash
python -m pip install aider-install
aider-install
```

官方写明：本机已有 Python 3.8–3.13 时可用上述方式起步；`aider-install` 会把 Aider 装进单独环境，必要时再装一个 Python 3.12。当天 PyPI 上 [aider-chat](https://pypi.org/project/aider-chat/) 0.86.2 的 `requires_python` 为 `>=3.10,<3.13`，安装页又写 pipx 和直接 pip 可用于 3.9–3.12。这几处并不完全相同，本文并列写出，不自行统一。若用 uv，官方示例是：

```bash
uv tool install --force --python python3.12 --with pip aider-chat@latest
```

官方不建议把系统包管理器里的 Aider 当作首选，理由是依赖常常不正确。直接 `pip install -U --upgrade-strategy only-if-needed aider-chat` 可以使用，但文档建议放进虚拟环境。

进入仓库后，README 仍用这些较旧的型号作为起步示例：

```bash
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](https://aider.chat/docs/llms.html) 为准，不要把 README 示例当成当天所有供应商的最新推荐。

## 一个实际例子

下面只在两个你自己指定的文件上请求一次小改动，用来确认安装、模型和 Git 集成是否可用。请在实验分支上做。本次没有实跑，因此不编造 diff 或提交说明。

1. 按上一节完成 `aider-install`，并进入一个 Git 仓库。若目录还不是仓库，Aider 官方行为是会询问是否初始化，请先自己决定。
2. 若不想每次修改都自动提交，先加上 `--no-auto-commits`。官方默认是自动提交，关闭方式见 [Git integration](https://aider.chat/docs/git.html)。
3. 明确点名两个文件后启动，例如：

```bash
aider --no-auto-commits README.md CHANGELOG.md
```

4. 在对话里发送：`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.`
5. 预期效果：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 文档](https://aider.chat/docs/llms.html) 和发行说明，不要只依赖 README 首页的示例型号。

### README 推荐的型号是不是已经过时？

首页在核验当天仍突出 Claude 3.7 Sonnet、o3-mini 等较旧型号，这与仓库约 6 个月未再推送的情况一致。最后一次提交曾扩充 Anthropic 模型名单，因此软件未必只能用这些旧名，但 README 不能当作当前推荐榜。能连哪些模型，以官方 LLM 文档为准。

### 怎样关闭自动提交？

启动时加上 `--no-auto-commits`。若还要阻止它先提交已有脏文件，使用 `--no-dirty-commits`。完全不用 Git 的开关是 `--no-git`，官方不建议，除非你有备份。详见 [Git integration](https://aider.chat/docs/git.html)。

### 应该用哪种方式安装？

官方首选是 `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](https://github.com/Aider-AI/aider) 使用 Apache-2.0 许可。本文依据 2026-11-16 查阅的 README、[安装文档](https://aider.chat/docs/install.html)、[Git 集成说明](https://aider.chat/docs/git.html) 和 PyPI 元数据，用自己的话写成，供 CQBase 上下文库使用。核验当天最近推送为 2026-05-22 22:02（Asia/Shanghai）。若安装命令、模型名单或 Git 默认行为有变，以官网为准。

## 收录信息

- 作者: Aider-AI
- 许可证: Apache-2.0
- 来源: https://github.com/Aider-AI/aider
- 收录: 2026-11-15
- GitHub 星标: 50121（采集 2026-11-15）

