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` 模板文件，要不要？