Windows 版 ChatGPT 桌面應用

Windows 版 ChatGPT 桌面應用提供統一介面，供你 跨專案工作、並行執行聊天並審查結果。 Windows 應用支援工作樹、計劃任務、Git 功能、內建瀏覽器、檔案預覽、外掛和技能等核心工作流程。 它使用 PowerShell 和 Windows 沙箱在 Windows 上原生執行，你也可以將其設定為 在 Windows Subsystem for Linux 2 (WSL2) 中執行。

下載 ChatGPT 桌面應用

下載 Windows 版 ChatGPT 桌面應用。

然後按照快速入門開始使用。

有關企業安裝和更新選項，請參閱 部署 Windows 應用。

如果你更喜歡通過命令列安裝，請執行：

winget install --id 9PLM9XGG6VKS -s msstore

原生沙箱

當代理在 PowerShell 中執行時，Windows 版 ChatGPT 桌面應用支援原生 Windows 沙箱；當你在 Windows Subsystem for Linux 2 (WSL2) 中執行代理時，則使用 Linux 沙箱。要在任一模式中應用沙箱保護，請先在編輯器下方選擇請求核准，再向 Codex 傳送訊息。

針對開發環境進行自定義

首選編輯器

為開啟操作選擇預設應用，例如 Visual Studio、VS Code 或其他 編輯器。你可以針對每個專案覆蓋此選擇。如果你已經從某個專案的 開啟選單中選擇了其他應用，則該專案專屬的 選擇優先。

整合終端

你也可以選擇預設整合終端。具體可用選項取決於已安裝的 軟體，包括：

• PowerShell
• 命令提示符
• Git Bash
• WSL

此更改僅適用於新的終端會話。如果已經打開了 整合終端，請重啟應用或開始新的聊天，然後 新的預設終端才會出現。

Windows Subsystem for Linux (WSL)

預設情況下，ChatGPT 桌面應用使用 Windows 原生 Codex 代理。這意味著代理 在 PowerShell 中執行。必要時，應用仍可使用 wsl CLI，處理位於 Windows Subsystem for Linux 2 (WSL2) 中的專案。

如果要新增 WSL 檔案系統中的專案，請點選新增新專案 或按 Ctrl+O，然後在檔案 資源管理器視窗中輸入 \\wsl$\。接著，選擇你的 Linux 發行版以及要 開啟的資料夾。

如果你打算繼續使用 Windows 原生代理，建議將專案儲存在 Windows 檔案系統中，並通過 /mnt/<drive>/... 從 WSL 存取。相比直接從 WSL 檔案系統開啟專案， 這種設定更可靠。

如果希望代理本身在 WSL2 中執行，請開啟**設定， 將代理從 Windows 原生切換到 WSL，並重啟應用**。只有 重啟後更改才會生效。重啟後，你的專案應會保留 在原位置。

Codex 0.114 及更早版本支援 WSL1。從 Codex 0.115 開始，Linux 沙箱遷移到了 bubblewrap，因此不再支援 WSL1。

實用的開發者工具

預先安裝一些常用開發者工具後，Codex 的使用效果最佳：

• Git：為 ChatGPT 桌面應用中的審查窗格提供支援，並可用於檢查或 還原更改。
• Node.js：代理用於更高效地執行任務的常用 工具。
• Python：代理用於更高效地執行任務的常用 工具。
• .NET SDK：建置 Windows 原生應用時很有用。
• GitHub CLI：為 ChatGPT 桌面應用中的 GitHub 專屬功能提供支援。

將以下內容貼上到整合終端中，或讓 Codex 安裝這些工具， 即可通過 Windows 預設包管理器 winget 完成安裝：

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 版本，請將軟體包 ID 更改為所需 版本。

故障排除和常見問題

使用提升的權限執行命令

如果需要 Codex 使用提升的權限執行命令，請以管理員身份啟動 ChatGPT 桌面應用本身。安裝後，開啟“開始”選單， 找到該應用，然後選擇以管理員身份執行。Codex 代理會繼承該 權限級別。

PowerShell 執行策略阻止命令

如果你以前從未在 PowerShell 中使用過 Node.js 或 npm 等工具， Codex 代理或整合終端可能會遇到執行策略錯誤。

如果 Codex 為你建立 PowerShell 指令碼，也可能發生這種情況。此時， 你可能需要採用限制較少的執行策略，PowerShell 才能執行 這些指令碼。

錯誤可能如下所示：

npm.ps1 cannot be loaded because running scripts is disabled on this system.

常見的解決方法是將執行策略設為 RemoteSigned：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

更改策略前，請檢視 Microsoft 的 執行策略指南， 瞭解詳細資訊和其他選項。

Windows 上的本機環境指令碼

如果你的本機環境使用 npm 指令碼等跨平台 命令，可以為所有平台共用一個設定指令碼或 一組操作。

如果需要 Windows 專屬行為，請建立 Windows 專屬設定指令碼或 Windows 專屬操作。

操作會在整合終端使用的環境中執行。請參閱 針對開發環境進行自定義。

本機設定指令碼在代理環境中執行：如果代理使用 WSL，則在 WSL 中執行； 否則在 PowerShell 中執行。

與 WSL 共享設定、身份驗證和會話

Windows 應用與 Windows 上的原生 Codex 使用同一個 Codex 主目錄： %USERPROFILE%\.codex。

如果你還在 WSL 中執行 Codex CLI，CLI 預設使用 Linux 主 目錄，因此不會自動與 Windows 應用共享設定、快取的 身份驗證資訊或會話歷史記錄。

要共享這些內容，請使用以下任一方法：

• 將 WSL ~/.codex 與檔案系統中的 %USERPROFILE%\.codex 同步。
• 通過設定 CODEX_HOME，讓 WSL 指向 Windows Codex 主目錄：

export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

如果希望每個 shell 都使用此設定，請將其新增到 WSL shell 設定檔中，例如 ~/.bashrc 或 ~/.zshrc。

Git 功能不可用

如果沒有在 Windows 上原生安裝 Git，應用將無法使用某些 功能。請在 PowerShell 中使用 winget install Git.Git 或通過 cmd.exe 安裝。

無法為從 \\wsl$ 開啟的專案檢測到 Git

目前，如果要將 Windows 原生代理用於一個也可 從 WSL 存取的專案，最可靠的臨時解決方法是將專案儲存 在 Windows 原生驅動器上，並通過 /mnt/<drive>/... 從 WSL 存取。

開啟對話方塊中未列出 Cmder

如果已安裝 Cmder，但它未出現在 Codex 的開啟對話方塊中，請將其新增到 Windows“開始”選單：右鍵點選 Cmder 並選擇固定到“開始”螢幕，然後 重啟 Codex 或重新啟動計算機。