为了测这套安装脚本,我先干了一件比较麻烦的事:把电脑里的 Node.js、npm 和全局 Codex CLI 全卸了。
在一台已经配好环境的电脑上跑通,说明不了多少问题。脚本到底能不能自己补齐 Node.js、装好 Codex,再把 API 配置写进去,得从缺环境的状态开始看。
这次用的是 Windows PowerShell 5.1。执行安装前,我单独检查了三个命令,结果全是 NOT FOUND。

第一张图就是这次测试的起点。Node.js 没有,npm 没有,全局 Codex CLI 也没有。
最后装出来的版本是 Node.js v22.16.0、npm 10.9.2、Codex CLI 0.147.0。安装结束后,再打开 Codex CLI 发一句"你好",就能看看当前配置是不是真的能用。
后台生成的安装指令带有用户自己的 API Key,所以正文不会展示这条指令。
安装入口从哪里拿
Codex CLI 是 OpenAI 提供的终端编程工具,官方文档里有单独的 Windows 安装入口。只把 CLI 装到电脑上还不够,使用自定义 API 时还要处理 Key、接口地址、Provider 和模型配置。
我这次用的是平时接 AI 编程工具的统一入口:KKFlow 向云(官网:https://kkflow.org)。
打开官网后先注册并登录。进入后台,在 API 密钥页面新建一个 Key。建议给 Key 写个能看懂的名字,比如"家里电脑-Codex"或者"办公电脑-Codex",以后查用量、停用和更换都会省事。
Key 建好以后,打开后台的"自动安装"页面,工具选择 Codex CLI,系统选择 Windows,再选中刚刚创建的 Key。页面会生成一条当前账号专用的安装指令。
这里不要去网上找别人贴出来的所谓通用命令。后台生成的内容跟 Key、接口和模型有关,应该登录自己的账号复制。Key 失效或者模型调整以后,也要回到后台重新生成。
执行时,建议单独打开 PowerShell 7
我第一次做环境检查时碰到过一个容易误判的情况。
明明已经卸载了全局 Codex CLI,在 VS Code 集成终端里输入命令却还能找到 Codex。检查后发现,这台电脑上的 VS Code Codex 插件目录被临时放进了终端 PATH。脚本在这里运行,会以为系统已经装过 CLI。
所以这次我没有用 VS Code 终端。我从 Windows 开始菜单单独打开 PowerShell,再粘贴后台生成的安装指令。
如果电脑里已经装了 PowerShell 7,建议优先使用。PowerShell 7 默认使用 UTF-8,处理中文脚本和中文输出时更省心,也不容易碰到乱码。这次截图用的是 Windows PowerShell 5.1,因为我还想看看系统自带环境能不能跑完整个流程;只有 5.1 也可以继续操作,没必要卡在这一步。
安装 Node.js 时可能弹出管理员权限确认。确认指令来自自己的 KKFlow 后台、脚本域名无误以后再继续。这个过程不要关窗口,等它自己跑完。
从没有 npm 到安装完成
下面这张图是脚本跑完后的完整结果。

脚本先发现电脑里没有 npm,于是安装 Node.js v22.16.0,再通过 npm 安装官方的 @openai/codex 包。随后写入 Codex 的 Provider、模型和认证配置,最后重新检查 Node.js、npm 和 Codex CLI 的版本。
截图里还有一个我觉得挺重要的细节:我卸载了运行环境,但没有删除用户目录里的 .codex 配置。脚本检测到原来的 config.toml 和 auth.json 后,先做了带时间戳的备份,再写入新配置。
这对已经用过 Codex 的人很实用。不过,如果你的配置里还有 MCP、自定义沙箱规则或者多个 Provider,执行前还是应该自己备份一次。自动备份能留后路,不能代替检查。
安装完以后,打开 Codex 说句"你好"
codex --version 能返回版本号,只能说明命令已经进入 PATH。API Key 写错、模型名过期或者接口地址有问题时,真正对话还是会失败。
关掉安装窗口,再开一个新的 PowerShell,输入 codex 启动 Codex CLI。进入交互界面后,不用准备复杂提示词,先发一句:
你好
Codex 能正常回一条消息,这一遍安装就算跑通了。
然后回到 KKFlow 后台看刚才那笔调用记录。时间和模型能对上,以后查用量也方便。
真遇到问题,先看这几处
脚本提示 Codex 已安装,但你确定自己卸载过,先看当前窗口是不是 VS Code 集成终端。换成开始菜单打开的独立 PowerShell,再做一次检测。
安装结束后输入 codex 仍然提示找不到命令,先把当前 PowerShell 关掉,重新开一个窗口。安装程序更新 PATH 后,旧窗口不一定马上拿到新值。
请求出现 401、403 或"模型不存在",回后台检查 Key 状态和当前模型。不要拿旧教程里的模型名硬改,也不要修改别人发来的安装指令。重新选 Key、重新生成一次,排查起来反而快。
还有 API Key。自动安装指令本身含有 Key,终端历史、录屏和截图都可能把它带出去。如果怀疑 Key 已经泄露,直接在后台停用旧 Key,再建一个新的。
这次实测的结果
这次测试从三个 NOT FOUND 开始,脚本补装了 Node.js 和 npm,安装了 Codex CLI,备份并更新了原配置。安装完成后,重新打开 PowerShell,启动 Codex 发一句"你好"就可以继续验证。
这些版本和结果记录于 2026 年 8 月 8 日,只代表这次 Windows PowerShell 5.1 实测。后面 Node.js、Codex CLI 或可用模型有更新,以 OpenAI 官方文档和 KKFlow 后台当时显示的内容为准。



