ChatBox 接入 Claude/GPT 配置指南

ChatBox 是一款流行的桌面 AI 聊天客户端，支持自定义 API 地址。如果你想在 ChatBox 里用上 Claude Opus 4.6 或 GPT-5.4，只需要一个 API 聚合平台的 Key 和三步配置。

为什么用 ChatBox？

ChatBox 的优势在于本地运行、隐私友好、支持多模型切换。很多开发者用它来做日常 AI 对话、代码辅助、文档翻译。但 ChatBox 默认只支持 OpenAI 官方 API，想用 Claude 就需要借助兼容 OpenAI 格式的聚合平台。

配置步骤

1. 获取 API Key

在 API 聚合平台（如 yapi.uk）注册账号，获取 API Key，充值一点余额。

2. 打开 ChatBox 设置

启动 ChatBox → 点击左下角设置图标 → 选择「AI 模型提供商」

3. 填写配置

• API 提供商：选择「OpenAI API」
• API 地址：填入 https://yapi.uk/v1
• API Key：填入你的 Key
• 模型：手动输入模型名称，比如 claude-opus-4-6 或 gpt-5.4

点击保存，然后在对话界面选择对应模型就能用了。

多模型切换技巧

ChatBox 支持保存多个模型配置。你可以同时配置 Claude 和 GPT，在不同对话中切换使用：

• 日常对话、翻译 → Claude Sonnet 4.6（速度快、便宜）
• 复杂编程、推理 → Claude Opus 4.6
• 创意写作 → GPT-5.4

这样一个 API Key 就能在 ChatBox 里自由切换多个模型。

验证是否配置成功

配置完成后，发一条消息测试。如果能正常收到回复，说明配置成功。如果报错：

• 401 错误：API Key 不对，检查是否复制完整
• 404 错误：模型名称不对，确认平台支持的模型名
• 429 错误：请求太频繁或余额不足，检查控制台余额
• 网络错误：检查 API 地址是否填对，注意 https:// 前缀

注意事项

• ChatBox 的 API 地址末尾不要加 /chat/completions，只填到 /v1 即可
• 模型名称要和平台支持的完全一致，大小写敏感
• 流式输出默认开启，如果遇到问题可以在设置里关闭试试

常见问题

Q: 手机版 ChatBox 也能这样配置吗？

A: 是的，ChatBox 的 iOS 和 Android 版本同样支持自定义 API 地址，配置方式一样。

Q: 为什么回复速度比较慢？

A: 可能是模型本身的推理时间（Opus 比 Sonnet 慢），也可能是网络延迟。可以先试试 Sonnet 模型对比速度。