Windows 版 ChatGPT 桌面应用
Windows 版 ChatGPT 桌面应用 为你提供了一个统一界面,用于跨项目工作、运行并行聊天以及查看结果。
Windows 应用支持 worktrees、计划任务、Git 功能、内置浏览器、文件预览、插件和技能等核心工作流。它通过 PowerShell 在 Windows 上原生运行,并使用 Windows 沙箱;你也可以将其配置为在 Windows Subsystem for Linux 2 (WSL2) 中运行。

下载 ChatGPT 桌面应用
Section titled “下载 ChatGPT 桌面应用”下载适用于 Windows 的 ChatGPT 桌面应用。
然后按照快速入门开始使用。
有关企业安装和更新选项,请参阅部署 Windows 应用。
如果你更喜欢通过命令行安装,请运行:
winget install --id 9PLM9XGG6VKS -s msstore当 agent 在 PowerShell 中运行时,Windows 版 ChatGPT 桌面应用支持原生的 Windows 沙箱;当你在 Windows Subsystem for Linux 2 (WSL2) 中运行 agent 时,则使用 Linux 沙箱。要在任一模式下应用沙箱保护,请在向 Codex 发送消息前,在编辑框下方选择请求批准。
在完全访问模式下运行 Codex,意味着 Codex 不受项目目录限制,并且可能执行无意的破坏性操作,从而导致数据丢失。请保持沙箱边界,并使用规则设置有针对性的例外;或者根据你的批准和安全设置,将批准策略设置为从不,让 Codex 尝试解决问题时无需请求提升权限。
针对开发环境进行自定义
Section titled “针对开发环境进行自定义”为打开选择一个默认应用,例如 Visual Studio、VS Code 或其他编辑器。你可以针对每个项目覆盖此选择。如果你已经在某个项目的打开菜单中选择了其他应用,则该项目专属的选择优先。

你还可以选择默认的集成终端。根据你已安装的内容,可选项包括:
- PowerShell
- Command Prompt
- Git Bash
- WSL
此更改仅适用于新的终端会话。如果你已经打开了集成终端,请重启应用或开始新的聊天,然后新默认终端才会显示。

Windows Subsystem for Linux (WSL)
Section titled “Windows Subsystem for Linux (WSL)”默认情况下,ChatGPT 桌面应用使用 Windows 原生 Codex agent。这意味着 agent 会在 PowerShell 中运行命令。应用仍然可以在需要时使用 wsl CLI 处理位于 Windows Subsystem for Linux 2 (WSL2) 中的项目。
如果你想从 WSL 文件系统添加项目,请点击添加新项目,或按 Ctrl+O,然后在文件资源管理器窗口中输入 \\wsl$\。接着选择你的 Linux 发行版和要打开的文件夹。
如果你计划继续使用 Windows 原生 agent,建议将项目存储在 Windows 文件系统中,并通过 /mnt/<drive>/... 从 WSL 访问。此设置比直接从 WSL 文件系统打开项目更可靠。
如果你希望 agent 本身在 WSL2 中运行,请打开**设置,将 agent 从 Windows 原生切换为 WSL,然后重启应用**。更改要在重启后才会生效。重启后,你的项目应当仍在原位置。
WSL1 通过 Codex 0.114 受支持。从 Codex 0.115 开始,Linux 沙箱迁移到了 bubblewrap,因此不再支持 WSL1。

你可以独立于 agent 配置集成终端。有关终端选项,请参阅针对开发环境进行自定义。你可以让 agent 在 WSL 中运行,同时在终端中使用 PowerShell;也可以两者都使用 WSL,具体取决于你的工作流。
实用开发者工具
Section titled “实用开发者工具”如果已经安装了一些常用的开发者工具,Codex 的运行效果会更好:
- Git:为 ChatGPT 桌面应用中的审查面板提供支持,并让你能够检查或还原更改。
- Node.js:agent 常用的工具,可帮助其更高效地执行任务。
- Python:agent 常用的工具,可帮助其更高效地执行任务。
- .NET SDK:适用于构建原生 Windows 应用。
- GitHub CLI:为 ChatGPT 桌面应用中的 GitHub 专属功能提供支持。
使用默认的 Windows 包管理器 winget 安装这些工具:将以下内容粘贴到集成终端中,或让 Codex 安装它们:
winget install --id Git.Gitwinget install --id OpenJS.NodeJS.LTSwinget install --id Python.Python.3.14winget install --id Microsoft.DotNet.SDK.10winget install --id GitHub.cli安装 GitHub CLI 后,运行 gh auth login 以启用应用中的 GitHub 功能。
如果你需要其他版本的 Python 或 .NET,请将软件包 ID 更改为所需版本。
故障排除与常见问题
Section titled “故障排除与常见问题”使用提升的权限运行命令
Section titled “使用提升的权限运行命令”如果你需要 Codex 使用提升的权限运行命令,请以管理员身份启动 ChatGPT 桌面应用。安装后,打开“开始”菜单,找到该应用,然后选择以管理员身份运行。Codex agent 会继承该权限级别。
PowerShell 执行策略阻止命令
Section titled “PowerShell 执行策略阻止命令”如果你之前从未在 PowerShell 中使用过 Node.js 或 npm 等工具,Codex agent 或集成终端可能会遇到执行策略错误。
如果 Codex 为你创建了 PowerShell 脚本,也可能发生这种情况。在这种情况下,你可能需要使用限制较少的执行策略,PowerShell 才能运行这些脚本。
错误可能类似于以下内容:
npm.ps1 cannot be loaded because running scripts is disabled on this system.一种常见的解决方法是将执行策略设置为 RemoteSigned:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned有关详细信息和其他选项,请在更改策略前查看 Microsoft 的执行策略指南。
Windows 上的本地环境脚本
Section titled “Windows 上的本地环境脚本”如果你的本地环境使用 npm 脚本等跨平台命令,则可以为每个平台保留一个共享的设置脚本或操作集。
如果需要 Windows 特有的行为,请创建 Windows 专用的设置脚本或 Windows 专用的操作。
操作会在集成终端所使用的环境中运行。请参阅针对开发环境进行自定义。
本地设置脚本会在 agent 环境中运行:如果 agent 使用 WSL,则在 WSL 中运行;否则在 PowerShell 中运行。
与 WSL 共享配置、身份验证和会话
Section titled “与 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 功能不可用
Section titled “Git 功能不可用”如果 Windows 原生未安装 Git,应用将无法使用某些功能。请在 PowerShell 或 cmd.exe 中使用 winget install Git.Git 安装。
从 \\wsl$ 打开的项目未检测到 Git
Section titled “从 \\wsl$ 打开的项目未检测到 Git”目前,如果你想将 Windows 原生 agent 与 WSL 也可访问的项目配合使用,最可靠的解决方法是将项目存储在原生 Windows 驱动器上,并通过 /mnt/<drive>/... 在 WSL 中访问。
打开对话框中未列出 Cmder
Section titled “打开对话框中未列出 Cmder”如果已安装 Cmder,但未显示在 Codex 的打开对话框中,请将其添加到 Windows“开始”菜单:右键点击 Cmder,选择添加到“开始”菜单,然后重启 Codex 或重新启动计算机。