# Codex保姆级安装教程：0基础小白也能看的懂得的安装指南
**作者**: Suu
**日期**: 2026-05-02T03:17:20.000Z
**来源**: [https://x.com/Suu766/status/2050414309419946243](https://x.com/Suu766/status/2050414309419946243)
---
> 最近推特时间线上出现了一个新的身影：Codex
> 一开始还不知道这是什么，后来用了一下才发现它其实就是 OpenAI 出的一个命令行 AI 编程助手
> 你在终端里用日常语言告诉它想干嘛，它直接给你生成代码，还能解释报错、分析项目结构、甚至当场跑通验证
> 不用装任何 IDE 插件，也不挑语言，对小白极其友好
目前 Codex CLI 在 Windows 上主要分两条路：
原生安装和 WSL2，我把两条路都走了一遍，你可以根据情况挑一条
## 装前小清单
不管选哪条路，这几样东西都要准备：
- 系统：Windows 10 或 11，建议更新到比较新的版本
- Node.js：版本需要 18 及以上
可以先去官网 https://nodejs.org/zh-cn 下载 LTS 版，或者在终端用 winget install OpenJS.NodeJS.LTS 命令安装，省心省力
- 权限：最好能用管理员身份运行终端，避免一些奇怪的权限问题
- 网络：确保能正常访问 OpenAI 的服务，有些公司或校园网可能需要代理
## 路径一：原生 Windows 安装
这是最直接的方式，全程在 PowerShell 里完成
1. 安装 Node.js
打开 PowerShell（右键“以管理员身份运行”），先看看电脑里装没装：
```
node -v
npm -v
```
如果都显示了版本号（Node >= 18），这步就跳过，如果提示找不到命令，用下面这个最省事的办法安装：
```
winget install OpenJS.NodeJS.LTS
```
装完之后，关掉当前 PowerShell，重新打开一个新的，再跑一遍 node -v 确认一下
2. 安装 Codex CLI
在 PowerShell 里执行：
```
npm install -g @openai/codex
```
如果遇到 EPERM 之类的权限错误，就用管理员身份重新打开 PowerShell 再执行一次
装完后验证一下：
```
codex --version
```
能显示版本号（比如0.1.xxx）就算装好了
3. 运行 Codex
直接在终端输入：
```
codex
```
第一次运行它会引导你登录，新手可以选择两种方式：
1. ChatGPT 账号登录：
这是最推荐的方式，不需要自己管理 API Key，直接用 ChatGPT Plus、Pro 或免费额度就行，安全省事
2. API Key 认证：
如果你有自己的 API Key，可以用环境变量的方式配置
如果你选择第二步，就在 PowerShell 里执行：
```
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "你的API Key", "User")
```
设置完后要关掉当前 PowerShell 重新打开，然后用 echo$env:OPENAI_API_KEY 验证一下是否成功
再次运行 codex，就能在提示符 > 后面直接提需求了
4. 你可能遇到的坑
如果在 PowerShell 里运行 codex 时报错“无法加载文件...禁止运行脚本”，这是 PowerShell 的安全策略在保护你
用下面这行命令解锁，然后继续就行：
```
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
```
另外如果遇到中文乱码，多半是因为 Windows 自带的 PowerShell 5.1 版本太旧
建议去微软商店装个新版 PowerShell 7，或者在终端里执行 chcp 65001 临时把编码切到 UTF-8
Windows 原生安装的小限制：
Codex 的沙箱安全机制在 Windows 原生环境下支持不太完整，官方还是把 Windows 归为“实验性支持”
如果只是日常写小脚本、分析数据、学习代码，原生完全够用；但如果你需要更完整的安全隔离，建议走下面的 WSL2 路径
## 路径二：通过 WSL2 安装（官方推荐，更稳）
如果你追求更稳定、和 Linux 完全一致的体验，WSL2 是官方最推荐的方式
1. 安装 WSL2
用管理员身份打开 PowerShell，一行命令就搞定：
```
wsl --install -d Ubuntu
```
等它跑完，按提示重启电脑
重启后在开始菜单里找到 “Ubuntu” 打开，第一次会让你设一个用户名和密码,输入密码时屏幕不会显示
2. 在 WSL 里装 Node.js 和 Codex
进入 Ubuntu 终端后，依次执行：
```
| bashcurl -o-https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh
source ~/.bashrc
nvm install 22
```
然后全局安装 Codex：
```
npm install -g @openai/codex
```
验证安装：
```
codex --version
```
3. 认证与运行
WSL 下同样支持两种认证方式
用浏览器登录最方便，直接 codex 然后选 ChatGPT 登录，它会在你的 Windows 浏览器里打开登录页面，授权就行
API Key 认证的话，执行：
```
echo 'export OPENAI_API_KEY=你的API Key' >> ~/.bashrc
source ~/.bashrc
```
小提醒：WSL 里操作的文件最好放在 Linux 自己的文件系统里（比如 /home/你的用户名/ 下面），不要放在 Windows 的 /mnt/c/ 路径，否则读写速度会慢不少
## 日常使用
1. 额度怎么算：
新注册的 OpenAI 账号通常有免费 API 额度
在 platform.openai.com 的 Usage 页面能看消耗
2. 升级和卸载：
升级就重新跑一遍 npm install -g@openai/codex ；
卸载的话，npm uninstall -g@openai/codex 就行
3. 遇到网络问题连不上：
偶尔 OpenAI 服务端繁忙，换个时间再试通常就好了
两条路我都亲测可用
如果你想简单直接，选原生 PowerShell；如果追求更完整的沙箱隔离和官方推荐体验，走 WSL2
按上面一步步来，基本上 20 分钟内就能搞定
最后，如果这篇文章对你有帮助，请点个关注支持一下，后续我也会继续分享干货知识和有用的小技巧~
## 相关链接
- [Suu](https://x.com/Suu766)
- [@Suu766](https://x.com/Suu766)
- [527](https://x.com/Suu766/status/2050414309419946243/analytics)
- [https://nodejs.org/zh-cn](https://nodejs.org/zh-cn)
- [0.1.xxx](https://0.1.xxx/)
- [$env](https://x.com/search?q=%24env&src=cashtag_click)
- [platform.openai.com](https://platform.openai.com/)
- [@openai/codex](https://x.com/@openai/codex)
- [@openai/codex](https://x.com/@openai/codex)
- [11:17 AM · May 2, 2026](https://x.com/Suu766/status/2050414309419946243)
- [527 Views](https://x.com/Suu766/status/2050414309419946243/analytics)
---
*导出时间: 2026/5/2 12:45:57*