Codex 怎么安装？桌面版、命令行下载安装，登录要验证手机号怎么办

现在大家说的 Codex 桌面版，就是 ChatGPT 桌面应用里的 Codex。官方介绍页是 openai.com/codex，下载入口在 ChatGPT 官方文档的桌面版页面：点 Download ChatGPT 右边的小箭头，可以选 macOS（Apple 芯片）、macOS（Intel）、Windows 和 Linux。

Mac 下载的是 dmg 文件，双击后把应用拖进“应用程序”。Windows 从 Microsoft Store 安装，也可以在 PowerShell 里用 winget 装。Linux 版还在预览阶段，支持 Ubuntu 24.04 / 26.04、Debian 13、Fedora 43 / 44 和 Arch，按系统下载 .deb 或 .rpm 包。

装好后打开，点 Continue，浏览器会跳到 OpenAI 的登录页。登录完回到应用，在 ChatGPT 下拉菜单里选 Codex，再打开一个项目文件夹就能开始用。

winget install --id 9PLM9XGG6VKS -s msstore

cd ~/Downloads
sudo apt install ./chatgpt_amd64.deb

点击查看大图↗

IMAGE VIEWER

ChatGPT 官方文档的下载按钮展开后，列出 macOS（Apple silicon）、macOS（Intel）、Windows 和多个 Linux 安装包

完整预览原图尺寸

1280 × 1038

想在终端里用 Codex，就装 CLI。官方给了四种装法，选一种就行：Mac 和 Linux 用安装脚本，Windows 用 PowerShell 脚本，装了 Node.js 的可以用 npm，Mac 上用 Homebrew 的也能直接装。

安装脚本要从 chatgpt.com 下载，国内网络经常卡住。更省事的是用 npm 国内镜像：npmmirror 同步了官方的 @openai/codex 包，9 月 24 日核对时版本和 npm 官方一致，都是 0.156.1。npm 方式需要 Node.js 16 或更高版本。

装完输入 codex --version，能看到版本号就是装好了。以后升级用 codex update。

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

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

npm install -g @openai/codex --registry=https://registry.npmmirror.com

brew install --cask codex

codex --version

主要在编辑器里写代码的，装 OpenAI 发布的 Codex 插件。在扩展市场搜 Codex，认准发布者是 OpenAI、条目 ID 是 openai.chatgpt。Cursor、Windsurf 这类基于 VS Code 的编辑器也能装。

插件和 CLI 共用一份登录信息：在一边登录过，另一边一般不用再登；在任意一边退出，两边都要重新登录。

第一次运行 codex，或者第一次打开桌面版、插件，都会让你选登录方式。选 Sign in with ChatGPT，用你自己的 ChatGPT 账号登录，用的就是这个账号套餐里的 Codex 额度。

另一种是 API Key 登录。它按 API 用量另外收费，不走套餐额度，部分功能也用不了，比如 Codex 云端任务必须用 ChatGPT 账号登录。只想用套餐额度的，不用去弄 API Key。

登录时浏览器会打开 OpenAI 的页面，登录完再把凭证交回 Codex。浏览器显示登录成功、终端却一直在等，通常是本机回调被网络设置挡住了，或者你是在远程服务器上装的。这时改用设备码登录：先在 ChatGPT 网页版的安全设置里打开设备码登录，再运行下面的命令，打开它给的链接，登录后输入一次性代码。

登录信息存在本机的 ~/.codex/auth.json 或系统钥匙串里。这个文件就是你账号的钥匙，别发给别人，也别传到 GitHub。

codex login status

codex login --device-auth

codex logout

这是装 Codex 时问得最多的问题。ChatGPT 网页版登录好好的，一到 Codex 就跳出 Verify your phone number 或 Phone number required，要你填手机号收验证码。

OpenAI 帮助中心 9 月 23 日更新了说明：注册账号、使用 ChatGPT 一般不需要验证手机号，但在桌面版里使用 Codex 时可能会被要求。验证码只能发短信，部分国家可以发到 WhatsApp，不能发邮件，也不能打电话。邮箱和验证器 App（也就是常说的两步验证、2FA）都代替不了这一步。

帮助中心只提到桌面版，但官方社区里不少人反映，用 CLI 和 VS Code 插件登录也会被带到同一个验证页。也不是每个账号都会遇到：V2EX 上有人新注册的账号直接登录没被要求，也有人付费账号照样要验证。OpenAI 没有公开触发规则。

点击查看大图↗

IMAGE VIEWER

OpenAI 帮助中心说明：使用桌面版中的 Codex 可能要求验证手机号，验证码只通过短信或 WhatsApp 发送，邮箱和验证器 App 不能代替手机验证

完整预览原图尺寸

1456 × 1036

• 能用：能正常收短信的手机号。所在国家支持的话，也可以选 WhatsApp 收码，帮助中心列了阿联酋、印度、印度尼西亚、马来西亚、土耳其、越南等 12 个国家。
• 不能用：座机、Google Voice 这类网络电话（VoIP）和付费号码。官方的理由是这些号码常被用来作弊。
• 国内手机号：中国大陆和香港不在 OpenAI 支持的国家和地区名单里，一般用不了。
• 号码绑定后不能更换：帮助中心写明，ChatGPT 和 API 都不支持修改账号绑定的手机号。好在正常情况下验证一次就够了，登录后不会反复要你收码。

• 手上有境外手机号的（实体卡或 eSIM），直接用它最省心。
• 验证一般只要做一次。之前 Codex 有过一个问题：已经登录的账号，又被要求验证一个早就不用的旧号码。OpenAI 7 月 22 日在官方社区说已经修好了。真遇到了，先退出重新登录；还不行再发邮件到 [email protected]，附上截图和出错时间。
• 没有境外号码，可以用接码平台，比如 hero-sms.com，几美分就能临时买一个号码收验证码。有两点要知道：不是每个号码都能收到码，收不到就换一个；这类号码大多是临时的，OpenAI 又不支持改号，万一以后又被要求验证，原来的号码可能已经用不了。

桌面版连不上，先看电脑的浏览器能不能正常打开 chatgpt.com。终端里的 CLI 要多注意一点：它默认不读系统代理设置，“跟随系统代理”这个功能还在开发中。所以常见的情况是浏览器能上 ChatGPT，终端里的 codex 却一直连不上，或者登录后卡住。

解决办法有两个。一是在终端里设置 HTTPS_PROXY 等环境变量，指向代理软件的本地端口，端口号在代理软件的设置里看，常见的是 7890，下面命令里的端口记得换成你自己的。二是打开代理软件的 TUN（虚拟网卡）模式，让终端的流量也走代理。

设好后运行 codex doctor 自查。它会列出安装方式、登录状态和网络情况：Connectivity 一栏能看到有没有读到代理变量，websocket 显示 connected 就说明能连上 OpenAI。

export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890

$env:HTTPS_PROXY="http://127.0.0.1:7890"
$env:HTTP_PROXY="http://127.0.0.1:7890"

codex doctor

点击查看大图↗

IMAGE VIEWER

codex doctor 输出节选：读到了 HTTP_PROXY、HTTPS_PROXY 环境变量，respect system proxy 为 disabled，websocket 已连接

完整预览原图尺寸

1100 × 554

Codex 包含在 ChatGPT 的 Free、Go、Plus、Pro、Business、Edu 和 Enterprise 套餐里，不用单独买。网上说的“Codex 充值”“Codex 会员”，其实就是给 ChatGPT 账号开 Plus 或 Pro。

Free 和 Go 能体验，额度少；日常写代码大多用 Plus；天天用、经常撞额度的再看 Pro 5×。先用现有账号跑几个真实任务，看额度够不够再决定。每个套餐每 5 小时能用多少、用完怎么办，看额度指南。