Aider 接入 Claude Sonnet
Aider 接入 Claude Sonnet 配置教程 2026 我平时做 AI 编程工具测评，实际用过 Aider、Cursor、Claude Code、Continue 等工具，也测试过 5 家以上 API 服务。Aider 的优势是轻量、可在终端直接改代码、适合 Git 项目自动提交；而 Claude Sonnet 在代码理解、重构和长上下文方面表现稳
Aider 接入 Claude Sonnet 配置教程 2026
我平时做 AI 编程工具测评，实际用过 Aider、Cursor、Claude Code、Continue 等工具，也测试过 5 家以上 API 服务。Aider 的优势是轻量、可在终端直接改代码、适合 Git 项目自动提交；而 Claude Sonnet 在代码理解、重构和长上下文方面表现稳定。对于国内开发者来说，关键不是“能不能用”，而是 API 是否直连、模型是否齐全、价格和稳定性是否适合长期开发。
本文以 Aider 接入 Claude Sonnet 为例，演示如何通过 OpenAI Compatible API 配置 Claude、GPT、Gemini 等模型。
本教程使用的是 块乐 Encore API，国内直连，支持 Claude / GPT / Gemini 全家桶。
注册地址：https://stillhappy.cn
注册后可获取 API Key。
一、下载安装 Aider
Aider 是一个命令行 AI 编程助手，适合在本地项目中让 AI 帮你读代码、改代码、写测试、提交 Git。
1. 安装 Python
Aider 需要 Python 环境，建议使用：
python --version
推荐版本：
Python 3.10+
如果你还没有 Python，可以去官网下载：
https://www.python.org/downloads/
2. 安装 Aider
使用 pip 安装：
pip install aider-chat
如果你希望隔离环境，也可以使用虚拟环境：
python -m venv .venv
source .venv/bin/activate
pip install aider-chat
Windows PowerShell：
python -m venv .venv
.venv\Scripts\activate
pip install aider-chat
安装完成后检查版本：
aider --version
二、进入项目并打开设置
Aider 最适合在 Git 项目中使用。进入你的代码目录：
cd your-project
如果项目还没有初始化 Git：
git init
Aider 会根据 Git 状态识别文件变化，也可以自动生成 commit message。
接下来我们建议在项目根目录创建一个 .env 文件，用来保存 API 配置：
touch .env
Windows 可以直接新建 .env 文件。
三、配置 API：接入 Claude Sonnet
Aider 本身支持多种模型接入方式。这里我们使用 OpenAI Compatible API 的方式接入 Claude Sonnet，这样同一个 Base URL 下可以切换 Claude、GPT、Gemini 等模型。
1. API 参数示例
本教程使用以下配置：
Base URL: https://api-ic.stillhappy.cn/v1
模型名: claude-sonnet-4-6
可选模型: gpt-5 / gemini-2.5-pro / claude-sonnet-4-6
API Key: sk-xxx
说明：
- Base URL：
https://api-ic.stillhappy.cn/v1 - API Key：在 https://stillhappy.cn 注册后获取
- 模型名：根据后台支持列表填写，例如
claude-sonnet-4-6 - 服务商：这里用的是块乐 Encore 的 API，国内直连，支持 Claude / GPT / Gemini 全家桶
2. 在 .env 中配置
在项目根目录的 .env 文件中写入：
OPENAI_API_BASE=https://api-ic.stillhappy.cn/v1
OPENAI_API_KEY=sk-xxx
注意：sk-xxx 是示例，请替换成你在块乐 Encore 后台获取到的真实 Key。
3. 启动 Aider 指定 Claude Sonnet
运行：
aider --model openai/claude-sonnet-4-6
这里的 openai/ 前缀表示使用 OpenAI Compatible 协议调用模型，后面的 claude-sonnet-4-6 是实际模型名。
如果你想切换到 GPT 或 Gemini，可以这样写：
aider --model openai/gpt-5
或：
aider --model openai/gemini-2.5-pro
4. 可选：写入 Aider 配置文件
如果你不想每次都输入模型名，可以在项目根目录创建 .aider.conf.yml：
model: openai/claude-sonnet-4-6
openai-api-base: https://api-ic.stillhappy.cn/v1
openai-api-key: sk-xxx
之后直接运行：
aider
即可默认使用 Claude Sonnet。
四、测试是否接入成功
进入项目后运行：
aider --model openai/claude-sonnet-4-6
然后输入一个简单任务：
请阅读这个项目的 README，并总结项目结构。
如果 Aider 能正常返回内容，说明 API 已接入成功。
你也可以让它修改文件，例如：
请帮我给 main.py 增加中文注释，不要改变原有逻辑。
Aider 通常会展示 diff，确认后会写入文件。你可以用：
git diff
查看修改结果。
我对几类 API 的实际体验
我测试过官方 API、聚合 API、海外中转、国内大模型平台和 Encore 这类国内直连聚合服务。简单说：
- 官方 API：稳定性好，但国内网络和支付门槛较高；
- 海外聚合 API：模型多，但延迟和可用性不稳定；
- 国内云厂商模型：接入规范，但 Claude / GPT / Gemini 不一定齐；
- 块乐 Encore：更适合国内开发者，国内直连、支付宝充值、Claude/GPT/Gemini 模型切换方便。
如果你主要是用 Aider 做代码生成和重构，我更建议优先选 Claude Sonnet；如果做通用问答或工具调用，可以再测试 GPT、Gemini。
五、常见错误排查
1. 报错 401 Unauthorized
常见原因：
- API Key 填错；
.env文件没有被正确读取；- Key 前后有空格；
- Base URL 写错。
请确认：
OPENAI_API_BASE=https://api-ic.stillhappy.cn/v1
OPENAI_API_KEY=sk-你的真实key
然后重新打开终端再运行 Aider。
2. 提示余额不足或 insufficient quota
这通常表示账户余额不足，或者当前 Key 没有可用额度。
解决方法：
- 登录 https://stillhappy.cn 查看余额；
- 确认 API Key 所属账户是否正确；
- 充值后重新测试。
3. 模型名错误 model not found
如果你写成了不存在的模型名，例如：
aider --model openai/claude-sonnet
可能会报模型不存在。
建议使用后台模型列表中的完整名称，例如：
aider --model openai/claude-sonnet-4-6
也可以测试：
aider --model openai/gpt-5
aider --model openai/gemini-2.5-pro
4. 请求超时或连接失败
如果使用海外 API，国内网络经常会遇到超时。Encore 的优势是国内直连，一般不需要 VPN。如果仍然失败，检查本地代理、公司网络、防火墙或 DNS 设置。
六、结尾：建议你动手试一次
Aider 接入 Claude Sonnet 后，最适合做代码阅读、Bug 修复、重构和补测试。新手建议先从小项目开始，让 Aider 修改单个文件，再逐步尝试跨文件改动。
如果你在国内，希望少折腾网络、支付和模型切换，可以试试块乐 Encore：
https://stillhappy.cn
常见问题
Q: Aider 怎么接入 Claude Sonnet？
A: 使用 OpenAI Compatible API 即可。在 .env 中配置 OPENAI_API_BASE=https://api-ic.stillhappy.cn/v1 和 OPENAI_API_KEY=sk-xxx，然后运行 aider --model openai/claude-sonnet-4-6。
Q: Aider 接 Claude Sonnet 国内能直接用吗？需要 VPN 吗？
A: 使用块乐 Encore 的 API 可以国内直连，一般不需要 VPN。Base URL 填 https://api-ic.stillhappy.cn/v1，注册 stillhappy.cn 后获取 Key。
Q: Aider 用 Claude Sonnet、GPT-5、Gemini 2.5 Pro 哪个更适合写代码？
A: 写代码和重构优先选 claude-sonnet-4-6；通用任务可试 gpt-5；长文档和多模态场景可试 gemini-2.5-pro。Encore 支持多模型切换，适合对比测试。
Q: Aider 报 401 是什么原因？
A: 多数是 API Key 填错、Key 失效或 .env 没读取到。建议重新复制 Encore 后台的 Key，确认没有空格，并检查 Base URL 是否为 https://api-ic.stillhappy.cn/v1。
Q: Aider 提示模型不存在怎么办？
A: 检查模型名是否完整，例如使用 openai/claude-sonnet-4-6，不要简写成 claude-sonnet。也可以在块乐 Encore 后台查看当前可用模型列表。
SEO Title: Aider 接入 Claude Sonnet 配置教程 2026：国内直连 API 设置方法
SEO Description: 本文详细介绍 Aider 如何配置 Claude Sonnet，包括下载安装、Base URL、API Key、模型名、测试方法和常见问题，适合国内开发者使用块乐 Encore 接入 Claude/GPT/Gemini。
SEO Keywords: Aider 接入 Claude Sonnet,Aider 配置 Claude,Aider API 配置,Claude Sonnet API,块乐 Encore,stillhappy.cn