ChatBox 集成教程

ChatBox 是一款跨平台（Windows / Mac / Linux / iOS / Android）的 AI 桌面客户端，支持接入多种 OpenAI 兼容 API。

配置步骤

1. 下载安装

从 ChatBox 官网 下载对应平台的安装包并安装。

2. 添加自定义提供方

启动 ChatBox，点击左下角的「设置」齿轮图标。

在「模型提供方」中，选择「添加自定义提供方」：

配置项	填写内容
名称	玄州API（可自定义）
API 模式	OpenAI API 兼容
API 密钥	sk-xxxxxxxxxxxxxxxxxxxxxxxx
API 主机	https://xuanzhouapi.top
API 路径	/v1/chat/completions（默认即可）
模型	添加你需要使用的模型 ID

3. 添加模型

在模型列表中手动添加模型名称，一行一个：

gpt-5.5
gpt-5.5-s
claude-sonnet-4-6
claude-opus-4-7-s
deepseek-v4-pro
deepseek-v4-flash
gemini-3.5-flash
glm-5.1
kimi-k2.6

4. 测试连接

点击「检查」或「检查连接」按钮，提示"连接成功"即配置完成。

5. 开始使用

返回聊天界面，选择刚刚添加的模型即可开始对话。

高级设置

系统提示词

在对话设置中可以为每个对话设置系统提示词：

你是一个全栈开发工程师，精通 Python、TypeScript 和 Go。用中文回复。

会话参数

在聊天界面中可以调整以下参数：

• Temperature：控制回复的随机性（0-2，默认 1）
• 上下文消息数量：控制携带的历史消息数量

推荐设置

参数	推荐值	说明
模型	claude-sonnet-4-6	综合性价比最高
Temperature	0.7	保持创意同时不过于随机
上下文	10	兼顾上下文和 token 消耗

常见问题

1. 连接失败

• 确认 API 主机地址为 https://xuanzhouapi.top（不含路径）
• 确认 API 路径为 /v1/chat/completions
• 确认 API 密钥完整且未被禁用
• 可尝试勾选「改善网络兼容性」选项

2. 模型报错

• 确认模型名称拼写与模型广场完全一致
• 注意区分大小写

3. 移动端同步

ChatBox 支持数据多端同步，但 API 配置需要在每个设备上单独设置。