Skip to main content

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

No Comments
Back to top