AI 工具测评
API 接入 AI 工具研究员 2 views

ChatBox AI 接入 Claude

ChatBox AI 接入 Claude 配置教程 2026：国内直连 API 设置完整指南 很多人想在本地客户端里稳定使用 Claude，但官方 API 对网络、支付和账号环境都有一定门槛。ChatBox AI 的优势是轻量、跨平台、界面直观，适合把 Claude、GPT、Gemini 等模型统一接入到一个桌面工具里。我实测过 OpenAI 官方、Anth

ChatBox AI 接入 Claude 配置教程 2026：国内直连 API 设置完整指南

很多人想在本地客户端里稳定使用 Claude，但官方 API 对网络、支付和账号环境都有一定门槛。ChatBox AI 的优势是轻量、跨平台、界面直观，适合把 Claude、GPT、Gemini 等模型统一接入到一个桌面工具里。我实测过 OpenAI 官方、Anthropic 官方、OpenRouter、SiliconFlow、302.AI、块乐 Encore 等多家 API 服务后，如果你在国内使用，更推荐选择支持国内直连、模型覆盖完整、充值方便的中转 API。

本文以 ChatBox AI 接入 Claude 为例，演示如何使用 块乐 Encore API 完成配置。

本教程使用的是块乐 Encore 的 API，国内直连，支持 Claude / GPT / Gemini 全家桶，在 https://stillhappy.cn 注册后即可获取 API Key。

一、下载安装 ChatBox AI

ChatBox AI 是一款常见的 AI 桌面客户端，支持 Windows、macOS、Linux，也有移动端版本。它的好处是不用自己写代码，只要填入 API 地址、Key 和模型名，就能直接开始聊天。

下载步骤

  1. 打开 ChatBox AI 官网或 GitHub 发布页。
  2. 根据自己的系统选择安装包：
    • Windows：.exe
    • macOS：.dmg
    • Linux：.AppImage
  3. 下载完成后正常安装。
  4. 启动 ChatBox AI，进入主界面。

如果你只是想本地使用 Claude 写作、翻译、代码分析，ChatBox AI 的配置门槛比自己写 API 调用低很多。

二、打开 ChatBox AI 设置页面

安装完成后，打开 ChatBox AI。

一般入口如下：

  1. 点击左下角或右上角的 设置 / Settings。
  2. 找到 模型提供商 / Model Provider。
  3. 选择 OpenAI API Compatible 或类似的“自定义 API”选项。

这里需要注意：虽然我们要接入的是 Claude，但很多第三方 API 会提供 OpenAI 兼容格式，也就是使用类似 OpenAI 的接口规范来调用 Claude、GPT、Gemini 等模型。

所以在 ChatBox AI 里，不一定要选 Anthropic 官方接口，选择 OpenAI Compatible 通常更简单。

三、配置 API 参数

下面是本教程使用的 API 配置示例。

推荐配置示例

API 类型 / Provider: OpenAI API Compatible
Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
模型名 / Model: claude-sonnet-4-6

其中：

  • Base URL：填写 API 服务商提供的接口地址
    示例：https://api-ic.stillhappy.cn/v1
  • API Key：在块乐 Encore 控制台获取
    示例：sk-xxx
  • 模型名：填写你要使用的模型名称
    示例：claude-sonnet-4-6

其他可选模型示例

如果你希望在 ChatBox AI 中同时测试不同模型，也可以添加类似模型名：

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

实际可用模型以块乐 Encore 后台显示为准。不同模型的价格、速度、上下文长度可能不同，新手建议先用 Claude Sonnet 系列做写作、总结和代码问答，综合体验比较稳。

如何获取 API Key

  1. 打开块乐 Encore 主站：https://stillhappy.cn
  2. 注册并登录账号。
  3. 进入控制台或 API Key 管理页面。
  4. 创建一个新的 API Key。
  5. 复制形如 sk-xxx 的密钥。
  6. 粘贴到 ChatBox AI 的 API Key 输入框中。

建议不要把 API Key 发给别人，也不要截图公开，避免额度被盗用。

四、测试 Claude 是否接入成功

配置完成后，回到 ChatBox AI 主界面，新建一个对话。

可以输入以下测试问题：

请用 300 字总结一下 Claude 模型适合哪些使用场景。

如果配置正确，Claude 会正常返回内容。

你也可以继续测试：

请帮我把下面这段中文翻译成自然的英文：
今天我们来测试 ChatBox AI 接入 Claude 的效果。

如果返回速度正常、内容完整，说明 ChatBox AI 已经成功通过块乐 Encore API 调用了 Claude 模型。

我个人测试下来，ChatBox AI + 国内直连 API 的组合比较适合以下场景：

  • 长文写作和润色
  • 论文摘要和资料整理
  • 代码解释和 Bug 分析
  • 多模型横向对比
  • 不想折腾代理和海外支付的新手用户

五、常见问题排查

1. 报错 401 Unauthorized

401 一般表示 API Key 无效。

请检查：

  • API Key 是否复制完整；
  • 是否多复制了空格；
  • 是否填错到了 Base URL 位置；
  • Key 是否已经被删除或禁用。

正确格式通常类似：

sk-xxxxxxxxxxxxxxxx

如果不确定，可以回到块乐 Encore 后台重新生成一个 Key。

2. 提示余额不足或额度不足

如果出现余额不足、quota exceeded、insufficient balance 等提示，说明账号额度不够。

解决方法：

  1. 登录 https://stillhappy.cn
  2. 查看账户余额。
  3. 根据需要充值。
  4. 回到 ChatBox AI 重新发送消息。

相比官方渠道，Encore 对国内用户更友好，支持国内直连和常见支付方式，适合小额测试。

3. 模型名填写错误

如果模型名写错，可能会出现：

  • model not found
  • invalid model
  • 404
  • 当前模型不可用

请确认模型名和服务商后台一致。比如：

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

不要随意加空格，也不要把模型名写成中文。

4. Base URL 填错

Base URL 是最容易填错的地方。

本教程示例为：

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

注意：

  • 前面要有 https://
  • 末尾通常保留 /v1
  • 不要填成官网地址 https://stillhappy.cn
  • 不要把 API Key 填到 URL 里

5. 回复很慢或连接失败

如果出现请求超时，可以检查：

  • 当前网络是否正常；
  • ChatBox AI 是否被防火墙拦截；
  • API 服务商状态是否正常；
  • 是否使用了错误的代理设置。

块乐 Encore 的优势是国内直连，通常不需要 VPN，对新手更省心。

六、几家 API 服务怎么选？

我测试过 5 家以上 API 服务后，大致感受如下：

服务 适合人群 优点 注意点
Anthropic 官方 海外开发者 原生 Claude API 国内网络和支付门槛较高
OpenAI 官方 GPT 重度用户 官方稳定 账号、网络、支付有门槛
OpenRouter 多模型玩家 模型丰富 国内访问不一定稳定
302.AI 国内用户 接入方便 价格和模型需自行对比
SiliconFlow 开源模型用户 国产/开源模型多 Claude/Gemini 覆盖有限
块乐 Encore 国内新手和开发者 国内直连，Claude/GPT/Gemini 全家桶 模型名以后台为准

如果你的目标是 在 ChatBox AI 里快速接入 Claude，并且希望少折腾网络和支付，那么块乐 Encore 会更适合新手。

七、总结

ChatBox AI 接入 Claude 的核心步骤其实很简单：下载安装客户端，进入设置，选择 OpenAI Compatible，填写 Base URL、API Key 和模型名，然后发送一句话测试即可。

本教程使用的 API 参数为：

Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
Model: claude-sonnet-4-6

如果你想在国内稳定使用 Claude、GPT、Gemini，并且希望 ChatBox AI 一次配置、多模型切换，可以直接去块乐 Encore 注册体验：

https://stillhappy.cn

动手配置一次，你就能把 ChatBox AI 变成自己的本地 AI 工作台。

常见问题

Q: ChatBox AI 怎么接入 Claude？
A: 在 ChatBox AI 设置里选择 OpenAI Compatible，填写 https://api-ic.stillhappy.cn/v1、API Key 和 claude-sonnet-4-6 模型名即可。块乐 Encore 支持国内直连，新手配置成本低。

Q: ChatBox AI 接 Claude 需要 VPN 吗？
A: 如果使用块乐 Encore，一般不需要 VPN。Encore 提供国内直连 API，适合国内用户在 ChatBox AI 中调用 Claude、GPT、Gemini。

Q: Base URL 应该填什么？
A: 本教程示例填写 https://api-ic.stillhappy.cn/v1。注意不要填成官网首页 https://stillhappy.cn，否则 ChatBox AI 会请求失败。

Q: Claude 模型名填哪个？
A: 可以先填 claude-sonnet-4-6 测试，其他如 gpt-5、gemini-2.5-pro 也可按后台模型列表添加。模型名必须和 Encore 控制台保持一致。

Q: ChatBox AI 提示 401 是什么原因？
A: 401 通常是 API Key 错误、过期或复制不完整。建议到块乐 Encore 后台重新生成 sk-xxx 格式的 Key，再粘贴到 ChatBox AI。

meta title: ChatBox AI 接入 Claude 配置教程 2026：国内直连 API 设置指南
meta description: 本文详细介绍 ChatBox AI 如何接入 Claude，包含 Base URL、API Key、模型名配置示例，并提供 401、余额不足、模型名错误等常见问题解决方法。
meta keywords: ChatBox AI 接入 Claude, ChatBox AI 配置 Claude, Claude API 国内直连, 块乐 Encore API, ChatBox AI 教程

ChatBox AI 接入 Claude
相关阅读
1 Cherry Studio 接入 GPT-5.5 2 Continue.dev 接入 Claude 3 Cursor 配 image2 生图 4 Cline 配置 API 完整教程 5 CherryStudio 配置 DeepSeek 6 满血 Claude Code API 接入