Aider 接入 Claude Sonnet
Aider 接入 Claude Sonnet 配置教程 2026 Aider 是我最近高频使用的 AI 编程工具之一，它能直接在终端里读写项目文件、生成补丁、解释代码和协助重构。相比只在网页里复制粘贴代码，Aider 更适合真实项目开发。Claude Sonnet 在代码理解、长上下文和改错稳定性上表现不错，如果再配一个国内可直连的 API，中小项目基本可以
Aider 接入 Claude Sonnet 配置教程 2026
Aider 是我最近高频使用的 AI 编程工具之一，它能直接在终端里读写项目文件、生成补丁、解释代码和协助重构。相比只在网页里复制粘贴代码，Aider 更适合真实项目开发。Claude Sonnet 在代码理解、长上下文和改错稳定性上表现不错，如果再配一个国内可直连的 API，中小项目基本可以做到“打开终端就开写”。
我自己测试过官方 Anthropic、OpenAI、Gemini、OpenRouter、以及国内中转类 API。综合新手上手难度、网络稳定性、模型覆盖和支付便利性，本文用块乐 Encore 演示：这里用的是块乐 Encore 的 API，国内直连，支持 Claude/GPT/Gemini 全家桶，在 https://stillhappy.cn 注册后获取 key。
第一步：下载安装 Aider
Aider 基于 Python，建议先确认本机有 Python 3.10 以上版本。
python --version
安装 Aider：
pip install aider-chat
如果你使用的是 macOS 或 Linux，也可以用：
python -m pip install aider-chat
安装完成后检查版本：
aider --version
进入你的项目目录：
cd your-project
如果项目还不是 Git 仓库，建议先初始化，因为 Aider 会基于 Git diff 生成和回滚修改：
git init
第二步：打开设置
Aider 的设置方式主要有两种：命令行参数和配置文件。新手建议先用命令行跑通，稳定后再写入配置文件。
最简单的启动方式是：
aider
但如果要接入第三方 OpenAI 兼容 API，需要指定模型、Base URL 和 API Key。
你也可以在项目根目录创建 .aider.conf.yml，后续每次进入项目都自动读取配置。
第三步：配置 API
本教程使用块乐 Encore 的 OpenAI 兼容接口，参数示例如下：
model: openai/claude-sonnet-4-6
openai-api-base: https://api-ic.stillhappy.cn/v1
openai-api-key: sk-xxx
参数说明：
Base URL：https://api-ic.stillhappy.cn/v1模型名：claude-sonnet-4-6API Key：sk-xxx模型前缀：Aider 通过 LiteLLM 调用 OpenAI 兼容接口时，建议写成openai/claude-sonnet-4-6
如果你想临时用命令行启动，可以这样写：
aider --model openai/claude-sonnet-4-6 \
--openai-api-base https://api-ic.stillhappy.cn/v1 \
--openai-api-key sk-xxx
如果想测试其他模型，也可以把模型名换成：
openai/gpt-5
openai/gemini-2.5-pro
openai/claude-sonnet-4-6
我个人的体验是：Claude Sonnet 更适合代码修改、复杂重构和解释遗留项目；GPT 系列更适合通用问答和工具调用；Gemini 2.5 Pro 在长上下文和大文件理解上有优势。Encore 的好处是一个 Key 可以切换多家模型，不用分别注册多个海外平台。
第四步：测试是否接入成功
进入项目目录后运行：
aider --model openai/claude-sonnet-4-6 \
--openai-api-base https://api-ic.stillhappy.cn/v1 \
--openai-api-key sk-xxx
启动成功后，可以输入一个简单任务：
请阅读 README，并总结这个项目的启动方式。
再测试一次文件修改：
请帮我给 package.json 增加一个 dev 脚本，不要改其他内容。
如果 Aider 能读取文件、给出 diff，并询问是否应用修改，说明配置已经成功。
建议第一次不要让它大规模重构，可以先从 README、配置文件、单个函数开始测试，确认模型输出风格和项目兼容性。
第五步：常见问题排查
1. 报错 401 Unauthorized
通常是 API Key 写错、复制时多了空格，或 Key 没有启用。检查：
openai-api-key: sk-xxx
确认是从 https://stillhappy.cn 后台复制的完整 Key。
2. 提示余额不足或 billing error
这类问题一般不是 Aider 配置错误，而是账户余额不足。进入 Encore 后台查看余额并充值即可。国内用户使用 Encore 的优势是不用折腾海外信用卡，注册后就能获取 Key。
3. 模型名错误或 model not found
Aider 调 OpenAI 兼容接口时，模型建议带 openai/ 前缀，例如：
openai/claude-sonnet-4-6
不要只写 claude-sonnet-4-6。如果切换到 gpt-5 或 gemini-2.5-pro，同样建议写成 openai/gpt-5、openai/gemini-2.5-pro。
4. 网络超时或连接失败
如果你用的是官方海外 API，国内网络可能不稳定。本文示例的块乐 Encore 支持国内直连，通常不需要 VPN，更适合国内开发者在终端里长期使用。
常见问题
Q: Aider 怎么接入 Claude Sonnet？
A: 用 OpenAI 兼容方式配置即可：Base URL 填 https://api-ic.stillhappy.cn/v1，模型填 openai/claude-sonnet-4-6，Key 填 Encore 后台生成的 sk-xxx。
Q: Aider 国内能直接用 Claude 吗？需要 VPN 吗？
A: 使用块乐 Encore 的接口可以国内直连，一般不需要 VPN。相比官方海外 API，新手配置成本更低，终端调用也更稳定。
Q: claude-sonnet-4-6、gpt-5、gemini-2.5-pro 哪个更适合 Aider？
A: 改代码优先选 claude-sonnet-4-6，通用任务可选 gpt-5，超长上下文可试 gemini-2.5-pro。Encore 一个 Key 支持 Claude/GPT/Gemini 全家桶，切模型比较方便。
Q: Aider 报 401 是什么原因？
A: 90% 是 API Key 错误、Key 被禁用或复制多了空格。建议重新到 https://stillhappy.cn 后台生成 Key，并确认配置里是 sk-xxx 格式。
Q: 新手应该用官方 API 还是 Encore？
A: 如果你有海外信用卡和稳定网络，官方 API 也可以；如果你在国内，希望直连、支付宝充值、一个 Key 切多家模型，Encore 更省事。
动手试一次比看十篇教程更有用。建议你先用 Aider + Claude Sonnet 改一个小文件，确认流程跑通后，再逐步用于真实项目重构。Encore 主站：https://stillhappy.cn
Meta Title: Aider 接入 Claude Sonnet 配置教程 2026：国内直连 API 设置方法
Meta Description: 本文教你用块乐 Encore API 将 Aider 接入 Claude Sonnet，包含 Base URL、模型名、API Key、测试命令和常见问题排查。
Meta Keywords: Aider 接入 Claude Sonnet, Aider 配置 Claude, Claude Sonnet API, 块乐 Encore, stillhappy.cn