# Aider AI 编码

Aider 是一个基于终端的 AI 编码助手，拥有超过 39K 的 GitHub 星标。它直接在你的仓库中编辑文件，自动创建 Git 提交，并支持云 API（OpenAI、Anthropic）以及通过 Ollama 完全本地的模型。在 Clore.ai GPU 上，你可以在自己的硬件上完整运行诸如 DeepSeek-R1 32B 或 Qwen2.5-Coder-32B 等大型编码模型——私有、快速且具有成本效益。

{% hint style="success" %}
所有示例均在通过以下方式租用的 GPU 服务器上运行： [CLORE.AI 市场](https://clore.ai/marketplace).
{% endhint %}

## 主要特性

* **终端原生** — 可通过 SSH 使用，非常适合无头的 Clore.ai 服务器
* **支持 Git** — 每次更改自动提交并附带描述性消息，便于审查和回滚
* **多文件编辑** — 将多个文件添加到上下文并同时编辑它们
* **本地模型支持** — 连接到 Ollama 以实现完全私有、无 API 成本的编码
* **架构师模式** — 使用强推理模型进行规划，然后用快速模型实现
* **仓库地图** — 自动为你的代码库建立索引，以便进行上下文感知的编辑
* **Lint 与测试** — 每次编辑后运行 linter/测试，自动修复失败项
* **语音输入** — 可通过麦克风口述编码指令

## 要求

| 组件     | 最低             | 推荐             |
| ------ | -------------- | -------------- |
| GPU    | RTX 3060 12 GB | RTX 4090 24 GB |
| 显存     | 12 GB          | 24 GB          |
| 内存     | 16 GB          | 32 GB          |
| 磁盘     | 30 GB          | 60 GB          |
| Python | 3.9            | 3.11           |

**Clore.ai 价格：** RTX 4090 约 $0.5–2/天 · RTX 3090 约 $0.3–1/天 · RTX 3060 约 $0.15–0.3/天

对于仅云模型（无本地推理），不需要 GPU —— 但 Clore.ai 的 GPU 允许你本地运行 Ollama 模型以实现完全私有化。

## 快速开始

### 1. 安装 Aider

```bash
pip install aider-chat
```

### 2. 为本地模型设置 Ollama

```bash
# 安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh

# 拉取一个编码模型
ollama pull deepseek-r1:32b

# 或者为更低显存使用较小的模型
ollama pull qwen2.5-coder:7b
```

### 3. 使用本地模型启动 Aider

```bash
cd /workspace/your-project

# 通过 Ollama 使用 DeepSeek-R1 32B（大约需要 ~20 GB 显存）
aider --model ollama/deepseek-r1:32b

# 或在 RTX 3060 上使用更小的模型
aider --model ollama/qwen2.5-coder:7b
```

### 4. 开始编码

在 Aider REPL 内：

```
> /add src/main.py src/utils.py
> 为 parse_config 函数添加错误处理并为其编写单元测试
```

Aider 将会：

1. 读取这些文件并理解代码库
2. 以 diff 的形式提出更改建议
3. 将更改应用到磁盘
4. 创建带有描述性消息的 Git 提交

## 使用示例

### 架构师模式（双模型设置）

使用一个强大的模型进行推理，另一个快速模型生成代码：

```bash
# 云端架构师 + 本地编辑器
aider --architect --model ollama/deepseek-r1:32b --editor-model ollama/qwen2.5-coder:7b
```

架构师模型负责规划更改，编辑器模型负责实际编写代码——将高质量的推理与快速的实现相结合。

### 添加文件并编辑

```bash
# 将特定文件添加到聊天上下文
> /add src/api/routes.py src/models/user.py

# 请求更改
> 将用户注册端点重构为使用 async/await 并添加使用 Pydantic 的输入验证

# 添加整个目录
> /add src/tests/

# 在编辑后运行测试
> /test pytest src/tests/ -v
```

### 与云 API 一起使用

```bash
# OpenAI
export OPENAI_API_KEY=sk-...
aider --model gpt-4o

# Anthropic
export ANTHROPIC_API_KEY=sk-ant-...
aider --model claude-sonnet-4-20250514
```

### Git 集成

```bash
# 每次更改都会自动创建一个提交
git log --oneline -5
# a1b2c3d aider: 为 parse_config 添加错误处理
# d4e5f6g aider: 为 parse_config 编写单元测试
# h7i8j9k aider: 重构用户注册端点

# 撤销上一次 aider 更改
aider --undo
```

### Lint 与自动修复

```bash
# 配置 linter
aider --lint-cmd "ruff check --fix" --auto-lint

# Aider 在每次编辑后运行 linter 并自动修复问题
```

### 非交互式（脚本化）模式

```bash
# 运行单个指令并退出
aider --model ollama/deepseek-r1:32b \
  --message "为 src/utils.py 中的所有函数添加类型提示" \
  --yes  # 自动接受更改
```

## 模型推荐

| A100                  | 显存      | 性能 | 质量 | 最适合           |
| --------------------- | ------- | -- | -- | ------------- |
| deepseek-r1:32b       | \~20 GB | 中等 | 高  | 复杂重构          |
| qwen2.5-coder:32b     | \~20 GB | 中等 | 高  | 代码生成          |
| qwen2.5-coder:7b      | \~5 GB  | 快速 | 良好 | 快速编辑，RTX 3060 |
| codellama:34b         | \~20 GB | 中等 | 良好 | 遗留代码，C/C++    |
| deepseek-coder-v2:16b | \~10 GB | 快速 | 良好 | 平衡性能          |

## 提示

* **使用 `/add` 有选择地** — 仅添加 Aider 需要查看的文件。文件过多会浪费上下文 token
* **架构师模式** 对于复杂更改非常强大 — 推理模型能捕捉到编辑模型可能遗漏的边缘情况
* **`/undo`** 通过 Git 干净地还原上一次更改 — 可放心试验
* **`/diff`** 在应用前显示建议更改 — 用于审查
* **设置 `--auto-commits`** （默认）记录每次 AI 更改的完整 Git 历史
* **使用 `.aiderignore`** 用于从仓库地图中排除文件（node\_modules、.venv 等）
* **对于大型仓库**，Aider 的仓库地图可帮助模型理解代码结构 — 首次加载时让它运行
* **在编辑后运行测试** — `/test pytest` 能立即捕捉回归

## # 使用固定种子以获得一致结果

| 问题                                     | 解决方案                                                      |
| -------------------------------------- | --------------------------------------------------------- |
| Ollama 模型太慢                            | 使用更小的量化（q4\_0）或更小的模型                                      |
| `CUDA 内存不足（out of memory）` 与 Ollama 一起 | 拉取更小的模型变体或使用 `OLLAMA_NUM_GPU=0` 用于 CPU                    |
| Git 提交错误                               | 确保已安装 `git config user.email` 和 `user.name` 已设置           |
| Aider 忽略我的文件                           | 使用 `/add filename.py` 明确添加 — Aider 只会编辑已添加的文件             |
| 模型产生不佳的修改                              | 尝试更强的模型，或使用架构师模式                                          |
| 连接被拒绝（Ollama）                          | 确保 Ollama 正在运行： `ollama serve` 或 `systemctl start ollama` |
| 上下文窗口超出限制                              | 使用以下命令移除文件 `/drop`，仅保留相关文件                                |

## 资源

* [Aider GitHub](https://github.com/Aider-AI/aider)
* [Aider 文档](https://aider.chat)
* [Ollama 模型库](https://ollama.com/library)
* [CLORE.AI 市场](https://clore.ai/marketplace)