Windows 版 ChatGPT 桌面应用

Windows 版 ChatGPT 桌面应用

在 Windows 上使用 ChatGPT 桌面应用中的 Codex，了解原生沙箱、PowerShell、WSL2、工作树、定时任务、Git、内置浏览器、文件预览、plugins 和 skills，并保留原 Codex App for Windows、管理员运行、本地环境、配置共享与故障排查搜索语义。

Windows 版 ChatGPT 桌面应用#

Codex 中文站说明： 本页围绕“Windows 版 ChatGPT 桌面应用”重新补充了中文使用场景和验证重点。界面名称可能随 Codex 版本更新，请以当前客户端为准。

在 Windows 版 ChatGPT 桌面应用中使用 Codex，支持原生沙箱、PowerShell 和 WSL2。

Windows 版 ChatGPT 桌面应用 为你提供一个统一界面，用于跨项目工作、并行运行多个聊天并评审结果。Windows 应用支持工作树、定时任务、Git、内置浏览器、文件预览、plugins 和 skills 等核心工作流。它可以直接在 Windows 上原生运行，使用 PowerShell 和 Windows 沙箱；也可配置为在 适用于 Linux 的 Windows 子系统 2（WSL2） 中运行。

Windows 版 ChatGPT 桌面应用，展示项目侧边栏、活动聊天和评审面板

下载 ChatGPT 桌面应用#

下载适用于 Windows 的 ChatGPT 桌面应用。

安装后，按 快速开始 开始使用。

企业安装与更新选项请参见部署 Windows App。

如果你更偏好命令行安装，可以运行：

powershell
winget install --id 9PLM9XGG6VKS -s msstore

原生沙箱#

Windows 版 ChatGPT 桌面应用在 Codex 智能体使用 PowerShell 时支持原生 Windows 沙箱；如果智能体运行在 WSL2 中，则使用 Linux 沙箱。无论哪种模式，都应在发送消息前从 composer 下方选择 Ask for approval（请求审批），以保持沙箱保护。

如果以完全访问模式运行 Codex，Codex 将不再被限制在项目目录内，可能会执行非预期的破坏性操作并导致数据丢失。应尽量保留沙箱边界，只对确有必要的情况通过规则添加定向例外；或者按你的审批与安全配置，设置 审批策略 = never，让 Codex 在不额外提示提权的前提下尝试解决问题。

按你的开发环境进行定制#

默认编辑器#

你可以为 Open（打开） 操作设置一个默认应用，例如 Visual Studio、VS Code 或其他编辑器。这个选择也可以按项目覆盖。如果你已经在某个项目的 Open 菜单中选过其他应用，那么项目级选择会优先生效。

Windows 上 ChatGPT 桌面应用设置里的默认 Open In（打开方式）应用

集成终端#

你也可以选择默认的集成终端。具体可选项取决于你电脑上安装了哪些终端，常见选项包括：

  • PowerShell
  • Command Prompt
  • Git Bash
  • WSL

这个改动只会影响新开的终端会话。如果你当前已经打开了一个集成终端，需要重启应用，或者开始一个新聊天后，新的默认终端才会生效。

Windows 上 ChatGPT 桌面应用设置里的集成终端选择器

适用于 Linux 的 Windows 子系统（WSL）#

默认情况下，ChatGPT 桌面应用使用 Windows 原生 Codex 智能体，也就是说智能体命令会在 PowerShell 中执行。即便如此，应用仍然可以通过 wsl CLI 处理位于 WSL2 文件系统中的项目。

如果你想把 WSL 文件系统中的项目添加进来，点击 Add new project（添加新项目） 或按 Ctrl+O，然后在 File Explorer（文件资源管理器）窗口里输入 \\wsl$\。接着选择你的 Linux 发行版和要打开的目录。

如果你打算继续使用 Windows 原生智能体，推荐把项目存放在 Windows 文件系统中，再通过 WSL 的 /mnt//... 路径访问它。相比直接从 WSL 文件系统里打开项目，这种方式通常更稳定。

如果你希望智能体本身运行在 WSL2 中，请打开 Settings（设置），把智能体从 Windows native（Windows 原生） 切换到 WSL，然后重启应用。这个改动只有在重启后才会生效，项目本身在重启后通常仍会保留。

WSL1 在 Codex 0.114 之前仍可使用。从 Codex 0.115 开始，Linux 沙箱切换到了 bubblewrap，因此 WSL1 不再受支持。

ChatGPT 桌面应用设置中展示 Windows native（Windows 原生）与 WSL 智能体选择器

集成终端与智能体的选择是相互独立的。参见上面的按你的开发环境进行定制章节。你可以让智能体运行在 WSL2 中，同时在终端里继续使用 PowerShell；也可以两者都切到 WSL，具体取决于你的工作流。

常用开发工具#

如果机器上已经装好一些常见开发工具，Codex 的体验会更好：

  • Git：支撑 ChatGPT 桌面应用中的评审面板，也方便你检查或还原改动。
  • Node.js：智能体常会依赖它来更高效地完成任务。
  • Python：智能体常会依赖它来更高效地完成任务。
  • .NET SDK：当你需要构建原生 Windows 应用时很有用。
  • GitHub CLI：支撑 ChatGPT 桌面应用中的 GitHub 相关功能。

你可以把下面这些命令粘贴到集成终端中，或者直接让 Codex 帮你安装：

powershell
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 才会允许运行这些脚本。

常见报错类似：

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

一个常见修复方式是把执行策略设置为 RemoteSigned：

powershell
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
bash
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//... 访问它。

打开对话框里看不到 Cmder#

如果你已经安装了 Cmder，但它没有出现在 Codex 的打开对话框中，可以先把它加入 Windows 开始菜单：右键 Cmder，选择 Add to Start，然后重启 Codex 或重启电脑。

本站实践建议#

验证“Windows 版 ChatGPT 桌面应用”时，请记录操作系统、终端、Codex 版本和项目路径。环境差异往往比配置文本本身更容易造成行为不一致。

Codex API 与国内使用#

在实践“Windows 版 ChatGPT 桌面应用”相关功能时，如需为 Codex 配置 OpenAI-compatible API，可以前往 APIBest 获取 API Key。第三方服务的模型映射、价格、额度和数据处理方式以 APIBest 当前说明为准。