Codex + CC Switch配置操作步骤：安装、导入与手动排查

今天讲一下怎么用 CC Switch 管理 Codex 的 API 配置。

流程并不复杂：先安装 Codex CLI，再把 Base URL、API Key 和模型 ID 填入 CC Switch。遇到导入不生效时，还可以直接检查 config.toml 和 auth.json。

一、安装 Codex CLI

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

node -vnpm -vnpm install -g @openai/codex@latestcodex --version

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

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

二、在 CC Switch 中添加配置

CC Switch 下载地址：

https://github.com/farion1231/cc-switch/releases

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

需要填写的内容如下：

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

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

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

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

New-Item -ItemType Directory -Force "$env:USERPROFILE.codex" | Out-Nullnotepad "$env:USERPROFILE.codexconfig.toml"

本文使用下面这套配置：

model_provider = "kkflow"model = "gpt-5.6-sol"review_model = "gpt-5.6-sol"model_reasoning_effort = "xhigh"disable_response_storage = truenetwork_access = "enabled"windows_wsl_setup_acknowledged = truemodel_context_window = 400000model_auto_compact_token_limit = 360000[model_providers.kkflow]name = "KKFlow"base_url = "https://kkflow.org/v1"wire_api = "responses"requires_openai_auth = true

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

接着登录 API Key：

$env:OPENAI_API_KEY="sk-你的API密钥"$env:OPENAI_API_KEY | codex login --with-api-keycodex login status

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

四、启动 Codex 验证

进入一个项目目录：

cd D:你的项目目录codex

第一次先发送只读任务：

先不要修改文件，请分析当前项目的目录结构、技术栈和主要模块。

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

也可以临时指定模型：

codex -m gpt-5.6-sol

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

五、常见报错

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

Codex 版本 -> CC Switch 当前 Provider -> Base URL -> API Key -> 模型 ID

六、正式使用前再做一步

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

git status

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

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