Skip to main content
更新日期：2026-06-06
ChatBox 是一款常见的跨平台 AI 客户端，支持 Windows、macOS、Linux，也有 Web 端。对接 Crazyrouter 时，建议优先使用 ChatBox 的 OpenAI API Compatible 或 OpenAI API 方式配置，而不是去找特定厂商预设。 这类接法的优点是：
  • 配置简单，适合普通用户快速接入
  • 可以直接切换 Crazyrouter 已放行的模型
  • 适合桌面对话、知识库问答、文件辅助阅读等使用场景

​
先说结论

推荐优先使用下面这组配置：
  • Provider / API Mode：OpenAI API Compatible 或 OpenAI API
  • API Host：https://api.crazyrouter.com
  • API Path：保持默认或留空
  • API Key：sk-xxx
  • 首个验证模型：gpt-5.5
根据 ChatBox 官方文档，API Path 一般不需要手动填写，默认就是 OpenAI 兼容聊天路径。因此在 Crazyrouter 文档里，推荐把 API Host 写成根域名 https://api.crazyrouter.com，不要先手动补 /v1/chat/completions。

​
适合谁用

  • 想在桌面端快速使用 Crazyrouter 的用户
  • 想做多模型日常对话、翻译、摘要、写作辅助的人
  • 想把本地知识库或文件问答能力与 Crazyrouter 结合的人
  • 不想写代码，只想在 GUI 里完成配置的人

​
前置条件

建议首轮只放行：
  • gpt-5.5
  • claude-opus-4-8
  • gemini-3.1-pro

​
安装 ChatBox

​
Windows

  1. 打开 ChatBox 官网
  2. 下载 Windows 安装包
  3. 双击安装
  4. 完成后启动 ChatBox

​
macOS

  1. 打开 ChatBox 官网
  2. 下载 macOS 安装包
  3. 拖动到 Applications
  4. 首次打开时如遇系统安全提示，按系统提示完成放行

​
Linux

  1. 打开 ChatBox 官网
  2. 下载适合你的发行版的安装包或桌面版本
  3. 安装后启动 ChatBox
如果你只是先验证 Crazyrouter 是否能在 ChatBox 中跑通，优先使用桌面客户端，不要一开始就同时折腾多端同步、知识库和复杂模型列表。

​
推荐配置方式

ChatBox 不同版本界面名称可能略有不同，常见入口包括：
  • Settings
  • Model Provider
  • AI Provider
  • Add
如果你当前版本已经内置了 OpenAI API 提供商，直接选它即可；如果没有，就新增一个 OpenAI API Compatible 提供商。

​
配置步骤

1

第 1 步：在 Crazyrouter 创建 ChatBox 专用 token

第一次建议只放行 1 到 2 个模型，例如：
  • gpt-5.5
  • claude-opus-4-8
这样更容易定位问题，不会因为模型太多导致排障范围过大。
2

第 2 步：打开 ChatBox 设置

启动 ChatBox 后，点击左下角的设置入口，然后进入：
  • Model Provider
  • 或 AI Provider
3

第 3 步：选择或新增 OpenAI 兼容提供商

推荐两种情况：
  • 如果已有 OpenAI API，直接选择
  • 如果没有，点击 Add，新增一个 OpenAI API Compatible 提供商
4

第 4 步：填写 Crazyrouter 连接信息

推荐填写：
  • API Host: https://api.crazyrouter.com
  • API Path: 保持默认或留空
  • API Key: sk-xxx
如果界面里要求填写提供商名称，可写成 Crazyrouter。
5

第 5 步：添加首个模型

第一次只建议加一个模型：
  • gpt-5.5
等最小链路验证通过后，再逐步加入：
  • claude-opus-4-8
  • gemini-3.1-pro
6

第 6 步：使用 Check 或 Save 先做连通性测试

如果你的 ChatBox 版本有 Check 按钮，先点 Check。如果只有 Save，先保存，然后返回主界面新建会话测试。
7

第 7 步：在主界面做首轮最小验证

新建一个聊天，确保当前模型是 gpt-5.5，输入：
如果能稳定返回 OK 或接近结果，说明 ChatBox 到 Crazyrouter 的主链路已经通了。

​
推荐验证顺序

建议按这个顺序做，不要一上来就开很多模型和功能：
  1. 先只配 1 个 token
  2. 先只配 1 个模型 gpt-5.5
  3. 先只做纯文本聊天验证
  4. 再增加第二个模型
  5. 最后再启用知识库、文件问答或复杂会话参数

​
推荐模型

​
ChatBox 常见功能怎么搭配 Crazyrouter

​
普通聊天

最简单，优先用来验证配置是否正确。

​
知识库 / 文件问答

建议在普通聊天已经跑通之后再启用。第一次测试时：
  • 文件尽量小
  • 内容尽量清晰
  • 先验证单文件问答
不要在尚未确认 API 配置正确时，直接用大量文件做复杂知识库测试。

​
多模型切换

适合在 ChatBox 里做不同任务分工，例如：
  • 默认基线聊天：gpt-5.5
  • 重要总结与写作：claude-opus-4-8
  • 首轮标准验证：gpt-5.5

​
参数建议

如果你的 ChatBox 版本支持常见采样参数，建议第一次保持保守：

​
Token 最佳实践

​
验证清单

  • 已安装 ChatBox 并能正常启动
  • 已创建 ChatBox 专用 Crazyrouter token
  • 已选择 OpenAI API 或 OpenAI API Compatible
  • API Host 已填写为 https://api.crazyrouter.com
  • API Path 已保持默认或留空
  • 已成功填写 sk-xxx
  • 已先只添加 gpt-5.5
  • 已通过 Check 或最小对话完成验证
  • Crazyrouter 后台日志中能看到对应请求

​
常见错误与修复

​
FAQ

​
ChatBox 里应该选哪个 Provider？

优先选 OpenAI API 或 OpenAI API Compatible。

​
API Host 该填什么？

填 https://api.crazyrouter.com。

​
要不要手动填写 /v1/chat/completions？

一般不需要。按照 ChatBox 官方文档，API Path 通常有默认值，先保持默认或留空即可。

​
第一个模型推荐填什么？

先填 gpt-5.5。

​
什么时候再加更多模型和知识库？

等最小聊天链路验证通过后，再逐步增加。
如果你的目标是“先把 ChatBox 跑通”，最好的做法不是一次性配很多模型和功能，而是先用 gpt-5.5 把最小聊天链路验证成功。