夜雨聆风最近我开始系统体验 OpenAI 的 Codex App。
如果你平时会写代码、看开源项目、折腾 AI 工具，那它很值得试一下。
它不是一个普通聊天窗口。
更准确地说，Codex App 是一个可以打开本地项目、阅读代码、运行命令、修改文件、查看 diff 的 AI 编程工作台。
这篇文章只解决一件事：
把 Codex App 装好，登录成功，并跑通第一个本地项目。
1.找到官方安装入口2.安装并打开CodexApp3.登录ChatGPT/OpenAI账号4.准备一个本地Git项目5.在CodexApp中打开项目6.创建第一个Local thread7.让Codex只读分析项目8.做一个 README 小修改9.在Review面板查看 diff10.处理Windows常见问题
如果你只是想快速体验，不需要一开始就研究 CLI、MCP、Skills、插件这些高级功能。
先把这条最小闭环跑通就够了：
打开项目->只读分析->小范围修改->查看 diff
这条链路通了，Codex App 就算真正装好了。
一、先找到官方入口
Windows 用户建议优先看官方 Windows 页面，里面会说明 Codex App 在 Windows 上的能力，包括 PowerShell、Windows sandbox、Git、Review、插件和 Skills 等。
Windows 推荐从 Microsoft Store 安装。
如果你喜欢命令行，也可以在 PowerShell 里执行：
winget install Codex-s msstore
注意，这个命令仍然是从 Microsoft Store 源安装，不是第三方安装包。
安装完成后，在开始菜单搜索：
Codex
然后打开。
二、登录账号
打开 Codex App 后，按界面提示登录。
新手建议优先使用 ChatGPT / OpenAI 账号登录。
虽然也可以使用 OpenAI API Key，但部分 App 能力可能不完整。
所以第一次体验，别把事情复杂化。
先登录账号，把 App 跑通。
这里提醒一句：
不要把 API Key 粘贴到聊天窗口、教程截图、配置文件或 Git 仓库里。
三、准备一个本地 Git 项目
第一次使用，不建议直接打开公司生产项目。
也不建议打开特别大的 monorepo。
最好找一个简单的 Git 项目。
比如我这里用的是：
D:\workspace\python\wechat-official
这个项目很适合做第一次测试：
- 文件数量少
- 有文章目录
- 是 Git 项目
- 可以安全修改 Markdown 文档
- 不会影响生产服务
为什么推荐 Git 项目？
因为 Codex App 的 Review 面板和 diff 查看体验，强依赖 Git。
如果没有 Git，你会少掉很关键的一环。
四、在 Codex App 中打开项目
回到 Codex App，选择本地项目目录。
这里选择刚才准备好的目录：
D:\workspace\python\wechat-official
第一次打开项目时，如果 App 询问权限，建议只授权当前项目目录。
不要一上来就给全盘访问。
截图占位：Codex App 选择本地项目目录。
图注建议：第一次体验建议选择一个低风险 Git 项目，不要直接打开生产仓库。
五、创建第一个 Local thread
项目打开后，创建一个 Local thread。
这里的 Local 很重要。
它表示 Codex 会在你的本机项目里工作。
第一次不要直接让它改代码。
先发一个只读任务：
阅读这个项目，告诉我它的技术栈、启动命令、测试命令，以及主要目录结构。不要修改文件。
如果 Codex 能读出项目结构，说明它已经能正常访问你的项目了。
这一步先建立安全感。
截图占位：Local thread 中发送只读分析 prompt。
图注建议：第一次任务建议只读分析项目，先确认 Codex 能正确理解目录结构。
六、做第一个安全修改
只读任务跑通后，再做一个非常小的写入任务。
比如：
修正 README.md 中一个明显的错别字。只修改 README.md，改完后展示 diff，不要提交。
这一步你要观察三件事：
第一，Codex 是否只改了指定文件。
第二，Review 面板里是否能看到 diff。
第三，它有没有自动提交。
正常情况下，第一次练习只需要看到 diff 就够了。
不要一开始就让它重构项目。
截图占位：Review 面板中的 README diff。
图注建议：看到 diff 之后再决定是否接受修改，不要直接把大范围改动合进去。
七、Windows 常见问题
1. 防火墙弹窗
Windows 上首次使用 Codex 时，可能会出现 Windows Defender Firewall 提示。
如果你在自己的电脑、可信的家庭或公司网络里使用，可以考虑允许专用网络。
但不建议随便勾选公用网络。
如果弹窗来源看起来可疑，先取消。
2. Git 不可用
如果 Review 面板没有 diff，或者 Git 状态异常，先检查 Git 是否安装：
git --version
没有安装的话，可以用：
winget install --id Git.Git
安装后重新打开 Codex App。
3. Node 或 Python 命令不可用
如果项目需要 Node.js 或 Python，要先安装对应工具链。
常见命令：
winget install --id OpenJS.NodeJS.LTSwinget install --id Python.Python.3.14
安装后建议重启 Codex App，让新的 PATH 生效。
4. PowerShell 执行策略问题
有些 Windows 机器运行 npm 时会遇到：
npm.ps1 cannot be loaded because running scripts is disabled on this system.
这是 PowerShell 执行策略问题，不是 Codex 特有问题。
常见修复方式是：
Set-ExecutionPolicy-ExecutionPolicyRemoteSigned
如果是公司电脑，先看公司安全策略，不要乱改。
八、WSL2 要不要配置？
新手不用急着配置 WSL2。
Windows 用户默认使用 Windows 原生环境 + PowerShell 就可以。
如果你的项目强依赖 Linux 工具链，再考虑切到 WSL2。
刚开始建议把项目放在 Windows 本机目录，比如：
C:\Users\你的用户名\Projects\demo
不要一上来就在复杂路径、同步盘、WSL 文件系统里折腾。
先跑通，再优化。
九、安装成功的判断标准
不要只看 App 能不能打开。
真正的安装成功，应该看这几项：
CodexApp能打开账号能登录能选择本地项目能创建Local thread能只读分析项目能做一个小范围修改Review面板能看到 diff没有默认开启 full access
全部跑通，说明你的 Codex App 已经可以进入日常使用了。
总结
Codex App 的安装并不复杂。
真正容易卡住的地方，通常不是下载，而是：
账号登录本地项目权限Git状态系统工具链PowerShell或防火墙提示
所以最好的入门方式不是一上来写复杂代码，而是先跑通一个最小闭环：
打开项目->只读分析->小改 README ->查看 diff
这条链路通了，Codex App 才算真正装好了。
后面再去研究 CLI、MCP、Skills、插件、自动化，会顺很多。
