Codex / Claude Code · 进阶

Windows 下 Codex App / CLI / Computer Use 和 Claude Code CLI 优化指南

Windows 上同时使用 Codex App、Codex CLI、Computer Use 和 Claude Code CLI 时，先分清 GUI 控制、命令行、WSL2，再配 Git、Node、ripgrep、PATH、项目目录和安全边界。

  • Windows
  • Codex
  • Computer Use
  • Claude Code
  • CLI
  • WSL2
更新于 2026-05-31

一句话结论

Codex Computer Use 是 Windows Codex App 的桌面操作能力；写代码仍靠 App / CLI，Linux 项目仍建议放 WSL2。

适用场景

  • 在 Windows 电脑上同时装 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
  • Codex App 里找不到 Computer Use，或者装了插件也不知道该怎么开始
  • Codex 能改代码，但不能点 Windows 应用、浏览器按钮或设置弹窗
  • Codex Windows 沙箱或提权提示看不懂，不知道该不该点同意

原因解释

  • Windows 原生环境和 WSL2 是两套系统：路径、Node、npm、Git、权限和文件监听机制都不一样。
  • Codex Windows 客户端适合直接处理 Windows 原生项目；CLI 在 WSL2 里使用时，需要在 WSL2 内单独安装 Linux 版 Node 和 npm。
  • Computer Use 是 Codex App 的图形界面操作能力，不等于 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. Codex 客户端用 Microsoft Store / winget 安装，Codex CLI 用 npm 全局安装；首次使用先设好工作目录和默认终端。
  4. 需要 Computer Use 时，打开 Windows 版 Codex App 的设置，进入 Computer Use，安装插件；再打开目标应用，让窗口保持在前台可见。
  5. 第一次只让它操作记事本、浏览器测试页或非敏感软件，不要让它碰密码、支付、客户资料和生产后台。
  6. Claude Code 原生 Windows 用官方 PowerShell 安装脚本或 winget 安装；优先用 Git Bash，检测不到再配置 Git Bash 路径或 PowerShell 插件。
  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
# Codex Windows 客户端与 CLI
winget install Codex -s msstore
winget upgrade Codex -s msstore
npm install -g @openai/codex
codex --version
codex
# Windows Codex App 启用 Computer Use 的小白流程
1. 打开 Windows 版 Codex App，先升级到最新版本。
2. 进入 Settings / Computer Use，点击 Install 安装 Computer Use 插件。
3. 打开你要让 Codex 操作的目标窗口，例如记事本、浏览器测试页、桌面软件设置页。
4. 让目标窗口保持在前台可见，不要最小化，不要遮住关键按钮。
5. 给 Codex 的任务只写一个窗口、一个目标、一个停止条件。
6. 运行时看着它做；看到权限、登录、支付、删除、发送消息等敏感动作，先停下来人工确认。
# 第一次练习 Computer Use 的安全提示词
请使用 Computer Use 操作当前 Windows 桌面上的记事本窗口。

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

如果看不到记事本窗口，请先停下来，不要乱点。
# PowerShell 拦截 npm / 安装脚本时，只给当前用户放开常见脚本权限
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
# Claude Code 原生 Windows 安装与检查
irm https://claude.ai/install.ps1 | iex
winget install Anthropic.ClaudeCode
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
npm config set os linux
# Claude Code 模型选择：临时用命令参数，长期用环境变量或 /model
claude --model claude-sonnet-4-5-20250929
setx ANTHROPIC_MODEL claude-sonnet-4-5-20250929
# %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
- 不要改生产配置
- 不要回滚用户已有改动

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

仍然不行怎么办

  • Codex 客户端打不开项目：先确认项目是 Windows 原生路径还是 WSL 路径。Windows 项目用原生打开，WSL 项目让客户端走 WSL。
  • Computer Use 入口看不到：先确认你用的是 Codex App 而不是 CLI；再更新 App，检查所在地区、账号和组织权限是否支持，最后看官方文档里的当前开放范围。
  • Computer Use 装了但不会操作窗口：先把目标软件放在前台，关闭多余窗口，用一句话限定它只操作当前窗口；Windows 上不要同时自己移动鼠标键盘。
  • Computer Use 点错窗口或看不到按钮：换成单显示器、100%-125% 缩放、浅色主题、最大化目标窗口，再重试一个更短的任务。
  • 遇到 UAC、管理员权限、支付、登录、验证码、客户资料：立刻停下，改成你人工完成敏感步骤，再让 Codex 继续非敏感部分。
  • Codex 沙箱或提权提示看不懂：先用默认的只读 / 工作区写入模式，不要一上来给危险全权限；只有隔离测试仓库才考虑放宽。
  • Claude Code 检测不到 Git Bash：安装 Git for Windows 后，配置 CLAUDE_CODE_GIT_BASH_PATH 指向 Git Bash 可执行文件。
  • 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. Codex 客户端用 Microsoft Store / winget 更新，Codex CLI 用 npm 全局更新到最新。
  3. Computer Use 只在 Codex App 里通过插件启用；CLI 负责命令行和代码任务，不负责直接点 Windows 窗口。
  4. 先用工作区写入沙箱，不要默认给危险全权限；需要提权时看清提示和项目目录。
  5. ChatGPT 登录用户可用 Codex 内置搜索时，再用 codex --search 让它补公开资料。
  6. 每个仓库放 AGENTS.md，写清构建、测试、部署、禁区和 Windows / WSL 边界。

Windows 版 Codex Computer Use 怎么用

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

  1. 确认你打开的是 Windows 版 Codex App，不是 WSL2 里的 codex CLI。
  2. 把 Codex App 升级到最新版本，再进入 Settings / Computer Use，点击 Install 安装插件。
  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 里找功能，Computer Use 要在 Codex App 的设置里安装插件。
  • 它说看不到窗口：把目标窗口最大化，切到前台，避免远程桌面、多显示器和遮挡。
  • 它点错位置：先改成 100%-125% 显示缩放，关闭花哨主题，缩短任务，只让它操作一个窗口。
  • 它卡在权限弹窗：不要让它自己猜，人工处理权限或取消后再继续。
  • 它占用鼠标键盘：这是 Windows 前台输入的正常限制，任务运行时不要同时操作同一台电脑；必要时用虚拟机或副机跑。
  • 它想读取敏感内容：关闭敏感窗口，只给它看当前任务必须看的界面。

Claude Code Windows 优化清单

  1. 原生 Windows 用官方 PowerShell 安装脚本或 winget；WSL2 项目就在 WSL2 里单独安装。
  2. Shell 优先 Git Bash；如果 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 / Codex App / 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 不让执行脚本：对当前用户执行 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned。
  • 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 Codex Computer Use：https://developers.openai.com/codex/app/computer-use
  • OpenAI Codex Windows 指南：https://developers.openai.com/codex/windows
  • 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

相关问题

还卡着？

可以把截图、日志、需求单或当前页面链接发到 zhemuy@gmail.com。