大约 3 分钟
模型分组介绍
模型分组决定三件事：可访问模型、计费倍率、故障时的可用性策略。大多数“令牌能用但模型不可用”的问题都来自分组选错。
本章目标
- 看懂模型广场里的能力分类
- 选出与你工具匹配的分组
- 把分组正确绑定到令牌
- 避免高频配置错误
建议阅读顺序
为什么不要跳过这一章
很多用户会直接去创建令牌，然后在 CLI 里反复改模型名、Base URL、环境变量，最后把问题归因到“平台不稳定”。
实际上更常见的真实原因是：
- 令牌绑错了分组，当前工具请求不到目标模型
- 分组费率和你的预期不一致，测试时误判了成本
- 把测试、生产、个人调试都混在同一个高权限令牌里，导致排障困难
先把分组看明白，再去创建令牌，后面的 CLI 配置会顺很多。
你到底在选什么
可以把“分组”理解成一层调用策略，而不是一个单纯的名字。
它通常同时决定：
- 这组里开放哪些模型家族
- 这组更偏稳定性、成本还是特定工具兼容
- 你的令牌适不适合放到 Claude、Codex、Gemini 或自动化脚本里
同一个账号可以同时维护多套分组策略。例如：
- 日常主力调用：优先稳定、故障少
- 压力测试或功能尝鲜：优先可用新模型
- 团队共享：权限收敛、便于审计
典型选择路径
| 你的场景 | 推荐做法 |
|---|---|
| 第一次配置 Claude Code | 先看模型广场，确认 Claude 系列模型在哪个分组，再创建一枚专用令牌 |
| 同时使用 Claude 和 Codex | 不要只用一枚“万能令牌”，至少拆成两个分组清晰的令牌 |
| 团队内多人共用 | 按环境拆分，至少区分测试和正式，不要共用个人调试令牌 |
| 只想先跑通链路 | 先用文档推荐分组，等调用稳定后再优化成本和备选组 |
读完这一章之后，你应该完成什么
- 在模型广场确认你要调用的模型属于哪个分组。
- 明确这个分组是给哪个工具、哪个环境、哪类任务使用。
- 创建 API 令牌时，把它绑定到正确的分组。
- 在 CLI 或 SDK 中做一次
models查询或最小调用验证。
常见误区
- 只看分组名称，不看该分组实际可用模型。
- 用 Claude 工具却绑定 Codex 分组令牌。
- 测试与生产共用一个高权限令牌，导致排障困难。
推荐阅读顺序之外的补充建议
- 如果你已经拿到令牌，但模型列表不对，优先回到本章，不要先删配置文件。
- 如果你在切换 CC-Switch 或多设备同步，最好为不同用途准备不同令牌，避免相互覆盖。
- 如果你准备交给同事使用，把“工具类型 + 绑定分组 + 验证结果”写成内部说明，后续支持成本会低很多。
读完本章再配置 CLI，成功率会明显提高。