codex cli的安装方法

📅 2026/7/18 19:29:18 👁️ 阅读次数 📝 编程学习
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

安装完成后,重新打开CMDPowerShell

验证是否安装成功:

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 登录的环境。