Codex CLI安装与登录：npm安装、ChatGPT账号登录与代理配置

安装与登录的完整流程

Codex CLI 是 OpenAI 推出的终端 AI 编程工具，在命令行里读取项目代码、执行命令并修改文件。安装它本身并不复杂，真正让人卡住的往往是网络：npm 下载慢、浏览器授权后终端收不到结果、登录提示地区不支持。按下面四步走，可以一次完成：

1. 安装 Node.js，确认 node 和 npm 可用；
2. 让当前终端走代理，并把本地地址排除在代理之外；
3. 用 npm 全局安装 @openai/codex；
4. 在项目目录运行 codex，选择 ChatGPT 账号或 API Key 登录。

本文专注安装与登录环节。节点地区、线路选择等长期使用的网络要求，请看 Codex 稳定网络环境指南。

准备工作

项目	要求	如何检查
Node.js 与 npm	建议使用较新的 LTS 版本，最低版本以官方说明为准	node -v、npm -v
操作系统	macOS、Linux；Windows 原生支持情况以官方文档为准，也可在 WSL 中使用	—
代理客户端	已导入订阅并能正常上网，记下本地混合端口	客户端“端口设置”
账号	ChatGPT 账号，或有余额的 OpenAI API Key	—
出口地区	OpenAI 支持的国家和地区，不要用香港节点	见后文验证步骤

以 Clash Verge Rev 为例，混合端口默认通常是 7897，下面的命令都以这个端口为准，实际请替换成你自己的端口。客户端的基本用法见 Clash Verge 使用教程。

步骤一：让终端先走代理

浏览器会自动使用系统代理，但 npm 和 Codex CLI 这类命令行程序通常不会，所以要在安装前先设置环境变量。

Windows（PowerShell）

$env:HTTPS_PROXY = "http://127.0.0.1:7897"
$env:HTTP_PROXY  = "http://127.0.0.1:7897"
$env:NO_PROXY    = "localhost,127.0.0.1"

macOS / Linux（zsh 或 bash）

export HTTPS_PROXY=http://127.0.0.1:7897
export HTTP_PROXY=http://127.0.0.1:7897
export NO_PROXY=localhost,127.0.0.1

这些设置只对当前终端窗口有效。NO_PROXY 很关键：ChatGPT 账号登录时，浏览器要把授权结果回调到本机地址，如果这个请求也被送进代理，终端就会一直等待。

如果 npm 仍然很慢，可以单独给 npm 指定代理，用完后再删除：

npm config set proxy http://127.0.0.1:7897
npm config set https-proxy http://127.0.0.1:7897
# 不再需要时
npm config delete proxy
npm config delete https-proxy

不想逐个配置时，也可以在客户端中开启 TUN 模式，让所有程序的流量都经过代理。

步骤二：用 npm 安装 Codex CLI

npm i -g @openai/codex
codex --version

能输出版本号就说明安装成功。以后升级执行 npm i -g @openai/codex@latest 即可。macOS 用户也可以通过 Homebrew 安装，具体命令以官方文档为准。

在 macOS 或 Linux 上如果出现 EACCES 权限错误，不建议直接加 sudo，更稳妥的做法是用 Node 版本管理工具安装 Node.js，或者把 npm 全局目录改到用户目录下。

步骤三：运行 codex 并登录

进入要处理的项目目录后启动：

cd 你的项目目录
codex

首次运行会出现登录选项，常见的有两种：

• 使用 ChatGPT 账号登录：CLI 会打开浏览器，登录 ChatGPT 并确认授权后，结果回调给终端，终端显示登录成功即可开始使用。额度与订阅计划相关，以官方说明为准。
• 使用 API Key：先把 Key 设置到 OPENAI_API_KEY 环境变量，再在登录界面选择 API Key 方式，按 API 实际用量计费。

# Windows PowerShell
$env:OPENAI_API_KEY = "你的 API Key"

# macOS / Linux
export OPENAI_API_KEY="你的 API Key"

较新版本还提供独立的 codex login 与 codex logout 子命令，可以在不进入交互界面的情况下切换登录状态，具体参数以 codex --help 的输出为准。登录凭证保存在用户目录下的 Codex 配置文件夹中（通常是 ~/.codex），不要把它提交到代码仓库。

在没有图形界面的远程服务器上，浏览器回调无法直接完成，官方文档提供了远程环境的替代登录方式，按官方说明操作即可。

两种登录方式怎么选

对比项	ChatGPT 账号登录	API Key
计费方式	使用订阅计划内额度	按 API 实际用量计费
适合人群	已订阅 ChatGPT 的个人开发者	需要精确控制成本或在脚本中调用的用户
网络注意点	需要浏览器授权并回调本机，浏览器与终端出口要一致	不经过浏览器，只要终端能访问 OpenAI API
凭证风险	凭证保存在本机配置目录	Key 泄露会被他人消耗余额

如果浏览器授权一再失败，可以先用 API Key 方式确认终端网络没有问题，再回头排查浏览器与回调环节，这样能快速把问题范围缩小一半。

在 WSL 中使用时的代理设置

Windows 用户在 WSL 里安装 Codex CLI 时，最容易忽略的一点是：WSL2 默认使用独立的虚拟网络，里面的 127.0.0.1 指向 WSL 自己，而不是 Windows 主机，所以直接照抄上面的代理地址是连不上的。常见解决办法有三种：

1. 开启 Windows 端的 TUN 模式：多数情况下 WSL 的流量也会被接管，无需在 WSL 中再设置环境变量，实际效果以你的系统环境为准；
2. 使用主机地址：在代理客户端中开启“允许局域网连接”，然后在 WSL 中用 Windows 主机的地址作为代理；
3. 镜像网络模式：较新版本的 WSL 支持镜像网络模式，开启后 WSL 可以直接使用 127.0.0.1 访问主机上的代理端口，开启方法以微软官方文档为准。

采用第二种方法时，可以在 WSL 中这样获取主机地址并设置代理：

HOST_IP=$(ip route show | grep -i default | awk '{ print $3 }')
export HTTPS_PROXY=http://$HOST_IP:7897
export HTTP_PROXY=http://$HOST_IP:7897
export NO_PROXY=localhost,127.0.0.1

设置完成后，同样用下文的 curl 命令验证连通性，再执行安装和登录。

验证是否安装成功

1. codex --version 能输出版本号；
2. 在同一个终端执行下面的命令，确认能连通 OpenAI：

# Windows PowerShell（注意用 curl.exe，避免调用 PowerShell 自带的别名）
curl.exe -I https://api.openai.com/v1/models

# macOS / Linux
curl -I https://api.openai.com/v1/models

返回 401 一类状态行说明网络已连通（只是没带 Key）；长时间无响应说明终端没走代理或节点不可用；返回 403 并提示地区不受支持，要换到支持地区的节点。

3. 在 Codex 中提一个简单问题，例如“说明这个项目的目录结构”，能正常输出回答即说明登录和网络都已就绪。

常见错误

现象	常见原因	解决方法
npm i 卡住或 ETIMEDOUT	npm 未走代理	设置环境变量、npm 代理或开启 TUN
提示找不到 codex 命令	npm 全局目录不在 PATH 中	执行 npm prefix -g 查看目录，加入 PATH 后重开终端
浏览器授权成功，终端一直等待	本地回调被代理拦截	设置 NO_PROXY，重新登录
登录时报地区不支持	出口 IP 不在支持地区	换美国、日本、新加坡等节点，见 Region Not Supported 解析
能登录，但任务中途断开	线路丢包或节点自动切换	见 Codex stream disconnected 排查
连接超时	节点本身不可用	参考 节点超时解决方法

节点与订阅建议

安装和登录只需要短时间联网，但日常用 Codex 执行长任务时，线路丢包率和节点是否固定更重要。本站收录的品牌中，目前只有 二猫云 的 Codex 经过实测可用（美国、日本、新加坡节点，专线丢包 0.3%），详细数据见 二猫云评测；其他品牌的 AI 实测情况可以对照 AI 机场排行榜。如果你同时使用 Claude Code，两者的网络差异可以参考 Codex 与 Claude Code 网络要求对比。

请遵守所在地法律法规以及 OpenAI 的使用条款与支持地区政策，API Key 等同于付费凭证，不要分享给他人。