Windows 下 ChatGPT 桌面应用中的 Codex / CLI / Computer Use 与 Claude Code CLI 指南

一句话结论

Computer Use 是 ChatGPT Windows 桌面应用中 Work / Codex 的图形界面能力；命令行任务仍用 Codex CLI，Linux 项目仍建议放 WSL2。

适用场景

• 在 Windows 电脑上同时使用 ChatGPT 桌面应用中的 Codex、Codex CLI 和 Claude Code CLI
• 想让 Codex 帮你看 Windows 桌面应用、浏览器页面、设置窗口或只在 GUI 里复现的 Bug
• Codex / Claude Code 能启动，但搜索慢、改文件慢、命令偶尔找不到
• 不知道项目应该放 C 盘、Git Bash、PowerShell 还是 WSL2
• 想让两套工具在同一个仓库里稳定接力，而不是互相抢文件

常见现象

• 终端提示 codex 或 claude 不是内部或外部命令
• WSL 里 npm / node 指向 Windows 路径，安装工具后仍然不能用
• Claude Code 搜索项目很慢、CPU 或内存突然飙高
• PowerShell 安装脚本被执行策略拦住
• Git Bash 找不到，或者 Claude Code 报 spawn cmd ENOENT / powershell.exe ENOENT
• ChatGPT 桌面应用里找不到 Computer Use，或者装了插件也不知道该怎么开始
• Codex 能改代码，但不能点 Windows 应用、浏览器按钮或设置弹窗
• Codex Windows 沙箱或提权提示看不懂，不知道该不该点同意

原因解释

• Windows 原生环境和 WSL2 是两套系统：路径、Node、npm、Git、权限和文件监听机制都不一样。
• ChatGPT Windows 桌面应用中的 Codex 适合直接处理 Windows 原生项目；CLI 在 WSL2 里使用时，需要在 WSL2 内单独安装 Linux 版 Node 和 npm。
• Computer Use 是 ChatGPT 桌面应用的图形界面操作能力，不等于 codex CLI，也不是让 WSL2 里的命令行去点 Windows 窗口。
• Claude Code 在 Windows 上依赖稳定的 Shell、Git Bash / PowerShell、PATH 和搜索工具；项目太大时还需要忽略构建产物。
• Windows 上 Computer Use 会占用前台输入。任务运行时要让目标窗口保持可见，不要一边让 Codex 点窗口一边自己操作同一台电脑。
• 把仓库放错文件系统会明显拖慢：WSL2 项目放 /mnt/c，或者 Windows 工具跨到 WSL 文件系统里反复读写，都会变慢。

解决步骤

1. 先选边界：Windows GUI、前端静态站、C 盘项目优先原生 Windows；Linux 服务、uv / bash 脚本、容器项目优先 WSL2。
2. 原生 Windows 先装 Git、Node LTS、GitHub CLI 和必要运行时，确认 node、npm、git、gh 都能在同一个终端里运行。
3. ChatGPT Windows 桌面应用用 Microsoft Store / winget 安装，Codex CLI 用 npm 全局安装；首次使用先设好工作目录和默认终端。
4. 需要 Computer Use 时，先在 ChatGPT Windows 桌面应用的 `Plugins > Computer Use` 安装并启用插件与 server/skill 开关，再到 `Settings > Computer Use` 检查应用权限。
5. 第一次只让它操作记事本、浏览器测试页或非敏感软件，不要让它碰密码、支付、客户资料和生产后台。
6. Claude Code 原生 Windows 用官方 PowerShell 安装脚本或 winget 安装；当前版本没有 Git Bash 时会使用 PowerShell，已有 Git Bash 也可继续使用。
7. WSL2 模式里只在 WSL 内安装 Linux 版 Node、npm、Codex、Claude Code，把仓库放在 ~/code 之类的 Linux 目录，不要长期放 /mnt/c。
8. 性能慢时先装 ripgrep，给 node_modules、dist、.next、build、coverage、.turbo 这类目录加忽略，并定期开新会话或压缩上下文。
9. 给仓库写 AGENTS.md / CLAUDE.md：固定 Windows 命令、构建命令、禁止触碰目录和验收方式，让 Codex 与 Claude Code 共用同一套规则。

可复制命令

# Windows 原生基础工具
winget install Git.Git
winget install OpenJS.NodeJS.LTS
winget install GitHub.cli
winget install Python.Python.3.12

node -v
npm -v
git --version
gh --version

# ChatGPT Windows 桌面应用与 Codex CLI
# Microsoft Store 使用固定产品 ID，避免名称别名匹配失败
winget install --id 9PLM9XGG6VKS -s msstore
winget upgrade --id 9PLM9XGG6VKS -s msstore
npm install -g @openai/codex
codex --version
codex

# ChatGPT Windows 桌面应用启用 Computer Use 的小白流程
1. 打开 ChatGPT Windows 桌面应用，先升级到最新版本。
2. 选择 ChatGPT 并切换到 Work，或选择 Codex。
3. 进入 Plugins > Computer Use，选择 Install plugin；如显示 Enable，先启用。
4. 打开 Computer Use server 和 skill 开关，再选择 Try now。
5. 到 Settings > Computer Use 检查目标应用访问权限。
6. 打开目标应用并保持前台可见，任务只写一个窗口、一个目标、一个停止条件。
7. 看到权限、登录、支付、删除、发送消息等敏感动作，先停下来人工确认。

# 第一次练习 Computer Use 的安全提示词
请使用 Computer Use 操作当前 Windows 桌面上的记事本窗口。

目标：
1. 在记事本里输入一行文字：Codex Computer Use Windows 测试成功。
2. 不要打开其他应用。
3. 不要访问网页、不要读取文件、不要输入任何密码。
4. 完成后停下来告诉我你做了什么。

如果看不到记事本窗口，请先停下来，不要乱点。

# 先只读查看策略；优先使用 winget 或已签名的官方安装器
Get-ExecutionPolicy -List

# 不要把修改 CurrentUser ExecutionPolicy 当作通用安装前置
# 只有在理解影响并审查具体脚本后，才按组织策略采用最小作用域方案

# Claude Code 原生 Windows 安装方式一：winget（二选一，不要和下一种重复安装）
winget install Anthropic.ClaudeCode
claude --version
claude doctor

# Claude Code 原生 Windows 安装方式二：官方 PowerShell 安装器（二选一）
irm https://claude.ai/install.ps1 | iex
claude --version
claude doctor

# Claude Code 搜索慢时，安装 ripgrep 并让 Claude Code 使用系统版
winget install BurntSushi.ripgrep.MSVC
setx USE_BUILTIN_RIPGREP 0

# WSL2 检查与安装。下面这些命令分两段：前两行在 Windows 里跑，后面进入 WSL 后跑。
wsl -l -v
wsl --install -d Ubuntu

# 进入 WSL2 后：项目放 Linux 文件系统，不要长期放 /mnt/c
mkdir -p ~/code
cd ~/code
npm install -g @openai/codex
codex --version

# WSL 里如果误用了 Windows node/npm，先只读确认来源
which node
which npm
type -a node npm
node -p "process.platform"

# 结果应指向 WSL 内的 Linux 路径，并显示 linux。
# 如果指向 /mnt/c 或 Windows 程序，先从 WSL PATH 移除 Windows Node，
# 再在 WSL 内按 Node 官方方式或 nvm 重装；不要用 npm config set os linux 掩盖混用。

# Claude Code 会话里先打开当前模型选择器
/model

# 自动化或临时启动时，使用你从当前 /model 或账号说明中确认的模型 ID
claude --model <当前可用模型 ID>

# 不要把旧文章中的固定模型 ID 写进全局 ANTHROPIC_MODEL。

# %USERPROFILE%\.codex\config.toml
# Codex Windows 沙箱如果需要固定提权模式，再按官方提示配置；不确定时先保持默认。
[windows]
sandbox = "elevated"

# AGENTS.md / CLAUDE.md 最小共享规则

## Windows 环境
- 本仓库运行在：Windows 原生 / WSL2（二选一写清）
- 默认终端：PowerShell / Git Bash / WSL Bash
- 不要混用 Windows node 和 WSL node

## 常用命令
- 安装：npm install
- 构建：npm run build
- 检查：npm run lint

## 禁止触碰
- 不要打印 API Key / Token
- 不要改生产配置
- 不要回滚用户已有改动

## 验收
- 构建通过
- 关键页面可打开
- 改动文件清单写清楚

仍然不行怎么办

• ChatGPT 桌面应用中的 Codex 打不开项目：先确认项目是 Windows 原生路径还是 WSL 路径。Windows 项目用原生模式打开，WSL 项目让应用走 WSL。
• Computer Use 入口看不到：先确认你用的是 ChatGPT 桌面应用而不是 CLI；再更新应用，检查所在地区、账号和组织权限是否支持，最后看官方文档里的当前开放范围。
• Computer Use 装了但不会操作窗口：先把目标软件放在前台，关闭多余窗口，用一句话限定它只操作当前窗口；Windows 上不要同时自己移动鼠标键盘。
• Computer Use 点错窗口或看不到按钮：换成单显示器、100%-125% 缩放、浅色主题、最大化目标窗口，再重试一个更短的任务。
• 遇到 UAC、管理员权限、支付、登录、验证码、客户资料：立刻停下，改成你人工完成敏感步骤，再让 Codex 继续非敏感部分。
• Codex 沙箱或提权提示看不懂：先用默认的只读 / 工作区写入模式，不要一上来给危险全权限；只有隔离测试仓库才考虑放宽。
• Claude Code 没有 Git Bash：2.1.120 起原生 Windows 会使用 PowerShell；只有旧版本或特定兼容问题才需要安装 Git for Windows 并配置 CLAUDE_CODE_GIT_BASH_PATH。
• Claude Code 报 spawn cmd ENOENT / powershell.exe ENOENT：检查 PATH 里是否有 C:\Windows\System32。
• WSL 里装完工具仍然不能用：确认 which node / which npm 指向 Linux 路径，不要指到 /mnt/c 或 Windows 程序。
• 搜索和上下文越来越慢：安装 ripgrep，忽略大目录，跑 /compact 或重开新会话，把大日志和二进制文件移出上下文。

Windows 原生和 WSL2 怎么选

• 选 Windows 原生：仓库就在 C 盘或 D 盘，主要是网页、桌面工具、PowerShell、Git Bash、Node 静态站、Windows GUI。
• 选 WSL2：项目需要 Linux 命令、bash 脚本、uv / Python、容器、Linux 服务，或者线上环境本来就是 Linux。
• 不要两边混跑：Windows 终端里装的 npm 包，WSL2 里不一定能用；WSL2 里装的工具，PowerShell 里也不一定能用。
• WSL2 项目建议放 ~/code/project，不建议长期放 /mnt/c/project；跨文件系统会让文件监听、搜索和安装明显变慢。

Codex Windows 优化清单

1. Windows 11 优先；较新的 Windows 10 可以用，但终端兼容性按实际情况检查。
2. ChatGPT Windows 桌面应用用 Microsoft Store / winget 更新，Codex CLI 用 npm 全局更新到最新。
3. Computer Use 在 ChatGPT 桌面应用中通过插件启用；CLI 负责命令行和代码任务，不负责直接点 Windows 窗口。
4. 先用工作区写入沙箱，不要默认给危险全权限；需要提权时看清提示和项目目录。
5. ChatGPT 登录用户可用 Codex 内置搜索时，再用 codex --search 让它补公开资料。
6. 每个仓库放 AGENTS.md，写清构建、测试、部署、禁区和 Windows / WSL 边界。

Windows 版 Codex Computer Use 怎么用

Computer Use 是 ChatGPT 桌面应用中 Work / Codex 的桌面操作能力：它可以看屏幕、点按钮、输入文字、操作菜单和浏览器页面。小白要记住一句话：能用命令行完成的事，优先让 Codex 用命令行；必须看界面、点按钮、复现 GUI Bug 的事，才交给 Computer Use。

1. 确认你打开的是 ChatGPT Windows 桌面应用，不是 WSL2 里的 codex CLI。
2. 把 ChatGPT 桌面应用升级到最新版本，在 `Plugins > Computer Use` 安装并启用插件与 server/skill 开关，再到 `Settings > Computer Use` 检查应用权限。
3. 打开目标应用，并让它保持在当前桌面前台可见；Windows 上 Computer Use 会使用前台输入。
4. 关闭无关窗口，尤其是密码管理器、支付页面、客户资料、生产后台和聊天窗口。
5. 给它一个很窄的任务：只操作当前窗口、只完成一个动作、遇到权限或登录就停。
6. 完成后让它汇报点了哪些位置、输入了什么、有没有看到错误提示。

什么时候该用，什么时候别用

• 适合用：检查桌面软件设置、点浏览器里的测试页面、复现只有 GUI 才出现的 Bug、读取没有 API 的界面数据、验证安装向导下一步是否正常。
• 不适合用：批量改代码、跑构建、提交 Git、处理 Linux 服务、整理大量文件。这些仍然交给 Codex CLI、PowerShell、Git Bash 或 WSL2。
• 不要让它做：输入银行卡、输入客户账号密码、绕验证码、群发消息、删除生产数据、点击不可逆按钮。
• 最安全的练习方式：先在记事本、计算器、浏览器测试页里练 3 次，再让它碰真实业务软件。

小白可复制提示词

# 模板 1：操作桌面软件设置
请使用 Computer Use 只操作当前前台窗口。
目标：检查这个软件的设置页里是否能找到 <设置项>。
限制：不要打开其他软件，不要输入密码，不要保存任何修改。
如果需要权限、登录或看不到目标按钮，请停下来问我。
完成后告诉我：你看到了什么、下一步我该点哪里。

# 模板 2：复现 GUI 问题
请使用 Computer Use 复现我看到的界面问题。
问题：<描述问题>
限制：只操作当前浏览器标签页，不要提交表单，不要删除数据。
步骤：先观察页面，再按最少步骤复现，最后停下来总结现象。

# 模板 3：做一次 Windows 应用验收
请使用 Computer Use 检查当前应用的基础流程：打开页面、点击主要按钮、确认没有明显报错。
不要修改设置，不要登录新账号，不要访问生产后台。
发现弹窗、权限请求或报错时先截图描述，不要继续乱点。

Computer Use 常见问题

• 看不到 Computer Use：你可能在 CLI 或 Settings 里找安装入口；应先到 ChatGPT 桌面应用的 `Plugins > Computer Use` 安装并启用，再到 Settings 检查权限。
• 它说看不到窗口：把目标窗口最大化，切到前台，避免远程桌面、多显示器和遮挡。
• 它点错位置：先改成 100%-125% 显示缩放，关闭花哨主题，缩短任务，只让它操作一个窗口。
• 它卡在权限弹窗：不要让它自己猜，人工处理权限或取消后再继续。
• 它占用鼠标键盘：这是 Windows 前台输入的正常限制，任务运行时不要同时操作同一台电脑；必要时用虚拟机或副机跑。
• 它想读取敏感内容：关闭敏感窗口，只给它看当前任务必须看的界面。

Claude Code Windows 优化清单

1. 原生 Windows 用官方 PowerShell 安装脚本或 winget；WSL2 项目就在 WSL2 里单独安装。
2. 原生 Windows 当前可直接使用 PowerShell；已有 Git Bash 可继续使用，只有旧版本或特定兼容问题再配置 CLAUDE_CODE_GIT_BASH_PATH。
3. 遇到异常先跑 claude doctor，进入会话后常用 /status、/model、/config、/compact。
4. 搜索慢就安装 ripgrep，并设置 USE_BUILTIN_RIPGREP=0。
5. 模型选择用 /model 最直观；自动化脚本可用 claude --model 或 ANTHROPIC_MODEL。

推荐目录布局

• Windows 原生项目：D:\code\site-v2，然后 PowerShell / Git Bash / ChatGPT 桌面应用中的 Codex / Claude Code 都从这个目录打开。
• WSL2 项目：~/code/site-v2，然后 WSL Bash / Codex CLI / Claude Code CLI 都从这个目录打开。
• 不要让 Codex 在 Windows 路径里改一半，再让 Claude Code 从 WSL 的 /mnt/c 路径继续改；这会增加路径、权限和性能问题。
• 共享文件只保留 AGENTS.md、CLAUDE.md、PLAN.md、TODO.md 这类文本，不要让两个工具同时写同一个日志文件。

高频报错对照

• codex / claude 命令找不到：检查安装是否成功、终端是否重开、npm 全局目录是否进 PATH。
• PowerShell 不让执行脚本：先用 `Get-ExecutionPolicy -List` 确认策略并优先选择 winget 或已签名安装器；不要把修改 CurrentUser 策略当作通用修复。
• WSL 提示 win32 或 Windows version not supported：通常是 WSL 内调用了 Windows node，改用 Linux node/npm。
• Claude Code 搜索慢：安装 ripgrep，设置 USE_BUILTIN_RIPGREP=0，并忽略 node_modules / dist 等目录。
• Codex 改错目录：先在客户端或 CLI 里确认当前工作目录，必要时把路径写进 AGENTS.md。
• Claude Code 上下文越来越乱：跑 /compact，或者新开会话并把上一轮结果整理成交接卡。

参考来源

• OpenAI Computer Use：https://learn.chatgpt.com/docs/computer-use
• OpenAI ChatGPT Windows 桌面应用：https://learn.chatgpt.com/docs/windows/windows-app
• OpenAI Codex CLI 入门：https://help.openai.com/en/articles/11096431-openai-codex-cli-getting-started
• OpenAI Codex GitHub：https://github.com/openai/codex
• OpenAI Codex Best Practices：https://developers.openai.com/codex/learn/best-practices
• Anthropic Claude Code Setup：https://docs.anthropic.com/en/docs/claude-code/setup
• Anthropic Claude Code Troubleshooting：https://docs.anthropic.com/en/docs/claude-code/troubleshooting
• Claude Code Model Configuration：https://support.anthropic.com/en/articles/11940350-claude-code-model-configuration

相关问题

• Codex 登录失败 account/read failed 怎么办

  先用 `codex login status` 确认状态，再用 `codex logout` 安全清理当前凭据并重登；浏览器回调受阻时优先试设备码登录。

• Claude Code 第一次跑起来要做什么

  第一次只跑通「只读分析、批准一处编辑、查看 diff、运行验证、保存 Git 记录」这条最小闭环。

• Claude Code 和 Codex 有什么区别

  不要按旧模型名、跑分或固定价格选工具；拿同一个真实任务比较交互、改动范围、验证结果和成本。

• Claude Code 与 Codex 如何协同完成项目

  不要按产品名称固定分配长短任务；根据当前客户端、项目环境和实测结果选一个主执行者，另一个独立复核，中间用任务卡交接。

还卡着？

仅把删除凭证、客户数据和环境变量值后的必要截图、日志片段、需求说明或当前页面链接发到 zhemuy@gmail.com。

• Agent 定制服务 — 看定制流程
• 1A1API 帮助中心 — 打开帮助中心
• 排错协助 — 联系处理