安装 Codex
如果你在终端中工作，或需要脚本和 CI，请安装 Codex CLI。如果你想在一个窗口中管理项目、并行对话和审查面板，请安装 ChatGPT 桌面应用。如果你主要使用 VS Code、Cursor 或 Windsurf，请安装 IDE 扩展。三者共用登录状态和 config.toml，因此你可以同时使用多个。
本页译自英文指南。命令和文件名保持不变。如两者有出入，以英文页面和官方来源为准。
应该安装哪一个？
| Codex CLI | ChatGPT 桌面应用（Codex） | IDE 扩展 |
|---|
| 运行位置 | 你的终端 | 一个桌面窗口 | 你的编辑器内 |
| 最适合 | 终端工作流、脚本、使用 codex exec 的 CI | 同时处理多个项目、工作树、定时任务、内置浏览器 | 针对已打开文件的集中编辑 |
| 平台 | macOS、Linux、Windows | macOS、Windows、Linux（预览版） | VS Code、Cursor、Windsurf；JetBrains 和 Xcode 通过各自的集成支持 |
| 安装方式 | 一行安装命令、npm 或 Homebrew | chatgpt.com/download 或 Microsoft Store | 编辑器扩展市场 |
| 指南 | 安装 CLI | 安装桌面应用 | 在编辑器中安装 |
拿不准？就从 CLI 开始。它安装体积小，能清楚展示 Codex 正在做什么，而且你配置的一切都能沿用到另外两个上。
安装之前
- 账号。 你需要使用包含 Codex 的套餐对应的 ChatGPT 账号登录，或使用按 API 费率计费的 OpenAI API 密钥。参见 ChatGPT 登录还是 API 密钥。
- Git。 可选，但推荐安装。Codex 用它来审查和撤销更改。OpenAI 建议在每个任务前后都创建一个 Git 检查点。
- 你的操作系统。 用我们的系统检测查看你的电脑支持哪些选项。
安装之后
本栏目内容
- 安装 Codex CLI 分步讲解如何用 OpenAI 独立安装程序、npm 或 Homebrew 安装 Codex CLI，然后登录并首次运行 codex。
- 安装 Codex 桌面应用 Codex 的桌面端体验现已整合进 ChatGPT 桌面应用。介绍如何在 macOS、Windows 或 Linux 上安装，并在项目文件夹中开始 Codex 对话。
- 在编辑器中安装 Codex 如何在 VS Code、Cursor 或 Windsurf 中添加 Codex IDE 扩展，以及如何在 JetBrains IDE 和 Xcode 中启用 Codex，附各官方页面链接。
- 在 Windows 上通过 WSL2 使用 Codex 在 Windows 的 WSL2 中运行 Codex：将桌面应用的智能体切换到 WSL，在 Linux 中安装 CLI，用 CODEX_HOME 共享配置，并避开 WSL1 的坑。
- 更新或卸载 Codex 用安装时的同一方式更新 Codex CLI，在各操作系统上更新桌面应用，并干净地移除 Codex，包括你的 ~/.codex 数据。
常见问题
可以同时安装 CLI 和桌面应用吗？
可以。OpenAI 的文档说明 CLI 和 IDE 扩展共用相同的配置层和登录缓存。在同一台电脑上，MCP 服务器设置在桌面应用、CLI 和 IDE 扩展之间共享。
安装 Codex 需要 Node.js 吗？
只有选择 npm 安装方式时才需要。官方独立安装程序和 Homebrew 都不需要 Node.js。
来源
本页的每条说明都附有官方来源链接。如果本页内容与官方来源不一致，请以官方来源为准，并告诉我们。