● 安装指南

Windows 安装 Codex 指南

在 Windows 上安装 OpenAI Codex CLI 的完整步骤教程

🖥️
适用环境
  • Windows 10 (1809+) 或 Windows 11
  • x64 / ARM64 架构
  • 终端: Windows Terminal / PowerShell 5.1+ / PowerShell 7+

一、安装前置依赖

1

安装 Node.js(建议 LTS 版本)

Codex CLI 通过 npm 分发,需要 Node.js 18 或以上。任选一种方式安装:

方式 A:官方安装包(推荐新手)

  • 打开 https://nodejs.org/zh-cn,下载 LTS 版本的 .msi 安装包。
  • 双击运行,一路 Next,保留默认勾选「Add to PATH」。

方式 B:winget(Windows 10/11 自带)

winget install OpenJS.NodeJS.LTS
⚠️ 安装完成后请关闭并重新打开 PowerShell 窗口,新的 PATH 才会生效。
✅ 验证: 在 PowerShell 里执行下面两条命令,都能输出版本号即成功 
node -v
npm -v
2

允许 PowerShell 运行本地脚本

Windows 默认禁止运行未签名的 .ps1 脚本。打开 Windows Terminal 或 PowerShell,执行:

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

提示时输入 Y 回车确认。这条只需要执行一次。

💡 仅作用于当前用户,不会影响系统级策略。RemoteSigned 表示本地脚本可直接运行,从网上下载的脚本需要签名。

二、安装 Codex CLI

3

通过 npm 全局安装官方包

npm install -g @openai/codex

验证安装是否成功:

codex --version
Get-Command codex
💡 常见安装位置(Windows 下 npm 全局包默认放在用户目录的 npm 文件夹)
  • 默认: %APPDATA%\npm\codex.cmd
  • 对应路径: C:\Users\<你的用户名>\AppData\Roaming\npm\codex.cmd
  • 自定义 npm prefix: npm config get prefix 输出目录下的 codex.cmd
4

命令找不到时的修复

如果执行 codex --version 提示 无法将"codex"项识别 / command not found,把 npm 全局目录加入 PATH:

方式 A:临时(只对当前会话生效)

$env:PATH = "$(npm config get prefix);$env:PATH"

方式 B:永久(写入用户环境变量)

$npmPrefix = (npm config get prefix).Trim()
[Environment]::SetEnvironmentVariable("PATH", "$npmPrefix;$([Environment]::GetEnvironmentVariable('PATH','User'))", "User")

设置完后关闭并重新打开 PowerShell,再执行 codex --version 验证。

三、验证可用

5

生成你的专属启动脚本

在下面输入你的下游 Key(以 lbk_ 开头),点击 下载启动脚本,会生成一份内置你 Key 的 new_codex.ps1(PowerShell 脚本)。

💡 Key 只在你浏览器本地拼接进脚本,不会上传到任何服务器。
6

运行启动脚本

下载得到 new_codex.ps1 后,打开 Windows Terminal 或 PowerShell,进入下载目录:

cd $HOME\Downloads
💡 也可以先把 new_codex.ps1 拷贝到自己的项目目录,后续直接在项目里 .\new_codex.ps1 启动。

启动 Codex:

.\new_codex.ps1
⚠️ 如果提示 因为在此系统上禁止运行脚本,先执行步骤 2 的 Set-ExecutionPolicy 命令开放本地脚本运行。

进入 TUI 后,输入一句话测试:

你好,你是谁?
✅ 模型正常返回回答即代表接入成功

四、常见问题

1. 无法将"codex"项识别为 cmdlet
  • 确认 npm install -g @openai/codex 没报错。
  • 执行 npm config get prefix,确认输出目录下存在 codex.cmd。
  • 把该目录加入 PATH(参考步骤 4),并重新打开 PowerShell。
2. 因为在此系统上禁止运行脚本 / 执行策略错误
  • 这是 PowerShell 的执行策略限制,执行步骤 2 的命令开放即可:
    Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
  • 临时绕过方式:powershell -ExecutionPolicy Bypass -File .\new_codex.ps1
3. 远程网关不可达
  • 检查能否访问 http://aitoolproxygateway.liuwanqin.com/health。
  • 如果用 Clash / V2Ray 等代理,把这个域名加入直连规则,或临时关闭代理。
  • 公司网络可能拦截 80 端口,换网络(比如手机热点)再试。
4. 中文输出乱码 / 颜色显示异常
  • 优先使用 Windows Terminal(而不是老版 CMD)。
  • 把 PowerShell 编码切到 UTF-8:
    chcp 65001 或 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
5. auth.json 一直被改回旧值
  • 启动脚本每次运行都会覆盖 %USERPROFILE%\.codex\auth.json。
  • 如果同时用官方 Codex 登录态,建议另起一份 profile,或者只在需要时跑脚本。
6. 模型 gpt-5.4 不识别
  • 这个模型名由上游代理站定义,不是官方 OpenAI 公开模型。
  • 如需切换模型,编辑 new_codex.ps1,把 -c 'model="gpt-5.4"' 换成你想用的模型名。
7. 想退出 / 切回官方 Codex
  • 删除 %USERPROFILE%\.codex\auth.json,然后 codex login 重新走官方登录。
  • 或直接编辑 %USERPROFILE%\.codex\auth.json,把 OPENAI_API_KEY 换回官方 sk-xxx。

五、卸载

7

卸载 Codex CLI

npm uninstall -g @openai/codex
Remove-Item -Recurse -Force $HOME\.codex

如果不再使用 Node.js,可一并卸载:

winget uninstall OpenJS.NodeJS.LTS

或者用「设置 → 应用 → 已安装的应用」里搜索 Node.js 卸载。

六、在桌面客户端使用 Codex

8

下载并打开 Codex 桌面客户端

访问官方页面,下载并安装 Windows 客户端:

👉 https://openai.com/zh-Hans-CN/codex/

装完直接打开就能用 —— 不用登录、不用改任何设置。

✅ 打开客户端,直接发一句话,有回答就说明接入成功。
9

Key 过期 / 换新 key 时怎么办

当下游 Key 过期或代理地址变化时,不需要手动改环境变量或客户端设置,流程就两步:

  1. 到原页面输入新 Key,重新下载 new_codex.ps1 覆盖旧文件。
  2. 跑一次 .\new_codex.ps1。
⚠️ Windows 用户级环境变量需要重启桌面客户端(右下角托盘 → 退出,再重新打开)才能生效;如果客户端在脚本运行前已启动,务必先退出再打开。
✅ 这样客户端和终端永远共用同一份配置,密钥更新一键搞定。

七、联系我们

有问题?联系管理员

扫码加我微信,有任何使用上的疑问都可以问。

管理员微信二维码

扫一扫上面的二维码图案,加我为朋友