Windows 版 ChatGPT 桌面應用
在 Windows 版 ChatGPT 桌面應用中使用 Codex,支援原生沙箱、PowerShell 和 WSL2。
Windows 版 ChatGPT 桌面應用 為你提供一個統一介面,用於跨專案工作、並行執行多個聊天並審查結果。Windows 應用支援工作樹、定時任務、Git、內建瀏覽器、檔案預覽、plugins 和 skills 等核心工作流程。它可以直接在 Windows 上原生執行,使用 PowerShell 和 Windows 沙箱;也可設定為在 適用於 Linux 的 Windows 子系統 2(WSL2) 中執行。
下載 ChatGPT 桌面應用
下載適用於 Windows 的 ChatGPT 桌面應用。
安裝後,按 快速開始 開始使用。
企業安裝與更新選項請參見部署 Windows App。
如果你更偏好命令列安裝,可以執行:
winget install --id 9PLM9XGG6VKS -s msstore原生沙箱
Windows 版 ChatGPT 桌面應用在 Codex 智能體使用 PowerShell 時支援原生 Windows 沙箱;如果智能體執行在 WSL2 中,則使用 Linux 沙箱。無論哪種模式,都應在傳送訊息前從 composer 下方選擇 Ask for approval(請求審批),以保持沙箱保護。
按你的開發環境進行定製
預設編輯器
你可以為 Open(開啟) 操作設定一個預設應用,例如 Visual Studio、VS Code 或其他編輯器。這個選擇也可以按專案覆蓋。如果你已經在某個專案的 Open 選單中選過其他應用,那麼專案級選擇會優先生效。
整合終端
你也可以選擇預設的整合終端。具體可選項取決於你電腦上安裝了哪些終端,常見選項包括:
- PowerShell
- Command Prompt
- Git Bash
- WSL
這個改動只會影響新開的終端會話。如果你當前已經打開了一個整合終端,需要重啟應用,或者開始一個新聊天后,新的預設終端才會生效。
適用於 Linux 的 Windows 子系統(WSL)
預設情況下,ChatGPT 桌面應用使用 Windows 原生 Codex 智能體,也就是說智能體命令會在 PowerShell 中執行。即便如此,應用仍然可以通過 wsl CLI 處理位於 WSL2 檔案系統中的專案。
如果你想把 WSL 檔案系統中的專案新增進來,點選 Add new project(新增新專案) 或按 Ctrl+O,然後在 File Explorer(檔案資源管理器)窗口裡輸入 \\wsl$\。接著選擇你的 Linux 發行版和要開啟的目錄。
如果你打算繼續使用 Windows 原生智能體,推薦把專案存放在 Windows 檔案系統中,再通過 WSL 的 /mnt/<drive>/... 路徑存取它。相比直接從 WSL 檔案系統裡開啟專案,這種方式通常更穩定。
如果你希望智能體本身執行在 WSL2 中,請開啟 Settings(設定),把智能體從 Windows native(Windows 原生) 切換到 WSL,然後重啟應用。這個改動只有在重啟後才會生效,專案本身在重啟後通常仍會保留。
WSL1 在 Codex 0.114 之前仍可使用。從 Codex 0.115 開始,Linux 沙箱切換到了 bubblewrap,因此 WSL1 不再受支援。
整合終端與智能體的選擇是相互獨立的。參見上面的按你的開發環境進行定製章節。你可以讓智能體執行在 WSL2 中,同時在終端裡繼續使用 PowerShell;也可以兩者都切到 WSL,具體取決於你的工作流程。
常用開發工具
如果機器上已經裝好一些常見開發工具,Codex 的體驗會更好:
- Git:支撐 ChatGPT 桌面應用中的審查面板,也方便你檢查或還原改動。
- Node.js:智能體常會依賴它來更高效地完成任務。
- Python:智能體常會依賴它來更高效地完成任務。
- .NET SDK:當你需要建置原生 Windows 應用時很有用。
- GitHub CLI:支撐 ChatGPT 桌面應用中的 GitHub 相關功能。
你可以把下面這些命令貼上到整合終端中,或者直接讓 Codex 幫你安裝:
winget install --id Git.Git
winget install --id OpenJS.NodeJS.LTS
winget install --id Python.Python.3.14
winget install --id Microsoft.DotNet.SDK.10
winget install --id GitHub.cli安裝完 GitHub CLI 之後,執行 gh auth login,即可啟用應用中的 GitHub 相關功能。
如果你需要不同版本的 Python 或 .NET,請把上面的 package ID 換成你想安裝的版本。
故障排查與常見問題
以管理員權限執行命令
如果你需要 Codex 以提升後的權限執行命令,請直接用管理員身份啟動 ChatGPT 桌面應用。安裝後,開啟開始選單,找到該應用,選擇 Run as administrator(以管理員身份執行)。Codex 智能體會繼承這個權限級別。
PowerShell 執行策略(execution policy)阻止命令執行
如果你之前從未在 PowerShell 中使用過 Node.js、npm 等工具,Codex 智能體或整合終端可能會遇到執行策略(execution policy)錯誤。
如果 Codex 為你生成了 PowerShell 指令碼,也可能出現同樣問題。在這種情況下,你可能需要把執行策略(execution policy)調整得稍微寬鬆一點,PowerShell 才會允許執行這些指令碼。
常見報錯類似:
npm.ps1 cannot be loaded because running scripts is disabled on this system.一個常見修復方式是把執行策略設定為 RemoteSigned:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned在更改之前,建議先檢視 Microsoft 的執行策略指南,瞭解其他可選項與風險。
Windows 上的本機環境指令碼
如果你的本機環境使用的是跨平台命令,例如 npm scripts,那麼你通常可以為所有平台共用一份初始化指令碼或動作集合。
如果你需要 Windows 專屬行為,就為 Windows 單獨定義初始化指令碼或動作。
動作會執行在你所選的整合終端環境中,參見上面的按你的開發環境進行定製。
本機初始化指令碼則執行在智能體所在環境中:如果智能體使用 WSL,它就在 WSL 裡執行;否則就在 PowerShell 中執行。
與 WSL 共享設定、認證和會話
Windows 應用使用的 Codex 主目錄與原生 Windows CLI 相同:%USERPROFILE%\.codex。
如果你也在 WSL 裡執行 Codex CLI,那麼 CLI 預設會使用 Linux home 目錄,因此不會自動與 Windows app 共享設定、快取的認證資訊或會話歷史。
若要共享,可以使用以下方式之一:
- 讓 WSL 中的
~/.codex與%USERPROFILE%\.codex保持同步 - 或在 WSL 中設定
CODEX_HOME
export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex如果你希望每個 shell 都生效,把它加入你的 WSL shell 設定檔,例如 ~/.bashrc 或 ~/.zshrc。
Git 功能不可用
如果你沒有在 Windows 原生環境裡安裝 Git,應用的某些功能將無法使用。可以在 PowerShell 或 cmd.exe 中執行 winget install Git.Git 安裝。
從 \\wsl$ 開啟的專案檢測不到 Git
目前,如果你想在一個也能被 WSL 存取到的專案上繼續使用 Windows 原生智能體,最可靠的做法仍然是把專案存放在 Windows 本機磁碟上,然後在 WSL 中通過 /mnt/<drive>/... 存取它。
開啟對話方塊裡看不到 Cmder
如果你已經安裝了 Cmder,但它沒有出現在 Codex 的開啟對話方塊中,可以先把它加入 Windows 開始選單:右鍵 Cmder,選擇 Add to Start,然後重啟 Codex 或重啟電腦。
來源:</zh-TW/docs/windows/windows-app> 更新時間:2026-07-10(UTC)