适合谁
适合已经安装Codex，或准备安装Codex，但不想手动维护多套配置文件的新手。CC Switch更适合把Codex、Claude Code等客户端的Provider配置集中管理，后续更换电脑、切换Provider或排错时也更容易确认正在用哪一套配置。
本文只讲使用自己的API Key完成基础配置。不要使用他人的Key，不要把Key发到聊天记录、截图、Git仓库或共享文档。
开始前准备
- 访问小贺API控制台：
https://api.xiao-he.top。 - 注册或登录后，创建并保管自己的API Key。
- 安装Codex，并确认客户端可以正常打开。
- 从CC Switch官方发布页或教程安装CC Switch，不从不明来源下载安装包。
- 准备一次不会修改重要文件的最小任务，例如让Codex只读分析一个项目目录或解释一个报错。
完整步骤
第一步：先在小贺API创建自己的Key
打开 https://api.xiao-he.top，进入控制台创建API Key。Key相当于访问凭证，只在自己的可信设备和客户端中输入。控制台中的地址、模型和可用范围会变化，配置时只复制当前页面展示的字段。
第二步：在CC Switch选择Codex
打开CC Switch，先确认当前选择的是 Codex，而不是Claude Code或其他客户端。不同客户端使用的字段、协议和配置位置可能不同，第一步选错，后面的填写即使看起来完整也不会生效。
实拍界面：先确认顶部选择的是Codex，再确认当前Provider。CC Switch版本更新后布局可能变化，但客户端和Provider这两个检查点不变。
第三步：导入或新建Provider
如果小贺API控制台当前提供CC Switch导入入口，优先按页面指引导入。没有导入入口时，在CC Switch中新增Provider，并根据当前界面填写：
- 名称：给自己识别用，例如“我的小贺API”。
- API Key：粘贴刚刚创建的个人Key。
- 地址或Endpoint：从
https://api.xiao-he.top登录后的当前控制台复制。 - 模型字段：只填当前控制台支持、且CC Switch需要的字段；不确定时不要根据旧截图猜名称。
不要把“控制台入口地址”和“客户端最终请求地址”混为一谈。是否需要版本路径、具体模型名或认证选项，必须由当前控制台和客户端说明共同决定。
第四步：保存并切换为当前Codex配置
保存Provider后，在CC Switch中把它切换为当前Codex使用的配置。确认名称、地址来源和切换状态都正确，再完全退出Codex。仅关闭窗口可能不足以让旧进程释放配置，建议确认客户端已经退出后再重新打开。
第五步：先做只读小任务
重新打开Codex后，不要立即让它修改整个项目。先输入一个可检查的小任务，例如：
请先不要修改任何文件。
请用中文说明当前项目的目录结构、技术栈和启动方式；
如果信息不足，请列出你还需要查看的文件。
能得到与本地项目相关的正常输出，才说明客户端、Provider和任务链路基本跑通。之后再逐步让它做小改动，并自行审查改动和测试结果。
实拍界面：配置是否成功，要以Codex能读取当前项目并完成一个可核验的小任务为准，不能只看网页能否打开。
实际示例
一个新手常见的正确顺序是：先在 https://api.xiao-he.top 创建自己的Key，接着在CC Switch的Codex页添加或导入Provider，保存并切换为当前配置，完全重启Codex，最后对一个测试项目执行只读分析。
这个顺序的重点不是记住某个固定模型名或地址后缀，而是让每个动态字段都来自当前控制台。配置成功的证据是Codex完成了真实小任务，不是网页打开、账户登录成功或单独看到一个HTTP状态码。
常见问题与报错
CC Switch里找不到Codex或保存后没有生效
先更新到CC Switch当前稳定版本，确认已进入Codex页面并选择了刚保存的Provider。然后完全退出再重开Codex。若依然无效，检查Codex是否还有独立配置文件或环境变量覆盖了CC Switch写入的配置。
填入Key后显示401
401通常表示认证未通过。先重新从控制台创建或复制Key，确认没有多复制空格、没有截断、没有粘贴到错误字段；再核对当前Provider使用的地址和认证方式。不要在任何截图中展示完整Key。
模型不存在、404或连接超时
模型不存在优先检查模型名是否来自当前控制台；404优先检查客户端协议与最终路径；没有状态码的连接错误再检查网络、客户端日志和服务状态。每次只改一个字段，然后重复同一个最小任务。
不会安装或切换配置
先按本文完成Key和客户端准备。基础的Codex安装、CC Switch配置、中文设置、Skills安装与第一次小任务验证，可按当前安排申请远程协助；Key仍应由你自己在控制台创建和输入。
完成后的检查方法
- 已从
https://api.xiao-he.top当前控制台创建个人API Key。 - CC Switch当前选择的是Codex，且新Provider已保存并切换生效。
- 地址、模型和协议没有来自旧教程或不明截图。
- Codex已经完全退出并重新打开。
- 已完成一次只读、可检查的真实小任务。
- API Key没有出现在截图、日志、代码仓库或聊天记录中。
资料来源
- CC Switch使用教程
用于核对CC Switch的安装与Provider管理入口。
- CC Switch：添加Provider说明
不同版本界面可能变化，以当前界面为准。
- OpenAI Codex文档
用于核对Codex客户端的当前官方使用说明。
FAQ
一定要手动填写所有字段吗？
不一定。若当前控制台提供CC Switch导入入口，可优先使用；没有导入入口时，再按控制台与CC Switch当前界面逐项填写。
Base URL是否一定要加/v1？
不一定。应以当前控制台和CC Switch、Codex客户端实际要求为准；判断依据是最终请求路径和真实最小任务，而不是旧文章截图。
为什么保存后Codex还是旧配置？
先确认CC Switch中该Provider已被设为当前Codex配置，然后完全退出Codex再重新打开；仍不生效时检查是否存在更高优先级的环境变量或本地配置。