Aider 在 Linux 上：终端原生的编程搭档

Aider 是 OG 终端原生 AI 配对程序员——Apache-2.0、纯 Python、在「agentic loop」还是营销词之前就在为你的仓库做上下文映射，并且默认自动 git commit 自己改的东西。最新版本 v0.86.0（2025-08-09），项目进入维护期但仍能用。本文讲 2026 年 Ubuntu 上的安装路径、第一天的用法以及配置套路。

Ubuntu 22.04 / 24.04 安装

官方 Aider 安装走 aider-install——一个基于 uv 的包装器，处理 Python 3.12 隔离（Aider 还没支持 3.13）：

curl -LsSf https://astral.sh/uv/install.sh | sh
. ~/.local/bin/env

uv tool install aider-install
aider-install

这给你一个用 Python 3.12 的独立 aider-chat tool env，不用跟系统 Python 打架。验证：

aider --version

简单但被废弃的路径是 pipx install aider-chat。想要稳定的生产行为就用 aider-install——项目自己也是这么推荐的。

选模型

Aider BYOK，配合任何 OpenAI 兼容 API：

export ANTHROPIC_API_KEY=***  # Anthropic (Claude Sonnet/Haiku)
export OPENAI_API_KEY=***      # OpenAI
export GEMINI_API_KEY=***      # Google Gemini
export DEEPSEEK_API_KEY=***    # DeepSeek
ollama serve &

Aider 跨 session 在 ~/.aider.conf.yml 里记你的模型。第一次跑不写配置它会问。

自动提交工作流

这是 Aider 跟 Claude Code / OpenCode 这些最大的区别。默认情况下 Aider 每回合 stage + commit 一次，自己写 commit message。这是它的超能力也是它的地雷。

高效的第一小时：

cd ~/work/my-app
aider app/api/users.py tests/test_users.py

文件名作位置参数传进去。Aider 会：

1. 映射仓库，把指名的文件读进 context。
2. 把下一步要改的 diff 展示给你。
3. 改完，跑 git add，按上下文相关的 message 提交。

想退回整个 session？每个 commit 都是一个 revert 点。不要自动提交？aider --no-auto-commits 关掉。

值得知道的有用 flag

• --model claude-sonnet-4-2026 —— 每个 session 选模型
• --no-auto-commits —— 关闭自动提交
• --no-stream —— 接受前看完整 diff
• --map-tokens 1024 —— 调 repo-map 大小（context 紧就调小）
• --edit-format diff —— 看 diff 而非整文件重写
• --weak-model <cheap-model> —— grep 类子任务用小模型

~/.aider.conf.yml 示例：

model: claude-sonnet-4-2026
weak-model: claude-haiku-3-5-2026
auto-commits: true
edit-format: diff
map-tokens: 1024

没掉队的强项

Aider 的 repo-map 成熟——对大型 Python/JS monorepo 的理解比多数竞品好。commit message 质量是真好（因为它同时看到 diff 和仓库其他部分）。带 --files 列表的多文件编辑是行业里最干净的。

现在该对 Aider 留心的地方

维护期信号：项目差不多一年没发大版本。核心还能用——commits、diffs、repo map、LSP 感知的 lint 钩子——但 agentic-loop UX（plan-first、MCP servers、运行时子 agent）是缺的。想要这些就 OpenCode 或 Claude Code 更合适。

Aider 最好当 「diff + commit 快线」 用，专门处理你确切知道该怎么改的事情。探索型多文件重构，前面接一个规划型 agent 更省心。

组合用法

Aider + git + pre-commit 钩子一起跑挺好。钩子在 Aider 提交之后跑，任何过期 import 或 lint 失败立刻露出来。Aider 也跟 act 和 CI 合得来——推 Aider 的提交，让 CI 抓真正的错。