> ## Documentation Index
> Fetch the complete documentation index at: https://docs.globalai.vip/llms.txt
> Use this file to discover all available pages before exploring further.

# ChatBox 接入 Global AI：桌面与手机端配置

> 在 ChatBox 桌面端与手机端接入 Global AI，填入平台地址与令牌即可调用 GPT、Claude、Gemini 模型。

ChatBox 是一款跨平台的图形化聊天客户端，支持自定义 OpenAI / Anthropic 兼容提供商，可直接接入 Global AI。本页面介绍完整的配置流程，桌面端与手机端配置方法一致。

<Warning>
  开始配置前请确保已完成 [接入总览](/clients/overview#接入前准备) 中的兑换与取密钥两步。
</Warning>

下载地址：[chatboxai.app](https://chatboxai.app)

## 配置步骤

<Steps>
  <Step title="进入设置">
    打开 ChatBox 主页，点击左下角「设置」。
  </Step>

  <Step title="选择模型提供方">
    进入「模型提供方」，选择 **Claude**（如需 GPT 也可选 OpenAI）。填写以下内容：

    * **API 密钥**：粘贴你的 `sk-` 令牌
    * **API 主机**：`https://globalai.vip/v1`
    * **路径**：留空（保持默认）
  </Step>

  <Step title="手动添加最新模型">
    ChatBox 内置模型列表可能不包含最新版本，需手动添加。点击「新建」，把 [定价页](https://globalai.vip/pricing) 复制的模型 ID（如 `claude-sonnet-5`）填入「模型 ID」，**能力部分建议全部勾选**，其他保持默认，点击保存。
  </Step>

  <Step title="开始对话">
    关闭设置页面，回到主页点击「新对话」，在右下角选择刚添加的模型，发送消息进行测试。AI 正常回复即接入成功。
  </Step>
</Steps>

## 排查

<AccordionGroup>
  <Accordion title="401 / 未授权">
    密钥复制不全或复制到空格。到 [/keys](https://globalai.vip/keys) 重新复制并核对。
  </Accordion>

  <Accordion title="连接超时 / 无法连接">
    最常见原因是开了代理或科学上网。请关闭所有代理软件后重试。
  </Accordion>

  <Accordion title="找不到某个模型">
    模型 ID 拼写错误，或该模型不在当前令牌允许范围内。到 [定价页](https://globalai.vip/pricing) 搜索确认拼写。
  </Accordion>
</AccordionGroup>


## Related topics

- [Global AI 客户端接入总览：常用参数与选型](/clients/overview.md)
- [OpenAI Codex 接入 Global AI：CC Switch 与手动配置](/clients/codex.md)
- [欢迎](/index.md)
- [Global AI 快速开始：从注册到首次 API 调用](/quickstart.md)
- [ChatWise 接入 Global AI：多提供商统一配置指南](/clients/chatwise.md)