Aider

Aider 快速入门

AI 编程领域的”老牌劲旅”——终端里跑的 AI 结对编程伙伴，自动映射代码库、Git 原生提交，39k+ Stars 见证了它的实力。

这是什么？适合谁？

Aider 是一个开源的 AI 结对编程工具，运行在终端中。它由 Paul Gauthier 创建，自 2023 年起持续更新，是 AI 编码工具领域的先驱之一。核心能力：你把 Aider 指向一个 Git 仓库，它读取整个代码库的映射，然后你可以用自然语言让它修改代码。每次修改后 Aider 自动 Git 提交，让你可以随时回滚。

Aider 的差异化定位是终端原生 + Git 深度集成。它不依赖任何 IDE，直接在终端里工作，特别适合喜欢命令行的开发者。支持 100+ 编程语言，可以接入任何 LLM（Claude、GPT、DeepSeek、Gemini、本地 Ollama 等），并且自动生成有意义的 Git 提交信息。

**适合谁？**三类人最受益：一是终端爱好者，喜欢在命令行里完成一切开发工作；二是需要批量修改代码的场景（如全局重命名、API 迁移），Aider 的代码库映射能力让它能准确定位所有需要修改的位置；三是需要 AI 编程但不想装 IDE 插件的开发者，pip install aider 一条命令即可开始。

注意：Aider 没有 GUI，所有交互都在终端中。如果你习惯 IDE 的可视化 diff 和文件树，Cline 或 Cursor 可能更舒适。

准备工作

• 设备要求：Python 3.8+，Git 2.0+
• 账号要求：至少一个 LLM 提供商 API Key
• 付费要求：Aider 本身免费开源（Apache 2.0），LLM API 按量付费。推荐 Claude API 或 DeepSeek API
• 可选准备：安装 tree-sitter 以获得更好的代码库分析

3 步快速上手

第 1 步：安装 Aider

pip install aider-chat
# 或使用 pipx 隔离安装
pipx install aider-chat

第 2 步：配置 LLM

# 配置 Claude（推荐）
export ANTHROPIC_API_KEY="your-key-here"

# 或配置 DeepSeek
export DEEPSEEK_API_KEY="your-key-here"

第 3 步：跑第一个任务

进入你的项目目录，启动 Aider：

cd /path/to/your/project
aider

Aider 会分析代码库并显示文件映射。然后你可以直接输入指令：

给所有 Python 文件添加类型注解

Aider 会：

1. 扫描所有 .py 文件
2. 逐个添加类型注解
3. 每次修改后自动 Git 提交
4. 让你在应用前审查每个变更

常用指令：

• /add <file> — 添加文件到对话上下文
• /drop <file> — 移除文件
• /commit — 手动提交
• /undo — 撤销最后一次修改
• /diff — 查看当前变更

常见踩坑

踩坑 1：大型代码库首次加载慢

• 症状：aider 启动后长时间卡在”mapping repository”
• 原因：大型代码库需要较长时间生成代码映射
• 解决：使用 --map-tokens 0 禁用映射（简单任务不影响），或使用 .aiderignore 排除无关目录

踩坑 2：API 费用意外高

• 症状：用完 Aider 后发现 API 账单很高
• 原因：Aider 默认会发送较多上下文给 LLM，大型代码库消耗大
• 解决：使用 --model 切换到更便宜的模型；使用 --no-auto-commits 手动控制提交频率

踩坑 3：修改了不该修改的文件

• 症状：Aider 修改了与指令无关的文件
• 原因：代码库映射可能将相关文件也纳入上下文
• 解决：使用 /add 明确指定要修改的文件，使用 /drop 排除无关文件

踩坑 4：Git 提交历史爆炸

• 症状：Aider 每次修改都自动提交，Git 历史中出现大量小提交
• 原因：默认 --auto-commits 开启
• 解决：使用 --no-auto-commits 关闭自动提交，手动 git add 和 git commit 批量提交

常见问题 FAQ

Q1：Aider 和 Claude Code 有什么区别？

A：Aider 是模型无关的终端工具，支持任何 LLM。Claude Code 是 Anthropic 官方工具，只支持 Claude 模型。Aider 的代码库映射和 Git 集成更成熟，Claude Code 的 Agent 能力更强（支持终端命令执行、多步自主操作）。

Q2：Aider 支持哪些编程语言？

A：Aider 支持 100+ 编程语言。Python、JavaScript、TypeScript、Go、Rust、Java、C/C++ 等主流语言支持良好。小众语言取决于 LLM 的能力。

Q3：Aider 和 Cursor/Cline 怎么选？

A：如果你习惯终端且喜欢 Git 原生工作流，选 Aider。如果你需要 IDE 集成和可视化 diff，选 Cline 或 Cursor。Aider 的代码库映射能力在批量修改场景下更强。

Q4：API 费用大概多少？

A：用 Claude Sonnet 4，中等使用每天约 $1-3。用 DeepSeek V4，每天约 $0.3-1。Aider 会在每次交互后显示 token 消耗。

Q5：能否离线使用？

A：可以。配置本地 Ollama 模型后，Aider 可以完全离线运行。但本地模型在处理复杂代码任务时效果不如云端模型。

参考链接

• Aider 官网
• GitHub 仓库
• Aider 文档
• 安装指南
• LLM 排行榜