<!-- title: 别只盯Cursor：Aider的终端八招 -->
<!-- domain: tips-tricks -->

你可能装了 Cursor、天天开着 Claude Code，却从没碰过 **Aider**——这个在 Hacker News 反复霸榜、GitHub 高 star 的终端 AI 结对编程（pair programming）工具。它和 IDE 系工具最根本的差别只有两条：**把 git 当存档**、**把"改代码"拆成"出方案"和"动手"两个模型**。这两条差别，衍生出 8 招国内几乎没人讲过的终端暗门。今天每一招你都能在自己的终端里 30 秒内敲出来，且多数能直接砍成本或省时间。

## 为什么这值得你停下来看

国内开发者把"AI 写代码"几乎等同于"开个 IDE 窗口对话"。但海外相当一部分独立开发者和老派工程师坚持留在终端里用 Aider，理由很实在：**它的每一步操作都落在 git 上，每条命令都有明确的边界**。截至 2026 年 5 月，Aider 已迭代到 v0.86.x（v0.86.2），支持 GPT-5 系列、Grok-4、Gemini 2.5 系列，并在 v0.86.1 里加入了 `reasoning_effort` 控制。可惜它的进阶能力藏在命令行参数和斜杠命令里，官方文档是一张大表，多数人只用到 `/add` 就停了。

下面这 8 招，是从 Aider 官方命令表、官方架构博客、第三方 2026 速查表和一位开发者公开的实战笔记里挖出来的，且我特意挑了中国用户最容易错过、又最能立刻见效的。

## 招式一：`/architect` 双模型拆分——让贵模型只动嘴

这是 Aider 区别于几乎所有 IDE 工具的核心机制。打开 architect 模式后，一次任务被切成两段推理：

- **Architect 模型**（比如强推理模型）只负责"怎么解决"，输出一段方案文字；
- **Editor 模型**（可以挑便宜、快的）负责把方案翻译成可落地的代码 diff。

官方博客给出的 benchmark 很说明问题：把 o1-preview 当 Architect、DeepSeek 当 Editor，通过率冲到 **85%** 的当时 SOTA；而 Claude 3.5 Sonnet 自身做 Architect/Editor 配对，从 solo 基线 77.4% 涨到 80.5%。换句话说，**"贵模型想，便宜模型写"比单模型硬扛更强还更省**。

**操作**：进入会话后敲 `/architect`（或启动时 `aider --architect`）。它会先问你方案，回复后会弹出 `Edit the files? (Y)es/(N)o`——选 N 就能让它重想，**全程不碰你的文件**。

**适用场景**：重构、跨文件大改动、需求模糊时先要方案。把 GLM 这类国产模型通过 OpenAI 兼容接口接进来当 Editor，让贵模型只出主意，账单立刻下来一截。

## 招式二：`/think-tokens` 和 `/reasoning-effort`——给"思考"设预算上限

推理模型动不动想几千上万 token，**这笔"思考税"是隐性大头**。Aider 给了你两把闸刀：

- `/think-tokens 8k`（也支持 `0.5M`、`10.5k`，填 `0` 直接关掉思考）；
- `/reasoning-effort high`（取值 `low`/`medium`/`high` 或 0–1 的数值）。

**预期效果**：在改字符串、改样式、补日志这种不需要深思的活上，把 thinking 关到最小甚至 0，单次调用成本能掉一截；只有在啃硬骨头时再调回 high。v0.86.1 已经把 `reasoning_effort` 正式接到 GPT-5 系列上。

## 招式三：`--watch-files`——让代码里的 `AI:` 注释自动跑

这条是终端党最爱的"注释驱动开发"。开启后，Aider 会盯住文件里以 `AI:`（或 `AI!`）开头的注释，把它当作一条指令自动执行、改完代码。

**操作**：`aider --watch-files`，然后在代码里写：

```python
def calc(x, y):
    # AI: 这里加一个对负数的安全检查
    return x / y
```

保存，Aider 会"读到"这条注释并动手。对从 IDE 迁过来的人，这是最接近 inline 编辑体验的终端玩法。

## 招式四：`/voice` + `--voice-language`——终端里直接开口说话

很多人以为"声控编程"是 IDE 的专利。Aider 内置 `/voice` 录音转写，配合 `--voice-language` 传 ISO 639-1 语言码（`en`、`ja`、`fr`…）就能适配语种。

**操作**：`aider --voice-language en`，会话里敲 `/voice`，对着麦克风说"把这个函数拆成两个并加单元测试"，它转写成文字送进上下文。

**适用场景**：一边在白板前比划架构、一边口述需求；或者手不方便敲键盘时做长指令录入。

## 招式五：`/web` 抓网页 + `/copy-context` 反向桥接 Web UI

这是双向的"上下文搬运工"，省掉无脑复制粘贴：

- `/web https://某文档地址`：直接把网页抓成 Markdown 喂进会话（查 API 文档、抄示例最顺手）；
- `/copy-context`：把当前会话的完整上下文导出成 Markdown，**一键粘贴到 claude.ai 或 ChatGPT 的网页版**继续聊。

**预期效果**：终端里啃不完的难题，`/copy-context` 丢到网页版大窗口里人工接着调；反过来网页里讨论出的方案，可以再带回终端。两个世界无缝切换。

## 招式六：`/undo` + spike 模式——git 就是存档键

Aider 的每一次改动都自动生成一个 git commit，`/undo` 永远只回滚最近一次 Aider 的提交。这条机制衍生出一个海外开发者常用的 **spike（探针）模式**：**不确定某个改法行不行，就先让它改，看一眼效果，立刻 `/undo` 撤掉**，只当一次零成本的实验。

**操作**：`/diff` 看本次改动 → 不满意 `/undo` → 满意了 `/commit`。`/git log --oneline -5` 还能在不污染上下文的前提下看历史。

**适用场景**：拿不准重构方向时，先 spike 一发探路；传统开发者最爱的"每个 commit 都是可回退的工作副本"在这里是默认行为。

## 招式七：Repo map 的 token 预算——`--map-tokens` / `/map-refresh` / `.aiderignore`

Aider 用 tree-sitter 给整个代码库生成一张"地图"塞进上下文，让模型知道有哪些函数、模块可用。但地图太大也烧 token。三件套控住它：

- `--map-tokens 2048`：限定地图的 token 预算；
- `/map-refresh`：增删文件后强制重建地图（默认是增量、可能滞后）；
- `.aiderignore`：gitignore 语法，把 `node_modules/`、`*.lock`、构建产物挡在地图和编辑范围外。

**预期效果**：上下文更聚焦、token 更省，模型也不再被无关文件带偏。

## 招式八：`/tokens` 监工 + `/test` `/run` 闭环——让它自己改到自己通过

最后两把常被忽略的刀：

- `/tokens`：实时报告当前上下文吃了多少 token，快爆窗口时用 `/drop` 丢掉不再需要的文件；
- `/test` 和 `/run`（别名 `!`）：`/run <命令>` 把任意 shell 输出注入会话；`/test <命令>` 则在退出码非 0 时自动把失败信息喂回，配合 `--auto-test` 让 Aider **改完就跑测试、跑挂了自己接着修**，形成自动闭环。

**操作**：`aider --auto-test`，先 `/test pytest`，之后每次改完它自己跑、自己改，直到绿。

## 一张图看懂 Aider 的"存档式"工作流

```mermaid
flowchart TD
    A[你的指令] --> B{chat-mode}
    B -->|/code| C[单模型直接改]
    B -->|/architect| D[Architect 贵模型：只出方案]
    D --> E{Edit the files? Y/N}
    E -->|N 重想| D
    E -->|Y| F[Editor 便宜模型：落地 diff]
    C --> G[自动 git commit]
    F --> G
    G --> H{效果对吗?}
    H -->|不对 /undo 秒回滚| D
    H -->|对 /commit 留存档| I[继续下一招]
```

## 信息差总结：你知道的 vs 别人没告诉你的

| 维度 | 多数人的认知 | Aider 的暗门 |
|------|------------|-------------|
| 改代码流程 | 一个模型干所有事 | `/architect` 双模型，贵模型只规划 |
| 版本安全 | 怕改坏不敢动 | 每次改动自动 commit，`/undo` 秒回 |
| 思考成本 | 模型想多久想多久 | `/think-tokens` 设上限，`0` 直接关 |
| 抓资料 | 手动复制粘贴 | `/web` 抓网页进上下文 |
| 跨端协作 | 终端与网页版割裂 | `/copy-context` 一键导出到 Web UI |
| 实验成本 | 试错要小心 | spike：改完看一眼再 `/undo` |
| 上下文透明 | 不知道还剩多少 | `/tokens` 实时盯，`/drop` 释放 |
| 注释 | 注释只是给人看 | `--watch-files` 让 `AI:` 注释自动跑 |

## 行动指南（今晚就能试）

1. `pip install aider-chat`，配置 `.env` 写入 API Key；
2. `cd` 进任意 git 仓库，`aider --architect` 起一个会话；
3. 依次敲 `/tokens`、`/map`、`/diff`、`/undo`、`/voice`，亲手感受一遍；
4. 在项目根目录建 `.aider.conf.yml` 固化常用配置，建 `.aiderignore` 排除噪声；
5. 想压成本：把贵模型设为 Architect，GLM 等 OpenAI 兼容模型设为 Editor，用 `/think-tokens` 关掉小活的思考。

Aider 不是要取代你的 Cursor 或 Claude Code，而是补上"**终端 + git 存档 + 双模型拆分**"这条国内被严重低估的路。会用 `/architect` 和 `/undo` 这两招，你就已经走在 90% 的用户前面了。

## 参考来源

- Aider 官方 in-chat 命令表（含 `/think-tokens`、`/reasoning-effort`、`/copy-context`）：https://aider.chat/docs/usage/commands.html
- Aider 官方博客：Separating code reasoning and editing（Architect/Editor benchmark）：https://aider.chat/2024/09/26/architect.html
- Aider Chat modes 文档（code/ask/architect/help）：https://aider.chat/docs/usage/modes.html
- Aider Cheat Sheet 2026（v0.86.x，2026-05-22 更新，77 条命令与 CLI flag）：https://toolsbase.dev/en/reference/aider-commands
- 实战笔记：Vibe Coding With Aider — Tips And Tricks（Mitchell A. Gordon）：https://mitchgordon.me/tools/2025/02/26/aider.html
> 本文由「51学通信」技术团队出品。51学通信由通信行业18年老兵**爱卫生**（微信ID: gprshome201101）维护。
> 聚焦5G/6G核心网、3GPP标准、AI工具实战。知识星球「51学通信」提供深度技术答疑和行业洞察。
### 完成摘要

### 注意事项

- 临时研究文件（`aider_*.txt`）因安全策略未能 `rm`，无害地留在 `/home/gprshome`，可手动删除：`rm aider_cmds.txt aider_architect.txt aider_cheatsheet.txt aider_vibe.txt`。
- 文中"GLM 可作 Editor"的提法基于 Aider 支持 OpenAI 兼容接口这一通用事实，具体接入参数请以智谱官方文档为准。

> [!tip] 51学通信知识星球
> **星主：爱卫生**（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。
> **星球定位**：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。
> **当前规模**：5200 篇主题 / 990 个回答，198 元/年。
> **加入福利**：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。
> **AI 加持**：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。

![51学通信知识星球海报-扫码加入](https://wiki.500nian.com/images/zhixingqiu_qrcode.png)
