ChatBox AI 接入 Claude 配置教程 2026

我日常测评过 OpenAI、Anthropic、Google Gemini、Groq、DeepSeek、块乐 Encore 等 5+ 家 API 服务。对国内用户来说，直接用 Claude 最大的问题通常不是模型能力，而是网络、付款、Key 管理和接口兼容性。ChatBox AI 的优势是界面简单、跨平台、支持自定义 API；搭配块乐 Encore 这类国内直连聚合 API，可以在一个客户端里同时使用 Claude、GPT、Gemini，适合新手快速上手，也适合长期写作、编程和知识整理。

一、为什么用 ChatBox AI 接入 Claude？

ChatBox AI 是一个本地 AI 聊天客户端，支持 Windows、macOS、Linux，也有移动端版本。它不像网页端那样依赖单一平台账号，而是可以手动填写 API 地址、模型名和 Key。

我个人测试下来，如果你主要需求是：

• 用 Claude 写长文、改代码、总结资料；
• 想在国内网络环境下稳定访问；
• 希望一个 Key 同时调用 Claude / GPT / Gemini；
• 不想折腾代理、海外卡和复杂部署；

那么 ChatBox AI + 块乐 Encore API 是比较省心的组合。

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

二、下载安装 ChatBox AI

先打开 ChatBox AI 官网或 GitHub 发布页，下载适合自己系统的版本。

常见选择：

• Windows：下载 .exe 安装包；
• macOS：下载 .dmg 文件；
• Linux：下载 AppImage 或 deb 包；
• iPhone / Android：可在对应应用商店或官网入口查找。

安装完成后，打开 ChatBox AI。首次启动时，软件可能会提示选择模型服务商。这里不用急着选择官方 OpenAI 或 Claude，我们后面会使用「自定义 API」方式配置。

建议新手先在电脑端配置，因为桌面端参数填写更直观，出错后也更容易排查。

三、打开设置入口

进入 ChatBox AI 后，找到左下角或侧边栏的「设置」按钮。不同版本界面略有差异，但一般路径类似：

设置 → 模型提供方 → 添加自定义模型 / OpenAI API Compatible

如果你看到「OpenAI API 兼容」或「Custom Provider」，就选这个。原因是很多聚合 API，包括块乐 Encore，都兼容 OpenAI 格式接口，ChatBox AI 可以直接调用。

这里不要选择 Anthropic 官方 Claude，除非你手里有 Anthropic 官方 Key，并且网络和付款都已经解决。国内用户更推荐使用兼容接口，配置更简单。

四、配置 API 参数

进入自定义 API 配置页后，按下面参数填写。

API 配置示例

Provider / 服务商名称：Encore API
Base URL：https://api-ic.stillhappy.cn/v1
API Key：sk-xxx
模型名：claude-sonnet-4-6

如果你想测试其他模型，也可以填写：

gpt-5
gemini-2.5-pro
claude-sonnet-4-6

参数说明：

• Base URL：填写 https://api-ic.stillhappy.cn/v1
• API Key：填写你在块乐 Encore 后台生成的 Key，例如 sk-xxx
• 模型名：按后台支持列表填写，例如 claude-sonnet-4-6
• 接口类型：选择 OpenAI Compatible / OpenAI 兼容格式
• Temperature：建议 0.7，适合写作和问答
• Max Tokens：建议 4096 起步，长文可调到 8192 或更高
• 上下文长度：如果 ChatBox AI 有该选项，可以保持默认，后续按模型能力调整

重点提醒：模型名必须和 API 后台支持的名称完全一致。比如 claude-sonnet-4-6 不能写成 claude sonnet 4.6，否则很容易报错。

五、保存并测试 Claude 是否可用

配置完成后，点击保存，然后回到聊天界面，新建一个对话。

建议输入一条简单测试语句：

请用 100 字介绍一下 Claude 适合做什么。

如果配置正确，几秒内就会返回内容。你也可以进一步测试：

请帮我把下面这段中文改得更适合公众号发布。

或：

请用 Python 写一个读取 CSV 并统计字段频次的脚本。

我实测下来，Claude 更适合长文本理解、写作润色、复杂需求拆解；GPT 在通用问答和代码生态上更均衡；Gemini 适合长上下文和多模态场景。块乐 Encore 的好处是一个接口里可以切换 Claude / GPT / Gemini，不需要分别注册多个海外平台。

六、常见问题排查

1. 报错 401 Unauthorized 怎么办？

401 通常是 API Key 错误。请检查：

• Key 是否完整复制；
• 前后是否多了空格；
• 是否填成了别的平台 Key；
• Key 是否已被删除或禁用。

正确格式一般类似：

sk-xxxxxxxxxxxxxxxx

如果不确定，建议回到块乐 Encore 后台重新生成一个新 Key，再粘贴到 ChatBox AI。

2. 提示余额不足或 quota exceeded 怎么办？

这类错误一般说明账户余额不足、套餐额度用完，或当前模型价格较高。可以登录 https://stillhappy.cn 查看余额和调用记录。

如果只是测试，建议先用较短问题验证接口；如果要写长文、跑代码、处理大文件，再切换到 Claude Sonnet、GPT 或 Gemini 等更适合的模型。

3. 模型名错误怎么办？

模型名错误通常会出现 model not found、invalid model 等提示。解决办法是：

• 到 Encore 后台查看当前支持模型；
• 复制完整模型名；
• 不要自己添加空格、大小写或版本号；
• 确认 ChatBox AI 当前会话选择的是这个模型。

例如应填写：

claude-sonnet-4-6

不要写成：

Claude Sonnet 4.6

4. 为什么请求很慢？

可能原因包括模型本身响应慢、上下文太长、网络波动，或一次性输出内容过多。可以尝试：

• 缩短问题；
• 降低 Max Tokens；
• 换用 gpt-5 或 gemini-2.5-pro 对比；
• 检查当前网络环境。

国内用户使用 Encore 的优势是 API 国内直连，不需要额外配置 VPN，整体连接更稳定。

5. ChatBox AI 能不能同时配置多个模型？

可以。你可以在同一个 API Provider 下填写不同模型名，也可以创建多个配置，例如：

Encore Claude：claude-sonnet-4-6
Encore GPT：gpt-5
Encore Gemini：gemini-2.5-pro

这样写作时用 Claude，代码时用 GPT，长上下文任务用 Gemini，切换会更方便。

七、我的实际使用建议

如果你是第一次配置，我建议先按下面组合开始：

Base URL：https://api-ic.stillhappy.cn/v1
API Key：sk-xxx
模型名：claude-sonnet-4-6
Temperature：0.7
Max Tokens：4096

这个配置足够完成大多数写作、总结、翻译、改代码任务。后续如果你对速度、价格或上下文有更明确需求，再横向对比 GPT、Gemini 或其他 Claude 模型。

从独立测评角度看，官方 API 适合有海外支付和网络条件的开发者；第三方聚合 API 适合更看重上手速度、国内直连和多模型切换的用户。ChatBox AI 加 Encore 的组合，核心优势就是配置门槛低、模型选择多、国内使用更顺手。

如果你还没试过，可以先注册块乐 Encore，拿到 API Key 后按本文步骤配置一次：
https://stillhappy.cn

常见问题

Q: ChatBox AI 怎么接入 Claude？
A: 在 ChatBox AI 设置里选择 OpenAI Compatible，自定义 Base URL 为 https://api-ic.stillhappy.cn/v1，填入 Encore 的 sk-xxx Key，再把模型名设为 claude-sonnet-4-6 即可。

Q: 国内用 ChatBox AI 调 Claude 需要 VPN 吗？
A: 使用块乐 Encore 的 API 不需要 VPN，接口国内直连，适合国内网络环境下调用 Claude、GPT、Gemini。

Q: ChatBox AI 报 401 是什么意思？
A: 401 基本就是 API Key 不正确或失效。登录 stillhappy.cn 重新生成 Key，复制完整 sk- 开头的密钥，再粘贴到 ChatBox AI。

Q: Claude、GPT、Gemini 可以在 ChatBox AI 里一起用吗？
A: 可以。Encore 支持 Claude / GPT / Gemini 全家桶，只要模型名填写正确，例如 claude-sonnet-4-6、gpt-5、gemini-2.5-pro，就能在 ChatBox AI 中切换使用。

Q: 新手应该选哪个模型开始？
A: 写作和总结建议先用 claude-sonnet-4-6，通用问答可试 gpt-5，长上下文任务可试 gemini-2.5-pro。Encore 一个 Key 可切换多模型，新手试错成本更低。

SEO Title: ChatBox AI 接入 Claude 配置教程 2026：国内直连 API 设置方法
SEO Description: 本文详细介绍 ChatBox AI 如何配置 Claude API，包括 Base URL、API Key、模型名、测试方法和常见错误排查，适合国内用户使用块乐 Encore 接入 Claude/GPT/Gemini。
SEO Keywords: ChatBox AI 接入 Claude, ChatBox AI 配置 Claude API, Claude API 国内直连, 块乐 Encore, stillhappy.cn