Aider 命令速查表 - 开源终端 AI 结对编程全参数

Aider 终端 AI 结对编程命令都在这里了,从安装启动到模型切换、从文件上下文到架构模式,按场景分类整理,复制即用。

AI 命令行·共 53 条命令·最后更新 2026-08-05
返回 AI 命令行

安装与启动 5

pip install aider-chat
通过 pip 安装(或 pipx 隔离安装)
aider
在 git 仓库中启动交互式结对编程
aider src/main.py tests/test_main.py
启动并把指定文件加入会话
aider --model claude-sonnet-4-6
指定主模型
export ANTHROPIC_API_KEY="sk-ant-..."
设置 Anthropic key(也支持 OpenAI/DeepSeek/本地)

模型与推理 7

aider --model ollama/codellama
使用本地 Ollama 模型
aider --architect --model claude-opus --editor-model claude-sonnet
架构模式:规划模型 + 编辑模型双模型
aider --weak-model gpt-4o-mini
指定弱模型(用于廉价子任务)
aider --reasoning-effort high
设置推理强度(兼容模型)
aider /think-tokens 4096
设置每轮思考 token 预算
/model
会话内切换主模型
/models
搜索可用模型列表

文件与上下文 9

/add src/auth/*.py
把文件加入会话(Aider 可编辑)
/drop tests/auth/test_login.py
移出会话以节省上下文
/read-only docs/api-spec.md
只读参考,禁止编辑
/ls
列出会话中的已知文件
/reset
丢弃所有文件并清空历史
/clear
清空可见对话历史
aider --map-tokens 2048
设置仓库地图 token 预算
aider --show-repo-map
打印当前仓库地图后退出
/map-refresh
强制刷新仓库地图

聊天模式 5

/code
代码模式:直接改代码(默认)
/ask
问答模式:只讨论不编辑文件
/architect
架构模式:规划与编辑双模型流程
/chat-mode
通用聊天模式切换器
/context
进入上下文浏览模式

Git 与运行 10

/git status
在会话内运行 git 命令
/commit "实现 JWT 认证"
手动提交脏改动
/undo
撤销 Aider 上次做的 git 提交
/diff
显示最近一次改动 diff
/run pytest tests/
运行 shell 命令并把输出喂给会话(别名 !)
/test
运行配置的测试命令
/lint
运行配置的 lint 命令
aider --auto-commits
每次改动自动 git 提交
aider --lint-cmd "ruff check"
改动后自动 lint
aider --test-cmd "pytest"
改动后自动跑测试

会话与工具 11

/voice
通过 Whisper 语音输入(需 portaudio)
/web https://docs.site
抓取网页渲染文本加入会话
/paste
从剪贴板粘贴图片或文本
/copy
复制上一条助手回复到剪贴板
/copy-context
复制会话上下文为 markdown
/save /path/script.md
把当前会话保存为可复现脚本
/load /path/script.md
从文件加载并运行命令
/settings
打印当前生效配置
/report
打开预填诊断的 GitHub issue
/help
Aider 回答关于自身的问题
/exit
干净退出

高级用法 6

aider --message "/ask 这个 bug 在哪"
非交互单条消息(--message/-m)
aider --edit-format whole
整文件编辑(小文件更稳)
aider --cache-prompts
启用提示缓存降本提速
/multiline-mode
切换多行输入模式
/vim
切换 Vim 键绑定
/editor
用外部 $EDITOR 写长提示

💡 提示

  • 每次改动自动 git 提交是 Aider 的杀手锏:配合 `--test-cmd` 和 `--lint-cmd`,改坏了一行 `/undo` 就能回退。
  • 复杂重构用 `/architect` 双模型:规划模型出方案、编辑模型出 diff,质量比单模型全程更高且通常更省钱。
  • 只加相关文件(每任务 3-5 个),用完 `/drop`;小会话更快、更便宜、编辑更精准。
  • 先用 `/ask` 让 Aider 规划再编辑,复杂任务先想清楚能少走弯路。

官方参考来源

命令整理自以下官方文档,点击核对最新用法。

由 LaoHand 维护

公开更新于 2026年8月5日,内容持续校对官方文档。

发现错误?反馈给我们

命令或描述有误?提交 issue 帮助我们修正。

发现错误?反馈给我们