Aider — AI 终端编程搭档¶

# === 方法一：pip 安装（推荐） ===
pip install aider-chat  # 安装 aider

# === 方法二：pipx 安装（隔离环境，不污染系统） ===
pipx install aider-chat  # 用 pipx 安装，自动创建独立环境

# === 方法三：uv 安装（最快） ===
uv tool install aider-chat  # 用 uv 安装，速度更快

# 验证安装
aider --version  # 查看版本号，确认安装成功

# === 方法一：环境变量（推荐） ===
# 在 ~/.bashrc 或 ~/.zshrc 中添加：
export ANTHROPIC_API_KEY="sk-ant-你的密钥"  # Anthropic Claude 的 API Key
export OPENAI_API_KEY="sk-你的密钥"  # OpenAI 的 API Key

# 让配置生效
source ~/.bashrc  # 重新加载配置文件

# === 方法二：启动时指定 ===
aider --api-key anthropic=sk-ant-你的密钥  # 直接在命令行指定

# 在项目根目录或 ~/.aider.conf.yml 创建配置文件
# ~/.aider.conf.yml

model: sonnet  # 默认使用 Claude Sonnet（最新版）
auto-commits: true  # 自动提交 Git
dark-mode: true  # 深色主题
auto-lint: true  # 自动运行代码检查
auto-test: true  # 自动运行测试

# 进入你的项目目录
cd /path/to/my-project  # 进入项目文件夹

# 启动 aider（默认使用 Claude Sonnet）
aider  # 启动 aider，它会自动索引项目

# 指定使用某个模型
aider --model sonnet  # 使用 Claude Sonnet
aider --model opus  # 使用 Claude Opus（最强但最贵）
aider --model gpt-4o  # 使用 GPT-4o
aider --model deepseek  # 使用 DeepSeek（便宜）

# 启动时指定要编辑的文件
aider app.py utils.py  # 告诉 aider 你要改哪些文件

# 启动 aider 后，直接用自然语言对话：

> 给 app.py 加一个 /health 健康检查接口
# aider 会自动修改 app.py 并创建 Git 提交

> 把所有的 print 语句换成 logging
# aider 会找到所有 print 并替换

> 这个函数有什么 bug？
# aider 会分析代码并告诉你问题在哪

# 在 aider 对话中使用的命令（以 / 开头）：
/add app.py  # 把 app.py 加入编辑范围
/add src/*.py  # 把 src 目录下所有 Python 文件加入
/drop app.py  # 从编辑范围中移除 app.py
/ls  # 查看当前编辑范围内的文件
/tokens  # 查看当前使用了多少 token
/undo  # 撤销上一次 AI 的修改
/clear  # 清除对话历史
/quit  # 退出 aider

# 启动监视模式
aider --watch  # aider 会监控你的文件变化

# 然后你在任何编辑器中写代码，加上特殊注释：
# Python 文件中：
# AI: 给这个函数加上输入验证

// JavaScript 文件中：
// AI: 把这个组件改成 TypeScript

-- SQL 文件中：
-- AI: 优化这个查询的性能

# aider 检测到标记后会自动：
# 1. 读取上下文
# 2. 执行修改
# 3. 提交 Git
# 4. 清除标记

# /architect 模式 — 先规划再执行
/architect  # 切换到架构师模式
# 输入需求后，aider 先给出计划，你确认后再修改代码

# /ask 模式 — 只问问题不改代码
/ask 这个项目用了什么设计模式？  # 只回答问题，不修改文件

# /code 模式 — 直接写代码（默认模式）
/code  # 切换回编码模式

# 启动语音模式（需要麦克风）
aider --voice  # 启动后可以用语音描述需求

# 对着麦克风说：
# "给用户模型加一个邮箱字段，加上格式验证"
# aider 会自动转成文字并执行

# 添加图片作为上下文
/add screenshot.png  # 把截图加入对话

# 然后说：
> 按照这个截图的设计实现前端页面

# 添加网页作为参考
/web https://docs.python.org/3/library/logging.html  # 把网页内容加入上下文

# 先启动 Ollama
ollama serve  # 启动 Ollama 服务

# 用 Ollama 的模型运行 aider
aider --model ollama/deepseek-coder-v2  # 使用本地 DeepSeek 模型
aider --model ollama/codellama  # 使用本地 CodeLlama 模型
# 完全离线，代码不会上传到任何服务器

# 配置自动测试命令
aider --test-cmd "pytest"  # 每次修改后自动运行 pytest
aider --lint-cmd "ruff check"  # 每次修改后自动运行 linter

# aider 会：
# 1. 修改代码
# 2. 自动运行测试
# 3. 如果测试失败，自动修复
# 4. 循环直到测试通过
# 5. 提交 Git