大约 2 分钟
令牌分组介绍
令牌分组可以理解为一组策略绑定：可用模型 + 计费倍率 + 使用边界。
令牌只是访问凭证，真正决定调用行为的是“令牌绑定到哪个分组”。
分组通常按这 3 类设计
| 分组维度 | 典型用途 | 你要关注的点 |
|---|---|---|
| 按模型家族 | Claude / Codex / Gemini 分开 | 避免工具拿到不兼容模型 |
| 按成本策略 | 低倍率 / 标准倍率 / 高性能组 | 成本与效果平衡 |
| 按环境隔离 | 测试组 / 生产组 | 避免测试任务影响线上预算 |
典型绑定示例
示例 A：Claude 主力 + Codex 备用
| 令牌 | 绑定分组 | 使用场景 |
|---|---|---|
tk_claude_prod | claude-main | 日常主流程、稳定调用 |
tk_codex_backup | codex-backup | Claude 不可用时切换 |
策略要点：两枚令牌独立管理，便于故障切换和成本统计。
示例 B：测试与生产隔离
| 令牌 | 绑定分组 | 限制策略 |
|---|---|---|
tk_test | shared-test | 小额度上限，只做验证 |
tk_prod | shared-prod | 正常额度，用于正式任务 |
策略要点：任何新配置先在测试令牌验证，再切生产令牌。
示例 C：团队按职责分组
| 团队角色 | 推荐分组 | 目的 |
|---|---|---|
| 开发与调试 | dev-fast | 保证迭代速度 |
| 运营与文档 | ops-stable | 稳定、可控成本 |
| 自动化任务 | job-batch | 便于单独核算批量任务消耗 |
如何把令牌绑定到分组
- 在控制台创建令牌时选择目标分组。
- 完成后记录令牌名称、用途、分组和负责人。
- 在 CLI 或 CC-Switch 中替换为该令牌。
- 执行一次最小请求验证，确认分组生效。
切换策略（高频使用场景）
- 一台机器同时只保留一套“当前生效令牌”。
- 切换前先清理旧令牌来源（旧环境变量、旧配置文件）。
- 切换后重启终端或对应 CLI 进程。
- 每次切换都做最小验证，不要直接跑长任务。
推荐最小验证动作：
- 查询模型列表，确认目标模型可见。
- 发起一次短请求，确认可返回结果。
- 观察一次扣费记录，确认计费分组正确。
常见错误与修正
| 常见错误 | 结果 | 修正方法 |
|---|---|---|
| 工具与分组不匹配 | 模型不可见或 model not found | 重新绑定到匹配分组 |
| 测试令牌用于生产 | 任务中途额度耗尽 | 生产使用独立令牌 |
| 切换后未重启终端 | 仍使用旧配置 | 重启终端并重新验证 |