前置条件
- 1已安装 Python 3.9+（推荐 3.10+）或 Homebrew / Docker 环境
- 2已注册至少一家 AI 模型供应商账号（OpenAI / Anthropic / DeepSeek 等）
- 3已安装 Git（Aider 与 Git 仓库深度集成）
常见问题
QAider 和 GitHub Copilot 有什么区别？
Copilot 是 IDE 内的 Tab 补全，你仍是主要敲键盘的人；Aider 是你说需求、AI 直接修改 git 仓库里的多个文件，每次改动一个独立 commit，可随时 `/undo` 回滚。
QAider 本身包含 AI 模型吗？
不包含。Aider 是工具壳，需接入外部 LLM。支持 OpenAI、Anthropic、DeepSeek、Ollama、OpenRouter 等几乎所有主流供应商，可按需切换。
Q没有 API Key 能用吗？
可以。Aider 内置 OpenRouter 接入能力，首次启动时会引导你使用 OpenRouter 的免费 / 付费通道，无需提前准备任何一家供应商的 Key。
QAPI Key 写在哪里最安全？
推荐用 `.env` 文件（放入 `~/.aider/` 或项目根目录，并加入 `.gitignore`）。注意：`.aider.conf.yml` 只允许写 OpenAI 和 Anthropic 的 Key，其他供应商必须用 `.env`。
Q如何切换不同模型？
用 `aider --model <provider/model>` 切换，如 `aider --model openai/gpt-4o`；也可在 `.aider.conf.yml` 中配置 `model-aliases` 用 `aider --model cheap` 等别名快速切换。
QArchitect 模式和普通模式有什么不同？
Architect 模式先用一个模型做规划（不写代码），再用另一个模型实施修改，适合复杂任务；普通 Code 模式直接边聊边改。