Codex Desktop 是 OpenAI 推出的 Codex 桌面應(yīng)用，提供并行處理多個(gè) Codex 線程的專注體驗(yàn)，內(nèi)置 worktree、自動(dòng)化和 Git 功能。它目前支持 macOS（Apple Silicon 與 Intel）和 Windows，Linux 版本尚未推出。安裝方式因系統(tǒng)而異：macOS 下載對(duì)應(yīng)架構(gòu)的 dmg 安裝包，Windows 通過(guò) Microsoft Store 或 winget install Codex -s msstore 安裝，且在 Windows 上原生運(yùn)行（基于 PowerShell 與 Windows sandbox），無(wú)需 WSL。如果只需要終端里的編碼 Agent，也可以用跨平臺(tái)的 Codex CLI（install.sh / npm / brew）。本文基于 OpenAI Codex 官方文檔，分平臺(tái)給出下載地址、安裝步驟、登錄認(rèn)證與配套工具的完整流程。

一、Codex Desktop 是什么

Codex Desktop 是一款面向 Codex 工作流的桌面應(yīng)用（官方定義：“a focused desktop experience for working on Codex threads in parallel”），核心價(jià)值是并行處理多個(gè)任務(wù)線程，并內(nèi)置了 worktree 支持、自動(dòng)化和 Git 功能。

它與 Codex CLI 的區(qū)別在于：

二、Codex Desktop 支持哪些系統(tǒng)

Codex Desktop 目前覆蓋兩大桌面平臺(tái)，Linux 尚在計(jì)劃中。安裝前先確認(rèn)自己的系統(tǒng)：

Linux 用戶目前無(wú)法安裝桌面 App，但可以使用跨平臺(tái)的 Codex CLI 獲得完整的編碼 Agent 能力（見(jiàn)第五節(jié)）。

三、macOS 安裝步驟

macOS 用戶根據(jù)芯片架構(gòu)下載對(duì)應(yīng)的安裝包。不確定自己的芯片時(shí)，可點(diǎn)擊左上角蘋果菜單 →「關(guān)于本機(jī)」查看。

1. 下載安裝包（據(jù) 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 拖入「應(yīng)用程序」文件夾
3. 啟動(dòng)并登錄：打開(kāi)應(yīng)用，選擇用 ChatGPT 賬戶登錄，或使用 OpenAI API Key（官方提示：使用 API Key 時(shí)部分功能可能不可用）
4. 選擇項(xiàng)目文件夾：首次使用選擇一個(gè)項(xiàng)目目錄，選擇 Local 模式讓 Codex 在本機(jī)運(yùn)行

四、Windows 安裝步驟

Windows 用戶通過(guò) Microsoft Store 安裝，也可以用命令行一鍵完成。關(guān)鍵信息：Codex Desktop 在 Windows 上原生運(yùn)行，基于 PowerShell 和 Windows sandbox，不需要 WSL。

1. 安裝應(yīng)用，二選一：
   • 打開(kāi) Microsoft Store 搜索 Codex 安裝
   • 或在 PowerShell 中運(yùn)行命令：

winget install Codex -s msstore

2. 登錄：打開(kāi)應(yīng)用，用 ChatGPT 賬戶或 OpenAI API Key 登錄
3. （可選）安裝配套開(kāi)發(fā)工具，在 PowerShell 中運(yùn)行：

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

4. GitHub 功能：如需使用 GitHub 集成，先安裝 GitHub CLI，再運(yùn)行 gh auth login

Windows 配置文件位于用戶主目錄 %USERPROFILE%\.codex。

五、Windows 要不要裝 WSL

不需要。Codex Desktop 在 Windows 上默認(rèn)以**原生 Windows Agent（運(yùn)行 PowerShell）**方式工作，WSL2 是可選項(xiàng)而非必需。

• 默認(rèn)模式：Windows 原生 Agent + PowerShell，開(kāi)箱即用
• 可選模式：在設(shè)置中切換到 WSL2（需重啟應(yīng)用）
• 注意：自 Codex 0.115 版本起，WSL1 已不受支持，如需用 WSL 請(qǐng)使用 WSL2

六、沒(méi)有桌面版？用跨平臺(tái)的 Codex CLI

如果你用 Linux，或更習(xí)慣終端操作，Codex CLI 是全平臺(tái)通用的選擇，安裝方式任選其一：

# macOS / Linux 官方安裝腳本
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# npm 全局安裝（全平臺(tái)）
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 下載對(duì)應(yīng)平臺(tái)的二進(jìn)制包（如 macOS Apple Silicon 的 codex-aarch64-apple-darwin.tar.gz、Linux x86_64 的 codex-x86_64-unknown-linux-musl.tar.gz），解壓后將文件重命名為 codex 即可。安裝完成后運(yùn)行 codex 并選擇 Sign in with ChatGPT 認(rèn)證；在 CLI 中運(yùn)行 codex app 也可喚起桌面體驗(yàn)。

七、桌面版有哪些獨(dú)占功能

選擇桌面 App 而非 CLI 的主要理由，是一批圖形界面才能提供的能力：

• In-app browser（內(nèi)置瀏覽器）：打開(kāi)渲染頁(yè)面、留下評(píng)論，或讓 Codex 操作本地瀏覽器流程
• Computer use（電腦操作）：讓 Codex 使用 macOS 應(yīng)用完成 GUI 任務(wù)、瀏覽器流程和原生應(yīng)用測(cè)試
• Appshots：把最前方的 Mac 應(yīng)用窗口連同截圖和可讀文本一起發(fā)給 Codex
• Worktrees / Automations：并行工作樹(shù)與自動(dòng)化任務(wù)
• Chrome 擴(kuò)展、Skills、Plugins、Sites 以及與 IDE 擴(kuò)展的同步

常見(jiàn)問(wèn)題

Q：Codex Desktop 支持 Linux 嗎？
目前不支持。Codex Desktop 僅提供 macOS（Apple Silicon 與 Intel）和 Windows 版本，Linux 版本尚未推出。Linux 用戶可以使用跨平臺(tái)的 Codex CLI，通過(guò) npm install -g @openai/codex 或官方安裝腳本獲得完整的編碼 Agent 功能。

Q：macOS 上 Apple Silicon 和 Intel 的安裝包一樣嗎？
不一樣。Apple Silicon（M 系列芯片）下載 Codex.dmg，Intel 芯片下載 Codex-latest-x64.dmg。裝錯(cuò)架構(gòu)可能無(wú)法運(yùn)行，安裝前請(qǐng)先在「關(guān)于本機(jī)」確認(rèn)芯片類型。

Q：Windows 裝 Codex Desktop 一定要先裝 WSL 嗎？
不需要。Codex Desktop 在 Windows 上原生運(yùn)行，基于 PowerShell 和 Windows sandbox。WSL2 是設(shè)置里的可選項(xiàng)（切換需重啟），WSL1 自 0.115 版起不再支持。

Q：Codex Desktop 用 API Key 能登錄嗎？
可以。打開(kāi)應(yīng)用后可選擇用 ChatGPT 賬戶或 OpenAI API Key 登錄。官方提示：使用 API Key 時(shí)部分功能可能不可用，完整功能建議用 ChatGPT 賬戶（Plus、Pro、Business、Edu、Enterprise 套餐均含 Codex）。

Q：桌面 App 和 CLI 的配置是分開(kāi)的嗎？
配置共享同一個(gè)主目錄。在 Windows 上，配置文件位于 %USERPROFILE%\.codex；macOS/Linux 對(duì)應(yīng) ~/.codex。MCP 服務(wù)器、模型等配置寫在該目錄下的 config.toml，桌面與命令行可共用。

結(jié)語(yǔ)

Codex Desktop 的安裝可以按系統(tǒng)一句話概括：macOS 下載對(duì)應(yīng)架構(gòu)的 dmg（Apple Silicon 用 Codex.dmg、Intel 用 x64 版），Windows 走 Microsoft Store 或 winget 且原生運(yùn)行無(wú)需 WSL，Linux 暫無(wú)桌面版可改用 CLI。據(jù) OpenAI Codex 官方文檔，桌面 App 的差異化價(jià)值在于并行線程、內(nèi)置瀏覽器與 Computer use 等圖形化能力，而 CLI 更適合終端與自動(dòng)化場(chǎng)景。開(kāi)發(fā)者在國(guó)內(nèi)接入 Codex 及配套的 MCP 生態(tài)時(shí)，可借助標(biāo)準(zhǔn)化的模型能力編排平臺(tái)，例如七牛云 MCP 服務(wù)提供了國(guó)內(nèi)可直接訪問(wèn)的 Agent 構(gòu)建能力，無(wú)需本地部署即可編排模型工具。

本文內(nèi)容基于 2026 年 7 月 OpenAI Codex 官方文檔，下載地址與版本要求可能隨更新變化，建議以官方文檔最新說(shuō)明為準(zhǔn)。

延伸資源

• MCP 服務(wù)編排與 Agent 構(gòu)建指南：https://zcn3fx96oxg4.feishu.cn/wiki/XKnIwXE4GiGtfUkeUJfcUhRAnJg

到此這篇關(guān)于Codex Desktop 安裝教程：Windows、macOS 全平臺(tái)完整攻略的文章就介紹到這了,更多相關(guān)Codex Desktop 安裝內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論