49K+ GitHub Stars

Aider:Git 原生的 AI 结对编程

49K+ GitHub Stars,每次 AI 修改自动生成 Git 提交——让代码变更可追溯、可回滚、可审查。截至 2026-10-21 核,官方最新 release 仍是 2025-08-09 的 v0.86.0,仓库最后一次提交是 2026-05-22。

更新于 2026-10-21

#Aider #AIPairProgramming #GitNative #OpenSource

什么是 Aider?

Aider 由 Paul Gauthier 开发,是一款运行在终端的 AI 结对编程工具。它最大的特色是 Git 原生——AI 的每次代码修改都会自动创建一个有意义的 Git 提交,让你随时可以 diff、回滚或 cherry-pick。

49K+
GitHub 仓库 star 数(2026-10-21 核)
100+
支持的代码语言(官方口径,2026-10-21 核)
Apache 2.0
开源许可证(2026-10-21 核)
Paul Gauthier
项目作者

核心特性

Git 原生提交

每完成一轮修改就自动生成一条 Git 提交,提交信息写明改了什么,之后随时能 diff、审查或回滚。

多文件编辑

启动时并列多个文件,或在对话里用 /add 追加;官方口径是覆盖 100+ 种代码语言,从 python 到 rust(核于 2026-09-21)。

仓库地图

它为整个仓库生成一份紧凑地图,列出关键类、函数及其类型与调用签名,不必把文件全加进对话也能理解结构(核于 2026-09-21)。

语音输入

官方提供语音模式:把要加的功能、要修的 bug、想补的测试说出来,由它落成代码改动(核于 2026-09-21)。

图片与网页

截图、参照文档或整个网页都能加进对话当视觉上下文,让改动照着你给的界面走。

可连接大多数模型

官方文档说能连大多数 LLM,本地模型与 OpenAI 兼容端点也包括在内;型号用 --model 选(核于 2026-09-21)。

安装与配置

官方快速起步命令是 python -m pip install aider-install,然后跑 aider-install;pip install aider-chat 仍然可用。

安装 aider-chat 包
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 中使用。Claude 走 Anthropic 端点(anthropic/ 前缀,https://api.qcode.cc/api),GPT 与国产模型走 OpenAI 兼容端点(openai/ 前缀,https://api.qcode.cc/openai/v1);写成 openai/claude-… 会返回 model_not_available_on_endpoint。

走 QCode 网关的配置示例
# 示例:Anthropic 端点与密钥(Claude 走 anthropic/ 前缀)
export ANTHROPIC_API_BASE="https://api.qcode.cc/api"
export ANTHROPIC_API_KEY="cr_your_qcode_key"

# 示例型号名;接 QCode 时 Claude 必须带 anthropic/ 前缀(换成 anthropic/claude-opus-5 也可,核于 2026-10-21)
aider --model anthropic/claude-sonnet-5

一把密钥多个工具

Aider 从环境变量读密钥:Anthropic 端点用 ANTHROPIC_API_BASE=https://api.qcode.cc/api 配 ANTHROPIC_API_KEY,OpenAI 兼容端点用 OPENAI_API_BASE=https://api.qcode.cc/openai/v1 配 OPENAI_API_KEY;同一把密钥也能交给 Claude Code 等客户端使用(核于 2026-10-21)。

按 token 计价

花费按每轮调用的输入与输出 token 结算,不同型号单价不同,各模型单价见 /models;机械改动交给便宜一档,复杂重构再上强档。

换型号不改代码

端点和密钥不动,改 --model 就换型号;截至 2026-10-21 核,claude-opus-4-6、claude-opus-4-8、deepseek-v4.1-flash 在 QCode 上均为可调状态,可调的 GPT 型号见 /models。

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-10-21 核)。这只覆盖客户端本身,模型调用另按 token 计量。

跑 Aider 需要自己的密钥吗?

需要,但不用单独申请:官方文档要求密钥经 ANTHROPIC_API_KEY 环境变量或 --anthropic-api-key 传入;接 OpenAI 兼容端点则设 OPENAI_API_BASE(AIDER_OPENAI_API_BASE)配 OPENAI_API_KEY,型号名写成 openai/ 加上模型名(核于 2026-10-21)。

Aider 和 Claude Code 怎么选?

想一轮一轮确认、每个改动单独提交、换型号只改 --model 的名字,就用 Aider;官方把 Claude Code 说成读代码库、改文件、跑命令的代理式工具,更适合整块任务。两者都能指向同一个网关端点(核于 2026-09-21)。

自动提交会不会把仓库弄乱?

每个改动单独一条提交,脏文件动手前先单独提交,你的编辑和它的编辑不会混在一条里;不想要可以用 --no-auto-commits 关掉(官方不推荐),已经落地的改动用 /undo 撤(核于 2026-09-21)。

一次协作的四个动作

一轮 Aider 对话通常是 4 个动作:把文件带进上下文、说清要什么、看它改并让它提交、决定接受还是撤销。

1

带入文件

启动时把文件名写在命令行里,或进对话后用 /add 添加,只带本轮要改的那几个。

2

说清需求

用自然语言说要加什么、修什么,必要时把截图或网页一并加进来;不指定文件时它会自己判断该改哪几个。

3

改动并自动提交

它给出补丁、落到文件里,随后自动生成一条带说明的提交;配了 lint 与测试的话,跑不通过它会接着修。

4

审查或撤销

先 /diff 看清这一轮改了什么,满意就继续,不满意 /undo 撤掉;改动逐条落在提交历史里,回头审查有据可查。

官方资源

本页的外部事实对照下面 4 类一手来源写,改配置前先查它们;仓库与端点数据核对于 2026-10-21。

GitHub 仓库

源码、issue、release、star 数与许可证都在 Aider-AI/aider,本页涉及仓库口径的说法以它为准:截至 2026-10-21 核,star 49,663、许可证 Apache-2.0、最新 release 仍是 2025-08-09 的 v0.86.0,仓库最后一次提交是 2026-05-22。

官方文档

安装、参数、模型接入与仓库地图都在 aider.chat 文档里讲;命令行参数的权威清单是 options 页,别照抄二手教程。

Discord 社区

官方首页直接挂着 Discord 邀请链接,用法问题在那里问;能复现的缺陷请走 GitHub issue(核于 2026-09-21)。

教程视频

文档里的教程视频页收录的是用户做的录屏,比如 architect 与 editor 双模型配合的演示,官方自己没录(核于 2026-09-21)。

立即体验 Aider + QCode.cc

以低成本在 Aider 中使用 Claude 与国产模型:按 token 计费,各模型单价见 /models。想先试几天、不想包月?已有个人套餐、额度不够的用户买加油包,没有套餐的买按量包,¥26 起买一笔额度,7 天内用完为止(人民币充值 ¥30 起)。

不确定从哪开始?

先试一周

小包 ¥26($30 额度,7 天)

每天都用

体验版 ¥63/月,比中包每 $1 约便宜一半(每天 $5 额度)