🚀 Aider 接入 CodingPlanX 自定义模型
> 导读：本文档将指导您如何使用热门的开源 AI 编程助手 Aider，无缝对接 CodingPlanX.ai API，在终端中获得极致的 AI 辅助编程体验。
Aider 是一款备受欢迎的开源命令行 AI 编程助手（GitHub 39K+ Stars）。它直接在您的终端中运行，支持 100+ 种编程语言。通过简单的环境变量配置，您就可以让 Aider 接入 CodingPlanX.ai 的强大模型。
✨ 为什么选择 Aider？
- 🆓 完全开源免费：软件本身免费，您只需支付 CodingPlanX.ai 的 API 侧费用。
- 🧠 Architect 模式：独创的双模型协作机制（一个模型负责架构规划，另一个负责编写代码），大幅提升复杂任务的代码质量。
- 🌳 Repository Map：基于
tree-sitter技术，能够智能生成并理解整个代码库的结构图。 - 🔗 Git 深度集成：AI 的每一次代码修改都会自动生成规范的 Git Commit 记录，方便随时回溯。
- ⚡ 极简配置：只需两行环境变量，即可快速连接 CodingPlanX.ai。
🛠️ 准备与安装
1. 前置条件
- 已安装 Python 3.8 或更高版本。
- 已获取 CodingPlanX.ai 的 API Key（以
cr_开头）。
2. 安装 Aider
推荐使用 pipx 进行隔离安装，避免与其他 Python 包产生依赖冲突：
# 推荐：使用 pipx（全局隔离安装）
pipx install aider-chat
# 备选：使用传统 pip
pip install aider-chat
⚙️ 配置 CodingPlanX.ai
由于 CodingPlanX.ai 提供了兼容 OpenAI 格式的接口，我们可以直接使用 OpenAI 的配置项来接入 Claude 模型。
方法一：环境变量配置（🌟 推荐）
这是最方便的方法，配置后每次启动 Aider 都不用再输入密钥。
临时生效（当前终端窗口）：
export OPENAI_API_BASE="https://api.codingplanx.ai/v1"
export OPENAI_API_KEY="cr_your_api_key"
永久生效（写入配置文件）：
如果您使用的是 macOS 或 Linux，请将以下内容添加到您的 ~/.zshrc 或 ~/.bashrc 中：
echo 'export OPENAI_API_BASE="https://api.codingplanx.ai/v1"' >> ~/.zshrc
echo 'export OPENAI_API_KEY="cr_your_api_key"' >> ~/.zshrc
source ~/.zshrc
方法二：命令行参数配置
如果您不想设置环境变量，也可以在每次启动时通过参数传入：
aider --openai-api-base "https://api.codingplanx.ai/v1" \
--openai-api-key "cr_your_api_key" \
--model openai/claude-sonnet-4-6
💻 开始使用
基础对话模式
进入您的项目目录，直接启动 Aider：
cd /path/to/your/project
# 启动 Aider（默认推荐使用 Claude Sonnet）
aider --model openai/claude-sonnet-4-6
# 如果遇到复杂难题，可切换至更强大的 Claude Opus
aider --model openai/claude-opus-4-6
Architect 架构师模式（🌟 强烈推荐）
Architect 模式是 Aider 的杀手锏功能。它让一个聪明的模型（如 Opus）先思考和规划，然后把具体的代码修改工作交给另一个执行力强的模型（如 Sonnet 或 Haiku）。这样既能保证代码质量，又能节省 API 费用。
# 方案 A：Opus 负责规划 + Sonnet 负责执行（追求极致质量）
aider --architect --model openai/claude-opus-4-6 --editor-model openai/claude-sonnet-4-6
# 方案 B：Sonnet 负责规划 + Haiku 负责执行（兼顾质量与低成本）
aider --architect --model openai/claude-sonnet-4-6 --editor-model openai/claude-haiku-4-5-20251001
⌨️ Aider 常用快捷命令
在 Aider 启动后的交互式会话中，您可以输入以下斜杠命令：
| 命令 | 详细说明 |
|---|---|
/add file.py | 将指定文件加入到 AI 的上下文中（AI 只能修改已 add 的文件） |
/drop file.py | 从上下文中移除指定文件，节省 Token |
/run pytest | 运行终端命令（如测试），并自动将报错输出喂给 AI 修复 |
/diff | 查看当前 AI 修改了哪些代码（类似于 git diff） |
/undo | 撤销上一次 AI 的代码修改 |
/commit | 手动提交当前的变更到 Git |
/help | 查看所有可用的指令帮助 |
支持的模型列表
| 模型定位 | Aider 中填写的模型名称 | 说明 |
|---|---|---|
| 主力推荐 | openai/claude-sonnet-4-6 | 速度与智能的完美平衡，性价比极高 |
| 最强推理 | openai/claude-opus-4-6 | 适合处理极度复杂的逻辑和架构设计 |
| 极速低价 | openai/claude-haiku-4-5-20251001 | 响应极快，适合作为执行模型或处理简单任务 |
⚖️ 选型指南：Aider vs Claude Code CLI
如果您在犹豫使用 Aider 还是官方的 Claude Code CLI，可以参考下表：
| 对比维度 | 🤖 Aider | 💻 Claude Code CLI |
|---|---|---|
| 开源状态 | 完全开源免费 | 闭源商业软件 |
| Git 集成 | 自动 commit（每次修改留痕） | 需手动输入 /commit |
| 工作流 | 支持多模型协作 (Architect 模式) | 单一模型对话 |
| 工具能力 | 专注文件编辑 + Shell 执行 | 更丰富（支持 LSP、全局搜索、浏览器等） |
| 上下文管理 | Repo Map (AST 语法树智能索引) | 依赖 20W-100W 的超大 Token 窗口硬吃 |
💡 我们的建议：
- 使用 Aider：进行高频的日常代码修改、重构，以及利用 Architect 模式进行精准开发。
- 使用 Claude Code CLI：需要 AI 自主分析庞大的未知项目、执行复杂的自动化 Terminal 任务时。
❓ 常见问题 (FAQ)
Q: 启动时报错 "Model not found"？
A: 请检查您的模型名称是否遗漏了 openai/ 前缀。
- ❌ 错误：
aider --model claude-sonnet-4-6 - ✅ 正确：
aider --model openai/claude-sonnet-4-6
Q: AI 思考时间太长，提示 API 调用超时？ A: 可能是网络波动或复杂任务导致。您可以尝试：
- 切换到上文提到的“备用 API 节点”。
- 启动时增加超时时间参数：
aider --model openai/claude-sonnet-4-6 --timeout 120