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长期支持版x6464 位安装步骤双击下载的.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 CMDset OPENAI_API_KEYsk-xxxxxxxxxxxxxxxxPowerShell$env:OPENAI_API_KEYsk-xxxxxxxxxxxxxxxx然后直接运行codexCodex CLI 会自动读取OPENAI_API_KEY无需浏览器授权。如果希望永久生效可以设置用户环境变量CMDsetx OPENAI_API_KEY sk-xxxxxxxxxxxxxxxxPowerShell[Environment]::SetEnvironmentVariable( OPENAI_API_KEY, sk-xxxxxxxxxxxxxxxx, User )重新打开终端即可。方法二命令行输入 API Key部分版本支持codex login --api-key按照提示输入 API Key 即可无需浏览器。如果当前版本不支持该参数建议直接使用环境变量方式。五、使用自定义 OpenAI 接口如果使用企业代理或兼容 OpenAI API 的服务可同时配置CMDset OPENAI_BASE_URLhttps://your-api.example.com/v1 set OPENAI_API_KEYsk-xxxxxxxxPowerShell$env:OPENAI_BASE_URLhttps://your-api.example.com/v1 $env:OPENAI_API_KEYsk-xxxxxxxx然后执行codex六、更新 Codex CLInpm install -g openai/codexlatest七、卸载npm uninstall -g openai/codex八、常见问题1. 提示codex不是内部或外部命令检查 npm 全局目录npm config get prefix通常需要将以下目录加入PATHC:\Users\用户名\AppData\Roaming\npm重新打开终端后再执行codex --version2. 安装失败可以先升级 npmnpm install -g npm再重新安装npm install -g openai/codex3. 网络下载慢可以先切换 npm 镜像例如npm config set registry https://registry.npmmirror.com安装完成后如有需要再切回官方源。完整安装流程:: 1. 安装 Node.jsMSI :: 2. 验证 node -v npm -v :: 3. 安装 Codex CLI npm install -g openai/codex :: 4. 配置 API Key无需浏览器 set OPENAI_API_KEYsk-xxxxxxxxxxxxxxxx :: 5. 启动 codex :: 6. 查看版本 codex --version这种方式特别适合服务器、远程桌面、SSH 或无法使用浏览器完成 OAuth 登录的环境。