IMPORTANT给阅读者的忠告！
01
请你在部署使用前一定去看看 模型分组介绍 与 常见问题 板块，如果有时间最好阅读全文
02
我们一直提倡 "授人以鱼，不如授人以渔"
03
这两个板块不仅能提升你的使用体验，也能解答你今后会在群里提问的 90% 的问题
让我们从这里开始吧！
从 0 开始的 Xcode 使用之旅~
一步步来，准没问题！
¶ 第一步：注册账号
进入注册页 {#进入注册页}
- 打开注册入口后，输入相应信息进行注册。
- 如果你在登录页，也可以点击“没有账户？注册”进入注册流程。
方式一（推荐）：使用邮箱注册 {#方式二-使用邮箱注册}
- 点击“我已阅读并同意服务条款”。
- 填写邮箱、用户名和密码。
- 按页面提示提交，完成注册。
温馨提示
邮箱会用于接收验证与通知；密码建议使用字母、数字和特殊字符组合。请妥善保管登录凭证，避免账号被盗用。
** 方式二：使用 LinuxDo 账号注册 **
- 点击“我已阅读并同意服务条款”。
- 在弹窗中选择要登录的 LinuxDo 账号并完成授权。
- 授权成功后，系统会自动创建账号并登录。
使用 LinuxDo 注册无需额外设置密码，后续登录时继续选择同一个 LinuxDo 账号即可。
¶ 第二步：登录账号
使用邮箱/用户名登录
- 输入邮箱地址或用户名。
- 输入账号密码。
- 点击“继续”完成登录。
设备登录说明
浏览器会保持登录状态；在新设备需重复登录流程。
¶ 第三步：购买额度
登录控制台后，进入左侧“钱包”页面购买额度。
- 在“金额”中选择固定额度，或在“自定义金额”中输入要充值的金额。
- 确认页面下方的“实付金额”后，选择付款方式并点击。
支付说明
目前充值比例为 1:1，即 1 元人民币等同于 1 美元额度 。如果使用支付宝或微信支付时没有弹出支付页面，请先关闭代理后重试。
公告：开票服务调整
-
开票说明：本站发票由中国大陆合作伙伴协助开具，开票主体与本站无直接关系，实际开票信息及处理结果以合作伙伴为准。
-
特别注意：下单支付主体与发票开具主体并非同一主体，请在支付及提交开票申请前充分知悉并确认。
-
开票时效：发票将在提交申请后的五个工作日内开具，并发送至您填写的邮箱，请注意查收。
-
开票提醒：发票开具后不支持重开或作废，请仔细核对开票信息后再提交。
-
服务范围：本站不支持出具发票以外的各类证明、说明或资质文件。
-
提交确认：请您充分理解并同意以上内容；如不同意，请勿提交申请，并通过工单申请退款。
¶ 第四步：创建 API 令牌
登录后进入控制台面板，左侧选择“API密钥”。
¶ 进入令牌管理
- 在左侧菜单点击“API密钥”。
- 点击页面右上方的“创建API密钥”。
¶ 创建新令牌
在弹窗中填写令牌信息：
- 名称：用于区分不同用途，例如
Claude Code、Codex、Gemini。 - 分组：必须选择，分组决定这个令牌可以使用哪些模型。
- 过期时间：默认“永不过期”，也可以按需要设置有效期。
- 新建数量：一般保持
1即可。 - 额度设置：开启“无限额度”时，令牌实际可用额度仍受账户余额限制。
- 访问限制：不熟悉时建议先保持默认，不要开启模型限制或 IP 白名单。
令牌分组一定要选对
令牌分组会直接影响可用模型。比如 Claude Code 选 claude官号仅支持CC 分组、Codex 选 ChatGPT-VIP 分组；使用 Gemini 模型（Cline / Roo Code 等）时选 gemini 分组。如果分组选错，很容易出现“模型不存在”或无法调用的问题。
如果你不确定每个分组适合什么场景，请先阅读 Xcode 各分组介绍。
填写完成后，点击右下角“保存更改”完成创建。
¶ 查看分组可用模型
你可以在“模型广场”查看每个令牌分组下支持哪些模型。
- 点击页面右上角“模型广场”。
- 在左侧“可用令牌分组”中选择分组。
- 右侧模型卡片会显示该分组可用的模型、价格和折扣倍率。
¶ 第五步：环境检查
在配置 Claude Code、Codex 或 Grok Build 之前，请先确认本机已经正确安装 Node.js。
在 Windows、macOS 或 Linux 终端中执行：
npm list -g --depth-0
如果命令可以正常执行，说明 Node.js 与 npm 已经可用。即使输出中没有安装任何全局包，也不影响后续配置。
如果提示“命令未找到”或类似错误，说明当前环境还没有安装 Node.js，或安装后没有正确加入系统环境变量。请先完成 Node.js 安装，再重新执行上面的命令确认。
必须先完成环境检查
CLI 工具依赖 Node.js 和 npm。环境没有准备好时，后续安装 Claude Code、Codex 等都可能失败。
¶ 第六步：配置 CLI 工具
Xcode 支持在命令行中使用 Claude Code、Codex、Grok Build。
不提供 Gemini CLI 教程
Google 官方 Gemini CLI 目前稳定性较差，几乎无法正常使用，本站不再提供 其安装与配置教程。使用 Gemini 模型请参考 Gemini 相关问题。
¶ 基础条件
开始配置 CLI 前，请先完成以下步骤：
¶ API 端点说明
登录控制台后，可以在“概览”左下角查看当前可用的 API Endpoint。
- 主站 Endpoint：
https://xcode.best，稳定可靠，适合生产环境。
OpenAI 兼容端点需要添加 /v1
如果你使用的是 OpenAI 兼容格式的客户端或工具，例如 Codex、OpenAI SDK、Cherry Studio 的 OpenAI 兼容配置，请在 API 地址后添加 /v1：
https://xcode.best/v1
如果使用的是 Claude Code 等专用配置，请以对应教程中的示例为准。
推荐配置
为了让配置过程进行轻便简单，我们极力推荐 使用 Github 开源项目 CC-Switch 来对使用环境进行配置。
CC-Switch 配置 Claude Code、Codex 教程
如果你是老鸟，或者不愿意使用此工具，可以参考以下 CLI 配置教程文档，但我们还是极力推荐使用此工具，能省很多时间！
CLI 手动配置教程传送门
注意：不管你是使用哪个 CLI，请一定先完成上方基础条件，确保 Node.js、npm 和对应 CLI 都可以正常使用。