游乐游手机版
首页/AI教程/文章详情

Codex安装保姆级攻略：Mac/Windows/CLI/IDE全覆盖

时间：2026-08-06 14:16
Codex是一套工具族，包含App、CLI、IDE扩展、Cloud和WSL2五种主流入口。普通用户推荐先安装桌面App，Mac用户根据芯片选择对应版本，Windows用户通过MicrosoftStore安装。开发者可按工作流补充CLI或IDE插件，首次安装先选一个入口即可。

一、全文速览图

特别提醒：本文整理自OpenAI官方文档，Codex更新频繁，动手前建议先打开官方页面确认最新状态。

Codex的入门门槛说高不高，说低也不低。很多朋友在第一步——安装——就被卡住了。是选Mac版还是Windows版？要不要装CLI？IDE插件和桌面App是一回事吗？WSL2又是什么？这些问题背后，其实是对Codex产品形态的认知错位：Codex不是只有一个入口，而是一套工具族。

今天这篇文章，就专门解决这个“到底该装哪个”的问题。先理清入口，再走通安装，最后附上常见问题的排查思路。目标是：让任何操作系统、任何背景的用户，都能在10分钟内跑通第一条Codex任务。

二、Codex 安装全攻略

Codex现在至少有五个主流入口，它们各自对应不同的使用场景：

  1. Codex App：Mac和Windows桌面端，最适合新手。
  2. Codex CLI：终端里的Codex，适合开发者。
  3. IDE Extension：VS Code、Cursor等编辑器里的插件。
  4. Codex Cloud：云端处理GitHub仓库任务，适合远程协作。
  5. WSL2：Windows用户可选装的Linux开发环境。

这篇文章只做一件事：让任何系统的用户都能选对入口，完成安装，并知道遇到问题应该查哪里。

三、一分钟选对入口，普通用户怎么选

简单粗暴的决策指南：

  • Mac用户，想最快开始→ Codex App
  • Windows用户，想最快开始→ Windows Codex App
  • 平时主要在VS Code / Cursor写代码 → IDE Extension
  • 喜欢终端操作 → Codex CLI
  • 只想让AI改GitHub仓库、开PR → Codex Cloud

新手最重要的一条原则：不要第一天就把所有入口一起装一遍。先选一个最顺手的，跑通了再说别的。

具体来说：

  1. Mac用户：先装App。
  2. Windows用户：先装Microsoft Store里的App。
  3. 明确需要终端能力时，再装CLI。
  4. 明确需要Linux工具链时，Windows用户再装WSL2。

四、先理解 Codex 的五个入口

1. Codex App：桌面端

这是最适合新手的入口。桌面App适合日常本地开发，可以选择项目文件夹、并行运行任务、查看改动、使用内置终端和浏览器能力。Mac和Windows都已经有正式入口。

官方下载页：https://developers.openai.com/codex/app

2. Codex CLI：命令行

CLI适合开发者。进入项目目录后运行 codex，它就能围绕当前目录读取文件、修改代码、运行命令。

官方文档：https://developers.openai.com/codex/cli

3. IDE Extension：VS Code / Cursor 插件

IDE插件适合希望在编辑器侧边栏直接和Codex协作的人。官方文档说明，它可以用于VS Code、Cursor和其他VS Code兼容编辑器；也可以在JetBrains IDE中使用。

官方文档：https://developers.openai.com/codex/ide

4. Codex Cloud：云端任务

Codex Cloud适合处理GitHub仓库任务、远程执行、长任务和PR工作流。它不是本地App，也不等于CLI。

5. WSL2：Windows 的可选 Linux 环境

WSL2不是Codex的必装项。它适合本来就在Linux工具链下开发的人。普通Windows用户只想使用Codex App，直接安装Microsoft Store版本即可。

五、Mac 安装 Codex App

Mac用户最容易卡住的问题不是安装步骤，而是：我的Mac应该下载Apple芯片版，还是Intel版？

第一步：判断你的 Mac 芯片

  1. 点击屏幕左上角苹果图标。
  2. 点击“关于本机”。
  3. 找到“芯片”或“处理器”一栏。

按下表对照选择：

第二步：下载正确安装包

打开官方页面：https://developers.openai.com/codex/app，选择对应版本下载。不要从不明网盘、群文件或第三方下载站获取安装包。

第三步：安装到 Applications

  1. 打开下载好的安装包。
  2. 将Codex拖入“应用程序”文件夹。
  3. 打开“访达”，进入“应用程序”，双击Codex。

Mac常见应用路径：/Applications/Codex.app

第四步：完成登录

  1. 打开Codex后，点击使用ChatGPT账号登录。
  2. 浏览器会打开授权页面。
  3. 完成登录后返回Codex App。
  4. 选择一个本地项目目录。
  5. 发送第一条任务。

Mac 常见问题

问题1：下载错了芯片版本

表现：打不开、闪退、系统提示架构不兼容。解决方案：回到“关于本机”确认芯片，删除错误版本，重新下载官方正确版本。

问题2：系统不允许打开

解决路径：系统设置 → 隐私与安全性 → 安全性 → 仍要打开。

问题3：登录后跳不回App

检查项：默认浏览器是否可正常打开ChatGPT；系统时间是否正确；网络袋里是否作用到桌面应用；公司网络是否拦截OpenAI相关域名。

六、Windows 安装 Codex App

Windows是这次最值得重点补充的部分。官方已经明确：Codex App可用于Windows。普通用户不需要先安装Node.js，也不需要先配置WSL2。

官方Windows文档：https://developers.openai.com/codex/windows
官方App下载页：https://developers.openai.com/codex/app

关于系统版本，官方文档的口径是：Windows 11是推荐系统；Windows 10属于尽力支持，体验可能有差异；企业设备如果Microsoft Store被管理员禁用，需要由IT管理员协助。

第一步：打开 Microsoft Store

两种方式：直接打开官方App页面，点击Windows下载入口；或者在Windows开始菜单搜索Microsoft Store，在商店里搜索Codex，确认发布者与官方页面一致。

第二步：安装并启动

在Microsoft Store页面点击安装，等待下载完成，点击打开，或者回到开始菜单搜索Codex启动。

第三步：登录账号

点击使用ChatGPT账号登录，在浏览器里完成授权，返回Codex App，选择本地项目目录，发送第一条任务。

第四步：确认 Windows sandbox

官方Windows文档说明，Windows原生版支持sandbox，用于限制Codex对本机的访问范围。普通用户先使用默认设置即可。开发者如果遇到权限问题，再进入Settings → Agent → Windows sandbox。官方文档给出了两类sandbox模式：Elevated（管理员权限设置，隔离更强）和Unelevated（无法使用管理员权限时的回退模式）。企业电脑如果权限受限，优先找IT管理员确认，不要盲目关闭安全设置。

Windows 常见问题

问题1：Microsoft Store里找不到Codex

检查项：是否从官方App页面跳转；Windows系统地区、Microsoft Store登录状态是否正常；公司设备是否禁用了Microsoft Store；Windows是否完成系统更新。

问题2：Windows 10能不能用

可以尝试，但官方推荐Windows 11。Windows 10属于尽力支持，不应把所有兼容性问题都当成Codex本身故障。

问题3：登录后白屏或跳转失败

检查项：默认浏览器、系统时间、袋里软件、公司网络策略、Microsoft Store应用更新。

问题4：项目在WSL2里，Windows App看不到

官方Windows文档说明，Windows App可以处理WSL工作区。进入App设置，在General下选择优先使用WSL。

七、Mac、Windows、Linux 安装 Codex CLI

桌面App适合普通用户。CLI适合需要终端工作流的开发者。

1. 官方推荐安装命令

前提：本机已经安装Node.js和npm。

Mac、Windows、Linux都可以使用：

npm install -g @openai/codex

安装后验证：

codex --version

Mac也可以使用Homebrew：

brew install --cask codex

2. 更新 Codex CLI

使用npm安装的用户：

npm install -g @openai/codex@latest

或者在Codex CLI中：

codex --upgrade

3. CLI 常见问题

问题1：codex: command not found

先执行这些命令排查：

which codex
npm config get prefix
echo $PATH

常见原因：npm全局安装目录没有加入PATH；安装后终端没有重开；Node.js和npm没有正确安装。

问题2：npm报EACCES或permission denied

不要第一反应就加sudo。更稳妥的选择：使用nvm管理Node.js；修正npm全局目录；Mac用户改用Homebrew安装。

问题3：Windows CLI应该用PowerShell还是WSL2

项目本来在Windows：用PowerShell；项目本来在WSL2：进入WSL2后安装。不要在两套环境里混用路径。

八、安装 IDE Extension

适合VS Code、Cursor和兼容VS Code插件体系的编辑器用户。

官方入口：https://developers.openai.com/codex/ide

安装步骤：打开VS Code或Cursor，点击左侧Extensions，搜索Codex，选择OpenAI官方扩展，点击Install，登录ChatGPT账号，打开本地项目目录，在侧边栏使用Codex。

Windows用户注意：如果项目在Windows文件系统，直接打开即可；如果项目在WSL2，使用VS Code的WSL工作区；不要把Windows和WSL2当成同一套环境。

九、安装完成后的验证清单

桌面 App

  1. 能打开App。
  2. 能登录ChatGPT账号。
  3. 能选择本地项目目录。
  4. 能发送第一条任务。
  5. 能看到回复和文件改动。

CLI

codex --version
mkdir codex-test
cd codex-test
codex

IDE Extension

  1. 能打开Codex侧边栏。
  2. 能登录账号。
  3. 能读取当前文件。
  4. 能解释一段代码。
  5. 能提出一次局部修改。

最常见问题：

最终推荐路线

Mac 普通用户

  1. 判断Apple芯片还是Intel。
  2. 下载对应Codex App。
  3. 安装到Applications。
  4. 登录。
  5. 选择项目。

Windows 普通用户

  1. 使用Windows 11。
  2. 从官方页面进入Microsoft Store。
  3. 安装Codex App。
  4. 登录。
  5. 选择项目。

开发者

在桌面App之外，根据工作流补充：

  1. 终端工作流：Codex CLI。
  2. VS Code / Cursor：IDE Extension。
  3. Windows上的Linux项目：WSL2。
  4. GitHub远程任务：Codex Cloud。

入口选对之后，Codex的学习成本会立刻下降一大截。

官方参考链接
  1. Codex App：https://developers.openai.com/codex/app
  2. Codex on Windows：https://developers.openai.com/codex/windows
  3. Codex CLI：https://developers.openai.com/codex/cli
  4. Codex IDE Extension：https://developers.openai.com/codex/ide
  5. Codex GitHub README：https://github.com/openai/codex
  6. OpenAI Codex 帮助中心：https://help.openai.com/en/articles/11096431-openai-codex
来源：https://www.uisdc.com/codex-6
windows
上一篇花1000积分终于掌握6个控制AI语气语速实战技巧 下一篇Claude聊天窗口的7大交互设计亮点深度拆解
本站内容用于信息整理与展示，如有侵权或内容问题请及时联系处理。

相关推荐

补充同频道和同主题内容，方便继续浏览更多相关内容。

阿里云Windows云服务器搭建IIS网站部署全指南 Codex CLI Windows 安装使用教程：Node.js配置到首次运行 Codex实现Windows部署路径配置方法与步骤 Codex App国内安装教程：Windows桌面版下载与配置指南2026 Hermes One-Click Windows一键运行AI智能体教程 Claude Desktop国内Windows安装教程与下载指南（2026） Windows环境下Ollama自定义安装目录与模型迁移实操指南

同类最新

继续查看同栏目最近更新的文章。

更多
CAD零基础入门教程：坐标输入、图层管理与基础绘图命令
AI教程 · 2026-09-01

CAD零基础入门教程：坐标输入、图层管理与基础绘图命令

本文面向CAD零基础学习者，系统讲解坐标输入、图层管理与基础绘图命令的核心用法。通过分步实操与常见问题排查，帮助新手建立精确绘图习惯，掌握规范出图的基础能力。

 CAD从入门到项目交付：绘图、标注、图块与实战工作流
AI教程 · 2026-09-01

CAD从入门到项目交付：绘图、标注、图块与实战工作流

掌握CAD的核心在于建立“画得准、标得清、复用快、交付稳”的工作流。本文提供从环境设置、高频命令组合、标注规范、图块标准化到项目分阶段交付的完整路径，帮助初学者避免常见返工陷阱，独立完成可检查、可复用、可打印的工程图纸。

 Claude Code 登录指南：个人、Teams 与企业账号区分与授权步骤
AI教程 · 2026-09-01

Claude Code 登录指南：个人、Teams 与企业账号区分与授权步骤

本文详细解析 Claude Code 登录前的账号类型区分方法，涵盖个人订阅、Teams 席位与企业 Enterprise 席位的授权路径差异。提供终端登录命令、环境变量排查及常见异常处理步骤，帮助用户快速完成正确授权并避免登录路径混淆。

 Claude Code 文件修改前的权限模式配置与命令审批指南
AI教程 · 2026-09-01

Claude Code 文件修改前的权限模式配置与命令审批指南

本文详细介绍Claude Code在修改文件前的权限模式配置方法，包括defaultMode可选值、permissions allow与deny规则设置、多层级配置文件管理以及 status验证技巧，帮助开发者安全高效地使用AI编程助手。

 Claude Code接入VS Code后先测扩展和终端命令
AI教程 · 2026-09-01

Claude Code接入VS Code后先测扩展和终端命令

在VS Code中接入Claude Code后，建议优先验证扩展面板与集成终端两条入口。本文提供标准检查顺序、关键命令与常见故障排查路径，帮助你快速确认环境就绪，避免后续开发受阻。