ChatGPT 适用于 Windows 的桌面应用
如需完整文档索引,请参阅 llms.txt。文档页面的 Markdown 版本可通过在页面后追加
.md来获取 URL。
这个 ChatGPT 适用于 Windows 的桌面应用 为你提供一个统一界面,用于 跨项目工作、运行并行聊天以及审查结果。 Windows 应用支持 worktree、计划任务、Git 功能、内置浏览器、文件预览、插件和技能等核心工作流。 它使用 PowerShell 和 Windows 沙箱在 Windows 上原生运行,或者你也可以将其配置为 在 Windows Subsystem for Linux 2(WSL2)中运行。
交互内容: CodexScreenshot 的动态演示请参阅页面顶部的官方原文链接。
下载 ChatGPT 桌面应用
Section titled “下载 ChatGPT 桌面应用”下载 ChatGPT 桌面应用 Windows 版。
然后按照 快速入门 开始使用。
如需企业安装和更新选项,请参阅 部署 Windows 应用。
如果你更喜欢命令行安装路径,请运行:
winget install --id 9PLM9XGG6VKS -s msstore这个 ChatGPT Windows 上的桌面应用支持原生 Windows 沙箱 ,当 agent 运行在 PowerShell时;当你在 Windows Subsystem for Linux 2(WSL2)中运行 agent 时,则使用 Linux 沙箱。要在任一模式下应用沙箱保护,请选择 请求批准 ,然后再在输入框下方向 Codex发送消息。
以 Codex 完全访问模式运行意味着 Codex 不会仅限于你的项目 目录,并且可能执行非预期的破坏性操作,从而导致 数据丢失。请保留沙箱边界,并使用 规则 来设置有针对性的例外,或者将你的 批准策略设置为 never ,让 Codex 在不请求提升权限的情况下尝试解决问题, 具体取决于你的 批准和安全设置。
为你的开发设置自定义
Section titled “为你的开发设置自定义”为 打开选择默认应用,例如 Visual Studio、 VS Code,或其他 编辑器。你可以按项目覆盖该选择。如果你已经为某个项目选择了 不同的应用,从 打开 菜单中选择,则该项目专属的 选择优先。
交互内容: CodexScreenshot 的动态演示请参阅页面顶部的官方原文链接。
你也可以选择默认集成终端。根据你已 安装的内容,选项包括:
- PowerShell
- 命令提示符
- Git Bash
- WSL
此更改只适用于新的终端会话。如果你已经打开了 集成终端,请重启应用或开始新的聊天,然后 再预期新的默认终端出现。
交互内容: CodexScreenshot 的动态演示请参阅页面顶部的官方原文链接。
Windows Subsystem for Linux(WSL)
Section titled “Windows Subsystem for Linux(WSL)”默认情况下, ChatGPT 桌面应用使用 Windows 原生 Codex agent。这意味着 agent
在 PowerShell中运行命令。该应用仍可处理位于
Windows Subsystem for Linux 2(WSL2)中的项目,方法是在需要时使用 wsl CLI 。
如果你想从 WSL 文件系统添加项目,请点击 添加新项目
或按 Ctrl+O,然后输入 \\wsl$\ 到文件
资源管理器窗口中。从那里选择你的 Linux 发行版和你
想打开的文件夹。
如果你计划继续使用 Windows 原生 agent,建议将项目存储在
你的 Windows 文件系统中,并从 WSL 通过
/mnt/<drive>/...访问它们。这种设置比打开
直接来自 WSL 文件系统的项目更可靠。
如果你希望 agent 本身在 WSL2中运行,请打开 设置, 将 agent 从 Windows 原生切换到 WSL,并 重启应用。该 更改在你重启前不会生效。重启后,你的项目应保持在 原位置。
WSL1 曾通过 Codex 0.114受到支持。从 Codex 0.115开始,Linux
沙箱已迁移到 bubblewrap,因此 WSL1 不再受支持。
交互内容: CodexScreenshot 的动态演示请参阅页面顶部的官方原文链接。
你可以独立于 agent 配置集成终端。请参阅 为你的开发设置自定义 了解 终端选项。你可以将 agent 保持在 WSL 中,同时仍使用 PowerShell 作为 终端,或使用 WSL 作为两者,具体取决于你的工作流。
实用开发者工具
Section titled “实用开发者工具”Codex 在预先安装一些常用开发者工具后运行效果最佳:
- Git:为 ChatGPT 桌面应用中的审查面板提供支持,并让你检查或 还原更改。
- Node.js:agent 用来更 高效执行任务的常用工具。
- Python:agent 用来更 高效执行任务的常用工具。
- .NET SDK:在你想构建原生 Windows 应用时很有用。
- GitHub CLI:为 GitHub专属功能提供支持,在 ChatGPT 桌面应用中。
使用默认的 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 版本,请将包 IDs 改为你想要的 版本。
故障排除和 FAQ
Section titled “故障排除和 FAQ”使用提升的权限运行命令
Section titled “使用提升的权限运行命令”如果你需要 Codex 使用提升的权限运行命令,请以管理员身份启动 ChatGPT 桌面应用本身。安装后,打开开始菜单, 找到该应用,然后选择 以管理员身份运行。 Codex agent 会继承该 权限级别。
PowerShell 执行策略阻止命令
Section titled “PowerShell 执行策略阻止命令”如果你以前从未使用过 Node.js 或 npm 等工具,在 PowerShell 中,
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 环境中运行: WSL 如果 agent 使用 WSL, 否则使用 PowerShell 。
Windows 应用使用与 Windows 上原生 Codex 相同的主目录 Codex :
%USERPROFILE%\.codex。
如果你也在 Codex CLI 中运行 WSL, CLI 默认使用 Linux 主 目录,因此它不会自动与 Windows 应用共享配置、缓存的 身份验证或会话历史。
要共享它们,请使用以下方法之一:
- 同步 WSL
~/.codex与文件系统上的%USERPROFILE%\.codex。 - 将 WSL 指向 Windows Codex 主目录,方法是设置
CODEX_HOME:
export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex如果你希望该设置在每个 shell 中生效,请将它添加到你的 WSL shell 配置文件,例如
比如 ~/.bashrc 或 ~/.zshrc。
Git 功能不可用
Section titled “Git 功能不可用”如果你没有在 Windows 上原生安装 Git,该应用将无法使用某些
功能。请使用 winget install Git.Git 从 PowerShell 或 cmd.exe安装它。
从 `\wsl### 从
Section titled “从 `\wsl### 从”目前,如果你想将 Windows 原生 agent 与同样
可从 WSL访问的项目一起使用,最可靠的变通方法是将项目存储
在原生 Windows 驱动器上,并在 WSL 中通过 /mnt/<drive>/...访问它。
Cmder 未列在打开对话框中
Section titled “Cmder 未列在打开对话框中”如果 Cmder 已安装但未显示在 Codex的打开对话框中,请将其添加到
Windows 开始菜单:右键点击 Cmder 并选择 添加到“开始”,然后
重启 Codex 或重新启动电脑。