Codex下载：官网入口、桌面版、CLI安装与Windows配置全流程【2026年8月更新】

最后更新：2026-08-11

国内 Codex 与多模型 API 开发工具推荐

国内进行 Codex、代码、脚本或多模型 API 开发时，可以按任务选择以下第三方工具：

• 💻 Codex/编程训练（ZeoGPT）：zeogpt.comCodex、代码、长文本和开发任务。
• 🔌 API/脚本接入（ZeoAPI）：zeoapi.com多模型 API 接入、脚本和原型测试。

以上均为邀请链接。ZeoGPT 与 ZeoAPI 均为第三方服务，不是相关模型厂商的官方网站或官方产品；所列型号与能力来自平台标称，具体功能与可用性以登录后的实际页面为准。请勿上传账号密码、API Key、合同或其他敏感资料。

本站是独立中文教程与导航博客，并非 OpenAI 官方网站，也不提供站内对话或代码执行功能。手机上想用 Codex，请打开 OpenAI 官方产品页或对应客户端，本站只讲解下载、安装与配置流程。文中提到的 Web、App、CLI 和 IDE 均指 OpenAI 官方产品形态，第三方开发工具会另行标注。

想把 Codex 真正装到电脑上并跑通第一次，可以直接按这条路线操作：核验官方唯一下载入口 → 判断自己要桌面版还是 CLI → 选择适合系统的安装方式 → 核对版本和命令路径 → 用 ChatGPT 账号或 API Key 登录 → 配置 config.toml → 在测试项目里完成第一次只读分析和小范围修改。整篇教程只围绕 OpenAI 当前的 Codex，不把早期弃用的旧 Codex 模型、第三方同名软件、增强启动器和不明镜像混为一谈。安装命令以 openai/codex 官方仓库 当前 README 为准，版本会持续更新，实际安装时不要照搬任何文章记录的固定版本号。

Codex 下载最短路径：先给结论

如果你只想尽快装上，可以直接照这个次序做，细节在后面各节展开：

• Windows：打开 PowerShell，运行官方安装脚本，重开终端后用 codex --version 验证。
• macOS / Linux：终端运行官方 shell 脚本，或用 brew install --cask codex。
• 已有 Node 环境：npm install -g @openai/codex 也行，但要留意多个 Node 路径冲突。
• 只想要图形界面：优先看官方桌面 App，而不是从下载站找“Codex 电脑版安装包”。
• 装完先登录、再配置、最后在测试项目里跑第一条只读任务。

需要中文开发工作流或较高额度 GPT 编程模型时，除了 OpenAI 官方 Codex CLI，也可以了解第三方平台 ZeoGPT（第三方服务，非 OpenAI 或 Codex 官方产品）；只做脚本、原型和多模型 API 测试，可以看 ZeoAPI（第三方 API 中转服务，非模型厂商官方 API）。两者都是邀请链接、都不是官方入口，功能与可用性以登录后的实际页面为准，接入前请先用公开或脱敏代码测试，不要上传 API Key、.env、客户数据、生产日志或私有仓库。

Codex 有哪几种形态：桌面 App、CLI 与 IDE 下载入口对照

搜索“Codex 下载”时最常见的错误不是命令输错，而是下载了错误形态，或从错误的地方下载。当前 Codex 可以出现在网页、桌面应用、命令行和编辑器中，它们的安装方式与权限边界不同。官方文档把 Codex 描述为“为软件开发设计的编码智能体”，并说明它有多种运行入口，你要先确定自己要哪一种。

形态	是否需要本地安装	更适合什么任务	从哪里开始
Codex Web	通常不需要	云端任务、阅读仓库、发起编码工作	ChatGPT 内的 Codex 入口
Codex 桌面版（App）	需要安装或从 CLI 启动	图形界面管理项目、会话与修改	官方 App 页面或 codex app
Codex CLI	需要	在终端读取项目、改文件、跑测试	openai/codex
Codex IDE 扩展	需要编辑器扩展	VS Code、Cursor、Windsurf 内协作	OpenAI Codex 官方文档

判断标准很直接：只想解释一段报错，不一定要装 CLI；想要图形化地看项目、切换会话、审查修改，桌面版 App 更顺手；要让 Codex 读本地仓库、改多个文件并运行命令，CLI 或 IDE 更合适。很多人搜索“codex桌面版”“codex官网下载电脑版”，其实要的是官方 App，而不是下载站上打包的第三方安装器。还没选好入口，可以先看 Codex 官网入口选择指南，想直接上手桌面版和沙箱，可看 Codex Windows 桌面版与 Sandbox 指南。

官方唯一下载渠道核验：如何辨别仿冒站与第三方安装包

Codex 没有一个五花八门的“官方下载站”网络，能作为核验基准的只有 OpenAI 自家页面。建议把下面三个地址固定为核验链路，任何第三方下载页都拿来跟它们对照：

1. OpenAI Codex 官方文档：核对当前产品、认证、系统支持和配置说明。
2. openai/codex 官方 GitHub 仓库：核对安装命令、源码、README 和版本发布，这个仓库当前已获得十万级 Star，是命令的权威来源。
3. Codex GitHub Releases：需要手动下载二进制文件时核对平台和架构。

辨别仿冒站可以用几个稳定信号：

• 官方安装脚本域名指向 OpenAI 自有域，不是任何个人博客、网盘或第三方镜像。
• 官方从不通过网盘、论坛附件、二维码或客服私聊发放安装包。
• 官方不会要求你先关闭杀毒软件、以管理员身份运行未知脚本，或在下载前输入 ChatGPT 账号密码。
• 页面若强调“绿色版”“破解版”“免登录版”“完整整合包”“内置模型直连”，基本可以判定不是官方入口。

Codex 会读取本地代码并可能执行命令，来源错误的风险远高于普通阅读软件。看到要求复制浏览器 Cookie、上传 API Key 或运行不明脚本时，应立即停止。国内网络环境下的合规访问与镜像取舍，可参考 Codex 国内能用吗与镜像下载分析。

Windows 下载与安装：系统要求与 Node.js/PATH 前置检查

OpenAI 官方仓库当前给出了 Windows PowerShell 安装脚本。动手前先做前置检查，能省掉一大半“命令找不到”的报错：

• 使用普通用户的 Windows Terminal 或 PowerShell，而不是残缺的第三方终端。
• 如果打算用 npm 安装，先确认 node --version、npm --version 正常返回，Node 建议使用官方仍在维护的 LTS 版本。
• 确认公司电脑没有全面禁止远程脚本、用户级安装或未知发布者程序。

打开 PowerShell，运行官方 README 中的安装命令：

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

安装结束后关闭当前终端，重新打开 PowerShell，然后核对：

codex --version
codex --help
where.exe codex

三个命令分别确认版本、帮助信息和实际调用路径。若 codex --version 成功，但 where.exe codex 显示多个路径，说明电脑里可能同时存在旧版 npm 安装、手动下载版本或其他同名命令，应先确认哪个路径来自官方安装，再决定是否清理旧版本。

Windows 脚本无法运行时，按以下顺序排查，不要一开始就关掉安全软件或永久放开执行策略：

1. 确认 PowerShell 能访问官方安装脚本地址。
2. 检查公司电脑是否禁止远程脚本、用户级安装或未知发布者程序。
3. 改用官方 README 中的 npm 安装方式。
4. 仍失败时，从官方 GitHub Release 下载与架构匹配的 Windows 文件。
5. 如果原生 Windows 的沙箱、路径或依赖表现不符合当前文档，再考虑 WSL2。

需要更细的 PATH、登录回调和 Windows 排错步骤，可继续看 Codex CLI Windows 安装与首次运行排错 与 Codex CLI 安装与 Windows 使用教程。

macOS 下载安装：脚本、Homebrew 与首次授权

macOS 可用官方 shell 脚本：

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

已用 Homebrew 管理工具的 macOS 用户，也可按官方 README 使用：

brew install --cask codex

安装后新开终端并运行：

codex --version
codex --help
command -v codex

如果你下载的是桌面 App 的 .dmg，按常规做法把 Codex 拖入 Applications，再从启动台或应用文件夹打开。首次启动时 macOS 可能弹出“来自互联网的应用”确认，只在你确认这是从官方渠道下载的安装包时才继续；若下载来源不明，宁可删除重下也不要放行。提示 command not found 时，先检查 shell 类型与 PATH，macOS 常见于 zsh 启动文件尚未重新加载。不要为了让命令出现，就把未知目录塞到 PATH 最前面。

Linux 与 npm 安装方式

Linux 同样可用官方 shell 脚本：

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

三平台也都支持官方 npm 包：

npm install -g @openai/codex

安装前先看 node --version、npm --version，安装后用 codex --version 和 npm list -g @openai/codex --depth=0 核对。npm 安装最常见的问题是全局目录权限、Node 版本管理器冲突和多个 npm 路径。Windows 用 where.exe node/npm/codex、macOS/Linux 用 command -v node/npm/codex 对比，三者最好来自同一套预期环境。Linux 上 command not found 常见于安装目录不在当前用户 PATH、代理拦截下载或 CA 证书异常。跨平台安装与国内开发者的整体路线，可参考 Codex 安装与使用教程 2026。

首次登录与运行验证：ChatGPT 登录路径与版本检查

安装完成后进入一个不含敏感信息的测试目录，运行 codex。首次启动优先按界面选择 Sign in with ChatGPT。官方文档说明 ChatGPT Plus、Pro、Business、Edu 和 Enterprise 计划包含 Codex，具体可用范围以你账号登录后的实际页面为准。浏览器登录成功不等于终端一定完成认证，必须回到终端确认已收到登录结果。

远程服务器、SSH 或没有可用浏览器的环境，可尝试设备码登录，然后检查状态：

codex login --device-auth
codex login status

需要 API Key 时，应从环境变量通过标准输入交给 Codex，不要把完整 Key 写进命令参数、截图、文章或仓库：

## macOS / Linux
printenv OPENAI_API_KEY | codex login --with-api-key

## PowerShell
$env:OPENAI_API_KEY | codex login --with-api-key

提示 401、403 或读不到 Key 时，先确认当前 Shell 是否真存在该变量，再检查 Key 所属项目、组织权限和认证方式，不要为排错把 Key 明文写进 config.toml。

事实边界：ChatGPT 登录和 OpenAI API Key 是两条不同认证路径，权限、会话和使用条件都不同；能登录 ChatGPT 网页并不代表一定能用 API。第三方 API 地址只有在服务明确兼容当前 Codex 的请求、认证、模型名和工具调用格式时才可能正常工作，且它们不是官方入口，接入前要核对数据流向、日志与服务条款。整套登录与工作流对照可看 ChatGPT Codex 使用、CLI 与 API 指南。

找到并配置 config.toml

Codex 默认把状态和用户配置放在 ~/.codex，也可以用 CODEX_HOME 改变目录。

系统	常见配置路径
Windows	%USERPROFILE%\.codex\config.toml
macOS/Linux	~/.codex/config.toml
自定义目录	$CODEX_HOME/config.toml

项目还可以有 .codex/config.toml。当前官方实现中，命令行会话覆盖通常高于项目配置，项目配置又高于用户配置。遇到“改了配置却不生效”，不要只盯着一个文件，要同时检查当前目录、命令行参数、项目级配置和用户级配置。

一个偏保守的基础示例：

## ~/.codex/config.toml
approval_policy = "on-request"
sandbox_mode = "workspace-write"

approval_policy 控制何时向你请求批准，sandbox_mode 控制文件与环境访问范围。具体可用值和默认行为可能随版本变化，修改前请核对官方配置文档与当前 CLI 输出。三个原则值得长期遵守：密钥放环境变量或 Secret 系统、第一次使用保留审批、项目规则写进 AGENTS.md。想验证第一条任务怎么设边界，可看 Codex 提示词示例大全。

第一次运行不要直接改生产项目

新建测试目录，或复制一个没有 .env、密钥、客户数据和生产配置的小项目，先建 Git 基线：

git init
git add .
git commit -m "baseline before Codex"

启动后第一条任务只要求读取和解释：

只读取当前项目，说明目录结构、启动命令和测试命令。
不要修改文件，不要安装依赖，不要访问网络。

只读结果正常后，再给一个极小修改：

只修改 tests/example.test.ts，为现有函数补一个边界测试。
不要修改依赖、配置和其他文件。完成后给出 Git Diff 摘要和测试命令。

修改后必须自己 git status、git diff 并运行原有测试或构建。Codex 的回答不是验收结果，文件列表、Diff、测试输出和可回滚性才是。

Codex 下载与安装常见报错清单

现象	优先检查	不建议做的事
codex 命令找不到	终端是否重开、PATH、安装目录、多个 Node 环境	反复安装不同来源的同名包
下载脚本连接失败	网络、代理、CA 证书、能否访问官方脚本地址	转去下载站找“绿色版”替代
版本与预期不同	实际执行路径、npm/Homebrew/手动版本冲突	只看包管理器显示，不看实际路径
ChatGPT 登录循环	浏览器账号、回调端口、代理、CLI 版本、组织策略	复制 Cookie 或把账号密码交给第三方
401	Key 是否撤销、变量名、当前 Shell 是否读取、认证方式	截图或公开完整 Key
403	项目、组织、模型权限与策略限制	连续生成新 Key 掩盖权限问题
429	速率、并发、可用额度和重试策略	无限重试或并发轰炸
无法修改文件	沙箱模式、审批、目录权限、项目规则	直接启用完全访问后继续试错
config.toml 不生效	用户级、项目级、会话参数和 CODEX_HOME 优先级	同时改多个配置来源

需要版本检查、升级失败处理、降级与彻底卸载，参考 GPT-5.6 Codex 更新与最低版本排查；其余错误码可从站内故障排查文章逐一定位，不要靠反复覆盖安装“修好”环境。

安全提示：不要使用来源不明的“完整版/绿色版”

搜索“codex官网下载安装”“codex官网下载电脑版”时，会出现大量打包好的第三方安装器，宣称免登录、内置直连、免翻墙。它们的风险集中在三处：

• 安装包可能被篡改，植入窃取 ChatGPT 凭据或本地代码的程序。
• 所谓“直连”常把你的请求转发到不透明的中转服务，代码、密钥和会话都经过第三方。
• 打包版本往往落后官方，命令、配置和认证方式对不上，反而更难排错。

判断很简单：能不能把下载来源一路追回到 OpenAI 官方文档、官方仓库或官方 Release？不能就不要装。如果你在国内确实需要更顺的开发环境，与其冒险下载破解包，不如把“官方 Codex + 合规访问”和“第三方开发平台”分开看待——需要中文开发工作流时可以评估文首推荐框里的 ZeoGPT，需要多模型 API 时可以评估 ZeoAPI，但要清楚它们都是第三方服务、都不是官方 Codex，敏感资料一律不上传。

下一步：CLI 常用命令与项目工作流入口

装好并跑通第一次之后，重点从“怎么下载”转到“怎么用好”。建议按这个顺序推进：

• 先掌握基础的只读分析和小步修改，再逐步放开权限。
• 把项目规则写进 AGENTS.md，让 Codex 每次都知道边界和命令。
• 熟悉常用斜杠命令、会话恢复和代码审查流程，减少来回描述。

下载与配置完成后的安全避坑清单，建议逐条对照：

• 下载来源能回到 OpenAI 官方文档、官方仓库或官方 Release。
• codex --version、帮助命令和实际路径都能正常返回。
• 已明确使用 ChatGPT 登录还是 API Key，不混用排错。
• config.toml 不包含 API Key、Token、Cookie 或生产密码。
• 第一次任务在测试项目或新分支中完成，并已查看 Git Diff。
• 已运行与改动相匹配的测试或构建，并知道如何回滚。
• 使用第三方入口前，已确认数据流向、日志与密钥保存方式。

想继续深入命令和工作流，可从 安装、CLI 与 IDE 与 Codex 国内使用指南 2026 进入。

常见问题

Codex 下载应该优先选哪个方式？

Windows 可先用官方 PowerShell 安装脚本，macOS/Linux 可先用官方 shell 脚本；已经统一用 Node.js 或 Homebrew 管理工具的开发者，也可选 npm 或 Homebrew。无论哪种方式，都要核对官方 README、版本号和实际命令路径，不要照搬任何文章记录的固定版本号。

Codex 官网到底是哪个？

产品介绍看 openai.com/codex，安装和配置看 developers.openai.com/codex，安装命令和源码以 github.com/openai/codex 仓库为准。网盘、绿色版、破解版和不明镜像都不是官方入口。

Codex 桌面版和 Codex CLI 是同一个东西吗？

不是同一种交互形态。CLI 主要在终端工作，桌面版提供图形界面，Web 运行在网页或云端，IDE 入口嵌入编辑器。它们可能共享账号或部分能力，但安装、权限、项目访问和排错方式不同。

Windows 必须使用 WSL2 吗？

官方仓库当前已提供 Windows PowerShell 安装脚本和 Windows Release 文件，多数情况可原生安装。某些运行、沙箱、依赖或团队环境仍可能更适合 WSL2，应以当前官方文档、CLI 提示和你的开发环境为准。

ChatGPT 登录和 API Key 登录选哪个？

个人本机交互可优先按官方提示用 ChatGPT 账号登录；CI、服务器或需要独立凭据管理的场景更适合 API Key。两者权限、会话和使用条件不同，能登录 ChatGPT 网页并不代表一定能使用 API。

第三方“绿色版/破解版”Codex 能不能下载？

不建议。Codex 会读取本地代码并可能执行命令，来源不明的安装包可能植入后门、窃取 ChatGPT 凭据或篡改仓库文件。任何要求关闭安全软件、输入 ChatGPT 密码或复制浏览器 Cookie 的下载页都应立即停止，只从 OpenAI 官方文档、仓库或 Release 下载。

config.toml 一定在用户目录吗？

默认用户配置通常位于 ~/.codex/config.toml，Windows 对应用户目录下的 .codex\config.toml。设置 CODEX_HOME 会改变目录，项目还可能有 .codex/config.toml，会话参数也可能覆盖配置，因此排查要同时看多个来源。

官方参考与核验时间

• OpenAI Codex 产品页
• OpenAI Codex 官方文档
• openai/codex 官方 GitHub 仓库
• Codex Latest Release

Codex 的安装脚本、版本、认证、系统支持和配置字段会继续变化，实际操作前应再次查看以上官方页面。继续阅读可直接进入 Codex 官网入口选择指南 与 Codex CLI Windows 安装与首次运行排错。