

在 Windows 安装 ChatGPT 桌面版:选择原生环境或 WSL2 并检查权限
你有一个放在 Windows 电脑上的项目,想让 ChatGPT 桌面版帮忙读代码、查看错误,并与你一起验证修改。本文介绍如何安装应用、为 Codex 选择 Windows 原生环境或 WSL2、设置安全权限,以及处理新手常见的故障。你需要一台 Windows 电脑、可使用该应用的账号、一个小型项目文件夹,以及约 30 到 45 分钟。
根据 OpenAI 的 Windows 指南,应用可以让代理直接在 Windows 上使用 PowerShell 和 Windows 沙箱运行,也可以在 Windows Subsystem for Linux 2,即 WSL2 中运行。两种环境的路径、工具和隔离方式不同。事先选好,可避免项目能打开,Git 或测试命令却不能运行。
准备工作
从官方链接下载 Windows 版 ChatGPT 桌面应用。如果熟悉 PowerShell,OpenAI 也给出了通过 Microsoft Store 安装的命令:
winget install --id 9PLM9XGG6VKS -s msstore
用有权限的账号登录。如果公司统一管理应用安装,请先询问管理员。准备一个不含秘密信息、带 Git 且有明确测试命令的项目。Git 帮助应用展示改动。刚接触代码仓库,可参考用 Codex CLI 阅读并验证陌生仓库的指南。
如果你只是想截取另一个应用的窗口,请另看使用 Appshots 撰写并核对工作更新的文章。本文的重点是 Windows 上 Codex 的运行环境。
操作步骤
1. 选择代理真正运行的环境
Windows 原生环境是默认选项。代理在 PowerShell 中运行命令,并使用 Windows 沙箱。如果项目位于 Windows 磁盘,例如 Documents 或 C:\Projects,先选这个模式。仅仅为了试用第一条请求,无需安装 WSL。
WSL2 适合已经把项目和构建工具放在 Linux 中,或每天都使用 Linux 工作流的团队。代理会在 WSL 中运行,并使用 Linux 沙箱。OpenAI 文档指出,从 Codex 0.115 开始不再支持 WSL1,因为 Linux 沙箱改用 bubblewrap。如果只知道电脑“装了 WSL”,先确认版本。
在 WSL 中打开项目,不等于代理也在 WSL 中运行。如果继续使用 Windows 原生代理,OpenAI 建议把项目放在 Windows 磁盘,再从 WSL 经 /mnt/<drive>/... 访问。若要让代理在 WSL2 中运行,打开 Settings,把 Agent environment 从 Windows native 改成 WSL,然后重启应用。
可以先让 ChatGPT 帮你比较,再自行确认项目位置:
我的项目位于[Windows 或 WSL 路径],常用测试命令是[命令]。
请帮我选择 ChatGPT 桌面版 Codex 的 Windows 原生环境或 WSL2。
说明代理会在哪里运行命令、项目适合放在哪里,以及切换后需要检查什么。
不要运行命令或更改设置。如果资料不足,请先提问。
2. 分配工作前设置权限
发送请求前,可在输入框下选择 Ask for approval,让沙箱限制操作,并在需要更多权限时征求批准。OpenAI 的 Windows 指南提醒,full access 模式不会把 Codex 限制在项目文件夹里,可能造成非预期的更改。第一次试用先安排只读任务:
请阅读这个项目,告诉我入口、测试命令和最重要的三个文件。
只读取项目内的文件。不要修改、安装软件包、访问网络,也不要运行需要管理员权限的命令。
如果某一步被拦截,请说明步骤和原因,然后停止。
确认应用读对文件夹后,再安排一项小修改,并要求说明验证方法。团队修改代码时限制 Codex 权限的文章有更多说明。如果用 Run as administrator 启动应用,代理也会继承该权限。不要仅为了避开普通配置错误就使用管理员权限。
3. 选择终端、编辑器和必需工具
在 Settings 中,选择用于 Open 的默认应用,例如 VS Code 或 Visual Studio。根据项目选择集成终端:PowerShell、Command Prompt、Git Bash,或已安装的 WSL。集成终端和代理运行环境是两项独立设置。 终端可以是 PowerShell,代理却在 WSL 中运行。更改默认终端只影响新的终端会话;若没有变化,请新开会话或重启应用。
如果 Git 功能不可用,检查 Windows 上是否安装了 Git。OpenAI 给出的例子是:
winget install --id Git.Git
只有项目需要时才安装 Node.js、Python、.NET SDK 或 GitHub CLI。确认终端能找到 Git,并能运行项目测试。在 WSL 中有效的命令,不会自动在 Windows 原生环境里拥有同样的运行条件。
4. 用安全的窗口试用 Appshots
Appshots 会把最前面的应用窗口发送到聊天中。在 Windows 上,同时按下两个 Alt 键,或使用你设置的快捷键。Appshot 会在主应用里打开。它可包含当前可见画面,以及应用提供的文字,包括滚动区域之外的文字。因此,先关闭客户资料和秘密信息。
打开公开文档,拍摄 Appshot,检查附件,然后问:“请解释画面内容,先不要操作我的电脑。”在 Settings 中可更改快捷键和目标:Current chat、New chat 或 Automatic。Automatic 可能沿用过去 60 秒内活跃的聊天。
如果 Appshots 无法使用,请更新应用、检查快捷键,并确认工作区允许该功能。Google Docs、Gmail、Sheets 或 Slides 等应用可能只提供可见画面的截图,而不是完整文档。不要断定 AI 已读完所有页面。Appshot 只是聊天的补充上下文,不能代替仓库或插件的访问权限。
5. 根据实际运行环境排查问题
PowerShell 拦截命令: 如果出现 npm.ps1 cannot be loaded because running scripts is disabled on this system,原因可能是 PowerShell 的脚本执行策略。OpenAI 将 RemoteSigned 列为常见处理办法,但企业可能统一管理此设置。更改前请咨询管理员或阅读 Microsoft 指南,不要根据未经核实的回答就放宽权限。
WSL 项目能打开,但 Git 功能缺失: 检查代理运行在 Windows 原生环境还是 WSL。对于原生代理,OpenAI 建议把仓库放在 Windows 磁盘,并从 WSL 通过 /mnt/<drive>/... 访问。如果确实需要 Linux 环境,请将代理切换到 WSL2 并重启应用。
更改设置后没有效果: 区分终端设置与代理环境。终端设置只影响新开的终端会话;将代理切换到 WSL 则必须重启应用。要求修改代码前,先检查项目文件夹和一条简单命令。
Appshots 无法截图: 检查应用版本、快捷键和工作区权限。在 Windows 上,Appshots 会在主应用中打开。Appshots 文档提到的 Screen Recording 和 Accessibility 授权步骤是给 macOS 用的,不应直接照搬到 Windows。
示例结果
假设 Minh 的网页项目位于 C:\Projects\shop-demo,测试命令是 npm test。他安装应用,选择 Windows 原生代理,保留 Ask for approval 并打开项目。Codex 阅读项目结构,指出正确测试命令,但暂不修改。若改动查看器提示缺少 Git,他先安装 Git,再要求修正一个界面标签。修改后,他查看差异并运行测试。如果 PowerShell 报 npm.ps1 错误,他记录提示,与管理员核对电脑策略,按公司允许的方式处理后重新测试。
Minh 还对公开指南拍摄 Appshot 来询问错误含义,并确认图片进入正确聊天且不含客户资料。这只是说明性例子;实际步骤和权限取决于电脑和工作区。
改善效果的小技巧
从小项目开始。 读一个文件夹、改一个界面标签、跑一条测试,足以检查环境是否选对。不要一开始就升级整个应用。
报告故障时记录三项信息。 代理运行在 Windows 原生环境还是 WSL2?仓库在哪里?错误出现在代理还是集成终端?这些信息有助于区分路径和权限问题。
明确截图用途。 告诉 ChatGPT 你需要解释还是下一步建议,执行前检查内容。
已知限制
应用按钮和工作区权限可能变化。应以官方的 Windows app、Appshots 和 Settings 页面为准。本文不建议默认更改 Windows 安全策略或启用管理员权限。
Appshot 是你提供给聊天的数据,不能证明 AI 看到了整个应用。Codex 也可能误读代码或测试。对于影响用户的修改,应阅读差异、运行相关测试,并由负责人审核。
常见问题
在 Windows 上使用 ChatGPT 桌面版必须安装 WSL 吗? 不必。应用默认使用基于 PowerShell 的 Windows 原生代理。项目和工具确实需要 Linux 环境时,再选择 WSL2。
把终端改成 WSL,会让代理也在 WSL 里运行吗? 不会。集成终端与代理环境分开设置。要切换代理,请在 Settings 中选择 WSL 并重启应用。
为什么 WSL 中的仓库能打开,Git 功能却不显示? Windows 原生代理通过 \\wsl$ 打开仓库时,可能无法检测 Git。OpenAI 建议保留原生代理时把仓库放在 Windows 磁盘,真正需要 Linux 时再把代理切换到 WSL2。
Appshot 只包含我眼前看到的内容吗? 它拍摄最前面的窗口,也可能包含应用提供的屏幕外文字。有些应用只提供可见截图。发送前检查附件,不要假设它包含完整文档。
PowerShell 阻止 npm.ps1 时,应关闭安全设置吗? 不要自行关闭。记录错误,检查电脑策略,阅读 Microsoft 指南或询问管理员。只有理解影响范围且获得许可后才调整策略。
主要来源:ChatGPT desktop app for Windows、Appshots、Settings,OpenAI Learn。核对日期:2026 年 10 月 5 日。#ChatGPTDesktop #Windows #Codex #WSL2 #Appshots





