大约 6 分钟
（4）认识令牌
这一步要做什么
- 搞清楚什么是令牌、它跟密码有什么区别
- 知道注册时就已经有 6 把令牌，你直接用就行
- 看懂令牌分组是什么意思（决定你能调哪类模型）
- 想自己建新令牌时知道怎么建、要选什么分组
- 全程 1 分钟以内（如果直接用预设令牌，连建都不用建）
令牌管理页：https://www.yuzhixiaolongxia.com/console/token
或从控制台左侧菜单点 "令牌管理" 进入。
令牌到底是什么
一句话解释
令牌就是一串很长的"密码"，用来告诉平台"是我在调用模型"。
- 跟你的登录密码不一样：登录密码用来登网页后台；令牌用来给程序、命令行工具、第三方客户端用
- 一个账号可以建很多把令牌，互相独立：一把出问题（比如泄露了），删掉就行，不影响其他令牌和账号
- 令牌长这样（示意）：
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
令牌要严格保密
令牌就是钱。任何人拿到你的令牌都能用你的余额调用模型。所以：
- 不要把令牌发到聊天群、工单截图、公开仓库
- 不要把令牌写在源代码里然后上传到 GitHub
- 怀疑泄露 → 立刻去令牌管理页删掉那把令牌，再建一把新的
好消息：你已经有 6 把令牌了
注册即得，开箱即用
注册成功的那一刻，平台自动给你建好了 6 个预设令牌分组：
| 分组名 | 能调用什么 | 典型用途 |
|---|---|---|
| Claude 家族 | Claude 系列模型 | 写代码、长文本对话 |
| Codex 家族 | Codex 系列模型 | 写代码、工程任务 |
| Gemini 家族 | Gemini 系列模型 | 多模态、超长上下文 |
| 图片 | 图片生成模型 | 文生图、参考图生图 |
| 视频 | 视频生成模型 | 文生视频、图生视频 |
| 外接渠道 | 其他模型 | 偏门需求 |
进令牌管理页就能看到这 6 把，直接复制令牌字符串就能用。不需要自己创建。
什么是"令牌分组"
分组决定这把令牌能调用哪类模型。这是新手最容易踩的坑：
分组选错会出现这种现象
- 你拿了一把"图片分组"的令牌
- 然后在 Claude Code 客户端里粘贴它
- 客户端会一直报错 "该模型在分组下不可用" 或 403
- 不是令牌坏了，是分组对不上模型类型
记住这个对应关系：
| 想干什么 | 用哪个分组的令牌 |
|---|---|
| 用 Claude Code 写代码 | Claude 家族 |
| 用 Codex / OpenAI 兼容工具 | Codex 家族 |
| 用 Gemini CLI | Gemini 家族 |
| 用 Cherry Studio 画图 | 图片 |
| 用 Cherry Studio 出视频 | 视频 |
自己建一把新令牌
如果预设的 6 把不够用（比如你想做权限隔离、按设备分开、给团队不同人不同令牌），可以自己建。
建令牌的步骤
- 进入 令牌管理页（左侧菜单 → 令牌管理）
- 点页面右上角的 "添加令牌" 或 "+" 按钮
- 弹出创建表单，按下面表格填
- 点 "提交"
表单字段建议
| 字段 | 建议填什么 | 说明 |
|---|---|---|
| 令牌名称 | 工具-用途-设备，例如 claude-test-笔记本 | 方便以后找是哪台机器哪个工具用的 |
| 令牌分组 | 按上面表格选对应分组 | 必选项，选错会用不了 |
| 过期时间 | 第一次建议 30 天 / 90 天 | 临时令牌设短一点；长期用就设长 |
| 额度限制 | 测试令牌设个小数（比如 5 元） | 防止脚本失控把余额全跑光 |
| 访问限制 | 默认就行 | 不熟先别动，能用再说 |
创建时必须选分组
平台强制要求你建令牌时选一个分组。不选会直接报错。这是为了避免"令牌建出来了但调啥都不行"的尴尬。
创建成功后立刻保存
令牌只完整显示一次
创建成功后，完整令牌字符串只会显示一次。如果你直接关掉页面再来看，就只能看到打码版的（前几位 + ***）。
离开页面前必须做的事：
- 复制完整令牌（点令牌旁边的复制按钮）
- 粘贴到密码管理器（如 1Password、Bitwarden、浏览器密码管理器）
- 顺手记一下用途：
名称：claude-test-笔记本
分组：Claude 家族
用途：本机首次接入测试
到期：2026-06-15万一没存到，删了重建一把就行，损失只是 1 分钟时间。
怎么查可用的模型 ID
不同模型有不同的 API 模型 ID（比如 claude-opus-4-7、gemini-3.1-pro-preview）。你在客户端配置或写代码调用时需要填这个 ID。
一个地方查全部
打开 模型广场：https://www.yuzhixiaolongxia.com/pricing
页面上会列出：
- 所有可用的模型名称
- 每个模型的 API 模型 ID（点旁边的复制按钮直接复制）
- 每个模型的价格 / 倍率
- 每个模型属于哪个分组
配工具时拿不准模型 ID 就来这里复制。
多令牌管理的好习惯
如果你要长期、严肃地用平台，建议：
| 场景 | 建议做法 |
|---|---|
| 自己一个人随便玩 | 直接用预设的 6 把就够 |
| 给团队多个人用 | 每人一把单独的令牌，互不影响；离职就吊销那一把 |
| 同时管多台机器 | 每台设备一把单独的令牌，名字里写清设备名 |
| 测试 + 生产 | 各建一把，测试令牌额度卡死，生产令牌正式名 |
不要图省事用一把令牌跑所有事。一旦出问题（泄露、超额、报错），排查成本会高很多。
常见令牌错误对照表
| 现象 | 大概原因 | 怎么解决 |
|---|---|---|
401 | 令牌字符串复制不全 / 多了空格 / 被删了 | 重新复制完整令牌；确认令牌还在管理页 |
403 | 余额不足 / 令牌被禁用 / 设了额度上限被超了 | 看钱包余额、看令牌状态、看令牌单独额度 |
model_not_found 或 "该模型在分组下不可用" | 分组选错了 | 换成正确分组的令牌；或建一把新令牌选对分组 |
429 | 请求太频繁 | 稍等一下再试，或在代码里加退避重试 |
上一步：（3）充值额度 下一步：（5）测试令牌可用性