Aider:Git 原生的 AI 结对编程
49K+ GitHub Stars,每次 AI 修改自动生成 Git 提交——让代码变更可追溯、可回滚、可审查
更新于 2026-09-21
什么是 Aider?
Aider 由 Paul Gauthier 开发,是一款运行在终端的 AI 结对编程工具。它最大的特色是 Git 原生——AI 的每次代码修改都会自动创建一个有意义的 Git 提交,让你随时可以 diff、回滚或 cherry-pick。
核心特性
Git 原生提交
每完成一轮修改就自动生成一条 Git 提交,提交信息写明改了什么,之后随时能 diff、审查或回滚。
多文件编辑
启动时并列多个文件,或在对话里用 /add 追加;官方口径是覆盖 100+ 种代码语言,从 python 到 rust(核于 2026-09-21)。
仓库地图
它为整个仓库生成一份紧凑地图,列出关键类、函数及其类型与调用签名,不必把文件全加进对话也能理解结构(核于 2026-09-21)。
语音输入
官方提供语音模式:把要加的功能、要修的 bug、想补的测试说出来,由它落成代码改动(核于 2026-09-21)。
图片与网页
截图、参照文档或整个网页都能加进对话当视觉上下文,让改动照着你给的界面走。
可连接大多数模型
官方文档说能连大多数 LLM,本地模型与 OpenAI 兼容端点也包括在内;型号用 --model 选(核于 2026-09-21)。
安装与配置
几条命令即可开始使用 Aider
pip install aider-chat
export ANTHROPIC_API_KEY=your-api-key
cd your-project
aider
通过 QCode.cc 解锁 Aider + Claude 组合
QCode.cc 的 API 密钥可以同时在 Claude Code、Aider、OpenCode、Codex 中使用
# 示例:换成你自己的网关地址和密钥
export ANTHROPIC_API_BASE="https://api.qcode.cc/api"
export ANTHROPIC_API_KEY=your-qcode-api-key
# 示例型号名,换成 claude-opus-5 这类在售型号(核于 2026-09-21)
aider --model claude-sonnet-4-6
一把密钥多个工具
Aider 从环境变量读密钥,填控制台里那把即可;同一把密钥也能交给 Claude Code 等客户端使用,不必逐个工具单独申请(核于 2026-09-21)。
按 token 计价
花费按每轮调用的输入与输出 token 结算,不同型号单价不同;机械改动交给便宜一档,复杂重构再上强档。
换型号不改代码
端点和密钥不动,改 --model 就换型号;截至 2026-09-21 核,claude-opus-4-6、gpt-5.5、deepseek-v4.1-flash 在 QCode 上均为可调状态。
Aider vs Claude Code 对比
| 对比维度 | Aider | Claude Code |
|---|---|---|
| 使用方式 | 终端对话 | 代理自主推进 |
| Git 集成 | 每改即提交 | 按指令提交 |
| 模型来源 | 云端与本地 | Claude 系列 |
| 工具与扩展 | lint 与测试 | MCP 扩展 |
| 适合场景 | 改一步审一步 | 整块任务交付 |
实用技巧
4 条写在官方文档里的做法,能少烧 token,也少踩回滚的坑。
只加要改的文件
官方建议只把本轮要改的文件 /add 进对话:加多了会挤占上下文、多花 token,还容易让模型改错位置(核于 2026-09-21)。
先提交自己的改动
它动到含未提交改动的文件时,官方做法是先把这些改动单独提交一条,再落自己的修改,你的手工编辑和它的编辑分在两条历史里(核于 2026-09-21)。
每轮先看 /diff
/diff 会列出从你上一条消息以来的全部改动,确认无误再继续;这一轮不对就直接 /undo,那条改动会被撤销丢弃。
按任务挑型号
官方单列了一份擅长改代码的型号清单;机械改动和结构设计未必用同一个型号,切换只需改 --model 参数(核于 2026-09-21)。
常见问题
Aider 是开源的吗?
是。官方 FAQ 写明它开源并托管在 GitHub,许可证为 Apache 2.0(截至 2026-09-21 核)。这只覆盖客户端本身,模型调用另按 token 计量。
跑 Aider 需要自己的密钥吗?
需要。官方文档要求密钥经 ANTHROPIC_API_KEY 环境变量或 --anthropic-api-key 传入;换提供商就是换对应的端点参数,例如 --openai-api-base(核于 2026-09-21)。
Aider 和 Claude Code 怎么选?
想一轮一轮确认、每个改动单独提交、换型号只改 --model 的名字,就用 Aider;官方把 Claude Code 说成读代码库、改文件、跑命令的代理式工具,更适合整块任务。两者都能指向同一个网关端点(核于 2026-09-21)。
自动提交会不会把仓库弄乱?
每个改动单独一条提交,脏文件动手前先单独提交,你的编辑和它的编辑不会混在一条里;不想要可以用 --no-auto-commits 关掉(官方不推荐),已经落地的改动用 /undo 撤(核于 2026-09-21)。
一次协作的四个动作
一轮 Aider 对话通常是 4 个动作:把文件带进上下文、说清要什么、看它改并让它提交、决定接受还是撤销。
带入文件
启动时把文件名写在命令行里,或进对话后用 /add 添加,只带本轮要改的那几个。
说清需求
用自然语言说要加什么、修什么,必要时把截图或网页一并加进来;不指定文件时它会自己判断该改哪几个。
改动并自动提交
它给出补丁、落到文件里,随后自动生成一条带说明的提交;配了 lint 与测试的话,跑不通过它会接着修。
审查或撤销
先 /diff 看清这一轮改了什么,满意就继续,不满意 /undo 撤掉;改动逐条落在提交历史里,回头审查有据可查。
官方资源
本页的外部事实全部对照下面 4 类一手来源写,改配置前先查它们;核对于 2026-09-21。
GitHub 仓库
源码、issue、release、star 数与许可证都在 Aider-AI/aider,本页涉及仓库口径的说法以它为准(核于 2026-09-21)。
官方文档
安装、参数、模型接入与仓库地图都在 aider.chat 文档里讲;命令行参数的权威清单是 options 页,别照抄二手教程。
Discord 社区
官方首页直接挂着 Discord 邀请链接,用法问题在那里问;能复现的缺陷请走 GitHub issue(核于 2026-09-21)。
教程视频
文档里的教程视频页收录的是用户做的录屏,比如 architect 与 editor 双模型配合的演示,官方自己没录(核于 2026-09-21)。