Aider AI 编程工具指南

Aider 是一款强大的 AI 终端编程工具，支持与 Git 深度集成。本文介绍 Aider 的安装、自定义 API 配置和高效使用技巧。

Aider 是什么？

Aider 是一款开源的 AI 编程助手，运行在终端中，核心特点：

• 深度 Git 集成 — 每次修改自动提交，方便回滚
• 支持多文件编辑 — 可以同时修改多个文件完成跨文件重构
• 支持多种模型 — Claude、GPT、Gemini、本地模型均可
• 架构图理解 — 自动分析项目结构，理解代码上下文
• 终端原生 — 无需 IDE，SSH 远程开发也能用

安装 Aider

推荐安装方式

# 使用 pip 安装（推荐 Python 3.9+）
pip install aider-chat

# 或使用 pipx 安装（隔离环境）
pipx install aider-chat

# 验证安装
aider --version

macOS 用户

# 使用 Homebrew
brew install aider

配置自定义 API

方法一：环境变量

使用环境变量是最简单的配置方式：

# 使用 OpenAI 兼容接口（推荐）
export OPENAI_API_KEY="cr_xxxxxxxxxxxxxxxxxxxxxxxx"
export OPENAI_API_BASE="https://claude4u.com/v1"

# 启动 Aider 并指定模型
aider --model openai/claude-sonnet-4-20250514

方法二：配置文件

在项目根目录或 Home 目录创建 .aider.conf.yml：

# ~/.aider.conf.yml
openai-api-key: cr_xxxxxxxxxxxxxxxxxxxxxxxx
openai-api-base: https://claude4u.com/v1
model: openai/claude-sonnet-4-20250514

方法三：命令行参数

aider \
  --openai-api-key cr_xxxxxxxxxxxxxxxxxxxxxxxx \
  --openai-api-base https://claude4u.com/v1 \
  --model openai/claude-sonnet-4-20250514

Git 集成使用

Aider 最大的亮点是 Git 集成，每次 AI 修改代码后会自动创建 commit：

# 在 Git 仓库中启动 Aider
cd your-project
aider

# 添加文件到上下文
/add src/main.py src/utils.py

# 让 AI 修改代码
请在 utils.py 中添加一个日志装饰器函数

# AI 修改后自动 git commit
# 如果不满意，直接 git revert 即可

高级技巧

Architect 模式

Aider 支持 Architect 模式，使用一个强模型（如 Opus）来规划架构，使用一个快模型（如 Sonnet）来执行编码：

aider \
  --architect \
  --model openai/claude-opus-4-20250514 \
  --editor-model openai/claude-sonnet-4-20250514

仓库地图

Aider 自动构建仓库地图（repo map），帮助模型理解项目结构。对于大型项目，可以调整地图大小：

aider --map-tokens 2048

配合 Git 工作流

• 在独立分支上使用 Aider，方便 Code Review
• 使用 /undo 命令撤销上次修改
• 使用 /diff 查看当前修改
• 使用 /commit 手动触发提交

常见问题

模型调用报错 404？

模型名格式不正确。使用中转站时，确保模型名前加 openai/ 前缀。

文件修改后没有自动提交？

确认当前目录是 Git 仓库。Aider 需要在 Git 仓库中运行才能使用自动提交功能。

为什么使用 claude4u.com 配合 Aider？

• Aider 的 Architect 模式需要同时调用两个模型，中转站支持一个 Key 访问所有模型
• 编程任务 token 消耗量大，中转站按量计费更经济
• 多账户负载均衡确保长时间编码不被限流
• 支持流式传输，终端中实时显示 AI 回复