发布日期：2026-07-08 | 适用读者：想安装 Codex 桌面版的开发者
Codex Desktop 是 OpenAI 推出的 Codex 桌面应用，提供并行处理多个 Codex 线程的专注体验，内置 worktree、自动化和 Git 功能。它目前支持 macOS（Apple Silicon 与 Intel）和 Windows，Linux 版本尚未推出。安装方式因系统而异：macOS 下载对应架构的 dmg 安装包，Windows 通过 Microsoft Store 或 winget install Codex -s msstore 安装，且在 Windows 上原生运行（基于 PowerShell 与 Windows sandbox），无需 WSL。如果只需要终端里的编码 Agent，也可以用跨平台的 Codex CLI（install.sh / npm / brew）。本文基于 OpenAI Codex 官方文档，分平台给出下载地址、安装步骤、登录认证与配套工具的完整流程。
一、Codex Desktop 是什么
Codex Desktop 是一款面向 Codex 工作流的桌面应用（官方定义："a focused desktop experience for working on Codex threads in parallel"），核心价值是并行处理多个任务线程，并内置了 worktree 支持、自动化和 Git 功能。
它与 Codex CLI 的区别在于：
| 维度 | Codex Desktop（桌面 App） | Codex CLI |
|---|---|---|
| 形态 | 图形界面桌面应用 | 终端命令行 |
| 平台 | macOS、Windows（暂无 Linux） | macOS、Linux、Windows |
| 特色 | 并行线程、内置浏览器、Computer use、Appshots | 轻量、脚本化、易集成 |
| 适合 | 图形化多任务、GUI 测试 | 终端党、自动化脚本 |
二、Codex Desktop 支持哪些系统
Codex Desktop 目前覆盖两大桌面平台，Linux 尚在计划中。安装前先确认自己的系统：
| 系统 | 支持情况 | 安装方式 |
|---|---|---|
| macOS（Apple Silicon） | ✅ 支持 | 下载 Codex.dmg |
| macOS（Intel） | ✅ 支持 | 下载 Codex-latest-x64.dmg |
| Windows | ✅ 支持（原生运行） | Microsoft Store / winget |
| Linux | ❌ 暂未推出 | 可用 Codex CLI 替代 |
Linux 用户目前无法安装桌面 App，但可以使用跨平台的 Codex CLI 获得完整的编码 Agent 能力（见第五节）。
三、macOS 安装步骤
macOS 用户根据芯片架构下载对应的安装包。不确定自己的芯片时，可点击左上角苹果菜单 →「关于本机」查看。
- 下载安装包 （据 OpenAI 官方）：
- Apple Silicon（M 系列芯片）：
persistent.oaistatic.com/codex-app-prod/Codex.dmg - Intel 芯片：
persistent.oaistatic.com/codex-app-prod/Codex-latest-x64.dmg
- Apple Silicon（M 系列芯片）：
- 安装：双击下载的 dmg 文件，将 Codex 拖入「应用程序」文件夹
- 启动并登录：打开应用，选择用 ChatGPT 账户登录，或使用 OpenAI API Key（官方提示：使用 API Key 时部分功能可能不可用）
- 选择项目文件夹 ：首次使用选择一个项目目录，选择 Local 模式让 Codex 在本机运行
四、Windows 安装步骤
Windows 用户通过 Microsoft Store 安装，也可以用命令行一键完成。关键信息：Codex Desktop 在 Windows 上原生运行，基于 PowerShell 和 Windows sandbox，不需要 WSL。
- 安装应用 ，二选一：
- 打开 Microsoft Store 搜索 Codex 安装
- 或在 PowerShell 中运行命令：
powershell
winget install Codex -s msstore- 登录：打开应用，用 ChatGPT 账户或 OpenAI API Key 登录
- （可选）安装配套开发工具，在 PowerShell 中运行：
powershell
winget install --id Git.Git
winget install --id OpenJS.NodeJS.LTS
winget install --id Python.Python.3.14- GitHub 功能 ：如需使用 GitHub 集成，先安装 GitHub CLI，再运行
gh auth login
Windows 配置文件位于用户主目录 %USERPROFILE%\.codex。
五、Windows 要不要装 WSL
不需要。Codex Desktop 在 Windows 上默认以**原生 Windows Agent（运行 PowerShell）**方式工作，WSL2 是可选项而非必需。
- 默认模式：Windows 原生 Agent + PowerShell，开箱即用
- 可选模式：在设置中切换到 WSL2（需重启应用）
- 注意 ：自 Codex
0.115版本起，WSL1 已不受支持，如需用 WSL 请使用 WSL2
六、没有桌面版？用跨平台的 Codex CLI
如果你用 Linux，或更习惯终端操作，Codex CLI 是全平台通用的选择，安装方式任选其一：
bash
# macOS / Linux 官方安装脚本
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# npm 全局安装（全平台）
npm install -g @openai/codex
# Homebrew（macOS）
brew install --cask codexWindows PowerShell 安装 CLI：
powershell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"也可从 GitHub Release 下载对应平台的二进制包（如 macOS Apple Silicon 的 codex-aarch64-apple-darwin.tar.gz、Linux x86_64 的 codex-x86_64-unknown-linux-musl.tar.gz），解压后将文件重命名为 codex 即可。安装完成后运行 codex 并选择 Sign in with ChatGPT 认证；在 CLI 中运行 codex app 也可唤起桌面体验。
七、桌面版有哪些独占功能
选择桌面 App 而非 CLI 的主要理由，是一批图形界面才能提供的能力：
- In-app browser（内置浏览器）：打开渲染页面、留下评论，或让 Codex 操作本地浏览器流程
- Computer use（电脑操作）：让 Codex 使用 macOS 应用完成 GUI 任务、浏览器流程和原生应用测试
- Appshots：把最前方的 Mac 应用窗口连同截图和可读文本一起发给 Codex
- Worktrees / Automations：并行工作树与自动化任务
- Chrome 扩展、Skills、Plugins、Sites 以及与 IDE 扩展的同步
常见问题
Q：Codex Desktop 支持 Linux 吗？
目前不支持。Codex Desktop 仅提供 macOS（Apple Silicon 与 Intel）和 Windows 版本，Linux 版本尚未推出。Linux 用户可以使用跨平台的 Codex CLI，通过 npm install -g @openai/codex 或官方安装脚本获得完整的编码 Agent 功能。
Q：macOS 上 Apple Silicon 和 Intel 的安装包一样吗？
不一样。Apple Silicon（M 系列芯片）下载 Codex.dmg，Intel 芯片下载 Codex-latest-x64.dmg。装错架构可能无法运行，安装前请先在「关于本机」确认芯片类型。
Q：Windows 装 Codex Desktop 一定要先装 WSL 吗？
不需要。Codex Desktop 在 Windows 上原生运行，基于 PowerShell 和 Windows sandbox。WSL2 是设置里的可选项（切换需重启），WSL1 自 0.115 版起不再支持。
Q：Codex Desktop 用 API Key 能登录吗？
可以。打开应用后可选择用 ChatGPT 账户或 OpenAI API Key 登录。官方提示：使用 API Key 时部分功能可能不可用，完整功能建议用 ChatGPT 账户（Plus、Pro、Business、Edu、Enterprise 套餐均含 Codex）。
Q：桌面 App 和 CLI 的配置是分开的吗？
配置共享同一个主目录。在 Windows 上，配置文件位于 %USERPROFILE%\.codex；macOS/Linux 对应 ~/.codex。MCP 服务器、模型等配置写在该目录下的 config.toml，桌面与命令行可共用。
结语
Codex Desktop 的安装可以按系统一句话概括：macOS 下载对应架构的 dmg（Apple Silicon 用 Codex.dmg、Intel 用 x64 版），Windows 走 Microsoft Store 或 winget 且原生运行无需 WSL，Linux 暂无桌面版可改用 CLI。据 OpenAI Codex 官方文档，桌面 App 的差异化价值在于并行线程、内置浏览器与 Computer use 等图形化能力，而 CLI 更适合终端与自动化场景。开发者在国内接入 Codex 及配套的 MCP 生态时，可借助标准化的模型能力编排平台，例如七牛云 MCP 服务提供了国内可直接访问的 Agent 构建能力，无需本地部署即可编排模型工具。
本文内容基于 2026 年 7 月 OpenAI Codex 官方文档，下载地址与版本要求可能随更新变化，建议以官方文档最新说明为准。
延伸资源
- MCP 服务编排与 Agent 构建指南：https://zcn3fx96oxg4.feishu.cn/wiki/XKnIwXE4GiGtfUkeUJfcUhRAnJg