小贺API是Codex和Claude Code工作流中的配置工具。用户先要知道工作怎么做，再处理连接所需字段。
把CC Switch当成AI执行工具，会期待在里面直接处理项目；把它当成API服务，又会混淆Key和Provider的来源。
所以这篇文章只解决一件事：分清执行客户端、API服务与配置管理工具的职责和使用顺序。重点不是得到一段看起来完整的答案，而是让输入、步骤、结果和检查标准能够彼此对应。
适合谁
适合同时看到Codex、Claude Code、小贺API和CC Switch四个名称，不知道分别该打开哪个的人。
不适合的情况也很明确：任务没有边界、原件无法恢复、关键事实无人负责，或最终结果准备直接对外发布。先解决这些前提。
API Key相当于调用凭证，不能出现在截图、文章示例、聊天记录、日志或代码仓库。地址、模型、协议和Provider字段只以当前控制台及客户端说明为准。
开始前准备
- 准备使用的Codex或Claude Code
- 小贺API当前控制台配置
- 已安装的CC Switch版本
- 建立一个测试副本或新目录，不直接操作唯一原件。
- 写下一句验收标准：用户能准确说出三个工具各自职责，并在目标客户端完成一次真实任务
开始前再做一次反向检查：少了哪份材料就无法判断结果？哪一步做错会影响原件？把答案写进当前任务，而不是留在自己脑中。
完整步骤
第一步之前：先做一个最小样本
小样必须足够小，出现问题时能回到具体输入和步骤；也要足够真实，不能只用一个刻意简化、永远不会出错的示例。
第一步：先确定执行客户端
需要处理项目的是Codex或Claude Code，二者至少先选一个。
把“目标客户端”作为本轮留存证据。后续合并或扩大范围时，都应能用它复盘。
第二步：从服务端取得当前配置
在小贺API控制台创建自己的Key，并查看对应客户端字段。
先停在这里检查一次。此时应已经形成“配置来源清单”，并且能回到原始材料说明它从哪里来。
第三步：用CC Switch管理Provider
在正确客户端区域导入或填写配置，保存并切换。
这一阶段的完成标志不是工具有回复，而是“CC Switch当前Provider”已经可供人工检查。
第四步：回到客户端做任务
重启Codex或Claude Code，用真实小任务验证，CC Switch本身不交付项目结果。
继续下一步之前，抽查“客户端验证记录”中的边界项和异常项；发现前提不成立就先修正。
第五步：人工验收并沉淀流程
最后把结果与原始材料逐项对照，记录有效步骤、人工判断点和没有解决的问题。重复任务可以继续整理成模板、项目规则或Skill。
实际示例
工作顺序是：选择Codex处理网站项目，在小贺API获取当前配置，用CC Switch管理和切换Provider，最后回Codex执行任务。
可以先这样描述任务：
我正在处理“分清执行客户端、API服务与配置管理工具的职责和使用顺序”。已有材料包括准备使用的Codex或Claude Code、小贺API当前控制台配置、已安装的CC Switch版本。请先不要扩大任务范围，也不要补造缺失信息。先完成“先确定执行客户端”，输出可以人工检查的中间结果；我确认后，再继续“从服务端取得当前配置”。最终请按照“用户能准确说出三个工具各自职责，并在目标客户端完成一次真实任务”列出验收结果和仍需人工确认的内容。
这个任务描述故意先要求中间结果，再允许继续。对高风险或范围较大的工作，可以在每一步都保留同样的确认点。
常见问题与报错
CC Switch显示配置正常，客户端仍不能用
CC Switch只证明配置被保存；继续检查是否切换生效、客户端是否完全重启、运行时是否被环境变量覆盖。
配置保存了，客户端仍然使用旧地址
确认当前Provider已经切换生效，完全退出客户端后重开，并检查环境变量或其他配置文件是否覆盖了刚保存的值。
401、404、429和超时一起排查
先记录真实状态码、最终请求路径和响应信息，再按认证、路径、额度、频率和网络分层处理；每次只改一个变量。
API排错必须保留真实状态码、最终请求路径和脱敏响应。每轮只改Key、地址、模型或Provider中的一项。
完成后的检查方法
- 用户能准确说出三个工具各自职责，并在目标客户端完成一次真实任务
- 关键结论能回到原始材料、文件、命令输出或当前控制台。
- 没有把缺失信息、推测内容或示例数字写成已经确认的事实。
- 重要文件保留原件、版本或可恢复副本，敏感信息没有进入公开内容。
- 结果已经由真正负责这项工作的人审阅，而不是只看页面是否生成。
当这套步骤连续在两个真实样本上成立，再考虑扩大范围或做成Skill。第一次跑通不等于流程已经稳定。
资料来源
- CC Switch项目说明
用于核对Provider管理和客户端切换入口；界面以当前版本为准。
- 小贺API控制台
地址、模型、价格、套餐和配置字段可能调整，以登录后当前页面为准。
FAQ
可以一次把整个任务交给工具完成吗？
不建议一次交付全部范围。先按本文步骤完成一个小样，用“用户能准确说出三个工具各自职责，并在目标客户端完成一次真实任务”验收，再决定是否扩大范围。
遇到“CC Switch显示配置正常，客户端仍不能用”应该先检查什么？
CC Switch只证明配置被保存；继续检查是否切换生效、客户端是否完全重启、运行时是否被环境变量覆盖
完成后还需要人工检查吗？
需要。AI或执行工具负责推进流程，最终仍要由你根据原始材料、任务规则和“用户能准确说出三个工具各自职责，并在目标客户端完成一次真实任务”完成验收。