下载并打开 Codex

这一页是 Codex 配置 7 步中的第 3 步。按顺序做，别凭感觉改配置；卡住了先看问题排查清单，解决不了就去技术支持。

用 Windows 或 macOS 的，装桌面端就行。Linux 用户装 Codex CLI。想只在 VS Code、 Cursor 或 Trae 里用，那就再装个扩展。之前装过的先更新到最新版：桌面端从官方下载页重新下载装一遍，CLI 把下方的安装命令再跑一次，直接覆盖。

电脑上装了不止一个入口的话，先挑定一个来配，记清你实际打开的到底是桌面端、CLI 还是编辑器扩展。下载、更新或登录失败了，把完整报错留着，解决完再往下走。

选择安装方式

Codex / ChatGPT 桌面端Windows / macOS 用户选这个

打开官方下载页，页面会自动匹配你的系统，点下载装上就行。Codex 就在装好的 ChatGPT 桌面端里，打开后选 Codex 即可。

这个页面必须在能访问 OpenAI 的网络下才打得开。在中国大陆打不开的话，直接用下面的「大陆直连下载」。

大陆直连下载官方页打不开时用，自动给你最新版

点对应你电脑的那条，下到的就是官方原版安装包，装法跟官方一样：

Windows: 直接下载 Windows 版下到 .Msix，双击安装；ARM 设备用 ARM64 版
Mac · Apple 芯片: 直接下载 Mac 版2021 年之后的 Mac 基本都是
Mac · Intel 芯片: 直接下载 Intel 版不确定就点苹果菜单 → 关于本机

这几条链接来自社区镜像项目 codex-app-mirror，不是 OpenAI 官方渠道。它原样搬运官方安装包，内容和官方逐字节一致。想自己核对的话，下载校验清单，Windows 用 certutil -hashfile 文件名 SHA256、Mac 用 shasum -a 256 文件名 对一下。

链接打不开时，去镜像的 GitHub Releases 页面下载同名文件；Windows 用户也能在微软商店搜 ChatGPT（发布者 OpenAI）直接安装。

Codex CLI主要给 Linux 用户

macOS / Linux：

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

Windows PowerShell：

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

上面两条命令也要能访问 OpenAI 的网络。在中国大陆装 CLI，先装 Node.js，再走阿里的 npm 镜像，内容和官方源逐字节一致：

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

VS Code / Cursor / Trae可选入口

安装 OpenAI Codex 扩展，它会读取同一份本机 Codex 配置。扩展商店在大陆一般能直接访问。

登录 Codex

打开 Codex，看自己的情况挑一种登录方式：

有 ChatGPT 账号: 按界面提示直接登录不影响后续走 Portdan，也不需要账号有额度
没有账号，用 Portdan Key: 选择 API Key 登录粘贴第 1 步创建的完整 Key，不要加引号或 Bearer 前缀

下载并打开 Codex ​

选择安装方式 ​

登录 Codex ​

下载并打开 Codex

选择安装方式

登录 Codex