Codex CLI 怎么安装？

Codex CLI 的常见安装方式是用 npm 全局安装官方包 @openai/codex，装好后在终端执行 codex 即可启动。截至 2026 年 9 月，具体的安装命令、Node.js 版本要求与支持的系统，请以 OpenAI 官方文档为准。

国内网络下需要额外准备两件事：一是让终端走代理，否则 npm 下载和后续请求都会超时；二是首次登录时，浏览器与终端必须使用同一个支持地区的节点。Codex 的登录采用浏览器回调，两边地区不一致是「浏览器授权成功、终端却一直等待」最常见的原因。

安装前准备

第一步：设置终端代理

在代理客户端中找到本地混合端口，Clash Verge Rev 通常是 7897，以实际显示为准。

macOS / Linux / WSL：

export HTTPS_PROXY=http://127.0.0.1:7897
export HTTP_PROXY=http://127.0.0.1:7897
curl -I https://api.openai.com

Windows PowerShell：

$env:HTTPS_PROXY = "http://127.0.0.1:7897"
$env:HTTP_PROXY = "http://127.0.0.1:7897"
curl.exe -I https://api.openai.com

curl 能返回响应头就说明终端代理生效。更完整的终端代理设置见 Codex CLI 代理设置。

第二步：安装并登录

1. 在已设置代理的终端中执行全局安装。
2. 执行 codex 启动，选择登录方式。
3. 使用 ChatGPT 账号登录时，会自动打开浏览器完成授权，授权结果回传给本地终端。
4. 授权前确认浏览器与终端走同一个节点：规则模式下浏览器可能被分到其他节点组，最省事的做法是暂时切到全局模式或开启 TUN 模式。
5. 终端显示登录成功后，进入项目目录即可开始使用。

npm install -g @openai/codex
codex

选哪种登录方式

使用 ChatGPT 账号登录时，用量计入账号所属套餐；使用 API Key 登录时，按 API 实际用量计费。两者的额度与可用模型会随官方政策调整，截至 2026 年 9 月以官方说明为准。

从网络角度看，API Key 登录不需要浏览器回调，适合远程服务器或没有图形界面的环境；ChatGPT 账号登录更适合本机日常使用，但要额外注意浏览器与终端的节点一致。无论哪种方式，后续每一次请求都需要终端稳定走代理。

常见安装问题

命令找不到：npm 全局目录不在 PATH 中，用 npm prefix -g 查看后加入 PATH。

登录卡住：多数是浏览器与终端地区不一致，排查方法见 Codex 登录失败怎么办。

安装后请求频繁断开：CLI 长连接对丢包敏感，建议选低倍率、低丢包的专线节点，挑选方法见 Codex 用什么节点。

总结

• 通过 npm 全局安装 @openai/codex，细节以官方文档为准。
• 安装与登录前先让终端走代理，用 curl 验证。
• 登录走浏览器回调，终端与浏览器必须使用同一地区节点。
• 日常使用选低丢包专线节点，避开香港。