Aider CLI 速查表

命令：aider 最后更新：2026 年 3 月 29 日
📋 Aider 选项参考 ✕
🧠 主模型与 API
模型选择
--model 主对话模型；环境变量 AIDER_MODEL
--list-models 按名称筛选列出已知模型（别名 --models）
--alias ALIAS:MODEL，可重复
--weak-model 弱模型（如摘要/辅助）
--editor-model 编辑器/子任务模型；--editor-edit-format
--architect 建筑师模式；--auto-accept-architect
--reasoning-effort 推理强度 API 参数
--thinking-tokens 思考 token 预算；0 关闭
--edit-format 补丁/编辑格式
密钥与端点
--openai-api-key AIDER_OPENAI_API_KEY
--anthropic-api-key AIDER_ANTHROPIC_API_KEY
--api-key PROVIDER=KEY，可重复
--openai-api-base 自定义 API Base；AIDER_OPENAI_API_BASE
--set-env VAR=value 注入环境（可多次）
文档 API Keys
🗺️ Repo map · 缓存 · 历史
仓库地图
--map-tokens 地图占用 token 预算
--map-refresh 刷新策略
--map-multiplier-no-files 无文件时的倍数
--show-repo-map 打印当前仓库地图后退出
缓存
--cache-prompts 提示缓存；--cache-keepalive-pings
历史文件
--input-history-file 输入历史路径
--chat-history-file 聊天历史路径
--restore-chat-history 恢复上次聊天历史
--llm-history-file LLM 调用历史
元数据
--model-settings-file 默认 .aider.model.settings.yml
--model-metadata-file 默认 .aider.model.metadata.json
⚡ 斜杠命令（会话内）
文件与会话
/add 加入可编辑或可细读文件
/drop 移出会话以省上下文
/read-only 只读参考或切换只读
/ls 列出已知文件及是否在会话中
/clear · /reset 清历史；/reset 另丢弃全部文件
/save · /load 保存/执行命令文件以复现场景
模式
/code · /ask 改代码 / 只问答不编辑
/architect 建筑师/编辑双模型流程
/chat-mode 切换聊天模式
/context 上下文浏览模式
/editor · /edit 外部编辑器写提示（同义）
模型与推理
/model · /models 切换主模型 / 搜索可用模型
/weak-model · /editor-model 切换弱模型与编辑模型
/reasoning-effort · /think-tokens 推理强度与思考预算
Git · 运行 · 网络
/commit · /git · /undo 提交、跑 git、撤销 aider 上次提交
/run（!） 执行 shell，输出可进会话
/test · /lint 测试命令；lint 当前或脏文件
/web 抓取网页转 Markdown 送入消息
上下文与杂项
/map · /map-refresh 打印/强制刷新仓库地图
/tokens · /diff · /settings token 用量、改动 diff、当前设置
/copy · /copy-context 复制末条回复或整段上下文 MD
/help · /exit · /quit 帮助；退出
全文 usage/commands
⌨️ 输入与键位
多行消息
{ … } 首行单独 {、末行 } 包裹多行
{tag … tag} 自定义标签，便于内容含 }
/multiline-mode 切换 Enter 与 Meta+Enter；等价 --multiline
历史
↑ / Ctrl+R 上一条消息；反向搜索历史
Ctrl+C 安全中断；部分回复仍保留在对话中
Emacs（默认）
Ctrl+↑ / Ctrl+↓ 翻阅已发送消息
Ctrl+X Ctrl+E 用外部编辑器编辑当前输入
Vi
--vim 启用 vi 键位（prompt-toolkit）
📜 Git · 质量门 · 脚本
Git 集成
--git / --no-git 是否使用 Git
--auto-commits 自动提交模型改动（默认开）
--dirty-commits 工作区已脏时仍提交
--commit 生成说明并提交当前改动后退出
--commit-prompt 自定义提交提示语
--dry-run 不落盘试跑
--watch-files 监视文件变更
--gitignore 与 .aiderignore、--subtree-only 等
Lint / Test
--lint · --lint-cmd 手动 lint；自定义命令
--auto-lint 自动 lint 修复
--test-cmd · --auto-test · --test 测试命令与自动跑测
非交互一条指令
-m / --message 单条自然语言，执行后退出（关闭聊天模式）
-f / --message-file 从文件读指令
--yes · --yes-always 自动确认所有提示
--stream / --no-stream 流式输出；脚本可调
--apply 应用给定补丁文件
--exit 处理后退出
文档 scripting
⚙️ 配置 · 界面 · 其它
配置文件
.aider.conf.yml 项目或用户级 YAML 配置
-c / --config 指定配置文件路径
--env-file 加载 .env 风格文件
文档 config
文件参数
--file · --read 添加可编辑 / 只读文件
--load 加载并执行命令文件
界面与输出
--gui / --browser 图形/Web 界面
--copy-paste 剪贴板模式
--dark-mode · --light-mode 配色主题
--code-theme · --show-diffs 代码高亮与 diff 展示
--fancy-input 增强输入体验
--verbose · -v 详细日志
语音与工具
--voice-* 格式、语言、输入设备
--disable-playwright 关闭 Playwright 相关能力
升级与分析
--upgrade · --version 升级与版本
--shell-completions 生成 shell 补全
--analytics* 使用情况统计相关开关
🐍 Python · 高级
脚本 API（非正式）
Coder.create from aider.coders import Coder；Model(...)
coder.run() 执行指令；可传 "/tokens" 等斜杠命令
InputOutput(yes=True) 等价非交互 --yes
注意 API 可能随版本变化；见仓库 base_coder.py
调试展示
--show-prompts 打印提示内容
--max-chat-history-tokens 聊天历史 token 上限
--timeout · --verify-ssl 请求超时与 TLS 校验
编码与语言
--encoding · --line-endings 文件编码与换行
--chat-language · --commit-language 对话与提交说明语言
协作元数据
--attribute-* 作者/提交者/Co-authored-by 等 Git 属性
✨ 体验与其它
终端行为
--suggest-shell-commands 建议可执行的 shell 命令
--notifications 系统通知；--notifications-command
--detect-urls 检测输入中的 URL
--editor 外部编辑器可执行文件
快捷与杂项
/ok 同意上一轮方案并继续改代码
/paste · /voice 剪贴板图像/文本；语音输入
/report 打开 GitHub Issue 反馈问题
--apply-clipboard-edits 应用剪贴板中的编辑
弃用模型简写
--opus · --sonnet · --4o … 旧版便捷开关，建议改用 --model
官网
aider.chat 主页 · GitHub