Windows 使用 Codex：桌面应用、IDE 扩展与 CLI 安装指南
Windows 上使用 Codex 不只有一种入口。对大多数用户来说，桌面应用最直观；习惯在 VS Code 中写代码，可以使用 IDE 扩展；需要终端操作或脚本自动化时，再选择 Codex CLI。
旧教程中的“Codex 独立桌面应用”已经进入整合阶段。当前新的 ChatGPT 桌面应用在 Windows 和 macOS 上同时包含 Chat、Work 与 Codex；原 Codex 应用更新后也会迁移到新应用。安装前先确认教程发布日期，避免在已经变化的界面中寻找旧入口。
三种方式怎么选
| 方式 | 更适合谁 | 主要特点 |
|---|---|---|
| ChatGPT 桌面应用中的 Codex | 初次使用、同时管理多个项目的人 | 图形界面完整，可查看任务、文件修改和终端过程 |
| Codex IDE 扩展 | 日常在 VS Code、Cursor 或 Windsurf 中编码的人 | 直接使用已打开的文件和选中代码，便于就地审查修改 |
| Codex CLI | 熟悉 PowerShell、需要终端或自动化的人 | 从项目目录运行，适合命令行工作流和可重复脚本 |
三种入口可以使用同一个 ChatGPT 账号，但本地记录、当前打开的项目和部分界面功能不一定完全相同。不要把“能用同一账号登录”理解成所有本地聊天都会自动同步。
方案一：安装 ChatGPT 桌面应用
这是普通 Windows 用户最省事的选择。
- 从 OpenAI 官方下载页 获取 Windows 版本，不使用网盘重打包安装器。
- 完成安装后打开 ChatGPT，使用自己的 ChatGPT 账号登录。
- 在左上角的产品切换区域选择 Codex。
- 添加本机项目文件夹，先让 Codex说明项目结构，再决定是否授权修改和运行命令。
如果电脑里已经安装旧 Codex 应用，优先通过应用自身更新。官方说明显示，更新后原有 Codex 项目和聊天应当保留；重要项目仍建议先提交 Git 或保留独立备份。
安装器跳转商店但无法下载
Windows 安装过程可能依赖 Microsoft Store 的分发服务。可以依次检查：
- Windows Update 与 Microsoft Store Install Service 是否被禁用；
- 系统时间、时区和 Microsoft Store 登录状态是否正常；
- 在 Microsoft Store 的“库”页面执行更新后重新尝试；
- 公司或学校设备是否由管理员限制应用安装。
不建议为绕过商店而下载来源不明的 MSIX、破解包或所谓绿色版。它们既无法确认更新来源，也可能接触本机代码和登录凭据。
方案二：安装 IDE 扩展
如果主要工作都在编辑器里完成，扩展通常更顺手。
- 打开 VS Code 或兼容编辑器的扩展市场。
- 搜索 Codex，核对扩展发布者和官方文档链接后安装。
- 打开一个真实的项目文件夹，而不是只打开单个代码文件。
- 点击侧边栏中的 Codex 图标并完成登录。
如果侧边栏没有图标，在命令面板中运行 Codex: Open Codex Sidebar。开始任务前先建立 Git 提交点；完成后查看 diff，再决定保留哪些修改。
扩展适合解释当前文件、修改选中代码和快速审查。如果任务涉及多个仓库、长时间运行或频繁查看终端过程，桌面应用通常更容易管理。
方案三：安装 Codex CLI
CLI 适合已经熟悉 PowerShell 和 Node.js 工具链的用户。安装 Node.js 的受支持版本后，在 PowerShell 中运行：
npm install -g @openai/codexcodex --version然后进入项目目录并启动：
cd D:\Projects\your-projectcodex首次运行时按提示选择使用 ChatGPT 登录或其他可用的认证方式。使用 ChatGPT 登录会使用对应套餐或工作空间的 Codex 权益；使用 API Key 则属于单独的 API 计费路径，不能因为已经订阅 ChatGPT 就默认免费。
如果输入 codex 提示找不到命令，关闭并重新打开 PowerShell，然后检查 Node.js 与 npm 的全局命令目录是否已经加入 PATH。不必反复卸载项目或删除个人配置。
登录失败时怎样排查
先记录完整错误信息，再按下面的顺序处理：
- 确认账号可以正常登录 ChatGPT 官网。 网页端也无法登录时，先处理账号或服务状态问题。
- 使用原来的登录方式。 通过 Google、Microsoft、Apple 或邮箱创建的账号，登录时应选择对应方式，避免身份提供方不一致。
- 更新客户端或扩展。 旧版本可能无法正确完成浏览器回调。
- 检查系统时间和默认浏览器。 时间偏差、浏览器阻止回调或企业安全软件拦截，都可能让授权状态失效。
- 核对官方支持地区。 遇到地区限制时，应以 OpenAI 支持范围为准，不采用来路不明的代理、共享账号或接码服务规避规则。
- 查看服务状态。 多台设备同时失败时，先检查 OpenAI Status，避免把服务故障误判为本机问题。
第一次使用前的安全设置
- 从一个已经使用 Git 管理、且不含生产密钥的测试项目开始。
- 先让 Codex只读分析，再逐步开放写入或命令执行权限。
.env、私钥、管理员密码和客户数据不要直接粘贴进聊天。- 对安装依赖、删除文件、发布网站等操作保留人工确认。
- 修改结束后检查 diff，并运行项目原有的测试和构建命令。
工具能打开并不代表环境已经配置完成。一次可靠的首次使用，至少应该包括：成功读取项目、完成一项小修改、检查变更、运行验证，以及确认可以用 Git 回退。
参考资料
本文根据当前官方资料重新组织和独立撰写，不包含充值广告、账号交易、接码服务、推广链接或第三方教程图片。软件入口和界面仍会变化，下载与登录步骤应以 OpenAI 官方页面为准。
