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

OpenAI 推出的 Codex Desktop 桌面应用，主打的就是一个并行处理多个 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 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 用户需要根据芯片架构下载对应的安装包。不确定芯片类型？点左上角苹果菜单 →「关于本机」就能看到。

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 安装，也可以用命令行一键搞定。关键点：

。

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 并选择

认证；在 CLI 中运行 codex app 也能唤起桌面体验。

七、桌面版有哪些独占功能

选择桌面 App 而不是 CLI 的主要原因，是一批图形界面才能提供的能力：

• In-app browser（内置浏览器）
  ：打开渲染页面、留下评论，或者让 Codex 操作本地浏览器流程

• Computer use（电脑操作）
  ：让 Codex 使用 macOS 应用完成 GUI 任务、浏览器流程和原生应用测试

• Appshots
  ：把最前方的 Mac 应用窗口连同截图和可读文本一起发给 Codex

• Worktrees / Automations
  ：并行工作树与自动化任务

• Chrome 扩展、Skills、Plugins、Sites
  以及与 IDE 扩展的同步

常见问题

目前不支持。Codex Desktop 仅提供 macOS（Apple Silicon 与 Intel）和 Windows 版本，Linux 版本尚未推出。Linux 用户可以使用跨平台的 Codex CLI，通过 npm install -g @openai/codex 或官方安装脚本获得完整的编码 Agent 功能。

不一样。Apple Silicon（M 系列芯片）下载 Codex.dmg，Intel 芯片下载 Codex-latest-x64.dmg。装错架构可能无法运行，安装前记得在「关于本机」确认芯片类型。

不需要。Codex Desktop 在 Windows 上原生运行，基于 PowerShell 和 Windows sandbox。WSL2 是设置里的可选项（切换需重启），WSL1 自 0.115 版起不再支持。

可以。打开应用后可选择用 ChatGPT 账户或 OpenAI API Key 登录。官方提示：使用 API Key 时部分功能可能不可用，完整功能建议用 ChatGPT 账户（Plus、Pro、Business、Edu、Enterprise 套餐均含 Codex）。

配置共享同一个主目录。在 Windows 上，配置文件位于 %USERPROFILE%.codex；macOS/Linux 对应 ~/.codex。MCP 服务器、模型等配置写在该目录下的 config.toml，桌面与命令行可以共用。

结语

Codex Desktop 的安装，按系统一句话就能概括：

。据 OpenAI 官方文档，桌面 App 的差异化价值在于并行线程、内置浏览器与 Computer use 等图形化能力，而 CLI 更适合终端与自动化场景。

本文内容基于 2026 年 7 月 OpenAI Codex 官方文档，下载地址与版本要求可能随更新变化，建议以官方文档最新说明为准。