# 快速开始 · 6 步上手 BeefAPI > 第一次用 AI API 中转? 跟着这 6 步走，10 分钟拿到你的 key + 跑通第一个工具。 > 老手可以直接跳第 4 步 (创建令牌) + 第 6 步 (CC Switch 一键导入)。  --- ## 1. 注册账号 打开 [https://beefapi.com](https://beefapi.com) → 右上 "**登录/注册**" → 填邮箱 + 验证码注册。 **支持登录方式**： - **邮箱 + 密码**：最稳，验证邮件可能进垃圾箱，先检查再申请补发 - **WebAuthn / Passkeys**：推荐，免密码 + 防钓鱼，支持 iPhone Face ID / Mac Touch ID / 1Password / YubiKey 等 注册后先进入控制台。新用户可以先加入 QQ 群 **912022855**，加群后私信群主，领取5 元体验额度；到账后再按下面步骤完成充值、创建令牌和工具配置。 > **遇到验证码收不到？** > > 1. 检查邮箱垃圾箱 / 广告分类 > 2. 在 "登录" 页点 "重新发送验证码" > 3. 仍然没有 → 联系在线客服处理 --- ## 2. 登录后到控制台 登录后默认进 `/console` 控制台。左侧菜单： | 菜单 | 用途 | | ------------------- | ---------------------------------------------------- | | **概览** | 余额 + 今日消费 + 模型调用统计 | | **聊天 · 在线体验** | 网页聊天入口，可先在浏览器里测试模型是否可用 | | **个人设置** | 改密码 / 绑 OAuth (Google/GitHub) / WebAuthn passkey | | **令牌** | 创建 API key（第 4 步） | | **充值** | 钱包充值入口（第 3 步） | | **日志** | 查每次请求的 model / token / 扣费明细 | > **提示**：左下角头像点开是 **主题切换 / 退出登录**。深色主题更适合长时间盯着代码看。 --- ## 3. 充值钱包 **侧栏 → 充值** → 选金额 → 选支付方式（支付宝）。 充值是**钱包额度**，不绑定具体模型，所有 group 共用同一个钱包余额扣费。 充值到账后，可以在 **概览** 看余额，在 **日志** 看每次请求的扣费明细。 --- ## 4. 创建 API 令牌 **侧栏 → 令牌 → 新建令牌**： | 字段 | 说明 | | ------------ | ------------------------------------------------------------------------------------------ | | **名称** | 自己识别用，比如 `claude-code-mac` / `codex-laptop` / `cherry-studio` | | **分组** | **关键！** 决定能用哪些模型和走哪套价格配置，见 [分组说明](/docs/onboarding/groups-models) | | **额度** | 单 key 限额。设 `0` = 不限（= 用完钱包余额） | | **过期时间** | 默认永不过期 | | **数量** | 一般 1 个，要批量给团队就调高 | ### 防坑：选错 group 会怎样？ 最常见错误：令牌选了 `claude-vip` 分组，但你工具填的模型是 `gpt-5.5` → **直接 404 `model_not_found`**。 **对应关系（粗略）**： | 你要用 | 选哪个 group | | -------------------------------------------------------------- | --------------------------------------------- | | Claude Code / Claude 系（claude-sonnet-4-6 / claude-opus-4-7） | `claude-vip` 或 `claude 特惠` | | Codex / ChatGPT 类（gpt-5.4 / gpt-5.5 / gpt-5.4-mini） | `gpt-plus` 或 `gpt-pro` | | 老 `gpt-vip` 分组 | 老分组不建议新建，切到 `gpt-plus` / `gpt-pro` | | 画图 `gpt-image-2` | 任意 `gpt-*` 分组 | 完整 group → model 映射说明见 [分组 / 模型](/docs/onboarding/groups-models)，实时价格配置以模型广场为准。 ### 立即复制 sk-xxx 创建后**马上复制完整 `sk-xxx` 字符串保存**，关闭页面再回来就只显示前后几位掩码了。 > 复制不到？点令牌行最右边的 "复制" icon，或者**删了重建一个新的**。 --- ## 5. 检查 base URL BeefAPI 的两个 endpoint： | 用途 | URL | | ---------------------------------------------------------------------------- | ------------------------ | | **OpenAI 兼容**（Codex / OpenAI SDK / Cherry Studio / NextChat / 自己 curl） | `https://beefapi.com/v1` | | **Anthropic 原生**（Claude Code / Claude SDK） | `https://beefapi.com` | > **⚠️ 注意 `/v1` 后缀** > > - OpenAI 兼容 CLI **必须**加 `/v1` > - Claude Code / Anthropic SDK **不要**加 `/v1`，直接用根域名 > > 装错 `/v1` 是 404 错误最常见的原因之一。 --- ## 6. 配置工具 ### 推荐：CC Switch 一键导入 **控制台 → API Key → 令牌行 → 一键接入** → 默认打开 **CC Switch** → 选择导入到 Codex / Claude Code / Claude Desktop / Hermes → 选模型 → 打开 CC Switch 确认导入。 Claude Desktop 用户注意：CC Switch 深链会先导入 Claude 供应商；导入后到 CC Switch 左侧 **Claude Desktop** 面板，点击 **将 Claude Code 中已有的供应商导入** 或手动启用该供应商，然后重启 Claude Desktop。  向导会自动： - 拉取你的真实 API Key - 构造 CC Switch 导入链接 - 按你选择的应用写入 Claude Code / Codex / Hermes 所需配置；Claude Desktop 需要在 CC Switch 的 Claude Desktop 面板导入/启用 - 自动带入 Key、接口地址和模型配置 ### 🧑‍💻 手动配置 Image2、自己写 SDK、以及其他 OpenAI Compatible 客户端看 [客户端配置](/docs/onboarding/clients)。 --- ## 验证跑通 任意工具配完后第一句话先打： ``` 你好，请告诉我你是什么模型，今天日期 ``` 模型回答出 "我是 Claude Sonnet 4 / GPT-5.5" 且日期合理 = 通了。 回答不出来 / 报错 → 看 [错误码排查](/docs/onboarding/errors)。 --- ## 下一步 - [分组 / 模型 / 价格](/docs/onboarding/groups-models) - 选对 group 防 404 - [客户端配置](/docs/onboarding/clients) - 手动 + 自动两种路线 - [API接口](/docs/onboarding/api) - 自己写 SDK / 单独查用量 - [错误码排查](/docs/onboarding/errors) - 401 / 429 / 524 / model_not_found - [常见问题](/docs/onboarding/faq) - 账号 / 充值 / 令牌 / 工具配置