Aider 怎么用？终端 AI 结对编程的 5 步实操流程

Aider 怎么用？流程就 5 步：装好 Python 环境、安装 Aider、在 git 仓库里启动并把要改的文件加进对话、用自然语言提需求、最后看 diff 确认改动。它是一个跑在终端里的开源 AI 结对编程工具，工具本身免费，花钱的是你选的模型 API。

本文按下面这条线走：

• 需要提前准备什么
• 5 步跑通第一个任务
• 常用斜杠命令与省钱方案
• 常见报错怎么查

前置准备：Python 与一个模型 API Key

三样东西备齐就能开工：

• Python 3.8 到 3.13（官方安装文档给出的支持范围）
• 一个能编辑代码的模型 API Key。官方推荐 Gemini 2.5 Pro、DeepSeek R1 与 V3、Claude 3.7 Sonnet、OpenAI o3、o4-mini 与 GPT-4.1 这一档
• 一个 git 仓库。没有 git 也能跑，但会失去自动提交带来的回滚能力

把 Key 准备好之后，建议先想清楚「这次要改哪几个文件」。这个习惯会直接决定后面体验的好坏。

第 1 步：安装 Aider

官方给了好几条路，按你的环境挑一条即可，详细的命令见 Aider 安装文档。

最省事的是 aider-install，它会为 Aider 单独建一个 Python 环境，必要时自动装一个 Python 3.12：

python -m pip install aider-install
aider-install

想用官方一键脚本，macOS 与 Linux 用：

curl -LsSf https://aider.chat/install.sh | sh

Windows 用 PowerShell：

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

习惯用 uv 或 pipx 的，也可以直接装包：

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

这一步最常见的卡点是网络。包来自 PyPI，国内下载慢或超时的话，先把 pip 源和网络确认好，不要一路重试。装完如果提示找不到 aider 命令，可以改用 python -m aider 启动。

第 2 步：在项目里启动并把文件加进对话

进入你的代码目录，带上要改的文件一起启动。官方给的示例长这样：

cd /to/your/project
aider --model deepseek --api-key deepseek=<key>
aider --model sonnet --api-key anthropic=<key>
aider --model o3-mini --api-key openai=<key>

也可以直接把文件名写在命令后面：

aider src/app.py src/utils.py

被点名的文件会加入对话，Aider 能看到内容并直接改它们。已经进入界面之后再补文件，用 /add。

这里有一条硬经验：只加需要改的文件。加太多文件会让模型被无关内容干扰，也更烧 token。Aider 会通过仓库地图自动带上相关上下文，不需要你手动把依赖全塞进去。

第 3 步：提需求，让它改代码

进入 > 提示符后，直接用自然语言说需求，例如「把这个递归函数改成迭代，并补一个测试」。Aider 会给出针对目标文件的 diff，并自动把每次改动 git commit，方便你回滚。

需求写得越具体，返工越少。把「改一下登录逻辑」换成「登录失败时返回 401 而不是 500，并把错误信息写进日志」，模型的编辑命中率会明显提高。

如果一次需求太大，模型容易改一半就对不上，拆成两三步提交更稳。

第 4 步：用斜杠命令控场

Aider 的交互几乎都靠斜杠命令，常用的这些先记住就够了，完整列表见 官方命令文档。

日常最短的工作流是 /add、提需求、/diff、不满意就 /undo。上下文快满时用 /tokens 看一眼，再用 /drop 清掉不再需要的文件，比直接 /clear 丢掉全部历史更划算。

第 5 步：确认跑通并学会回滚

怎么判断真的跑通了？看四个信号：

• 输入需求后，Aider 显示了针对目标文件的 diff
• 用 /diff 能看到本轮的改动内容
• git log 里出现由 Aider 生成的提交记录
• /tokens 显示的上下文占用没有异常膨胀

Aider 官网给了一组能说明它自身成熟度的数字：GitHub 44K star、PyPI 累计 680 万次安装、每周处理 150 亿 token，另外官网标注它最近一次发布中 88% 的新代码由 Aider 自己写成。这个比例不代表你的项目也能达到同样效果，但说明它在自己的代码库上是能长期跑通的。

回滚只要一条 /undo，它撤回的是 Aider 自己做的提交，不会动你自己写的代码。

怎么省钱：免费额度与本地模型

Aider 本体开源免费，成本全在模型上。官方文档专门列了几个免费路径：

• OpenRouter 提供一批免费模型，有每日使用限制
• Google 的 Gemini 系列模型也可以直接接
• 本地模型走 Ollama，或者任何提供 OpenAI 兼容接口的服务

取舍要说清楚：免费模型和本地模型通常编辑能力弱一些，容易出现「模型说了要改但文件没变」的情况。官方也提醒，能力弱于 GPT-3.5 的模型配合 Aider 体验会明显变差。

比较稳的路径是：先用免费额度把流程跑通，再把天天要做的任务换成付费的高质量模型。想先熟悉 OpenRouter 的注册和额度，站内有一篇 Ox Alpha 的 API 接入教程 把注册到接入的步骤写得比较细；如果打算走 Gemini 这条线，Google AI Studio 的免费额度与 API 教程 可以先看额度规则。

顺带提一句，如果你更喜欢图形界面而不是终端，站内那篇 腾讯 CodeBuddy 的上手流程 走的是另一条交互路线，思路相通：都是先让模型看到你的代码，再让它改。

常见报错速查