CCSwitch 团队 profile 命名混乱怎么办？
CCSwitch 配置一多，团队最先乱掉的通常不是技术参数，而是 profile 名称。每个人都能跑通，但“prod”“正式”“new-api”“backup”背后可能是不同 Key、不同模型和不同权限。
配置台账：适用场景和命名边界
本文适合团队中多人使用 CCSwitch 管理模型接口、代理、Key 和 Codex 默认调用的场景。典型表现是同一个任务在同事电脑上走不同模型，测试 Key 被误设为默认，profile 名写着 prod 实际连的是旧 API 地址，或者账单归因时看不出谁用了高成本模型。配置漂移问题可结合 团队里的 CCSwitch 配置不一致怎么排查，费用归因可看 CCSwitch 调用费用对不上怎么办。
profile 命名不是文档美化，而是运行时风险控制。名称如果不能表达环境、用途和负责人，Codex 接入时就需要靠猜。猜错一次，可能消耗生产额度、暴露正式数据，或者把低质量模型用于需要稳定结构输出的任务。
团队落地操作步骤：先定命名，再定默认项
1. 建一张 profile 基线表
基线表至少包含 profile 名、环境、用途、base URL、模型名、Key 权限、是否默认、负责人、更新时间和固定测试结果。不要只截配置界面，因为截图不能做差异比较，也不能被脚本检查。API 地址优先级问题可以参考 Codex 调用的 API 地址为什么总是旧的。
建议命名采用可读但不暴露密钥的结构，例如 prod-codex-code-owner、test-office-summary-owner、dev-json-check-owner。名称里不要写真实 Key、客户名、手机号或内部项目密级。
2. 区分环境和用途
环境回答“能访问什么数据”，用途回答“适合做什么任务”。测试、正式、个人开发、批处理、演示环境不要混用；代码生成、长文摘要、JSON 输出、低成本批处理也不要共用一个含糊的 default。测试和正式 Key 隔离可参考 CCSwitch 怎么区分测试 Key 和正式 Key。
如果团队正在做 AI 自动化办公，建议把办公脚本 profile 与 Codex 改代码 profile 分开。前者更关注批处理成本、输入长度和人工复核，后者更关注代码上下文、命令风险和输出准确性。
3. 每次变更都跑固定测试
固定测试至少包括中文短答、JSON 输出、长上下文摘要、错误模型名、低权限 Key 和网络异常。每条测试要记录 profile 名、模型名、返回状态、耗时和 request_id。多模型按任务切换时，可参考 CCSwitch 多模型怎么按任务切换 建立路由说明。
测试结果不要只发“已通过”。要写清楚哪个 profile 通过了什么请求，旧 profile 是否保留，谁负责回滚。否则下次 Codex 连接失败或输出格式变化时，团队仍会从头猜。
还要把临时 profile 和长期 profile 分开。临时配置只用于排查某个网络、代理或模型权限问题，命名里应带上日期和负责人，处理完就删除或归档；长期配置才进入团队文档和默认候选。这样做能减少“某次排错留下的入口变成正式入口”的问题，也方便在 AI API 接入异常时快速回到上一版。
4. 同步文档和本地环境
profile 改名后，README、脚本、环境变量示例、CI 配置、Codex 任务说明和新人上手文档都要同步。只改 CCSwitch 界面，不改文档，会让新同事复制旧名字。只改文档，不改本地默认项，则运行时仍会走旧配置。
如果切换代理后仍连不上，可继续看 CCSwitch 切换代理后 Codex 仍然连不上怎么办。命名治理和连接排查要分开：先确认你要用哪个 profile，再排查它为什么不通。
避坑记录：default 是团队协作里最危险的名字
第一个坑是所有人都保留一个叫 default 的 profile，但内容各不相同。第二个坑是 profile 名只写模型别名，不写环境和权限。第三个坑是把备用接口命名为 backup，却没有说明什么时候能切、谁能切、切完怎么验证。
第四个坑是为了方便，把高权限 Key 放进所有 profile。这样看起来少维护几个配置，实际会让任何任务都可能消耗正式额度。永沃云枢建议默认权限最小化，只有明确需要时才切到高权限 profile，并保留日志标签。
交接检查清单：团队发布配置前确认
- profile 名是否包含环境、用途和负责人或维护组。
- 测试、正式、个人开发和批处理是否分开。
- 默认 profile 是否经过团队确认，而不是个人习惯。
- 固定测试请求是否覆盖 JSON、长文、错误输入和低权限 Key。
- README、脚本、CI、Codex 任务说明是否同步新名称。
- 账单、日志和 request_id 是否能追到 profile 与任务标签。
验收标准：别人看到名字就知道能不能用
合格的 CCSwitch 团队配置不要求名字很短，但要求不靠口头解释也能判断用途。新同事拿到 profile 表，应能知道哪个用于 Codex 代码任务，哪个用于 AI API 批处理，哪个不能碰生产数据，哪个只用于演示。这样模型调用管理才不会停留在“谁电脑能跑通”的阶段。