Windows 系统安装 Codex 指南

作者：蛋黄的IT日记 | 发布于：2026-04-17

标签：[Codex] [AI编程] [Windows]

---

前言

Codex 是由 OpenAI 开发的 AI 编程助手，能够在终端中运行，帮助开发者完成代码生成、代码解释、自动修复 Bug、项目重构、命令生成、脚本编写等功能。作为 OpenAI 的产品，Codex 对 OpenAI API 有良好的支持，同时也支持多种 API 提供商。本指南将详细介绍在 Windows 系统上安装 Codex CLI 的完整步骤。

一、安装前准备

1.1 系统要求

组件	要求
操作系统	Windows 10/11 (64位)
Node.js	>= 20 (推荐 >= 22)
npm	>= 10
Git	推荐安装

1.2 安装 Git for Windows

详细安装步骤可参考： Windows系统安装OpenCode指南 - Git 安装部分

验证安装：

git --version

1.3 安装 Node.js

Node.js 是 Codex CLI 的运行时环境，必须先安装。

详细安装步骤可参考： Windows系统安装OpenCode指南 - Node.js 安装部分

验证安装：

node -v
npm -v

二、安装 Codex CLI

2.1 npm 全局安装（推荐）

推荐版本：最新版 Codex CLI 存在兼容性问题，推荐使用 0.57.0 版本

以管理员身份打开 PowerShell，执行以下命令：

npm install -g @openai/codex@0.57.0

国内镜像加速（如需）：

npm install -g @openai/codex@0.57.0 --registry=https://registry.npmjs.org

2.2 解决 PowerShell 执行策略问题（如遇到）

如果遇到以下错误：

在此系统禁止运行脚本

执行以下命令解决：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

三、验证安装

安装完成后，验证 Codex 是否正常工作：

codex --version

如果显示版本号，说明安装成功。

3.1 首次运行 - 选择模型

选择一个工作目录输入 codex 命令启动codex，首次启动 Codex 时，会显示模型选择界面：

Introducing GPT-5.4

Codex just got an upgrade with GPT-5.4, our most capable model...

Choose how you'd like Codex to proceed:
› 1. Try new model
  2. Use existing model

Use ↑/↓ to move, press enter to select

• 选择 1. Try new model - 试用新模型（GPT-5.4）
• 选择 2. Use existing model - 使用现有模型

按 ↓ 选择后按 Enter 确认即可。

四、登录认证

首次运行 codex 命令后，会直接进入模型选择界面。如果未登录，系统会在后续提示进行认证。

方式一：使用 API Key 登录（以 MiniMax 为例）

重要提示：使用前请先清除 OpenAI 环境变量，以免影响 MiniMax API 的正常使用。

1. 获取 MiniMax API Key（可从 MiniMax 开放平台 获取）

   

2. 清除 OpenAI 环境变量（如有）：

Remove-Item env:OPENAI_API_KEY -ErrorAction SilentlyContinue
Remove-Item env:OPENAI_BASE_URL -ErrorAction SilentlyContinue

3. 设置 MiniMax API Key：

$env:MINIMAX_API_KEY = "<YOUR_MINIMAX_API_KEY>"

4. 启动 Codex（使用默认配置）：

codex

或使用指定配置启动：

codex --profile m27

方式二：配置文件登录（以 MiniMax 为例）

通过配置文件进行认证：

1. 创建配置目录（如不存在）：

mkdir $env:USERPROFILE\.codex -Force

2. 创建 config.toml 文件：

[model_providers.minimax]
name = "MiniMax Chat Completions API"
base_url = "https://api.minimaxi.com/v1"
env_key = "MINIMAX_API_KEY"
wire_api = "chat"
requires_openai_auth = false

[profiles.m27]
model = "codex-MiniMax-M2.7"
model_provider = "minimax"

3. （可选）创建 auth.json 文件存储 API Key：

{
  "api_key": "<YOUR_MINIMAX_API_KEY>"
}

4. 设置环境变量：

$env:MINIMAX_API_KEY = "<YOUR_MINIMAX_API_KEY>"

5. 使用指定配置启动 Codex：

codex --profile m27

[截图：配置文件示例]

遇到问题：Error loading configuration: config profile 'm27' not found

排查步骤：

1. 确认配置目录存在：C:\Users\你的用户名\.codex\
   
2. 查看配置文件内容是否正确：

Get-Content "$env:USERPROFILE\.codex\config.toml"

3. 确认配置文件中是否包含 [profiles.m27] 部分，如果不存在需要手动添加
4. 重启终端后再次执行以下命令验证配置：

$env:MINIMAX_API_KEY = "<YOUR_MINIMAX_API_KEY>"
codex --profile m27 --version

如果显示版本号而无报错，说明配置加载成功

注意：如果仍有问题，检查当前安装的 Codex 版本：

codex --version

推荐使用 0.57.0 版本，如需降级：

npm install -g @openai/codex@0.57.0

五、快速入门

5.1 启动 Codex

进入项目目录，使用 MiniMax 配置启动 Codex：

cd 你的项目目录
codex --profile m27

[截图：启动 Codex]

5.2 常用命令

命令	说明
codex	启动 Codex
codex --version	查看版本
codex --help	查看帮助

5.3 常用功能

• 代码生成：描述你想要的功能，Codex 自动生成代码
• 代码解释：选中代码，询问 Codex 解释
• Bug 修复：描述问题，Codex 帮助定位和修复
• 命令生成：描述需求，Codex 生成 shell 命令

六、常见问题

Q1：运行 codex 提示"不是内部或外部命令"？

1. 检查 Node.js 是否正确安装
2. 检查环境变量是否配置
3. 重启终端或电脑

Q2：npm 安装失败，提示权限/EPERM？

以管理员身份运行 PowerShell，然后重新安装：

npm install -g @openai/codex@0.57.0

Q3：安装时提示需要编译工具？

安装 Node.js 时确保勾选了"Build Tools"选项，或单独下载安装 Visual Studio Build Tools。

Q4：想升级 Codex？

npm update -g @openai/codex@0.57.0

Q5：想卸载 Codex？

npm uninstall -g @openai/codex

总结

本文介绍了在 Windows 系统上安装 Codex CLI 的完整步骤：

1. 安装 Git for Windows（推荐）
2. 安装 Node.js >= 20
3. 使用 npm 全局安装 @openai/codex@0.57.0（推荐版本）
4. 解决 PowerShell 执行策略问题（如需要）
5. 验证安装是否成功
6. 配置 MiniMax API 登录认证

安装完成后，即可在终端中享受 AI 编程助手的便捷体验！

---

原创声明

本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载需附上此出处声明。