Aider

TL;DR

来源说明：本文事实点基于 aider.chat 官方文档（modes.html / llms.html / HISTORY.html）和 GitHub 仓库归纳，命令、参数、模型列表以官方为准。

核心特性

Git 原生：每次改动 = 一次 commit

这是 Aider 与所有竞品的最大区别。其他 AI 编程工具改完文件丢给你看 diff，让你手动 stage / commit；Aider 把 git 集成到工作流里：

• 每次对话改完代码，自动 git add + git commit，commit message 由 weak-model 生成
• 想撤回上一步：/undo 或者直接 git reset
• 改坏了想从分叉点重来：git checkout <hash> 后继续 aider，对话上下文还在
• 这也是为什么官方推荐 Aider 用在 git 仓库里——非 git 目录功能受限

Architect 模式：两个模型分工

Architect 模式把"想方案"和"写代码"拆给两个模型——根据 官方 modes 文档：

• --model（architect）：负责高层方案推理。适合 o1 / o3 / DeepSeek R1 / Claude Opus 这类强推理模型
• --editor-model：负责把方案落地成具体文件 diff。适合 GPT-4o / Claude Sonnet 这类编辑能力强但推理一般的模型
• --weak-model（可选）：用来生成 commit message / 简单重构。可以指定便宜模型省钱

启动示例：

aider --architect \
  --model deepseek/deepseek-reasoner \
  --editor-model claude-3-5-sonnet-20241022 \
  --weak-model gpt-4o-mini

据 Aider 官方 benchmark，DeepSeek R1（架构师）+ Claude 3.5 Sonnet（编辑器）的 Architect 组合，比任一模型单跑高约 10%。本数据来自 aider.chat/HISTORY.html 与 pixelsham.com 的 2025-07 评测笔记。

几乎能接所有模型

Aider 官方推荐 的"最佳模型清单"：

接入方式靠 LiteLLM 适配层，OpenRouter / Bedrock / Vertex / xAI / Groq / Cohere / Azure / 私有 OpenAI 兼容端点 都支持——你能想到的 base_url，基本都行。

Repo map：上下文召回的核心机制

Aider 用 tree-sitter 解析整个 git 仓库，生成一份压缩版的 "repo map"——把符号定义、函数签名、类层级提取出来塞进 prompt。模型不需要看到所有源代码就能理解项目结构。这是 Aider 在 polyglot benchmark 上能打过很多带 Composer 的工具的关键原因。

上手 5 分钟

# 1. 安装（要 Python 3.9+）
python -m pip install -U --upgrade-strategy only-if-needed aider-chat

# 2. 进入 git 仓库
cd your-project

# 3. 设置 API key（任选其一）
export ANTHROPIC_API_KEY=sk-ant-...
export DEEPSEEK_API_KEY=sk-...
export OPENAI_API_KEY=sk-...

# 4. 启动（默认会用环境变量里第一个能识别的 key）
aider

# 或指定模型
aider --model deepseek/deepseek-chat
aider --model claude-3-5-sonnet-20241022

# 5. 在 aider 里直接用自然语言下指令
> 把 server/api/user.ts 里的 getUserById 改成支持批量查询

价格与运行成本

• Aider 本体：开源免费（Apache 2.0 协议，根据官方 GitHub 仓库 LICENSE）
• 真正的成本是模型 API key：100% 自带——这是 Aider 与 Cursor / Windsurf 最大的商业模式差异
• 单次会话典型消耗：
  • 用 Sonnet 4 改 1 个中型 PR（10-15 文件）：约 $0.5-2 美元
  • 用 DeepSeek-V3 同等任务：约 $0.05-0.2 美元
  • 用 GPT-5 reasoning：根据推理深度，可能到 $3-8

走 DeepSeek-V3 + Architect 模式 是当前性价比最高的组合，国内付款也直接。

国内使用注意事项

1. 直连 OpenAI / Anthropic 需要代理——Aider 没有内置代理设置，靠环境变量 HTTPS_PROXY
2. DeepSeek / Qwen / GLM 直连无障碍——国内付款，国内带宽，体验最好
3. 支持自定义 base_url：通过 OPENAI_API_BASE 环境变量接 国内中转 / 硅基流动 / OneAPI 都行
4. Ollama 本地模型零网络依赖——隐私场景首选，模型质量取决于本机

与同类怎么选

怎么选：

• 不想被锁在某家厂商，要随时切换 DeepSeek / Claude / GPT → Aider
• 已经买 Claude Pro / Max 订阅 → Claude Code
• 已经买 ChatGPT Plus / Pro → Codex CLI
• 习惯 VS Code 不想离开 GUI → Cline / Cursor

避坑清单

• 没在 git 仓库里跑会被警告：Aider 强烈建议你 git init 后再用，否则 /undo 不能用，自动 commit 也无意义。
• /add 之前的文件不会被 Aider 看见：和 Cursor @codebase 不同，Aider 默认只看 repo map，需要修改的文件要 /add path/to/file 显式加入对话。这是新手最容易卡住的地方。
• Architect 模式有 prompt injection 风险：根据 GitHub issue #5058（2026 年 4 月报告），如果让 architect 读取 untrusted 仓库（如 README 被人塞了攻击指令），可能被诱导让 editor 生成后门代码。建议：在 --yes 自动接受前确认 architect 输出；不要在不可信项目上开 architect mode + --yes 组合。
• --yes-always 太激进：会跳过所有确认，包括"是否要把这个文件加入 chat"——容易让 Aider 偷偷读你不想给模型看的文件。生产环境慎用。
• token 限制错误的判断不可靠：Ollama 本地模型超 context 不会报错而是静默截断，会让你以为"模型忘了我加的文件"。明确配置 num_ctx（见 DeepSeek alternative providers 一文）。
• --editor-model 比想象重要：架构师推理再强，editor 写不出合法 diff 一样白搭。优先选 Claude Sonnet 系列做 editor，不要让推理模型自己做 editor。
• 中文 commit message 默认不开：可以 aider --commit-prompt "...中文...." 或 .aider.conf.yml 配置中改。

适合 / 不适合

✅ 适合：

• 命令行重度用户、tmux / Neovim 工作流
• 多模型试用 / 比价场景（一行命令切换）
• 开源项目维护者（git 工作流原生融入）
• 想要完全离线（Ollama + 本地模型）
• 对 token 成本敏感（DeepSeek + Aider 组合极便宜）
• 跨语言项目（官方支持 100+ 语言）

❌ 不适合：

• 习惯 GUI / 不愿读命令行文档的人
• 想"一键智能"、不愿配置环境变量
• 团队协作场景（没有共享 sessions / 协作 UI）
• Windows 纯小白（虽然能跑，但 Python 环境 + git CLI 双依赖门槛高）

相关阅读

• 同类对比：Claude Code / Codex CLI / Cline
• 推理模型选择：DeepSeek R1 / GPT-5
• 协议生态：MCP / Function Calling
• 工作流：Context Engineering

来源

• 官网：https://aider.chat
• 官方文档：https://aider.chat/docs/
• Chat Modes 文档：https://aider.chat/docs/usage/modes.html
• LLM 兼容列表：https://aider.chat/docs/llms.html
• GitHub：https://github.com/Aider-AI/aider
• 发布历史：https://aider.chat/HISTORY.html
• PyPI：https://pypi.org/project/aider-chat

本卡片由 AIHO 编辑部根据官方公开资料整理。如有更新请通过 /submit 反馈。