Codex Desktop 安装教程：Windows、macOS 全平台完整攻略

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 支持哪些系统

Codex Desktop 目前覆盖两大桌面平台，Linux 尚在计划中。安装前先确认自己的系统：

Linux 用户目前无法安装桌面 App，但可以使用跨平台的 Codex CLI 获得完整的编码 Agent 能力（见第五节）。

三、macOS 安装步骤

macOS 用户根据芯片架构下载对应的安装包。不确定自己的芯片时，可点击左上角苹果菜单 →「关于本机」查看。

1. 下载安装包（据 OpenAI 官方）：
   • Apple Silicon（M 系列芯片）：persistent.oaistatic.com/codex-app-prod/Codex.dmg
   • Intel 芯片：persistent.oaistatic.com/codex-app-prod/Codex-latest-x64.dmg
2. 安装：双击下载的 dmg 文件，将 Codex 拖入「应用程序」文件夹
3. 启动并登录：打开应用，选择用 ChatGPT 账户登录，或使用 OpenAI API Key（官方提示：使用 API Key 时部分功能可能不可用）
4. 选择项目文件夹：首次使用选择一个项目目录，选择 Local 模式让 Codex 在本机运行

四、Windows 安装步骤

Windows 用户通过 Microsoft Store 安装，也可以用命令行一键完成。关键信息：Codex Desktop 在 Windows 上原生运行，基于 PowerShell 和 Windows sandbox，不需要 WSL。

1. 安装应用，二选一：
   • 打开 Microsoft Store 搜索 Codex 安装
   • 或在 PowerShell 中运行命令：

winget install Codex -s msstore

2. 登录：打开应用，用 ChatGPT 账户或 OpenAI API Key 登录
3. （可选）安装配套开发工具，在 PowerShell 中运行：

winget install --id Git.Git
winget install --id OpenJS.NodeJS.LTS
winget install --id Python.Python.3.14

4. 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 是全平台通用的选择，安装方式任选其一：

# macOS / Linux 官方安装脚本
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# npm 全局安装（全平台）
npm install -g @openai/codex
# Homebrew（macOS）
brew install --cask codex

Windows PowerShell 安装 CLI：

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