CLI 选项（Flags）

汇总 Aider 最重要的 CLI 参数,按模型、自动化、上下文及其他分组。

Aider 的 CLI 参数可以在启动时组合使用(例如 aider --model ... --test-cmd ... --yes-always),也可以写在配置文件里或设为环境变量。最重要的参数按组: 模型: --model MODEL(主模型,环境变量 AIDER_MODEL);--weak-model WEAK_MODEL(用于提交信息/历史摘要);--editor-model EDITOR_MODEL(在 Architect 模式下写文件编辑);--architect(直接激活 Architect 模式);--reasoning-effort VALUE 和 --thinking-tokens VALUE(控制思考深度/预算) 自动化/脚本: --message/-m/--msg(发送单条消息,处理回复,然后退出——用于脚本/CI);--message-file/-f(从文件读取消息);--yes-always(自动确认所有询问,不再提示);--no-auto-commits(关闭对 LLM 改动的自动提交,默认为开启);--test-cmd(定义测试命令)配合 --auto-test 或一次性的 --test;--lint-cmd(按语言的 lint 命令)配合 --auto-lint 或一次性的 --lint;--watch-files(监视文件中触发 Aider 的特殊 AI 注释) 上下文: --read FILE(以只读方式添加文件,可多次使用)或 --file FILE(以可编辑方式添加);--map-tokens VALUE(仓库映射大小,0 表示禁用);--map-refresh VALUE(auto/always/files/manual) 安装/其他: --upgrade/--update(更新 Aider 自身);--just-check-update(只检查是否有可用更新);--config/-c(自定义配置文件);--env-file(存放 API Key 的自定义 .env 文件);--version;--help/-h

✅ 什么时候用？

在脚本/CI 流水线中用 -m 进行非交互式单次运行

在 CI 任务中运行 aider --message 'Fix the failing test in test_auth.py' --yes-always --test-cmd 'pytest -q'

有针对性地限定自动化范围,而不是全部放开

aider --test-cmd 'pytest -q' --auto-test --no-auto-commits — 测试自动运行,但提交要先经人工检查

⛔ 什么时候不该用？

在每次交互式运行中都无脑设置 --yes-always,不检查建议

这样有风险或不想要的改动也会被自动确认,没有人事先看到它们。

更好的选择: --yes-always 只在受控的脚本/CI 场景中配合 --message 使用;交互式时手动确认建议

让 API Key 以明文参数的形式留在 shell 历史里

--openai-api-key/--anthropic-api-key 作为命令行参数往往会留在 shell 历史和进程列表中可见。

更好的选择: 改用 --env-file/.env 或 AIDER_ANTHROPIC_API_KEY 这类环境变量设置 Key

来源

Aider 官方文档——选项参考(Options Reference) ↗ aider.chat