Aider 集成

用 QCode.cc 配置 Aider：Claude 走 Anthropic 端点（anthropic/ 前缀），GPT 与国产模型走 OpenAI 兼容端点

最后核实：2026-09-18 · 📄 依据官方文档（Aider 上游仓库；见下表状态说明）

上游活跃度：Aider-AI/aider 仓库最后一次提交为 2026-05-22，其后无新 release（2026-09-18 经 GitHub API 核实）。本页接入方式仍然可用；若需要活跃维护的同类工具，可看 Cline 或 Kilo Code。

接入速览¶

Aider 是一款热门的开源 AI 编程助手（39K+ GitHub Stars），在终端中运行，支持 100+ 编程语言。它底层用 LiteLLM 路由模型，因此同时支持 Anthropic 与 OpenAI 两种协议。

🔴 先看这一条：Claude 必须走 Anthropic 端点¶

QCode 的 OpenAI 兼容端点不接受 Claude 模型。把 OPENAI_API_BASE 指向 QCode 再用 openai/claude-… 这种写法会返回 model_not_available_on_endpoint。

对照表见 接入点与 API 格式。

为什么选择 Aider？¶

• 完全开源免费：仅需支付 API 费用
• Architect 模式：用一个模型做计划、另一个执行，提升代码质量
• Git 深度集成：每次 AI 编辑自动生成 git commit
• Repository Map：基于 tree-sitter 智能索引整个代码库
• 两种协议都支持：Claude 走 Anthropic，GPT / 国产走 OpenAI

安装¶

# 推荐使用 pipx（隔离安装）
pipx install aider-chat

# 或使用 pip
pip install aider-chat

配置 Claude（Anthropic 端点）¶

export ANTHROPIC_API_BASE="https://api.qcode.cc/api"
export ANTHROPIC_API_KEY="cr_你的QCode密钥"

aider --model anthropic/claude-sonnet-5

LiteLLM 会在这个 base 后面自动追加 /v1/messages，所以填到 /api 为止，末尾不要带斜杠。

变量名可能因版本而异：LiteLLM 历史上在 ANTHROPIC_API_BASE 与 ANTHROPIC_BASE_URL 之间有过分歧。如果一个不生效，试另一个，或用命令行参数 --anthropic-api-key。 以 Aider 官方文档 为准。

永久设置（追加到 ~/.zshrc 或 ~/.bashrc）：

echo 'export ANTHROPIC_API_BASE="https://api.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="cr_你的QCode密钥"' >> ~/.zshrc
source ~/.zshrc

配置 GPT 与国产模型（OpenAI 兼容端点）¶

export OPENAI_API_BASE="https://api.qcode.cc/openai/v1"
export OPENAI_API_KEY="cr_你的QCode密钥"

aider --model openai/gpt-5.5

国产四家族（glm-5.2 / kimi-k3 / deepseek-v4-pro / qwen3.7-max 等）两条腿都能走， id 见 国产模型接入。

使用¶

cd /path/to/your/project

# 日常主力
aider --model anthropic/claude-sonnet-5

# 更强的旗舰
aider --model anthropic/claude-opus-5

Architect 模式（推荐）¶

Architect 模式让一个模型负责规划，另一个负责执行代码修改：

# Opus 规划 + Sonnet 执行（推荐）
aider --architect --model anthropic/claude-opus-5 --editor-model anthropic/claude-sonnet-5

# Sonnet 规划 + Haiku 执行（省费用）
aider --architect --model anthropic/claude-sonnet-5 --editor-model anthropic/claude-haiku-4-5

两个模型必须用同一条协议腿。混用（例如 anthropic/ 规划 + openai/claude-… 执行） 会在执行侧被拒。

常用命令¶

在 Aider 会话中：

备用节点¶

四个接入域业务能力相同，只是网络路由不同，同一把 Key 通用：

可用模型¶

claude-sonnet-4-6、claude-opus-4-8 等 4.x 仍在售（前缀同样是 anthropic/）。 实时清单以 qcode.cc/models 为准。

与 Claude Code CLI 的对比¶

推荐组合：Aider 用于快速代码修改和 Architect 模式规划，Claude Code CLI 用于复杂项目分析和自动化任务。

常见问题¶

报错 model_not_available_on_endpoint¶

你把 Claude 模型送到了 OpenAI 腿上。检查两件事：模型名前缀应是 anthropic/ 而不是 openai/； base 应是 ANTHROPIC_API_BASE=https://api.qcode.cc/api。

报错 "Model not found"¶

Aider 需要前缀来判断走哪个 provider：

# 正确
aider --model anthropic/claude-sonnet-5

# 错误（缺少前缀）
aider --model claude-sonnet-5

API 调用超时¶

尝试切换备用节点，或增加超时时间：

aider --model anthropic/claude-sonnet-5 --timeout 120

下一步¶

• 接入点与 API 格式 — 协议 × 模型家族真源表
• Cline 集成 — VS Code 中的图形化替代方案
• 命令行技巧 — Claude Code 的高级用法
• Aider 官方文档