CC Switch配置Codex：导入API后完成首次验证

01 · 开始前，先核对四项信息

CC Switch负责管理与切换配置；Codex负责执行任务；API服务处理模型请求。三者的角色不同，登录其中一个不表示其他部分已经配置成功。

Windows安装包名称和版本会变化。按当前Release说明选择安装版或便携版，并确认x64/ARM等架构。签名文件不是安装程序。已经装好CC Switch的读者可以直接进入下一步，不必重新安装。CC Switch官方安装说明

注意： 配置之前记下原来的Provider名称和当前使用方式；本地配置备份也可能包含密钥，应妥善保存。不要把完整Key、Token或auth.json发到聊天、工单、截图或公开仓库。

还没有可用API服务？先核对小贺API的适用场景、接入说明和服务条件。如果已有其他能满足需求的服务，可以继续使用，不必为了本教程更换。

02 · 导入配置：先看你的控制台提供哪种入口

路径A：控制台提供“导入到CCS”

1. 打开所用服务的控制台，进入自己的API Key列表，找到准备使用的Key。
2. 如果该行提供“导入到CCS”或同类按钮，先启动本机CC Switch，再点击导入。
3. 浏览器询问是否打开本地应用时，核对来源域名和目标应用确实是CC Switch，再继续。
4. 回到CC Switch，查看新出现的配置。确认它属于Codex，而不是Claude Code或其他客户端。

小贺AI原有教程描述了小贺API的这一导入方式；当前账户是否显示该按钮，需要以登录后的实际界面为准。没有看到入口时，先核对当前服务说明，不要猜测导入链接，也不要不断导入产生多条难以辨认的配置。

路径B：没有导入入口，需要手动配置

先查看服务方是否提供当前CC Switch版本的配置说明。如果需要在Codex标签下添加Provider，请使用同一服务提供的地址、模型和认证方式；不会确认时，转到Codex手动配置第三方API教程。

不要把A服务的Key、B服务的Base URL和C教程的模型名拼在一起。也不要看到别人的地址带/v1就直接添加；实际取决于客户端怎样拼接请求路径。Base URL中的/v1如何判断

03 · 确认配置启用，并检查协议是否匹配

在CC Switch的Codex标签下找到刚导入或添加的配置。按钮可能叫“启用”“切换”或其他类似名称，以当前版本为准。保存一条配置与将它设为当前配置，是两个动作。

依次核对：

如果服务原生支持Codex所需的Responses接口，与只支持Chat Completions的服务，接入路径可能不同。CC Switch当前官方指南说明：需要协议转换时可能要启用本地路由及Codex接管。不是所有Provider都要开启路由，也不是写对模型名就等于协议兼容。 按你的版本和服务说明选择对应路径，不为尝试而同时开启所有开关。CC Switch官方协议与路由说明

使用Codex桌面App，且需要在第三方模型配置之外保留官方登录相关能力的读者，应额外阅读同一官方指南的适用条件。这不是所有CLI用户的统一前置步骤，也不要手动复制别人的官方登录缓存。Codex的认证与自定义Provider行为需结合当前官方配置说明核对。Codex认证文档 · 高级配置文档

04 · 重启你实际使用的客户端，做一次只读验证

第一步：退出旧会话，再重新打开

保存正在进行的工作后，正常关闭当前Codex会话并重新打开。如果你实际用的是IDE扩展，就在相同IDE环境下验证；使用CLI，就在重新打开的终端会话中验证。不要在CLI测试成功后，直接断言另一个App也使用同样配置。

先选一个你有权读取、没有敏感资料的练习目录。记录测试时间、系统、客户端与版本、CC Switch版本、Provider名称和模型ID，便于失败时对照。

第二步：发送这个最小任务

只查看当前目录。
列出你实际看见的文件名，并简要说明能够从这些文件确认的信息。
不要修改文件，不要安装依赖，不要访问外部网站。
如果目录为空或信息不足，请直接说明，不要猜测项目内容。

这段提示词用于观察一次真实任务，不能代替客户端本身的权限控制。审核任何写入或外部访问请求；第一次验证没有必要让工具重构项目、安装一批依赖或执行生产操作。

回答中出现可核对的文件名，说明任务有进展；模型自称“我使用某模型/某服务”并不能证明真实请求去向。

第三步：对照结果与请求记录

当最小任务成功、文件保持不变、请求归属符合预期后，再进行小范围修改。如果需要回到原来的服务，按CC Switch当前版本的切换/关闭接管说明恢复原Provider，并重复同一个最小任务；不要通过删除全部配置来碰运气。

05 · 常见错误：每次只检查一个分支

仍失败时，提交这些脱敏信息即可：系统与客户端版本、CC Switch版本、Provider名称、测试时间与时区、错误原文/状态码、request_id（如有）、改过哪一项。不要提交完整Key、认证缓存、原始账户截图或敏感项目文件。

相关教程与下一步

• 需要手动维护参数：Codex配置第三方API。
• 不知道地址是否需要后缀：Base URL中的/v1怎么填。
• 基础连接已经成功：Codex第一次任务怎么做。
• 希望复用工作流程：Codex Skills安装与使用。

还需要多模型API接入？

如果你准备让Codex或Claude Code长期连接模型服务，可以先查看小贺API当前支持的模型、接口协议、计费方式、使用限制和服务说明，再判断是否适合你的任务。小贺API为独立第三方服务，不是OpenAI或Anthropic官方服务。

查看小贺API接入与服务说明 · 已有账户？进入控制台

配置仍有困难时，先完成上面的错误分流，再查看配置支持范围与条件。是否适用远程支持，以当前页面和服务说明为准。