很多人想用 Claude,但不想每次都打开浏览器、登录网页、等加载。更麻烦的是,网页版没有本地数据持久化,换了设备聊天记录就没了。
Chatbox 解决的就是这个问题——一个开源的 AI 桌面客户端,装上以后像用微信一样用 Claude,聊天记录存在本地,支持全平台同步。
这篇文章教你从零开始:下载 Chatbox、在 apito.ai 获取 Claude API Key、填好参数、开始对话。全程不需要写代码,操作简单。
01 Chatbox 是什么
Chatbox 是一款开源的 AI 对话客户端,GitHub 上超过 20K Star。它的核心定位是:一个界面,接入所有主流大模型。
你不需要为 Claude 装一个客户端,为 GPT 装另一个,为 DeepSeek 再装一个。Chatbox 一个应用全搞定,切换模型只需要点一下下拉框。
核心特点:
- 全平台支持:Windows、macOS、Linux、iOS、Android、网页版,六端通用
- 本地存储:聊天记录存在你自己的设备上,不走云端,隐私有保障
- 多模型接入:Claude、GPT、DeepSeek、Gemini、本地模型,一键切换
- 免费开源:客户端本身完全免费,你只需要为大模型的 API 调用付费
- 支持自定义 API 地址:可以接入第三方 API 中转服务,国内网络可直接使用
和 Claude 网页版的区别:
| 维度 | Claude 网页版 | Chatbox + Claude API |
|---|---|---|
| 聊天记录 | 存在 Anthropic 云端 | 存在你本地设备 |
| 多设备同步 | 需要登录同一账号 | 导出/导入即可迁移 |
| 模型切换 | 只能用 Claude | Claude/GPT/DeepSeek 随意切 |
| 网络要求 | 需要稳定访问 claude.ai | API 调用,中转服务可解决 |
| 费用 | 按月订阅 $20 | 按 Token 用量付费 |
| 离线使用 | 不支持 | 历史记录可离线查看 |
简单说:如果你只是偶尔用用 Claude,网页版够了。如果你想日常高频使用、多模型切换、本地保存记录,Chatbox 是更好的选择。
02 第一步:下载安装 Chatbox
访问 Chatbox 官网:chatboxai.app
根据你的设备选择对应版本下载:
- Windows:下载 .exe 安装包,双击安装
- macOS:根据芯片选择 Intel 版或 Apple Silicon 版,拖入 Applications 文件夹
- Linux:提供 AppImage 和 deb 包
- iOS:App Store 搜索「Chatbox」
- Android:官网下载 .apk 安装,或 Google Play 搜索
- 网页版:直接访问 web.chatboxai.app,无需安装
安装完成后打开 Chatbox,你会看到一个干净的对话界面,左侧是对话列表,右侧是聊天区域。第一次使用需要配置模型提供方。

华为手机注意:需要在「设置」→「系统和更新」中关闭「纯净模式」才能安装第三方 apk。
03 第二步:在 apito.ai 获取 Claude API Key
Chatbox 装好了,接下来需要拿到 Claude API 的接入凭证。我们通过 apito.ai 来中转。
为什么用 apito.ai
直接注册 Anthropic 官方 API 会遇到几个问题:需要海外信用卡、网络不稳定、延迟高。apito.ai 作为独立的第三方 Claude API 接入服务,解决了这些痛点:
| 维度 | Anthropic 官方 | apito.ai |
|---|---|---|
| 注册门槛 | 需要海外信用卡 | 支持国内支付 |
| 网络稳定性 | 国内访问不稳定 | 国内直连,低延迟 |
| 平均延迟 | 取决于网络 | 较低(以实际测试为准) |
| 价格 | 官方标准价 | 有一定价格优势,具体以官网为准 |
| 模型支持 | 全部 Claude 模型 | 同步官方模型 |
| SDK 兼容 | 原生 | 兼容 OpenAI API 格式 |
| 数据留存 | 官方政策 | 据官方介绍不留存用户数据 |
以上信息基于 apito.ai 官方公开资料整理,实际表现请以平台最新政策为准。
apito.ai 的工作方式是将你的 API 请求转发至 Anthropic 官方上游。据官方介绍,转发过程不存储用户数据、不修改请求内容。对你来说,使用方式和直连官方基本一致,唯一的区别是 Base URL 换成了 https://gw.apito.ai。
注册并获取 API Key
- 访问 apito.ai
- 注册账号,支持国内信用卡支付
- 进入控制台,点击「新建」创建密钥

- 在密钥列表中找到刚创建的 Key,点击复制按钮

同时记下页面上方的「默认线路」地址,这就是你接下来要填入 Chatbox 的 Base URL。
记下两个信息,下一步要用:
- API Key:你刚复制的密钥
- Base URL:
https://gw.apito.ai
04 第三步:在 Chatbox 中配置
桌面版(Windows / macOS)
以 Windows 版为例,macOS 操作完全一致。
第一步:打开设置
启动 Chatbox,在主界面左下角点击齿轮图标(设置),或者第一次启动时选择「使用自己的 API Key 或本地模型」。
第二步:选择模型提供方
在设置页面的「模型提供方」列表中,选择 Claude(或点击「+ 添加」创建自定义提供方)。
如果你的 Chatbox 版本里没有单独的 Claude API 选项,选择 OpenAI API Compatible,然后在 API 格式中选择 Anthropic 格式。新版 Chatbox 已原生支持 Claude API。
第三步:填写 API 配置
选择 Claude 后,在右侧配置区域填入以下参数:
| 参数 | 填写内容 |
|---|---|
| API Key | 你从 apito.ai 控制台复制的 Key |
| API 域名(API Host) | https://gw.apito.ai |
| 模型 | claude-sonnet-4-6 或其他 Claude 模型 |

如上图所示,红色方框标注的两个字段是关键:API 密钥填入你在 apito.ai 控制台复制的 Key,API 主机从默认的 https://api.anthropic.com/v1 改为 https://gw.apito.ai。下方会自动预览完整的请求地址 https://gw.apito.ai/v1/chat/completions。
第四步:选择模型
Chatbox 支持手动输入模型名称。当前推荐的 Claude 模型:
| 模型名称 | 定位 | 适用场景 |
|---|---|---|
claude-opus-5 |
旗舰推理 | 复杂推理、长文档分析 |
claude-sonnet-5 |
均衡 | 日常对话、写作、代码 |
claude-haiku-4-5 |
快速轻量 | 快速问答、简单任务 |
claude-opus-4-7 |
高级推理 | 代码审查、技术分析 |
claude-sonnet-4-6 |
通用 | 日常使用首选 |
不知道选哪个?先用 claude-sonnet-4-6,日常使用性价比较高。
在 Chatbox 的模型列表中,点击模型名称即可选择。你也可以点击「+ 新建」手动添加模型,或点击「Fetch」从 API 自动拉取可用模型列表。

第五步:保存并测试
点击「保存」,然后点击 API Key 旁边的「Check」按钮测试连接。如果配置正确,会弹出测试结果窗口,显示「连接成功」并逐项验证文本请求、图片请求、工具调用请求。

测试通过后,回到主界面,新建一个对话,输入「你好」,如果 Claude 正常回复,说明配置完全成功。

如上图所示,在对话界面可以随时通过底部的模型选择器切换不同的 Claude 模型。
移动版(iOS / Android)
移动版配置和桌面版基本一致。
iOS:
- App Store 搜索「Chatbox」安装
- 打开应用,点击左上角菜单图标
- 进入「设置」→「模型提供方」
- 选择 Claude API
- API Key 填 apito.ai 的密钥,API 域名填
https://gw.apito.ai - 选择模型,保存
Android:
- 官网下载 .apk 安装包(部分手机需关闭纯净模式)
- 打开应用,点击左上角菜单
- 进入「设置」→「模型提供方」
- 选择 Claude API
- 同上填写 apito.ai 的 API Key 和 Base URL
- 选择模型,保存
移动版注意事项:
- 移动端不支持本地模型运行,必须配置远程 API
- 建议在 WiFi 环境下使用,移动网络下 API 调用可能产生额外流量
网页版
不想安装客户端?Chatbox 提供网页版。
- 浏览器访问 web.chatboxai.app
- 首次进入选择「Use My Own API Key / Local Model」
- 点击「Settings」进入设置
- 模型提供方选择 Claude API
- API Key 填 apito.ai 密钥,API 域名填
https://gw.apito.ai - 填模型名称,点击「Save」保存
网页版适合临时使用,聊天记录存在浏览器本地存储中,清除浏览器数据会丢失记录。
05 常见问题排查
配置过程中最容易遇到的 5 个问题:
问题 1:API 报错 401 Unauthorized
原因:API Key 不正确或已过期。
解决:
- 检查 API Key 是否完整复制(不要多空格或少字符)
- 登录 apito.ai 控制台确认 Key 没有过期或被撤销
- 确认 API Key 和 Base URL 都是 apito.ai 的(不要混用其他平台的 Key)
问题 2:API 报错 404 Not Found
原因:Base URL 配置错误。
解决:
- apito.ai 的 Base URL 是
https://gw.apito.ai - 不要加
/v1后缀 - 不要在末尾加斜杠
问题 3:API 报错 429 Too Many Requests
原因:请求频率超过限制。
解决:
问题 4:连接超时或无法访问
原因:网络问题。
解决:
- apito.ai 国内直连,正常情况无需额外网络配置
- 检查防火墙是否拦截了 Chatbox 的网络请求
- 换个网络环境试试(比如手机热点)
问题 5:模型名称不识别
原因:模型名称拼写错误或该模型不在你的 API 权限范围内。
解决:
- 确认模型名称拼写正确(区分大小写和连字符)
- 在 apito.ai 控制台查看支持的模型列表
- Claude 模型名称参考:
claude-sonnet-4-6、claude-opus-4-7、claude-haiku-4-5
06 进阶使用技巧
配置成功只是开始,这几个技巧能让你用得更好。
技巧 1:设置 System Prompt
在 Chatbox 的设置中,你可以为每个对话设置 System Prompt(系统提示词)。这相当于给 Claude 一个角色设定。
例如,设置 System Prompt 为:
你是一个专业的技术文档编辑。回答问题时:
1. 使用简洁清晰的中文
2. 代码示例用 Markdown 代码块包裹
3. 涉及专业术语时附上简短解释
你是一个专业的技术文档编辑。回答问题时:
1. 使用简洁清晰的中文
2. 代码示例用 Markdown 代码块包裹
3. 涉及专业术语时附上简短解释
这样每次对话 Claude 都会按这个风格回答。

技巧 2:调整 Temperature 参数
Temperature 控制回答的随机性:
- 0 - 0.3:适合代码生成、数据分析,回答更确定
- 0.4 - 0.7:适合日常对话、写作,平衡创意和准确
- 0.8 - 1.0:适合头脑风暴、创意写作,回答更多样
在 Chatbox 设置中可以调整这个值。日常使用建议 0.7。

技巧 3:多模型切换
Chatbox 支持配置多个模型提供方。你可以同时配置 Claude API 和 GPT API,在对话时随时切换。

技巧 4:导出聊天记录
Chatbox 的聊天记录存在本地。你可以:
- 导出为 Markdown 文件,方便整理和归档
- 导出为 JSON 格式,方便迁移到其他工具
- 导入其他 Chatbox 实例的记录,实现设备间迁移

技巧 5:使用快捷指令
Chatbox 支持自定义快捷指令(Prompt Templates)。你可以把常用的提示词保存为模板,下次直接调用。
例如保存一个「周报生成」模板:
请根据以下要点生成一份周报:
1. 本周完成的工作
2. 遇到的问题
3. 下周计划
格式要求:分三段,每段 3-5 条,语言简洁。
请根据以下要点生成一份周报:
1. 本周完成的工作
2. 遇到的问题
3. 下周计划
格式要求:分三段,每段 3-5 条,语言简洁。
需要时一键插入,不用每次重新打字。
07 总结
Chatbox + apito.ai + Claude API,三步完成配置:
- 下载 Chatbox:chatboxai.app
- 在 apito.ai 注册,获取 API Key
- Chatbox 里填入 Key 和 Base URL(
https://gw.apito.ai),保存
这套组合适合国内个人用户使用 Claude:



