Aider 教程：终端 AI 编程助手接国产模型（2026）
发布于 2026年9月8日
Aider 是最早一批、也是至今口碑最稳的开源终端 AI 编程助手：你在命令行里用自然语言下达需求，它读你的代码库、跨文件改代码，改完还自动帮你 Git 提交，出问题一条命令就能回滚。它不像 Cursor、Trae 那样是完整 IDE，而是像 Claude Code、Codex CLI 一样「住在终端里」，胜在轻、快、模型自由——想接 DeepSeek、GLM、Kimi 等国产模型只要几个环境变量。这篇 Aider 教程带你从安装、接国产模型，到 architect 架构模式和常用命令一次跑通。
Aider 是什么
Aider 是一个开源、免费的命令行 AI 结对编程工具（AI pair programming in your terminal）。它最大的特点有三个：一是深度绑定 Git——每次让 AI 改动代码都会自动生成一次提交，历史清晰、可随时回滚；二是「仓库地图」（repo map），它会扫描整个项目结构，让 AI 在改一处代码时也理解上下文；三是模型自由，底层通过 LiteLLM 兼容几乎所有主流大模型，既能用 Claude、GPT，也能接 DeepSeek、GLM、Kimi 等国产模型。它和 Claude Code、Codex CLI 属于同一类「终端 agentic 编程工具」，但更轻量、更聚焦「改代码」这件事本身。
一句话定位
Aider = 住在终端里的 AI 结对程序员。开源免费、自动 Git 提交可回滚、模型随便换，适合喜欢命令行、想低成本接国产模型跑真实项目的开发者。
安装：三种方式任选
Aider 用 Python 分发，官方要求 Python 3.8 到 3.13。推荐用官方的 aider-install，它会把 Aider 装进独立的 Python 环境，避免污染你系统里的其它包（必要时它还会自带一份 Python 3.12）。下面三种方式任选其一：
bash
# 方式一：官方推荐，装进独立环境
python -m pip install aider-install
aider-install
# 方式二：用 uv（更快，自带指定 Python 版本）
uv tool install --force --python python3.12 --with pip aider-chat@latest
# 方式三：用 pipx（Python 3.9-3.12）
pipx install aider-chat
# 装好后，进到你的项目目录启动
cd /path/to/your/project
aider接 DeepSeek：最省事的国产选择
DeepSeek 是接 Aider 最顺的国产模型——Aider 内置了它的别名，不用填 base URL，只要一个 API Key。DeepSeek Chat 在 Aider 官方的代码编辑基准上分数一直很高，性价比也好，是国内跑 Aider 的首选。先到 DeepSeek 开放平台申请 API Key，然后：
bash
# Mac/Linux 设置环境变量
export DEEPSEEK_API_KEY=你的_DeepSeek_密钥
# Windows（PowerShell 用 setx，设置后需重开终端）
setx DEEPSEEK_API_KEY 你的_DeepSeek_密钥
# 进项目目录，指定 deepseek 模型启动
cd /path/to/your/project
aider --model deepseek/deepseek-chat接 GLM / Kimi 等 OpenAI 兼容网关
智谱 GLM、月之暗面 Kimi（Moonshot）等大多提供「OpenAI 兼容」接口。这类模型统一走 Aider 的 OpenAI 兼容通道：设两个环境变量——OPENAI_API_BASE 指向厂商网关地址，OPENAI_API_KEY 填对应密钥，再用 openai/ 前缀指定模型名即可。
bash
# 以智谱 GLM 为例（网关与模型名以官方文档为准）
export OPENAI_API_BASE=https://open.bigmodel.cn/api/paas/v4
export OPENAI_API_KEY=你的_GLM_密钥
aider --model openai/glm-4.6
# 以 Kimi / Moonshot 为例
export OPENAI_API_BASE=https://api.moonshot.cn/v1
export OPENAI_API_KEY=你的_Kimi_密钥
aider --model openai/kimi-k2
# 也可以把这些写进项目根目录的 .env 文件，Aider 会自动读取网关地址和模型名会变，以官方为准
上面的 base URL 和模型名（glm-4.6、kimi-k2 等）只是示例。各厂商的接口地址、模型版本号迭代很快，配置前请以对应厂商开放平台的最新文档为准；模型名填错会直接报「model not found」。用第三方中转时也要评估其可信度，别把密钥泄露出去。
Aider 的核心能力
- 自动 Git 提交：每次 AI 改动都自成一次 commit，改坏了用 /undo 一键撤销，安全感拉满。
- 仓库地图（repo map）：自动扫描项目结构，让 AI 改局部时也懂全局，不用手动喂一堆文件。
- /add 与 /drop：把要改的文件加进/移出会话上下文，精准控制 AI 能看到什么、省 token。
- /run：直接跑命令（如测试），并把输出喂回给 AI 让它据此修 bug。
- /web：抓取一个网页内容作为上下文，比如把报错对应的文档丢给它。
- --watch-files：监听代码里写的 AI! 注释指令，你在编辑器里写需求，Aider 自动接手。
- 语音输入 /voice、多模态贴图等能力，具体取决于你接的模型是否支持。
architect 架构模式：规划与写码分离
面对稍复杂的改动，Aider 的 architect 模式很好用：让一个「架构模型」先想清楚怎么改（出方案），再让一个「编辑模型」负责把方案落成具体代码。这样既借用强推理模型的思考力，又用便宜快速的模型干体力活，兼顾质量和成本。
bash
# 用推理型模型做架构、用快模型做编辑（模型名按需替换）
aider --architect \
--model deepseek/deepseek-reasoner \
--editor-model deepseek/deepseek-chat
# 也可以进入会话后随时用命令切换
# /architect 切到架构模式
# /code 切回直接写码模式常用斜杠命令速查
| 命令 | 作用 |
|---|---|
| /add 文件 | 把文件加入会话，让 AI 能读能改 |
| /drop 文件 | 把文件移出会话上下文，省 token |
| /undo | 撤销 Aider 上一次的改动和提交 |
| /diff | 查看最近一次改动的 diff |
| /run 命令 | 执行命令并把输出喂回 AI（如跑测试） |
| /architect | 切换到「先规划后写码」的架构模式 |
| /model 名称 | 会话中途切换所用模型 |
| /help | 查看全部命令 |
和 Claude Code、Cursor 怎么比
Cursor 是完整 IDE，适合喜欢图形界面、要补全和聊天一体的人；Claude Code 是终端 agent，agentic 能力强、生态成熟，但模型绑定 Anthropic（国内需接第三方网关）。Aider 的差异点在于：它是纯开源、纯命令行，模型完全自由、天然亲和国产 API，而且「自动 Git 提交 + 一键回滚」这套工作流对谨慎的工程师特别友好。三者不冲突，可按任务和预算混用——想了解 Claude Code 怎么接国产模型、Cursor 之外还有哪些国产平替 CLI，站内都有对应教程。
Aider 把「在终端里低成本用上 AI 结对编程」做到了极致，接国产模型也只是几行环境变量的事。但工具越顺手，越考验你会不会拆需求、审代码、把 AI 的产出稳定用进真实项目——这才是真正拉开差距的地方。想系统掌握用 AI 工具做出能交付产品的方法，欢迎来 IMAI 看看我们的体系化实战课程。
想系统学会用 AI 编程,从入门到做出真实产品?
查看系统课程