ChatGPT 中文教程
中文
联系我 goolvyouyou@gmail.com

Windows 版 Codex App

Windows 版 ChatGPT 桌面应用

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

Windows 版 ChatGPT 桌面应用，其中显示了项目侧边栏、当前聊天和审查窗格

下载 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 或其他 编辑器。你可以针对每个项目覆盖此选择。如果你已经从某个项目的 打开菜单中选择了其他应用，则该项目专属的 选择优先。

ChatGPT 桌面应用设置，其中显示了 Windows 上用于“打开方式”的默认应用

集成终端

你也可以选择默认集成终端。具体可用选项取决于已安装的 软件，包括：

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

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

ChatGPT 桌面应用设置，其中显示了 Windows 上的集成终端选择

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。

ChatGPT 桌面应用设置，其中显示了包含 Windows 原生和 WSL 选项的代理选择器
集成终端与代理需要分别配置。有关 终端选项，请参阅[针对开发环境进行自定义](#customize-for-your-dev-setup)。你可以让代理继续在 WSL 中运行，同时在 终端中使用 PowerShell；也可以根据工作流需要，让两者都使用 WSL。

实用的开发者工具

预先安装一些常用开发者工具后，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 或重新启动计算机。