Aider 集成
使用 Aider 开源 AI 编程助手配合 QCode.cc API
Aider 集成¶
Aider 是一款热门的开源 AI 编程助手（39K+ GitHub Stars），在终端中运行，支持 100+ 编程语言。通过简单的环境变量配置即可配合 QCode.cc API 使用。
为什么选择 Aider？¶
-
完全开源免费：仅需支付 API 费用
-
Architect 模式：用一个模型做计划、另一个执行，提升代码质量
-
Git 深度集成：每次 AI 编辑自动生成 git commit
-
Repository Map：基于 tree-sitter 智能索引整个代码库
-
配置最简单：两行环境变量即可连接 QCode.cc
安装¶
# 推荐使用 pipx（隔离安装）
pipx install aider-chat
# 或使用 pip
pip install aider-chat
配置 QCode.cc¶
方法一：环境变量（推荐）¶
export OPENAI_API_BASE="https://asia.qcode.cc/claude/v1"
export OPENAI_API_KEY="cr_your_api_key"
永久设置（添加到 ~/.zshrc 或 ~/.bashrc）：
echo 'export OPENAI_API_BASE="https://asia.qcode.cc/claude/v1"' >> ~/.zshrc
echo 'export OPENAI_API_KEY="cr_your_api_key"' >> ~/.zshrc
source ~/.zshrc
方法二：命令行参数¶
aider --openai-api-base "https://asia.qcode.cc/claude/v1" \
--openai-api-key "cr_your_api_key" \
--model openai/claude-sonnet-4-6
使用¶
基本使用¶
# 进入项目目录
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 模式让一个模型负责规划，另一个负责执行代码修改：
# Opus 规划 + Sonnet 执行（推荐）
aider --architect --model openai/claude-opus-4-6 --editor-model openai/claude-sonnet-4-6
# Sonnet 规划 + Haiku 执行（省费用）
aider --architect --model openai/claude-sonnet-4-6 --editor-model openai/claude-haiku-4-5-20251001
常用命令¶
在 Aider 会话中：
| 命令 | 说明 |
|---|---|
/add file.py |
将文件添加到聊天上下文 |
/drop file.py |
移除文件 |
/run pytest |
执行命令并将输出发给 AI |
/diff |
显示所有变更 |
/undo |
撤销上一次 AI 编辑 |
/commit |
提交当前变更 |
/help |
显示帮助 |
备用节点¶
# 香港节点
export OPENAI_API_BASE="http://103.218.243.5/claude/v1"
# 深圳节点
export OPENAI_API_BASE="http://103.236.53.153/claude/v1"
可用模型¶
| 模型 | Aider 中的名称 | 说明 |
|---|---|---|
| Claude Sonnet 4.6 | openai/claude-sonnet-4-6 |
推荐，性价比高 |
| Claude Opus 4.6 | openai/claude-opus-4-6 |
最强模型 |
| Claude Haiku 4.5 | openai/claude-haiku-4-5-20251001 |
低成本快速 |
注意：模型名称前需要加
openai/前缀，以指示 Aider 使用 OpenAI 兼容端点。
与 Claude Code CLI 的对比¶
| 维度 | Aider | Claude Code CLI |
|---|---|---|
| 开源 | 完全开源 | 不开源 |
| Git 集成 | 每次编辑自动 commit | 手动 /commit |
| Architect 模式 | 双模型规划+执行 | 单模型 |
| 工具能力 | 文件编辑 + Shell | 更丰富（LSP、搜索、浏览器） |
| 上下文管理 | Repository Map 智能索引 | 20 万-100 万 token 窗口 |
| 配额 | 共享 QCode.cc 套餐配额 | 共享 QCode.cc 套餐配额 |
推荐组合：Aider 用于快速代码修改和 Architect 模式规划，Claude Code CLI 用于复杂项目分析和自动化任务。
常见问题¶
报错 "Model not found"？¶
确保模型名称前有 openai/ 前缀：
# 正确
aider --model openai/claude-sonnet-4-6
# 错误（缺少前缀）
aider --model claude-sonnet-4-6
API 调用超时？¶
尝试切换备用节点，或增加超时时间：
aider --model openai/claude-sonnet-4-6 --timeout 120
下一步¶
-
查看 Cline 集成 了解 VS Code 中的图形化替代方案
-
查看 CLI 技巧 了解 Claude Code 的高级用法
-
访问 Aider 官方文档 了解更多功能