跳转到内容

Windows 版 ChatGPT 桌面应用

身份 非官方简体中文镜像
翻译状态 AI 翻译 / AI 审校
来源版本 官方未提供
同步日期 2026-07-26
官方原文 learn.chatgpt.com

Windows 版 ChatGPT 桌面应用 提供了一个统一界面,用于跨项目工作、运行并行聊天和审查结果。

Windows 应用支持 worktrees、计划任务、Git 功能、内置浏览器、文件预览、插件和技能等核心工作流。它使用 PowerShell 在 Windows 上原生运行,并使用 Windows 沙箱;你也可以将其配置为在 Windows Subsystem for Linux 2 (WSL2) 中运行。

ChatGPT Windows 桌面应用,显示项目侧边栏、活动聊天和审查面板

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

然后按照快速入门开始使用。

有关企业安装和更新选项,请参阅部署 Windows 应用

如果你更喜欢使用命令行安装,请运行:

Terminal window
winget install --id 9PLM9XGG6VKS -s msstore

Windows 上的 ChatGPT 桌面应用支持原生 Windows 沙箱:代理在 PowerShell 中运行时使用 Windows 沙箱;代理在 Windows Subsystem for Linux 2 (WSL2) 中运行时使用 Linux 沙箱。要在任一模式下应用沙箱保护,请在向 Codex 发送消息前,在编辑框下方选择 请求批准

在完全访问模式下运行 Codex,意味着 Codex 不受项目目录限制,并且可能执行无意的破坏性操作,导致数据丢失。请保留沙箱边界,并使用规则设置有针对性的例外;或者将批准策略设置为“从不”,让 Codex 根据你的批准和安全设置,尝试在不请求提升权限的情况下解决问题。

打开 选择默认应用,例如 Visual Studio、VS Code 或其他编辑器。你可以针对每个项目覆盖此选择。如果你已经从某个项目的 打开 菜单中选择了其他应用,则该项目的特定选择优先。

ChatGPT 桌面应用设置,显示 Windows 上的默认“打开方式”应用

你也可以选择默认的集成终端。根据已安装的内容,可选项包括:

  • PowerShell
  • Command Prompt
  • Git Bash
  • WSL

此更改仅适用于新的终端会话。如果你已经打开了集成终端,请重启应用或开始新的聊天,然后才能看到新的默认终端。

ChatGPT 桌面应用设置,显示 Windows 上的集成终端选择

默认情况下,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 native 切换为 WSL,然后重启应用。重启前更改不会生效。重启后,你的项目应保持原位。

Codex 0.114 支持 WSL1。从 Codex 0.115 开始,Linux 沙箱迁移到了 bubblewrap,因此不再支持 WSL1。

ChatGPT 桌面应用设置,显示包含 Windows native 和 WSL 选项的代理选择器

你可以独立于代理配置集成终端。有关终端选项,请参阅针对开发环境进行自定义。你可以让代理在 WSL 中运行,同时在终端中使用 PowerShell;也可以两者都使用 WSL,具体取决于你的工作流。

如果已经安装了一些常用的开发者工具,Codex 的运行效果会更好:

  • Git:为 ChatGPT 桌面应用中的审查面板提供支持,并让你能够检查或还原更改。
  • Node.js:代理用于更高效地执行任务的常用工具。
  • Python:代理用于更高效地执行任务的常用工具。
  • .NET SDK:适用于构建原生 Windows 应用。
  • GitHub CLI:为 ChatGPT 桌面应用中的 GitHub 特定功能提供支持。

使用默认的 Windows 包管理器 winget 安装这些工具:将以下内容粘贴到集成终端中,或让 Codex 安装它们:

Terminal window
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 中使用过 Node.js 或 npm 等工具,Codex 代理或集成终端可能会遇到执行策略错误。

如果 Codex 为你创建了 PowerShell 脚本,也可能发生这种情况。在这种情况下,PowerShell 运行这些脚本前可能需要使用限制性较低的执行策略。

错误可能如下所示:

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

一种常见的解决方法是将执行策略设置为 RemoteSigned

Terminal window
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

有关详细信息和其他选项,请在更改策略前查看 Microsoft 的执行策略指南

如果你的本地环境使用 npm 脚本等跨平台命令,则可以为每个平台保留一个共享的设置脚本或操作集。

如果需要 Windows 特定的行为,请创建 Windows 特定的设置脚本或操作。

操作会在集成终端所使用的环境中运行。请参阅针对开发环境进行自定义

本地设置脚本会在代理环境中运行:如果代理使用 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 主目录:
Terminal window
export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

如果希望每个 shell 都应用该设置,请将其添加到 WSL shell 配置文件中,例如 ~/.bashrc~/.zshrc

如果未在 Windows 原生安装 Git,应用将无法使用某些功能。请在 PowerShell 或 cmd.exe 中运行 winget install Git.Git 进行安装。

\\wsl$ 打开的项目未检测到 Git

Section titled “从 \\wsl$ 打开的项目未检测到 Git”

目前,如果你想使用 Windows 原生代理处理一个也可从 WSL 访问的项目,最可靠的解决方法是将项目存储在 Windows 原生驱动器上,然后通过 /mnt/<drive>/... 在 WSL 中访问。

如果已安装 Cmder,但它没有显示在 Codex 的打开对话框中,请将其添加到 Windows 开始菜单:右键点击 Cmder,选择 添加到“开始”菜单,然后重启 Codex 或重新启动计算机。