codex cli的安装方法
下面以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-xxxxxxxxxxxxxxxxPowerShell:
$env:OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxx"然后直接运行:
codexCodex 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-xxxxxxxxPowerShell:
$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 --version2. 安装失败
可以先升级 npm:
npm install -g npm再重新安装:
npm install -g @openai/codex3. 网络下载慢
可以先切换 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 登录的环境。
