从零搭建 Windows AI 开发环境：安装 Codex CLI 避坑全指南

OpenAI 的 Codex CLI 已经原生支持 Windows，可以直接在终端里用自然语言写代码。但新机器装起来会遇到执行策略、环境变量等一系列坑。本文基于一次真实的装机过程，整理了完整的安装步骤和故障排查方案。

---

一、痛点场景

刚装好的 Windows 系统，想体验 OpenAI 最新的 AI 编程工具，结果：

• 没有 Node.js，npm 根本用不了
• npm install -g 报权限错误
• PowerShell 弹窗提示"禁止运行脚本"
• codex 命令找不到，环境变量还没配

你有没有遇到过这种「环境装得好好的，跑的时候全报错」的崩溃瞬间？

别慌，这篇文章就是为了解决这些问题而写的，跟着做就行。

---

二、Codex CLI 是什么

Codex CLI 是 OpenAI 推出的命令行 AI 编程助手，可以直接在终端里通过自然语言完成代码编写、调试、重构等任务。

它不是浏览器里的 ChatGPT 聊天窗口，而是一个终端工具，你可以：

• 直接在命令行描述需求，让 AI 帮你写代码
• 让它修改现有项目中的文件
• 批量处理代码任务，效率远超手动逐行编写

为什么值得折腾：

痛点	传统做法	用 Codex CLI
写样板代码	手动写或者搜 Stack Overflow	终端描述「帮我生成 CRUD API」，自动生成
调试报错	阅读 error log 然后改代码	直接把错误信息贴给 AI，让它修
重构代码	手动找引用逐个改	终端说「把所有的 console.log 改成 logger.info」
写单元测试	手动写 mock 和测试用例	终端说「为这个函数写 10 个测试用例」

简单说，你的终端变成了一个有上下文的 AI 编程搭档。

---

三、环境要求

在开始之前，确认你的机器满足这些最低要求：

项目	要求	说明
操作系统	Windows 10 或更高	Windows 11 体验最佳
Node.js	v22+	Codex CLI 需要 Node.js 运行环境
包管理器	WinGet	随 Windows 10/11 自带，简化安装流程

如果你的系统是全新安装的，意味着上面三样都需要从头装起，这正是下面要讲的场景。

---

四、安装步骤

第一步：检查 WinGet

WinGet 是微软官方的 Windows 包管理器，新系统一般自带。打开 PowerShell：

winget --version

如果输出版本号，继续。如果提示找不到命令，说明 App Installer 没装完整，去微软商店搜索 “App Installer” 装一下就行。

第二步：用 WinGet 装 Node.js 和 Git

打开管理员 PowerShell，一次性搞定：

winget install --id Git.Git -e
winget install --id OpenJS.NodeJS.LTS -e

-e 参数表示 silent install，不弹安装界面。装完后关掉 PowerShell，重新打开，验证安装成功：

node -v
npm -v
git --version

如果三个命令都有版本输出，Node.js 环境就绪。

第三步：解决执行策略（90% 的人卡在这一步）

新系统装好 Node.js 后，直接输入 npm 大概率会报这个错：

npm : 无法加载文件 C:\Program Files\nodejs\npm.ps1，因为在此系统上禁止运行脚本。

这不是 Node.js 装坏了，是 PowerShell 的执行策略 拦住了它。

解决方法很简单，在 PowerShell 里执行：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

输入 Y 确认。这就只对当前用户放开了权限，不影响系统其他用户。

如果你不想改长期策略，也可以只对当前窗口临时放行：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

或者干脆不改动任何东西，直接用 .cmd 版本绕过：

npm.cmd -v

第四步：安装 Codex CLI

执行策略搞定了，现在安装 Codex CLI：

npm install -g @openai/codex
codex --version
codex

--version 确认版本没问题后，直接输 codex 启动。第一次运行会提示登录方式：

• 使用 ChatGPT 账号登录
• 或者使用 OpenAI API Key

按提示走就行。

第五步：验证安装

登录成功后，在终端里输入自然语言试试，比如：

帮我创建一个 Express 项目的基本结构

如果 Codex 开始自动帮你写文件，说明安装完全成功了。

---

五、一键安装脚本

如果你嫌上面一步步敲命令太麻烦，可以把整段安装流程合并。以下脚本在 PowerShell 中运行：

# Windows Codex CLI 一键安装脚本
# 以管理员身份运行 PowerShell

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
Write-Host "=== [1/3] 执行策略已设置 ===" -ForegroundColor Green

Write-Host "=== [2/3] 正在安装 Node.js 和 Git ===" -ForegroundColor Green
winget install --id Git.Git -e
winget install --id OpenJS.NodeJS.LTS -e
Write-Host "安装完成，请关闭并重新打开 PowerShell 后再继续" -ForegroundColor Yellow

# 重新打开 PowerShell 后继续：
Write-Host "=== [3/3] 正在安装 Codex CLI ===" -ForegroundColor Green
npm install -g @openai/codex
codex --version

Write-Host ""
Write-Host "========================================="
Write-Host " 安装完成！"
Write-Host " 输入 codex 即可开始使用"
Write-Host "========================================="

使用方式：

1. 复制上面代码，在管理员 PowerShell 中粘贴并回车
2. 安装完 Node.js 后，关掉 PowerShell 重新打开
3. 继续运行最后两段命令

---

六、故障排查

如果安装过程中遇到了问题，对照下表排查：

症状	原因	解决方案
Set-ExecutionPolicy 报错	权限不足	必须以管理员身份运行 PowerShell
npm install -g 报 EPERM 权限错误	全局安装目录写权限不足	先运行 npm config set prefix "$env:APPDATA\npm"，切到用户目录
codex 命令找不到	PATH 环境变量没包含 npm 全局 bin 目录	npm config get prefix 查看路径，手动加到系统 PATH
安装最新版后启动失败	部分 Windows 环境有兼容性 bug	降级安装：npm install -g @openai/codex@0.119.0
报错缺少 api-ms-win-crt	缺少 Visual C++ Redistributable	安装 VC++ 运行库
公司电脑策略限制	Group Policy 锁定了执行策略	Get-ExecutionPolicy -List 查看策略层级，如果是 MachinePolicy 需要联系 IT

排查小技巧：

# 确认 node/npm/codex 都在 PATH 里
where.exe node
where.exe npm
where.exe codex

# 确认 npm 全局安装路径
npm config get prefix

# 查看当前执行策略
Get-ExecutionPolicy -List

---

七、FAQ

Q: Windows 10 能用吗？
A: 能用，但 Windows 11 支持更稳定。

Q: 一定要装 WSL2 吗？
A: 不需要。OpenAI 官方文档已经确认 Windows 原生支持。WSL2 只是可选方案，适合原本就在用 Linux 工具链的开发者。

Q: 公司电脑装不了怎么办？
A: 大概率是公司组策略限制了 winget install 和 npm install -g。可以尝试：

1. 把 npm 全局目录切到用户目录：npm config set prefix "$env:APPDATA\npm"
2. 不用管理员权限，只对当前用户操作
3. 如果连执行策略都改不了，只能联系 IT 部门

Q: codex 装完版本对但启动报错？
A：常见原因是缺少 Visual C++ 运行库或 UCRT。装好 VC++ Redistributable 基本就能解决。

---

八、进阶建议

新机除了 Codex CLI，建议顺手把开发工具链一起配好：

winget install --id Microsoft.VisualStudioCode -e
winget install --id Microsoft.WindowsTerminal -e

VS Code + Windows Terminal + Codex CLI，一套组合拳，后续的开发体验会顺畅很多。

如果你经常用 AI 辅助开发，还可以装：

• GitLens：VS Code 里的 Git 增强插件
• GitHub Copilot：和 Codex CLI 互补，编辑器内实时补全
• Oh My Posh：让 PowerShell 终端更实用美观

---

九、总结

Windows 从零安装 Codex CLI，核心就是 四步：

# 1. 执行策略
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

# 2. 装 Node.js（和 Git）
winget install --id OpenJS.NodeJS.LTS -e

# 3. 装 Codex CLI
npm install -g @openai/codex

# 4. 启动验证
codex --version
codex

整个过程 5 分钟搞定，卡住的时候回头看看故障排查表和 FAQ。

希望这篇文章能帮你少踩几个坑。如果对你有帮助，欢迎分享给你身边正在折腾 Windows 开发环境的同事和朋友。

---

相关资源：

• Codex CLI - GitHub 仓库
• OpenAI 官方文档
• Node.js 下载
• Visual C++ Redistributable
• Windows Terminal
• PowerShell 执行策略文档