一、安装 Codex CLI

Codex CLI 需要 Node.js。先安装当前 LTS 版本，再重新打开 PowerShell：

四条命令都能正常返回结果，说明本地环境已经准备好。

如果提示找不到 node、npm 或 codex，先关闭终端重新打开。仍然无效时，再检查 Node.js 安装目录和 npm 全局目录是否已经加入 PATH。

二、在 CC Switch 中添加配置

CC Switch 下载地址：

Windows 用户可以下载 .msi 安装包。安装完成后打开 CC Switch，进入 Codex 配置页面，添加一个新的 Provider。

需要填写的内容如下：

保存后点击启用，然后完全退出正在运行的 Codex，关闭终端并重新打开。

CC Switch 修改的是本地配置，已经启动的 Codex 通常不会自动重新读取，所以重开终端这一步不要省略。

三、配置没有生效时手动检查

如果导入后没有变化，可以直接打开 Codex 配置文件：

本文使用下面这套配置：

模型列表变化时，需要同时修改 model 和 review_model。上下文窗口和自动压缩阈值也要与模型实际规格匹配，不能直接套用超过模型能力的数值。

接着登录 API Key：

如果已经通过 CC Switch 成功启用配置，就不要再反复手改同一份文件，否则下次切换 Provider 时可能覆盖手动修改的内容。

四、启动 Codex 验证

进入一个项目目录：

第一次先发送只读任务：

能够读取项目并正常回答，说明 Codex、认证信息、接口地址和模型已经连接成功。

也可以临时指定模型：

需要注意，-m 只负责切换模型，不会自动替换当前 Provider、Base URL 或 API Key。

五、常见报错

排查时不要同时修改多个地方。建议按照下面的顺序逐项确认：

六、正式使用前再做一步

进入真实项目后，先检查 Git 状态：

第一次任务先让 Codex 分析项目并给出计划，确认后再允许它修改。完成任务后查看 git diff，并核对测试或构建命令是否真的执行成功。

整个配置过程可以概括为：安装 Codex CLI，在 CC Switch 中填写接口信息，启用后重开终端，再进入项目做一次只读验证。出现问题时优先检查实际生效的配置，不要反复卸载软件。