分组管理
大约 5 分钟
分组管理
这一页讲操作:怎么创建新令牌、怎么删除、怎么续期、多令牌怎么管。
操作入口
一、新建令牌
步骤
- 打开
/console/token - 点右上角 "新建令牌" 按钮
- 按下面字段表填写
- 点 保存,列表里会出现新的令牌,把
sk-xxxx字符串复制走(只显示一次)
字段含义
| 字段 | 必填 | 说明 |
|---|---|---|
| 名称 | 是 | 自己看的,建议起跟用途相关的(vscode-claude-code、n8n-生图、小张-codex) |
| 分组 | 是 | 选 6 个预设分组之一,不选会报错;分组决定这个令牌能调哪些模型 |
| 过期时间 | 否 | 不填默认永不过期;填了到期后令牌自动失效 |
| 额度限制 | 否 | 给令牌设个花钱上限,达到上限后令牌失效,避免被滥用 |
必须选分组
新建令牌时分组字段不能空。如果不知道选哪个,回分组基础的对照表查。
创建时的常见错误
| 症状 | 原因 | 怎么改 |
|---|---|---|
| 提示"必须选择分组" | 分组下拉框没选 | 选一个分组再保存 |
创建成功但找不到 sk- | 没复制就关掉了窗口 | sk-xxxx 只显示一次,关掉就只能重新创建 |
| 名称重复报错 | 已经有同名令牌 | 起个区分度更高的名字 |
二、删除令牌
- 打开
/console/token - 找到要删的令牌
- 点行末的 删除 按钮
- 弹窗确认
删除不可恢复
删除后该令牌立即失效——所有还在使用这个令牌的工具会马上开始报 401。删之前务必确认没有线上服务在用。
三、续期 / 修改额度
- 在令牌列表里找到目标令牌
- 点 编辑 按钮
- 修改"过期时间"或"额度限制"
- 保存
修改过期时间相当于续期;修改额度可以临时上调或下调。
四、多令牌场景
为什么要建多个令牌
预设的 6 张令牌已经够覆盖日常工具了,但有些场景值得再创建独立令牌:
| 场景 | 建议 |
|---|---|
| 多个项目并行 | 每个项目一张独立令牌,方便追溯哪个项目花了多少 |
| 给团队成员分发 | 一人一张,离职 / 离开项目时直接删该令牌 |
| 长期跑的自动化(n8n、定时任务) | 单独建一张并设额度上限,跑飞了不会爆掉账户 |
| 试用新工具 | 临时令牌 + 小额度,试完就删 |
命名约定建议
| 场景 | 推荐命名 |
|---|---|
| 个人开发 | <工具名>-<用途>,例如 claude-code-dev、gemini-cli-personal |
| 团队分发 | <成员名>-<工具>,例如 xiaozhang-codex、xiaowang-claude |
| 自动化任务 | <任务名>-bot,例如 daily-report-bot、n8n-image-pipeline |
五、公司团队场景
管理员视角
平台支持给员工分发令牌——管理员账号统一收口充值,给每个员工一张独立令牌。
推荐流程
- 管理员账号充值(一次性大额,省事)
- 在
/console/token给每个员工创建一张令牌 - 命名带成员标识(例如
xiaozhang-claude、xiaowang-codex) - 给令牌设额度上限,防止单人耗光全部余额
- 把对应令牌单独发给员工本人
离职 / 项目结束怎么办
直接去令牌列表 删除该员工的令牌即可——其他人的令牌完全不受影响,不需要换密码、不需要重新发令牌。
审计
在令牌列表里能看到每张令牌的累计花费,按令牌维度做账单非常清晰。
六、令牌泄露怎么办
令牌相当于密码
令牌 sk-xxxx 一旦泄露,别人就可以用你的余额。处理流程如下:
- 立刻去令牌列表 删除泄露的令牌
- 新建一张同分组的令牌,重新部署到原来的工具里
- 检查最近的额度使用情况,发现异常可联系客服核查
避免泄露的最佳实践:
- 令牌只放在服务端环境变量或部署平台的 Secret 管理里
- 不要写进前端代码 / 移动 App 包 / git 仓库 / 公开日志
- 给每张令牌设合理的额度上限,把损失风险控制住
七、常见问题
我删了一张令牌,但工具还能用
工具客户端通常有缓存,重启或几分钟后就会失效。如果一直能用,可能你删的不是工具实际在用的那张——回工具配置看一下用的是哪张令牌的 sk-。
我能不能把一张令牌从 A 分组改到 B 分组
不能。分组在创建时绑定就固定了。需要换分组就删了重建。
设了过期时间,但没到期就停了
去充值 看一下账户余额;余额耗尽时即使令牌没过期也会停用。
一个账户最多能建多少令牌
实际上限非常宽松,常规个人 / 团队用法用不到。如果碰到上限再联系客服。
