配置文件与环境变量

.aider.conf.yml

大多数选项都能写进 .aider.conf.yml。Aider 会在三个位置找：用户主目录、Git 仓库根目录、当前目录；存在的话按此顺序加载，后加载的优先。--config <文件> 则只加载那一个文件。列表可以写成项目符号，也可以写成 [a, b]。每个命令行开关都有同名配置项（去掉 --）。官方文档提供了列出全部有效条目的示例文件。注意：YAML 配置文件里只能放 OpenAI 和 Anthropic 的 API Key，其他服务商的 Key 放 .env。

model: sonnet
read: CONVENTIONS.md
auto-test: true
test-cmd: pnpm test

.env 与环境变量

每个选项也有对应的环境变量，形如 AIDER_<OPTION>（例如 AIDER_MODEL、AIDER_STREAM、AIDER_MESSAGE）。Aider 会从 .env 文件加载环境变量，各服务商的 API Key（如 OPENAI_API_KEY、ANTHROPIC_API_KEY）也可以写在里面；详细加载位置和顺序以官方为准。也可以用 --api-key provider=<key> 设置对应的 PROVIDER_API_KEY，--set-env NAME=value 设置任意环境变量。

选项分组（命令行参考）

主要分组：主模型（--model）；API Key 与设置（--openai-api-key、--anthropic-api-key、--openai-api-base、--set-env、--api-key）；模型设置（--list-models、--model-settings-file、--model-metadata-file、--alias、--reasoning-effort、--thinking-tokens、--timeout、--edit-format、--architect、--weak-model、--editor-model、--editor-edit-format、--max-chat-history-tokens）；缓存（--cache-prompts、--cache-keepalive-pings）；仓库地图（--map-tokens、--map-refresh）；历史文件；输出外观（主题、颜色、--stream）；Git（自动提交、署名）；Lint 与测试；语音等。运行 aider --help 查看完整列表。

模型别名、设置与元数据

• --alias 别名:模型 给模型起短名，可多次使用。
• 对 Aider 未知的模型，可用 --model-settings-file（默认 .aider.model.settings.yml）声明编辑格式等设置，用 --model-metadata-file（默认 .aider.model.metadata.json）提供上下文窗口和价格。
• 官方的「Advanced model settings」页列出了所有已内置模型的默认设置，并说明了这些文件的字段。
• 模型与服务商的接入（OpenAI、Anthropic、DeepSeek、OpenRouter、Ollama、OpenAI 兼容接口等）见「入门」里的快速上手与官方「Connecting to LLMs」。