Windows 上安装 Codex：新手先用 App，再学 CLI

Windows 新手不要一上来复制终端安装命令。先用 Codex App 跑通登录、打开项目、只读摸底和查看 diff；等你理解项目目录、PowerShell 和 Git 后，再安装 CLI。

先选入口

入口	适合谁	第一次成功标志
Codex App	零基础、Windows 桌面用户、需要同时管理多个项目	能登录、添加一个测试项目、让 Codex 只读解释项目
Codex CLI	已经会用 PowerShell、npm 或终端的人	在项目目录运行 `codex`，能登录并发起只读任务
IDE 扩展	已经在 VS Code / Cursor / Windsurf 写项目的人	编辑器侧边栏能打开 Codex，并看到项目上下文

如果你只是想完成第一个任务，先走 App。CLI 是进阶路径，不是新手第一步的硬要求。

Codex 官方 Windows 文档提供 Microsoft Store 入口。也可以在 PowerShell 里用 winget 安装：

winget install Codex -s msstore

安装后按这个顺序做：

请只读这个项目，不要修改文件，不要运行写入命令。

输出：
1. 这个项目做什么
2. 入口文件在哪里
3. 本地怎么运行或预览
4. 哪些文件现在不要动
5. 一个适合新手的最小改动任务

成功标志：

如果你已经会用 PowerShell，可以按官方 quickstart 的 Windows 命令安装 CLI：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

也可以用 npm：

npm install -g @openai/codex

安装后进入测试项目目录：

cd D:\dev\your-test-project
codex

第一次启动后，按提示登录。登录完成后，先发只读任务，不要直接让它修整个项目。

Codex 在 Windows 上可以用 Windows 原生 agent，也可以配置到 WSL2。新手先保持默认 Windows 原生路径，原因很简单：项目文件、PowerShell、App、Review Pane 都更容易对上。

只有在下面情况再考虑 WSL2：

如果使用 Windows 原生 agent，优先保持 sandbox 边界，不要为了省事长期打开 full access。full access 意味着 Codex 不再只被限制在项目目录里，误操作风险会明显上升。

现象	先做什么
`winget` 找不到	打开 Microsoft Store 搜 Codex，或确认 App Installer 是否可用
PowerShell 不允许运行脚本	先看 PowerShell 执行策略报错
`npm` 找不到	先看 npm 或 node 命令找不到
安装命令下载失败	检查网络、代理、公司防火墙，再看安装命令报错
登录后功能不完整	确认你用的是 ChatGPT 账号还是 API Key；API Key 登录可能缺少部分功能