跳转到内容

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

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

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

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

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

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

  • PowerShell
  • Command Prompt
  • Git Bash
  • WSL

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

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

默认情况下,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。

ChatGPT 桌面应用设置,显示包含 Windows 原生和 WSL 选项的 agent 选择器

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

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

  • Git:为 ChatGPT 桌面应用中的审查面板提供支持,并让你能够检查或还原更改。
  • Node.js:agent 常用的工具,可帮助其更高效地执行任务。
  • Python:agent 常用的工具,可帮助其更高效地执行任务。
  • .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 agent 会继承该权限级别。

如果你之前从未在 PowerShell 中使用过 Node.js 或 npm 等工具,Codex agent 或集成终端可能会遇到执行策略错误。

如果 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 专用的设置脚本或 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 主目录:
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 原生 agent 与 WSL 也可访问的项目配合使用,最可靠的解决方法是将项目存储在原生 Windows 驱动器上,并通过 /mnt/<drive>/... 在 WSL 中访问。

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