> ## 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.

# Global AI 客户端接入总览：常用参数与选型

> 汇总 Global AI 各类客户端接入所需的通用参数、模型分组说明，以及不同客户端类型的适配情况与选型建议。

Global AI 兼容 OpenAI、Claude 与 Gemini 三种协议，几乎所有主流 AI 客户端都可以接入。本页面汇总接入前必备的通用参数与选型建议，具体客户端配置见下方分类页面。

## 接入前准备

在配置任何客户端之前，请先完成以下两步：

<Steps>
  <Step title="兑换额度">
    如果您已经得到了兑换码，请到 [globalai.vip/wallet](https://globalai.vip/wallet) 的「兑换码」区域粘贴兑换码并点击兑换。也可以在站内直接 [在线充值](https://globalai.vip/wallet)。
  </Step>

  <Step title="获取 API 密钥">
    访问 [globalai.vip/keys](https://globalai.vip/keys)，复制系统默认令牌；如果没有，点击「添加令牌」新建一个即可。密钥以 `sk-` 开头，详见 [令牌管理](/usage/tokens)。
  </Step>
</Steps>

## 通用配置参数

绝大多数客户端只需要这四项信息：

| 参数                | 取值                                                 | 备注                                       |
| ----------------- | -------------------------------------------------- | ---------------------------------------- |
| API 主机 / Base URL | `https://globalai.vip` 或 `https://globalai.vip/v1` | 以客户端的填写规则为准；Claude 原生格式一般填不带 `/v1` 的主机地址 |
| API Key           | 你的 `sk-xxxxxxxx` 令牌                                | 在 [/keys](https://globalai.vip/keys) 复制  |
| 模型名称              | 见 [定价](https://globalai.vip/pricing)               | 直接复制模型 ID 粘贴到客户端                         |
| 提供方 / Provider    | OpenAI 或 Anthropic 或 自定义                           | 按目标模型协议选择                                |

<Note>
  粘贴 API 地址与密钥时请检查前后不要留空格，否则会出现连接失败。
</Note>

## 按客户端类型选择配置页

<CardGroup cols={2}>
  <Card title="ChatBox" icon="comments" href="/clients/chatbox">
    跨平台图形化聊天客户端，桌面端与手机端配置一致。
  </Card>

  <Card title="Cherry Studio" icon="cherries" href="/clients/cherry-studio">
    支持一键拉取全部可用模型的多提供商聊天客户端。
  </Card>

  <Card title="ChatWise" icon="messages" href="/clients/chatwise">
    在同一界面并存 OpenAI、Anthropic、Gemini 三个提供商。
  </Card>

  <Card title="Claude Code" icon="terminal" href="/clients/claude-code">
    官方 Claude Code CLI 在 Windows、macOS、Linux 的接入方法。
  </Card>

  <Card title="OpenAI Codex" icon="code-branch" href="/clients/codex">
    通过 CC Switch 或手动编辑配置文件接入 Codex CLI。
  </Card>

  <Card title="编程 Agent 插件" icon="robot" href="/clients/coding-agents">
    Cline、Roo Code、WorkBuddy 等 VS Code / Cursor 插件。
  </Card>

  <Card title="OpenCode / CC-Switch" icon="toolbox" href="/clients/opencode">
    OpenCode 配置文件与 CC-Switch 一键切换供应商。
  </Card>

  <Card title="Dify 工作流" icon="diagram-project" href="/clients/dify">
    通过 OpenAI-API-compatible 提供商接入 Dify。
  </Card>
</CardGroup>

## 遇到问题？

<CardGroup cols={2}>
  <Card title="常见错误代码" icon="triangle-exclamation" href="/faq#令牌与调用">
    401、403、429 等错误的排查思路。
  </Card>

  <Card title="联系客服" icon="headset" href="/faq">
    工作时间 09:00 - 23:00，商务合作、发票、退款均可咨询。
  </Card>
</CardGroup>


## Related topics

- [Global AI 常见问题：账号、令牌、调用与计费](/faq.md)
- [Cherry Studio 接入 Global AI：Claude、GPT、Gemini 配置](/clients/cherry-studio.md)
- [Cline、Roo Code、WorkBuddy 接入 Global AI 指南](/clients/coding-agents.md)
- [ChatBox 接入 Global AI：桌面与手机端配置](/clients/chatbox.md)
- [Claude Code 接入 Global AI：Windows、macOS 与 Linux 配置](/clients/claude-code.md)