下面以 Windows 为例介绍 Codex CLI 的安装方法，以及不使用浏览器登录的方法。

---

这是 PowerShell 执行策略阻止了 codex.ps1。

推荐只为当前用户放开：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

输入 Y 确认，然后关闭并重新打开 PowerShell，再执行：

codex

查看当前策略：

Get-ExecutionPolicy -List

如果公司策略不允许修改，可以只对当前 PowerShell 会话临时放开：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

这个设置只对当前窗口有效，关闭 PowerShell 后自动恢复。

也可以绕过 .ps1，直接调用 npm 生成的批处理文件：

codex.cmd

或者：

& "$env:APPDATA\npm\codex.cmd"

更稳妥的建议顺序：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
codex

不要直接把 LocalMachine 设置成 Unrestricted，范围过大，安全性较差。

一、安装 Node.js

首先下载安装 Node.js（建议安装 LTS 长期支持版）。

下载地址：

Node.js 官方下载（中文）

建议下载：

• Windows Installer (.msi)

• LTS（长期支持版）

• x64（64 位）

安装步骤

双击下载的 .msi 安装包。

一路点击：

Next
↓
I accept the terms...
↓
Next
↓
Next
↓
Install
↓
Finish

安装完成后，重新打开 CMD 或 PowerShell。

验证是否安装成功：

node -v
npm -v

正常会显示类似：

v22.x.x
10.x.x

---

二、安装 Codex CLI

执行：

npm install -g @openai/codex

安装完成后验证：

codex --version

如果能显示版本号，则安装成功。

---

三、第一次运行

进入项目目录：

cd D:\project

运行：

codex

默认会提示登录。

---

四、不使用浏览器登录（推荐）

如果服务器、远程桌面或受限环境无法打开浏览器，可以使用 API Key 登录。

方法一：使用环境变量（推荐）

Windows CMD：

set OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx

PowerShell：

$env:OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxx"

然后直接运行：

codex

Codex CLI 会自动读取 OPENAI_API_KEY，无需浏览器授权。

如果希望永久生效，可以设置用户环境变量：

CMD：

setx OPENAI_API_KEY "sk-xxxxxxxxxxxxxxxx"

PowerShell：

[Environment]::SetEnvironmentVariable(
    "OPENAI_API_KEY",
    "sk-xxxxxxxxxxxxxxxx",
    "User"
)

重新打开终端即可。

---

方法二：命令行输入 API Key

部分版本支持：

codex login --api-key

按照提示输入 API Key 即可，无需浏览器。

如果当前版本不支持该参数，建议直接使用环境变量方式。

---

五、使用自定义 OpenAI 接口

如果使用企业代理或兼容 OpenAI API 的服务，可同时配置：

CMD：

set OPENAI_BASE_URL=https://your-api.example.com/v1
set OPENAI_API_KEY=sk-xxxxxxxx

PowerShell：

$env:OPENAI_BASE_URL="https://your-api.example.com/v1"
$env:OPENAI_API_KEY="sk-xxxxxxxx"

然后执行：

codex

---

六、更新 Codex CLI

npm install -g @openai/codex@latest

---

七、卸载

npm uninstall -g @openai/codex

---

八、常见问题

1. 提示 codex 不是内部或外部命令

检查 npm 全局目录：

npm config get prefix

通常需要将以下目录加入 PATH：

C:\Users\<用户名>\AppData\Roaming\npm

重新打开终端后再执行：

codex --version

2. 安装失败

可以先升级 npm：

npm install -g npm

再重新安装：

npm install -g @openai/codex

3. 网络下载慢

可以先切换 npm 镜像，例如：

npm config set registry https://registry.npmmirror.com

安装完成后，如有需要再切回官方源。

---

完整安装流程

:: 1. 安装 Node.js（MSI）

:: 2. 验证
node -v
npm -v

:: 3. 安装 Codex CLI
npm install -g @openai/codex

:: 4. 配置 API Key（无需浏览器）
set OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx

:: 5. 启动
codex

:: 6. 查看版本
codex --version

这种方式特别适合服务器、远程桌面、SSH 或无法使用浏览器完成 OAuth 登录的环境。