跳转到主要内容
Aider 是一款终端 AI 结对编程工具,可直接在本地代码库中完成代码修改并自动生成 Git 提交。

安装

pip install aider-chat
或使用 pipx(推荐,避免依赖冲突):
pipx install aider-chat

配置与启动

方式一:环境变量(推荐,永久生效)

echo 'export OPENAI_API_KEY="sk-your-api-key"' >> ~/.zshrc
echo 'export OPENAI_API_BASE="https://api.ephone.ai/v1"' >> ~/.zshrc
source ~/.zshrc
echo 'export OPENAI_API_KEY="sk-your-api-key"' >> ~/.bashrc
echo 'export OPENAI_API_BASE="https://api.ephone.ai/v1"' >> ~/.bashrc
source ~/.bashrc
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-your-api-key", "User")
[Environment]::SetEnvironmentVariable("OPENAI_API_BASE", "https://api.ephone.ai/v1", "User")
设置环境变量后,进入项目目录启动:
cd your-project
aider --model gpt-4o

方式二:命令行参数(单次使用)

aider \
  --openai-api-key sk-your-api-key \
  --openai-api-base https://api.ephone.ai/v1 \
  --model gpt-4o

使用 Anthropic 模型

# 设置环境变量
export ANTHROPIC_API_KEY="sk-your-api-key"
export ANTHROPIC_BASE_URL="https://api.ephone.ai/anthropic"

# 启动
aider --model claude-opus-4-5-20251101

使用 .aider.conf.yml 配置文件

在项目根目录创建 .aider.conf.yml,避免每次手动传参:
openai-api-key: sk-your-api-key
openai-api-base: https://api.ephone.ai/v1
model: gpt-4o

常用命令

启动后,在 Aider 交互界面中可使用以下命令:
命令说明
/add <文件>将文件加入当前编辑上下文
/drop <文件>从上下文中移除文件
/diff查看当前会话产生的所有代码变更
/undo撤销最近一次 AI 做出的 Git 提交
/commit提交当前变更
/model <模型名>切换模型
/exit退出 Aider

推荐模型

场景推荐模型
通用编程gpt-4o
复杂重构claude-opus-4-5-20251101
快速迭代gpt-4o-mini
Aider 默认会将所有修改自动提交到 Git,建议在干净的 Git 状态下使用,方便通过 /undo 回滚。