Codex 安装并不难

这篇不展开讲概念，只按实际顺序把 Codex 跑通。最终链路很简单：

```text
Codex CLI → CC Switch → 中转站 → 模型

我自己常用的统一 API 接入入口是 https://kkflow.org，下面以它为例。换成其他中转站时，配置思路相同，但 Base URL、模型名和接口兼容情况要按对应平台填写。

一、安装 Codex

Codex CLI 需要 Node.js。先到 https://nodejs.org/ 安装 LTS 版本，然后重新打开 PowerShell：

node -v
npm -v
npm install -g @openai/codex@latest
codex --version

四条命令都能正常执行，就说明环境已经准备好。

接着登录 KKFlow 后台，创建一条给 Codex 使用的 API Key。文章里不要展示真实 Key，后面统一用这个占位符：

sk-你的KKFlow密钥

同时确认后台实际提供的模型 ID。本文以 gpt-5.6-sol 为例，如果你的后台显示不同名称，就以后台为准。

二、用 CC Switch 配置中转站

下载地址：

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

Windows 用户下载 .msi 安装包，安装后打开 CC Switch，切换到 Codex 页面。

如果 KKFlow 后台有“导入到 CCS”或“导入到 CC Switch”，可以直接导入；没有的话，就手动添加一个 Provider：

配置项	填写内容
名称	KKFlow
Base URL	https://kkflow.org/v1
API Key	自己创建的 Key
模型	gpt-5.6-sol，或后台实际模型 ID
接口类型	Responses

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

这一点很重要：CC Switch 修改的是本地配置，已经启动的 Codex 不会自动重新读取。

三、CC Switch 没生效，就手动配置

如果一键导入失败，或者想确认配置到底写到了哪里，可以直接打开：

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
notepad "$env:USERPROFILE\.codex\config.toml"

填入下面这份最小配置：

model_provider = "kkflow"
model = "gpt-5.6-sol"

[model_providers.kkflow]
name = "KKFlow"
base_url = "https://kkflow.org/v1"
wire_api = "responses"
requires_openai_auth = true

然后在 PowerShell 中登录 API Key：

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

如果 CC Switch 已经成功导入并启用配置，这一节可以跳过。不要一边让 CC Switch 管理配置，一边反复手改文件，否则下次切换 Provider 时可能被覆盖。

四、启动并验证

进入你的项目目录：

cd D:\你的项目目录
codex

第一次先发一条只读任务：

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

如果 Codex 能读取项目并正常回答，说明配置已经跑通。

也可以临时指定模型：

codex -m gpt-5.6-sol

注意，-m 只切换模型，不会自动切换 Provider。当前启用的 Base URL 和 API Key 仍然要正确。

五、常见报错

报错或现象	优先检查
401 Unauthorized	Key 是否完整、是否失效，当前启用的是否是正确 Provider
403 Forbidden	当前 Key 或模型分组是否有权限
model not found	模型 ID 是否和后台完全一致
请求失败或一直重试	Base URL 是否为 https://kkflow.org/v1，接口是否支持 Responses
CC Switch 启用后没变化	完全退出 Codex 并重新打开终端，再检查实际生效的 config.toml
找不到 codex 命令	重开终端，重新检查 Node.js、npm 和 PATH

如果不确定模型名，可以直接查看模型列表：

curl.exe "https://kkflow.org/v1/models" `
  -H "Authorization: Bearer sk-你的KKFlow密钥"

整个流程压缩成一句话就是：先装 Codex，在 CC Switch 里填好中转站的 Base URL、Key 和模型名，启用配置后重开终端。

最容易写错的只有两个地方：

Base URL：https://kkflow.org/v1
模型名：以后台实际显示为准

这两项对上，剩下的问题通常都能根据具体报错继续排查。