# win11本地部署Codex机器人

收到！"Codex 机器人"一般指 OpenAI 的 \*\*Codex CLI\*\* —— 一个跑在终端里的 AI 编程助手。Windows 11 原生支持，不用装 WSL。我先给你画个整体流程图，再上保姆级步骤。  
先看整体流程，一共 5 步，10 分钟内能搞定：  
下面是保姆级教程，全部在 \*\*PowerShell\*\*（开始菜单搜 "PowerShell"，建议以管理员身份打开）里操作。

\---

\## 一、先说清楚 Codex 是什么

Codex CLI 是 OpenAI 官方的\*\*终端 AI 编程助手\*\*，开源在 GitHub（`openai/codex`）。它能：  
\- 用自然语言写代码、改 Bug、重构  
\- 直接读写你本地的项目文件  
\- 在终端里自动执行命令（装依赖、跑测试）

\*\*Windows 11 原生支持，不需要装 WSL。\*\* 前提是你有 ChatGPT Plus/Pro/Business/Edu 订阅，或者 OpenAI API Key。

\## 二、安装 Node.js（必备）

```powershell  
\# 1. 先看装没装  
node -v  
npm -v  
```

如果没装，用 Windows 自带的 winget 一条命令搞定：

```powershell  
winget install --id OpenJS.NodeJS.LTS -e  
```

装完\*\*关掉 PowerShell 重新打开\*\*，再验证 `node -v` 能输出版本号（如 v22.x）。

\## 三、放行执行策略（90% 的人卡在这步）

不先做这步，npm 会报 `无法加载文件 ...npm.ps1，因为在此系统上禁止运行脚本`：

```powershell  
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned  
```

输入 `Y` 确认。只对当前用户生效，不影响系统其他人。

\## 四、安装 Codex CLI

```powershell  
\# 国内网络慢的话，用 npmmirror 镜像加速（推荐）  
npm install -g @openai/codex --registry=https://registry.npmmirror.com

\# 验证版本  
codex --version  
```

> 如果提示 `codex` 找不到命令：执行 `npm config get prefix` 拿到全局安装路径，把它加到系统环境变量 PATH 里，然后重开终端。

\## 五、登录认证

输入 `codex` 启动，首次运行会让你选择登录方式：

| 方式 | 适用人群 | 说明 |  
|------|---------|------|  
| \*\*ChatGPT 账号登录\*\* | 有 Plus/Pro 订阅 | 会弹浏览器完成授权，最省事 |  
| \*\*API Key\*\* | 有 OpenAI API 账号 | 在 platform.openai.com 生成 `sk-...` 密钥 |

也可以写配置文件永久生效，路径为 `%USERPROFILE%\\.codex\\config.toml`：

```toml  
model = "gpt-5.4-codex"  
model\_provider = "openai"  
```

\## 六、国内网络怎么解决

\- \*\*npm 下载慢\*\* → 已经用镜像解决了（上面命令里的 `--registry`）。  
\- \*\*登录/调用 OpenAI 慢或失败\*\* → 需要能访问 OpenAI 的网络环境，或使用\*\*合法合规\*\*的 API 中转服务。若走中转，在 `config.toml` 里加：

```toml  
model\_provider = "openai"  
base\_url = "https://你的中转服务地址/v1"  
api\_key = "sk-你的中转key"  
model = "gpt-5.4-codex"  
```

⚠️ 提醒：请务必使用合法合规的服务渠道，遵守相关法律法规和 OpenAI 使用条款。

\## 七、开始使用

```powershell  
codex  
```

进入交互界面后直接说需求，比如：  
\- `帮我创建一个 Express 项目的基本结构`  
\- `把项目里所有 console.log 改成 logger.info`  
\- `给这个函数写 10 个单元测试`

会话内常用命令：`/model` 切换模型、`/approval-mode` 控制自动执行还是逐步确认。

\## 八、常见问题速查

| 症状 | 原因 | 解决 |  
|------|------|------|  
| npm 报执行策略错误 | 没放行脚本 | 执行第三步的命令 |  
| `npm install` 报 EPERM | 权限不足 | 用管理员 PowerShell，或把全局目录切到 `$env:APPDATA\\npm` |  
| `codex` 找不到命令 | PATH 没配 | `npm config get prefix` 查路径后加入系统 PATH |  
| 启动报缺 api-ms-win-crt | 缺 VC++ 运行库 | 安装 Visual C++ Redistributable |  
| 版本装完启动失败 | 个别版本有兼容 bug | 降级：`npm install -g @openai/codex@0.119.0` |

升级到最新版：`npm install -g @openai/codex@latest`

\---

需要的话，我可以直接帮你把环境变量配置写成一个一键脚本，或者帮你写一个 `config.toml` 模板文件，要不要？