Codex CLI 安装：选官方渠道，验证命令并完成首次登录

如果你要在终端里运行 Codex，目标是安装 Codex CLI，不是 Codex 桌面应用，也不是 IDE 扩展。完整路径只有三步：选一个适合当前环境的官方渠道，运行 codex 验证命令可用，再选择 ChatGPT 或 API key 登录。安装脚本结束，只能说明安装器跑完，不能说明当前 shell 已经能找到命令。

截至 2026 年 8 月 16 日，OpenAI 的 Codex CLI 官方页面列出四类安装入口：macOS/Linux 独立脚本、Windows PowerShell 独立脚本、npm 包和 Homebrew cask。下面先帮你选渠道，再完成安装、验证和登录。

“

本文只使用 OpenAI 当前公开的官方命令。它不把第三方镜像、代理、替代模型服务或手写凭据文件包装成“官方安装方式”。

先选与你当前环境相符的官方渠道

这不是四个必须依次执行的步骤，而是互相替代的安装入口。根据操作系统和你已经具备的工具，只选一个分支即可。官方列出命令，不代表它已在每一种系统版本、CPU 架构、企业设备策略或网络环境中成功复现。

按所选渠道安装

macOS 与 Linux：独立安装脚本

在终端执行：

bash
curl -fsSL https://chatgpt.com/codex/install.sh | sh

这是官方当前列出的 macOS/Linux 独立安装命令。

Windows：PowerShell 独立安装脚本

打开 PowerShell，执行：

powershell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

这是官方当前列出的 Windows 独立安装命令。受管理设备的执行策略可能影响执行结果。

npm：安装官方包

如果你的环境已经能使用 npm，可执行：

bash
npm install -g @openai/codex

官方包名是 @openai/codex。当前核验的官方资料没有建立本文可以承诺的 Node.js 最低或推荐版本；如果 npm 本身不可用，应先处理自己的 npm 环境，不要从第三方教程补入一个版本数字。

Homebrew：安装 cask

如果你已经在 macOS 环境中使用 Homebrew，可执行：

bash
brew install --cask codex

这是官方当前列出的 Homebrew cask 安装方式。它不表示 Homebrew 是所有用户都必须采用或始终更合适的渠道。

这些命令证明的是官方当前列出的渠道，不是我们已经在所有系统、架构和网络条件下完成了安装测试。真正的完成信号来自下一步的本机验证。

验证：运行 codex，不要只看安装器输出

安装完成后，打开你准备交给 Codex 处理的项目目录，然后运行：

bash
codex

官方 quickstart 的下一步就是在项目目录中启动 codex，并在首次运行时选择可用的登录方式。你可以据此判断当前状态：

• 终端无法解析 codex：安装目标尚未达到“命令可运行”，不要继续假设认证会成功；回到所选渠道和官方安装页核对当前命令。
• codex 启动并进入 CLI 或首次登录选择：命令已经可用，可以继续处理认证。
• 登录被账户、组织策略或网络条件阻止：这是认证或环境边界，不应通过改用来历不明的镜像、凭据文件或第三方服务来掩盖。

这里的“验证”只确认你看到了可观察的本机结果，不把单台机器的结果扩展成其他操作系统或地区的普遍结论。

首次认证：ChatGPT 登录还是 API Key？

根据 OpenAI 的 Codex 认证文档，本地 Codex CLI 支持 ChatGPT 登录，也支持 API key 登录。两者不是同一个计费与权限语境。

要显式启动浏览器中的 ChatGPT 登录流程，可运行：

bash
codex login

如果选择 API key，官方认证文档给出的 shell 示例是通过 stdin 传入，而不是把密钥直接写进命令参数：

bash
printenv OPENAI_API_KEY | codex login --with-api-key

这条示例要求当前 shell 中已经安全设置 OPENAI_API_KEY，并不代表所有 shell 都使用相同语法。不要把真实密钥粘贴到公开提示词、聊天记录、截图、共享脚本或不受信任的环境中；也不要为了“安装方便”把密钥写进第三方教程建议的公开文件。

登录后可查看当前认证状态：

bash
codex login status

需要清除本地登录状态时，可运行：

bash
codex logout

CLI 与 IDE 扩展可能共享缓存的登录信息。若设备由组织管理，先确认 workspace 权限、凭据存储策略和数据处理要求，再决定使用个人订阅还是 API 项目。

更新 Codex CLI 时沿用原渠道

官方当前给出的更新方式与安装渠道对应：

macOS/Linux 独立脚本

重新运行同一条官方脚本：

bash
curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows 独立脚本

重新运行同一条 PowerShell 命令：

powershell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

npm

bash
npm install -g @openai/codex

Homebrew

bash
brew upgrade --cask codex

安装命令属于易变信息。若你是在较晚日期阅读本文，应先打开官方 Codex CLI 页面核对命令是否仍然一致，再执行更新。

中国大陆读者需要保留的边界

上述命令回答的是“OpenAI 当前公开列出了哪些官方安装与认证入口”，不是“中国大陆所有读者都能稳定完成安装和登录”。当前官方资料和本文证据不能确认以下事项：

• 在中国大陆物理位置稳定访问官方安装器和认证流程；
• 特定账户、ChatGPT 订阅或组织 workspace 的资格；
• 支付方式、地区政策和所有本地功能的完整可用性；
• 某个镜像、代理、VPN、第三方模型提供商或替代 base_url 是 OpenAI 官方方案。

因此，本文不会推荐绕过路径，也不会把中文搜索结果里的第三方配置混进 Codex CLI 官方安装步骤。若你的失败落在访问、资格、支付或组织策略上，应查看当前官方文档，并向自己的 workspace 管理员或账户支持渠道确认；更换安装命令不能自动解决这些边界。

常见问题

npm 安装需要哪个 Node.js 版本？

本文不能给出一个有第一方依据的最低或推荐版本。当前核验的官方 Codex CLI quickstart、认证页与官方仓库资料没有建立该数字。能运行 npm install -g @openai/codex 是进入 npm 渠道的前提，但不能据此反推出未公布的版本要求。

安装成功后一定能登录吗？

不一定。安装、命令可运行和认证是三个可分别观察的节点。账户资格、workspace 权限、网络环境和登录方式都会影响认证结果；官方同时提供 ChatGPT 与 API key 路径，不等于任意账户在任意地区都能使用全部功能。

可以直接使用第三方镜像或“国内模型”配置吗？

它们不属于本文能够核验的 OpenAI 官方安装事实。第三方服务可能有自己的认证、计费、数据处理和安全边界，不应与安装官方 Codex CLI 混为一谈。

怎样判断我装的是 CLI，而不是其他 Codex 产品？

本文的完成信号是在项目目录中运行 codex，进入 Codex CLI 的首次运行或认证流程。桌面应用和 IDE 扩展有各自的安装入口；搜索“Codex 安装”时看到它们，并不代表它们能替代终端中的 codex 命令。

用四个结果确认这次安装是否完成

• 目标无误：你安装的是终端中的 Codex CLI，而不是桌面应用或 IDE 扩展。
• 渠道可追溯：你只选择并执行了一个当前官方列出的安装入口。
• 命令可观察：在项目目录运行 codex 后，终端进入 CLI 或首次认证流程。
• 认证选择明确：你知道当前使用 ChatGPT 订阅语境还是 API 按量语境，并可用 codex login status 检查状态。

任何一步若触及未确认的地区、账户或平台条件，就停在实际看到的结果上，回到当前官方资料核对，而不是用第三方说法补齐未知。这样完成的不是“复制过一条命令”，而是一条能说明渠道来源、当前状态和认证后果的 Codex CLI 安装路径。