让我们从这里开始吧！
从 0 开始的 BofT API 使用之旅~
一步步来，准没问题！
第一步：注册账号
- 打开注册入口后，点击页面右上角的“注册”。
- 如果你在登录页，也可以点击底部“没有账户？注册”进入注册流程。
方式一（推荐）：使用 Google 账号注册
- 点击“使用 Google 继续”。
- 在弹窗中选择要绑定的 Google 账号并完成授权。
- 授权成功后，系统会自动创建账号并登录。
使用 Google 注册无需额外设置密码，后续登录时继续选择同一个 Google 账号即可。
方式二：使用邮箱注册
- 点击“使用用户名注册”。
- 填写邮箱、用户名和密码。
- 按页面提示提交，完成注册。
注意
邮箱会用于接收验证与通知；密码建议使用字母、数字和特殊字符组合。请妥善保管登录凭证，避免账号被盗用。
第二步：登录账号
使用 Google 账号登录
- 点击“使用 Google 继续”。
- 选择注册时绑定的 Google 账号。
- 授权成功后即可自动登录。
使用邮箱/用户名登录
- 输入邮箱地址或用户名。
- 输入账号密码。
- 点击“继续”完成登录。
设备登录说明
浏览器会保持登录状态；在新设备需重复登录流程。
如果点击“使用 Google 继续”后出现“错误：OIDC 获取 Token 失败，请检查设置！”，通常是浏览器缓存或 Cookie 状态异常导致。
可以先清空浏览器缓存后重试：
- Windows / Linux Chrome：按
Ctrl + Shift + Delete打开清除浏览数据页面。 - macOS Chrome：按
Command + Shift + Delete打开清除浏览数据页面。
如果清理缓存后仍然无效，请手动删除 boft.ai 相关 Cookie：
- 在登录页按
F12打开开发者工具。 - 进入“应用”面板。
- 在左侧依次选择“存储” → “Cookie” →
https://www.boft.ai。 - 删除
session、TDC_itoken等站点 Cookie 后刷新页面，再重新登录。
第三步：购买额度
登录控制台后，进入左侧“钱包管理”页面购买额度。
- 在“选择充值额度”中选择固定额度，或在“自定义额度”中输入要充值的金额。
- 在“选择开票类型”中选择发票类型：
- 不需要大陆发票，选择
Invoice。 - 需要开大陆发票，选择“大陆发票”。
- 不需要大陆发票，选择
- 确认页面下方的“实付金额”后，点击“立即支付”。
支付说明
目前充值比例为 1:1，即 1 元人民币等同于 1 美元额度。如果使用支付宝或微信支付时没有弹出支付页面，请先关闭代理后重试。
第四步：创建 API 令牌
登录后进入控制台面板，左侧选择“令牌管理”。
进入令牌管理
- 在左侧菜单点击“令牌管理”。
- 点击页面上方的“添加令牌”。
创建新令牌
在弹窗中填写令牌信息：
- 令牌名称：用于区分不同用途，例如
Claude Code、Codex、Gemini。 - 令牌分组：必须选择，分组决定这个令牌可以使用哪些模型。
- 过期时间：默认“永不过期”，也可以按需要设置有效期。
- 新建数量：一般保持
1即可。 - 额度设置：开启“无限额度”时，令牌实际可用额度仍受账户余额限制。
- 访问限制：不熟悉时建议先保持默认，不要开启模型限制或 IP 白名单。
令牌分组一定要选对
令牌分组会直接影响可用模型。比如 Claude Code、Codex、Gemini CLI 需要选择对应分组；如果分组选错，后续配置 CLI 时很容易出现“模型不存在”或无法调用的问题。
如果你不确定每个分组适合什么场景，请先阅读 BofT API 各分组介绍。
填写完成后，点击右下角“提交”完成创建。
查看分组可用模型
你可以在“模型广场”查看每个令牌分组下支持哪些模型。
- 点击页面右上角“模型广场”。
- 在左侧“可用令牌分组”中选择分组。
- 右侧模型卡片会显示该分组可用的模型、价格和折扣倍率。
如果你想了解折扣含义，可以点击模型广场右上方的“折扣说明”。
第五步：环境检查
在配置 Claude Code、Codex 或 Gemini CLI 之前，请先确认本机已经正确安装 Node.js。
在 Windows、macOS 或 Linux 终端中执行：
npm list -g --depth-0如果命令可以正常执行，说明 Node.js 与 npm 已经可用。即使输出中没有安装任何全局包，也不影响后续配置。
如果提示“命令未找到”或类似错误，说明当前环境还没有安装 Node.js，或安装后没有正确加入系统环境变量。请先完成 Node.js 安装，再重新执行上面的命令确认。
必须先完成环境检查
CLI 工具依赖 Node.js 和 npm。环境没有准备好时，后续安装 Claude Code、Codex、Gemini CLI 都可能失败。
第六步：配置 CLI 工具
BofT API 支持在命令行中使用 Claude Code、Codex、Gemini CLI
基础条件
开始配置 CLI 前，请先完成以下步骤：
API 端点说明
登录控制台后，可以在“数据看板”右侧查看当前可用的 API Endpoint。
- 主站 Endpoint：
https://www.boft.ai，稳定可靠，适合生产环境。 - 优化线路 Endpoint：
https://api-slb.boft.ai，优化线路，适合对延迟敏感的场景。
OpenAI 兼容端点需要添加 /v1
如果你使用的是 OpenAI 兼容格式的客户端或工具，例如 Codex、OpenAI SDK、Cherry Studio 的 OpenAI 兼容配置，请在 API 地址后添加 /v1：
https://www.boft.ai/v1
https://api-slb.boft.ai/v1如果使用的是 Claude Code、Gemini CLI 等专用配置，请以对应教程中的示例为准。
推荐配置
为了让配置过程进行轻便简单，我们极力推荐使用Github开源项目 CC-Switch来对我们的使用环境进行配置。
如果你是老鸟，或者不愿意使用此工具，可以参考以下CLI配置教程文档，但我们还是极力推荐使用此工具，能省很多时间！
CLI 手动配置教程传送门
注意：不管你是使用哪个 CLI，请一定先完成上方基础条件，确保 Node.js、npm 和对应 CLI 都可以正常使用。