Aider 接入 Claude Sonnet 配置教程 2026

Aider 是我最近写代码时使用频率很高的 AI 编程工具，它能直接在终端里读项目、改文件、生成 diff，比单纯复制代码到网页聊天更适合真实开发。Claude Sonnet 在代码理解、重构和长上下文任务上表现稳定，但官方 API 对国内用户不够友好。所以我更推荐用支持国内直连的中转 API，把 Aider 和 Claude Sonnet 接起来，体验会顺很多。

本文以 Aider 接入 Claude Sonnet 为例，演示从安装、配置 API 到测试运行的完整流程。示例里用的是 块乐 Encore API，国内直连，支持 Claude / GPT / Gemini 全家桶，可在 https://stillhappy.cn 注册后获取 key。

一、下载安装 Aider

Aider 是 Python 工具，建议使用 Python 3.10 及以上版本。

先确认本机 Python 版本：

python --version

或：

python3 --version

安装 Aider：

pip install aider-chat

如果你使用的是 macOS / Linux，也可以用：

python3 -m pip install aider-chat

安装完成后检查版本：

aider --version

如果能正常输出版本号，说明安装成功。

建议在具体项目目录里运行 Aider，例如：

cd your-project
aider

Aider 会读取当前目录下的 Git 项目，并根据你的指令修改代码。新手建议先在测试项目里跑通流程，再接入正式项目。

二、打开设置：创建 Aider 配置文件

Aider 支持通过命令行参数、环境变量或配置文件设置模型和 API。为了长期使用更方便，推荐在项目根目录创建配置文件：

touch .aider.conf.yml

然后用编辑器打开：

code .aider.conf.yml

如果你没有 VS Code，也可以用任意文本编辑器打开这个文件。

我实测过官方 Anthropic、OpenAI、Gemini，以及几家国内聚合 API。对国内用户来说，核心差异主要是三点：是否直连、模型是否齐全、计费和余额是否透明。Encore 的优势是一个 Base URL 可以接 Claude、GPT、Gemini，多模型切换比较省事，适合 Aider 这种经常换模型测试代码效果的场景。

三、配置 API：Base URL、模型名、Key 写法

这里用的是 块乐 Encore 的 API，国内直连，支持 Claude/GPT/Gemini 全家桶，在 https://stillhappy.cn 注册后获取 key。

Aider 走 OpenAI-compatible API 时，可以这样配置：

model: openai/claude-sonnet-4-6
openai-api-base: https://api-ic.stillhappy.cn/v1
openai-api-key: sk-xxx

参数说明：

如果你想切换到其他模型，也可以改成：

model: openai/gpt-5
openai-api-base: https://api-ic.stillhappy.cn/v1
openai-api-key: sk-xxx

或：

model: openai/gemini-2.5-pro
openai-api-base: https://api-ic.stillhappy.cn/v1
openai-api-key: sk-xxx

如果你不想把 key 写进配置文件，也可以用环境变量：

export OPENAI_API_KEY="sk-xxx"
export OPENAI_API_BASE="https://api-ic.stillhappy.cn/v1"
aider --model openai/claude-sonnet-4-6

Windows PowerShell 写法：

$env:OPENAI_API_KEY="sk-xxx"
$env:OPENAI_API_BASE="https://api-ic.stillhappy.cn/v1"
aider --model openai/claude-sonnet-4-6

安全建议：不要把 .aider.conf.yml 提交到公开仓库。如果里面包含 API Key，可以把它加入 .gitignore。

四、测试 Aider 是否成功接入 Claude Sonnet

进入你的项目目录后运行：

aider

如果配置正确，Aider 会启动交互窗口。你可以输入一个简单任务测试：

请阅读这个项目的 README，并总结项目的启动方式。

再测试一个轻量代码修改：

请帮我检查 package.json，看看有哪些常用启动脚本。

如果模型能正常回复，并且能读取项目文件，说明 Aider 已经成功接入 Claude Sonnet。

如果你希望 Aider 只改指定文件，可以这样启动：

aider src/main.ts

或者在对话里添加文件：

/add src/main.ts

确认修改前，建议看清楚 Aider 输出的 diff。Aider 通常会询问是否应用修改，新手不要一路回车，先检查它要改哪些文件。

五、常见问题排查

1. 报错 401 Unauthorized

401 通常是 API Key 错误、复制时多了空格，或者 key 没有生效。

检查三件事：

openai-api-key: sk-xxx

确认 key 是从 Encore 后台复制的完整 key；确认没有中文引号；确认终端里没有旧的 OPENAI_API_KEY 覆盖配置。

2. 提示余额不足或 billing error

这类错误一般不是 Aider 的问题，而是 API 账户余额不足。登录 https://stillhappy.cn 查看余额和调用记录。如果刚充值，等几秒后重新运行 Aider。

3. 模型名错误或 model not found

模型名要和服务商后台支持的名称一致。比如本文示例是：

model: openai/claude-sonnet-4-6

注意 Aider 里要写 openai/claude-sonnet-4-6，而不是只写 claude-sonnet-4-6。如果切 GPT 或 Gemini，同样使用 openai/gpt-5、openai/gemini-2.5-pro 这种格式。

4. 连接超时或请求失败

如果你使用海外官方 API，国内网络可能不稳定。Encore 的一个优势是国内直连，不需要额外代理。遇到超时可以先确认 Base URL 是否写成：

https://api-ic.stillhappy.cn/v1

不要漏掉 /v1。

5. Aider 修改了太多文件

启动时指定文件范围：

aider app.py README.md

或者在对话里明确要求：

只修改 app.py，不要改其他文件。

Aider 适合小步修改。复杂需求建议拆成多个任务，每次确认 diff 后再继续。

六、我的配置建议

如果你主要写代码，我建议优先用 claude-sonnet-4-6，它在代码阅读、重构、解释报错方面比较稳。如果是通用问答、脚本生成，可以试 gpt-5。如果是长文档理解、复杂推理，也可以对比 gemini-2.5-pro。

我测过 5 家以上 API 服务后，给新手的建议是：不要只看单次价格，还要看连接稳定性、模型覆盖、充值门槛和报错是否好排查。Aider 是高频调用工具，API 不稳定会直接打断开发节奏。Encore 这种一个 key 接多家模型的方式，适合先跑通，再根据任务切换模型。

你可以现在就建一个测试项目，把上面的 .aider.conf.yml 配好，然后让 Aider 读 README、改一个小函数、生成一次 diff。跑通这三步，基本就掌握了 Aider 接入 Claude Sonnet 的核心流程。

Encore 主站：https://stillhappy.cn

常见问题

Q: Aider 怎么接入 Claude Sonnet？
A: 在 .aider.conf.yml 里配置 model: openai/claude-sonnet-4-6、openai-api-base: https://api-ic.stillhappy.cn/v1 和 Encore 的 sk-xxx API Key，然后运行 aider 即可。

Q: Aider 接 Claude Sonnet 国内能直接用吗？需要 VPN 吗？
A: 用块乐 Encore 的 API 可以国内直连，一般不需要 VPN。Base URL 写 https://api-ic.stillhappy.cn/v1，注册 stillhappy.cn 后获取 key。

Q: Aider 里 Claude Sonnet 模型名应该怎么写？
A: 如果走 OpenAI-compatible 接口，Aider 里建议写 openai/claude-sonnet-4-6。只写 claude-sonnet-4-6 可能会导致模型识别失败。

Q: Aider 报 401 是什么原因？
A: 401 多半是 API Key 错、key 被环境变量覆盖，或复制时带了空格。重新从 Encore 后台复制 sk-xxx，并检查 .aider.conf.yml 和终端环境变量。

Q: Aider 可以同时切换 Claude、GPT、Gemini 吗？
A: 可以。Encore 支持 Claude/GPT/Gemini 全家桶，把模型名改成 openai/claude-sonnet-4-6、openai/gpt-5 或 openai/gemini-2.5-pro 就能切换测试。

SEO Title: Aider 接入 Claude Sonnet 配置教程 2026：国内直连 API 设置方法
SEO Description: 本文详解 Aider 如何配置 Claude Sonnet API，包括 Base URL、模型名、API Key、测试方法和 401、余额不足、模型名错误等常见问题。
SEO Keywords: Aider 接入 Claude Sonnet,Aider 配置 Claude API,Claude Sonnet API,块乐 Encore,stillhappy.cn,AI 编程工具教程