Codex安装教程：桌面App、CLI与IDE扩展三种方式、环境要求与首次运行排查【2026年8月】

最后更新：2026-08-15

本站为独立教程博客，并非 OpenAI 或 Codex 的官方网站，也不提供 AI 模型对话功能；文中涉及的产品下载与账号登录，都请在对应的官方网站或官方产品内完成。

直接回答：Codex 目前有三种主流安装方式——随 ChatGPT 套餐使用的桌面/云端体验、在终端运行的 Codex CLI，以及 VS Code 等编辑器里的 IDE 扩展。如果你要的是“随手在网页/桌面里跑任务”，选桌面 App；要脚本化、自动化和精细控制，装 CLI；想边写代码边让 AI 协作，装 IDE 扩展。三者可以共存，本文把安装路径、环境要求和首次运行排查整理成一张决策地图。

本页与其他安装页面怎么分工

为了避免多个页面反复讲同一件事，本站把安装相关问题拆成四个清晰入口。本页是安装主教程，适合还没有确定使用形态、需要从选择入口一路完成首次验证的读者。

你现在的问题	应该阅读	页面边界
App、CLI、IDE 扩展到底装哪个	本页	比较三种形态，并完成环境检查、安装、登录和首次运行
下载链接是不是官方	Codex 官网下载渠道核验	只解决域名、仓库、发布者和仿冒安装包识别
只想把终端 CLI 跑通	Codex CLI 安装与使用	聚焦命令行、Windows PATH、登录、命令和项目验证
安装后出现具体错误	Codex 故障排查	按登录、权限、沙箱、MCP、错误码和升级问题进入对应页面

这样做的目的不是减少信息，而是让每个 URL 回答一个主要问题。读完本页后，只有遇到具体子问题时再进入对应专题，不需要在几篇相似的“完整教程”之间反复寻找差异。

安装前准备：账号、系统版本、网络与依赖检查

正式安装前，先把这几项确认好，能省掉大量“装完跑不起来”的返工：

账号：Codex 能力包含在 ChatGPT 的 Plus、Pro、Business、Edu、Enterprise 等套餐中（以官方页面为准）。先确认你的账号套餐是否覆盖 Codex，或准备好可用的 API Key。
操作系统版本：桌面 App 提供 Windows 与 macOS 版本；CLI 可在 macOS、Linux 及 Windows 上使用。尽量保持系统为受支持的较新版本。
网络环境：下载安装包、拉取 npm 依赖、登录验证都需要联网。国内环境请保持稳定合规的网络。
依赖：走 npm 安装 CLI 需要本机有较新的 Node.js 与 npm；IDE 扩展需要满足编辑器的最低版本要求。

提示：不要从第三方下载站获取所谓“完整版/绿色版/破解版”，只用官方渠道，避免账号、代码和本地文件泄露。关于渠道核验，可参考 Codex官网下载怎么找？官方下载渠道、桌面App与CLI安装包真假核验。

三种安装方式对比：桌面 App vs CLI vs IDE 扩展，分别适合谁

三种方式解决的是不同场景的问题，先看对比再决定装哪个（或几个都装）：

维度	桌面 App	Codex CLI	IDE 扩展（VS Code 等）
适合人群	想快速上手、以对话式交互为主	需要脚本化、自动化、精细权限控制	边写代码边让 AI 协作的开发者
交互方式	图形界面、任务列表	终端命令行	编辑器侧边栏 / 内嵌面板
安装难度	低（下载安装包）	中（需 Node 或脚本安装）	低到中（应用市场搜索安装）
依赖	系统安装包	Node/npm 或官方二进制	编辑器 + 扩展
登录方式	ChatGPT 账号	ChatGPT 账号或 API Key	ChatGPT 账号
典型用途	日常任务、审阅结果	CI、批处理、自定义流程	代码补全、重构、调试协作

选择建议：新手先从桌面 App 或 IDE 扩展入门，熟悉后再上 CLI 做自动化。想深入了解各入口取舍，可看 Codex官网入口在哪？ChatGPT、GitHub、CLI、App与IDE安装方式怎么选。

桌面 App 安装步骤（Windows / macOS）与登录

桌面 App 是最直观的入口，流程和常规软件安装类似：

从官方渠道（openai.com/codex 与 developers.openai.com/codex）进入下载入口，选择对应系统的安装包。
Windows 下载 .exe/安装程序后双击安装；macOS 下载后拖入“应用程序”文件夹。
首次启动会提示登录，选择 使用 ChatGPT 账号登录，在弹出的浏览器/内置窗口完成授权。
登录成功后返回 App，确认套餐可用，即可创建第一个任务。

Windows 桌面版更细的下载、安装与 Sandbox 说明，可参考 Codex Windows 桌面版与 Sandbox 指南 2026。

CLI 安装步骤：npm 全局安装与官方脚本安装的区别

Codex CLI 是一个运行在终端里的轻量编码智能体（openai/codex 仓库即以此为核心）。常见有两条安装路径：

方式一：npm 全局安装（需要 Node.js）

bash

npm install -g @openai/codex

安装完成后运行：

bash

codex

首次运行会引导你登录。适合已有 Node 环境、习惯用 npm 管理全局工具的开发者。

方式二：官方脚本 / 包管理器安装二进制

若不想依赖 Node，可按官方文档提供的脚本或 Homebrew 等包管理器安装预编译二进制。这种方式不强制 Node，适合精简环境或 CI。

两者区别：npm 方式便于跟随 npm 生态更新，但受 Node 版本影响；二进制方式更独立、启动更干净。命令与参数请以官方文档为准，见 learn.chatgpt.com/docs/codex/cli 与 github.com/openai/codex。

终端命令与 Windows 配置的完整流程，另见 Codex CLI安装与使用：终端命令、Windows配置与国内模型接入全流程与 OpenAI Codex CLI：Windows安装、ChatGPT登录、PATH与首次运行排错。

IDE 扩展安装（VS Code 等）与侧边栏未出现的处理

想在写代码时直接调用 Codex，装 IDE 扩展最顺手：

打开 VS Code（或兼容编辑器），进入扩展市场。
搜索官方的 Codex / OpenAI 扩展，确认发布者为官方后点击安装。
安装后完全重启编辑器，在侧边栏或命令面板中找到 Codex 入口。
首次使用点击登录，用 ChatGPT 账号完成授权。

侧边栏没出现时，按顺序排查：

确认编辑器版本满足扩展最低要求；
检查扩展是否被禁用，或与旧版本扩展冲突；
完全退出并重启编辑器（不是重载窗口）；
查看编辑器“输出/日志”面板中的扩展报错；
仍无效则卸载后重装扩展。

环境要求：Node 版本、PATH 配置与常见依赖

CLI 走 npm 路线时，环境是排查问题的关键：

Node 与 npm：使用较新的稳定版本；版本过旧可能导致安装或运行报错。可用 node -v、npm -v 查看当前版本。这里不写死具体版本号，以官方文档要求为准。
PATH 配置：npm 全局安装的可执行文件在全局 bin 目录，需确保该目录在 PATH 中。用 npm root -g 定位全局路径，对应的 bin 目录要能被终端识别。
权限：macOS/Linux 避免 sudo npm install -g，容易造成权限混乱；更推荐用 nvm 等版本管理器管理 Node，从根本上规避权限问题。
Windows：安装后需重开终端（或注销重登）让 PATH 生效；如用 PowerShell 遇到执行策略限制，按官方说明处理。

跨平台（Windows / macOS / Linux）的系统要求与验证细节，见 Codex跨平台安装环境指南。

首次运行与账号验证：跑通第一个任务的最小流程

装好后，用最小流程验证是否真的可用：

打开终端进入一个测试项目目录（或用桌面 App/IDE 打开项目）。
运行 codex（CLI）或在 App/扩展中新建任务。
按提示完成 ChatGPT 账号登录或填入 API Key。
给一个安全、范围明确的小任务，例如：

text

请阅读当前项目结构，并用一句话总结它的用途。
不要修改任何文件。

确认它能读取项目并给出回应，说明安装与登录链路已跑通。

验证通过后，再逐步放开可修改文件范围，进入真实开发。

安装失败与无法启动排查（权限、路径、版本冲突）

遇到装不上或起不来，对照下面这份避坑清单逐项排查：

codex: command not found：PATH 没包含 npm 全局 bin 目录。用 npm root -g 找到全局路径，把对应 bin 加入 PATH，重开终端。
npm 安装报权限错误（EACCES）：不要用 sudo 硬装。改用 nvm 管理 Node，或修正 npm 全局目录权限。
Node 版本过旧导致安装失败：升级到受支持的较新版本后重试。
版本冲突 / 旧扩展残留：先卸载旧版本再装新版，避免多个版本同时存在。
网络导致下载中断：检查网络稳定性，必要时切换稳定合规的网络重试；不要改用第三方镜像的“破解安装包”。
登录一直失败：确认账号套餐是否覆盖 Codex，清理浏览器授权后重登。
桌面版提示版本过低：更新到官方要求的最低版本，参考 GPT-5.6 Codex怎么更新：CLI 0.144.0、桌面版最低版本和模型排查。

如果同一问题反复出现，先定位根因（权限？PATH？版本？），不要在同一处反复打补丁。

国内网络受限时的安装与登录思路

国内环境下，安装和登录卡点多集中在网络与验证环节：

下载安装包、拉取 npm 依赖、账号授权都需要联网，网络不稳时容易中途失败，建议保持稳定合规的网络环境。
只从官方渠道获取安装文件，核验来源，拒绝第三方“完整版”。
如果主要做代码与脚本任务、又希望减少环境折腾，可在开发工作流里配合第三方平台。上文推荐框中的 ZeoGPT（zeogpt.com）定位于 Codex、代码与长文本开发任务，需要多模型 API 接入或脚本原型时可用 ZeoAPI（zeoapi.com）。两者均为第三方服务、非官方产品，具体能力以登录后页面为准。
国内使用的整体思路（安装、登录、项目开发）可参考 Codex 国内使用指南 2026 与 ChatGPT Codex 使用、CLI 与 API 指南 2026。

安装后进阶：如何选择后续 CLI / IDE / 桌面版工作流

装完不等于用好，后续工作流建议这样搭配：

日常改代码、调试：以 IDE 扩展为主，配合桌面 App 处理较大的任务。
自动化、批处理、CI：用 CLI 编排，把 Codex 接进脚本；API 配置见 OpenAI Codex API配置教程。
多设备协作：桌面 App 与云端体验适合快速查看和审阅结果。
模型能力进阶：想用更高阶模型或多智能体，参考 GPT-5.6 max与ultra怎么用。

不管选哪条路径，都保留人工 review，明确允许修改的文件范围，先小范围验证再放开。

事实边界与安全提醒

本文不写具体版本号、发布日期或安装包文件名，以避免过期误导；命令与依赖要求请以官方文档为准。
Codex 的套餐覆盖、登录方式与功能可能随官方调整而变化，安装前请核对 developers.openai.com/codex、openai.com/codex 与 github.com/openai/codex。
涉及 API Key 时，配置文件里只保存占位符如 <YOUR_API_KEY>，切勿把真实密钥提交到仓库或分享给第三方。
本站为独立教程博客，不代表官方立场，也不提供模型对话服务。

常见问题

Q1：Codex 一共有几种安装方式？
目前官方主要有三种入口：随 ChatGPT 套餐使用的云端/桌面体验、在终端运行的 Codex CLI，以及 VS Code 等编辑器里的 IDE 扩展。三者可以共存，按工作场景选择即可。

Q2：安装 Codex CLI 一定要 Node.js 吗？
通过 npm 全局安装 @openai/codex 需要本机具备较新的 Node.js 与 npm。若使用官方脚本或 Homebrew 等方式安装二进制，则不强制依赖 Node，但仍建议保持系统工具链更新。

Q3：Codex 登录用 ChatGPT 账号还是 API Key？
两种都支持。多数个人开发者直接用 ChatGPT 账号登录，Codex 能力包含在 Plus、Pro、Business、Edu、Enterprise 等套餐中；需要脚本化或按量计费时，可改用 API Key 方式。具体额度与可用范围以官方页面为准。

Q4：装完 CLI 输入 codex 提示找不到命令怎么办？
多数是 PATH 未包含 npm 全局 bin 目录，或安装时权限不足。可先用 npm root -g 查看全局路径，确认 bin 目录已加入 PATH，重开终端后再试；macOS/Linux 避免用 sudo 强装。

Q5：IDE 扩展装了但侧边栏没出现怎么办？
先确认编辑器版本满足扩展要求，完全重启编辑器；再检查扩展是否被禁用、是否已登录账号。仍无效时卸载重装扩展，并查看编辑器的输出/日志面板确认报错信息。

Q6：国内网络受限时能顺利安装和登录吗？
下载安装包和 npm 依赖、以及登录验证都可能受网络影响。建议保持稳定合规的网络环境，从官方渠道获取安装文件，避免使用来路不明的“绿色版”“破解版”，以免账号与代码泄露。

Codex安装教程：桌面App、CLI与IDE扩展三种方式、环境要求与首次运行排查【2026年8月】 ​

本页与其他安装页面怎么分工 ​

安装前准备：账号、系统版本、网络与依赖检查 ​

三种安装方式对比：桌面 App vs CLI vs IDE 扩展，分别适合谁 ​

桌面 App 安装步骤（Windows / macOS）与登录 ​

CLI 安装步骤：npm 全局安装与官方脚本安装的区别 ​

IDE 扩展安装（VS Code 等）与侧边栏未出现的处理 ​

环境要求：Node 版本、PATH 配置与常见依赖 ​

首次运行与账号验证：跑通第一个任务的最小流程 ​

安装失败与无法启动排查（权限、路径、版本冲突） ​

国内网络受限时的安装与登录思路 ​

安装后进阶：如何选择后续 CLI / IDE / 桌面版工作流 ​

事实边界与安全提醒 ​

常见问题 ​