本文详细介绍了 OpenAI Codex 在 Windows 系统上的完整安装与配置流程，涵盖三种主流使用方式：桌面应用版（Microsoft Store）、命令行工具版（Codex CLI）和IDE 集成版（VS Code/JetBrains）。指南包含从系统要求检查到具体安装步骤、API 密钥配置、中文界面设置等详细说明，并针对常见问题如微软商店下载失败、安装错误代码、网络代&理问题等提供了经过验证的解决方案。最后还提供了完整的卸载方法，帮助用户彻底清理残留文件。

一、概述

OpenAI Codex 是一款基于 GPT 系列模型专门针对编程任务优化的 AI 编程助手，支持代码生成、解释、调试、重构等功能。与 GitHub Copilot 不同，Codex 更侧重于 ** 自主编程代&理（Autonomous Coding Agent）** 能力，能够在沙箱环境中独立完成复杂的编程任务并生成完整的 Pull Request 供开发者审核。

截至 2026 年 5 月，Codex 提供三种 Windows 使用方式：

• 桌面应用版：图形界面，适合新手用户
• 命令行工具版（CLI）：功能强大，适合开发者和自动化场景
• IDE 集成版：无缝集成到 VS Code、JetBrains 等开发环境中

二、系统要求与前置准备

2.1 系统要求

表格

组件	最低要求	推荐要求
操作系统	Windows 10 19041 及以上（64 位）	Windows 11 22H2 及以上（64 位）
内存	4GB RAM	8GB RAM 及以上
硬盘空间	至少 2GB 可用空间	5GB 及以上可用空间
网络	稳定的互联网连接	带宽≥10Mbps
权限	管理员权限（部分安装步骤需要）	管理员权限

2.2 必备依赖安装

Visual C++ 2019 Redistributable

桌面应用版和 CLI 工具都需要此依赖：

1. 下载地址：https://aka.ms/vs/16/release/vc_redist.x64.exe
2. 双击运行安装程序
3. 按照向导完成安装，重启电脑生效

Node.js 环境（仅 CLI 版需要）

Codex CLI 基于 Node.js 开发，要求 Node.js 22.0 及以上版本：

# 方法一：使用winget安装（推荐）
winget install --id OpenJS.NodeJS.LTS -e
# 方法二：官网下载
# 访问 https://nodejs.org/ 下载LTS版本的.msi安装包
# 双击运行，一路下一步即可

验证安装：

node -v  # 应输出v22.x.x或更高版本
npm -v   # 应输出v10.x.x或更高版本

三、桌面应用版安装与配置

3.1 安装步骤

1. 打开 Microsoft Store 应用商店
2. 搜索 "Codex" 或直接访问官方地址
3. 点击 "获取" 按钮开始下载安装
4. 等待安装完成后，点击 "打开" 启动应用

3.2 首次配置

启动 Codex 桌面应用后，会出现登录界面

选择登录方式：

方式一：OpenAI 账号登录（推荐）

1. 点击 "Sign in with OpenAI"
2. 在浏览器中登录你的 OpenAI 账号
3. 授权 Codex 访问你的账号信息
4. 浏览器会自动跳回应用完成登录

方式二：API Key 登录

1. 点击 "Use API Key"
2. 输入你的 OpenAI API Key（格式：sk-...）
3. 点击 "Verify" 验证密钥有效性
4. 验证成功后点击 "Continue"

完成初始设置向导，选择你的主要编程语言和使用场景

点击 "Finish" 进入主界面

3.3 基本配置

中文界面设置：

• 点击右上角头像 → Settings → General
• 在 Language 下拉菜单中选择 "简体中文"
• 重启应用生效

模型选择：

• 点击右上角头像 → Settings → Models
• 选择默认使用的模型（推荐：GPT-5.5-Codex）
• 调整温度参数（Temperature）：0.2-0.5 适合代码生成，0.7-1.0 适合创意性任务

沙箱设置：

• 点击右上角头像 → Settings → Sandbox
• 启用 "Windows Sandbox" 以获得更好的安全性
• 设置允许的文件系统访问范围

四、命令行工具版（CLI）安装与配置

4.1 安装步骤

以管理员身份打开 PowerShell

设置执行策略（仅首次需要）：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

输入 "Y" 确认更改

安装 Codex CLI：

# 官方源安装
npm install -g @openai/codex

# 如果npm速度慢，可以使用淘宝镜像
npm config set registry https://registry.npmmirror.com
npm install -g @openai/codex

验证安装：

codex --version
# 应输出类似：0.130.0

4.2 配置 API Key

临时配置（仅当前会话有效）

$env:OPENAI_API_KEY="你的OpenAI API Key"

永久配置

# 写入用户环境变量
setx OPENAI_API_KEY "你的OpenAI API Key"

# 验证配置
# 关闭当前PowerShell窗口，重新打开一个新窗口
echo $env:OPENAI_API_KEY
# 应输出你设置的API Key

4.3 基本使用

启动交互式会话：

codex

常用命令：

# 查看帮助
codex help

# 初始化项目
codex init

# 运行任务
codex run "创建一个简单的Python Web服务器"

# 查看历史记录
codex history

五、IDE 集成版安装与配置

5.1 VS Code 集成

1. 打开 VS Code
2. 点击左侧扩展图标（Ctrl+Shift+X）
3. 搜索 "OpenAI Codex"
4. 找到官方扩展并点击 "安装"
5. 安装完成后，点击 "Reload" 重启 VS Code
6. 按提示登录你的 OpenAI 账号或输入 API Key
7. 配置完成后，你可以在编辑器中使用 Codex 的代码生成和补全功能

5.2 JetBrains IDE 集成（IntelliJ IDEA、PyCharm 等）

1. 打开 JetBrains IDE
2. 进入 File → Settings → Plugins
3. 搜索 "OpenAI Codex"
4. 找到官方插件并点击 "Install"
5. 重启 IDE
6. 进入 File → Settings → Tools → AI Assistant → Codex
7. 输入你的 OpenAI API Key 并点击 "Test Connection"
8. 测试成功后点击 "Apply" 和 "OK"

六、常见问题与解决方案

6.1 安装问题

问题 1：Microsoft Store 下载失败

解决方案：

检查网络连接是否正常

重置 Microsoft Store 缓存：

wsreset.exe

重启电脑后再次尝试下载

问题 2：npm 安装失败，提示权限错误（EPERM）

解决方案：

以管理员身份运行 PowerShell

使用 --force 参数强制安装：

npm install -g @openai/codex --force

如果仍然失败，修改 npm 全局目录：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
[System.Environment]::SetEnvironmentVariable('Path', $env:Path + ";$env:USERPROFILE.npm-globalbin", [System.EnvironmentVariableTarget]::User)
# 重新打开终端后再次安装

问题 3：安装时提示缺少 Visual C++ 运行库

解决方案：按照 2.2.1 节的说明安装 Visual C++ 2019 Redistributable

6.2 配置问题

问题 1：API Key 验证失败

解决方案：

1. 检查 API Key 是否正确，注意不要有多余的空格
2. 确认你的 OpenAI 账号有足够的余额
3. 检查 API Key 是否有访问 Codex 模型的权限
4. 如果使用的是第三方 API Key，确认服务商支持 Codex 模型

问题 2：公司网络环境下无法登录

解决方案：

配置系统代&理：

# 设置HTTP代&理
setx HTTP_PROXY "http://你的代&理地址:端口"
setx HTTPS_PROXY "http://你的代&理地址:端口"

或者在 Codex 配置文件中设置代&理：

编辑C:Users你的用户名.codexconfig.toml

添加以下内容：

[proxy]
http = "http://你的代&理地址:端口"
https = "http://你的代&理地址:端口"

6.3 使用问题

问题 1：Codex 响应缓慢

解决方案：

1. 检查网络连接速度
2. 尝试切换到更快的模型（如 GPT-5.1-Codex-Mini）
3. 减少上下文长度，只提供必要的信息

问题 2：生成的代码有错误

解决方案：

1. 提供更详细的提示词，明确你的需求
2. 分步骤生成代码，而不是一次性生成整个项目
3. 使用/plan命令让 Codex 先生成计划，再生成代码

七、完整卸载方法

7.1 桌面应用版卸载

• 打开 Windows 设置 → 应用 → 已安装的应用
• 搜索 "Codex"
• 点击右侧三个点 → 卸载
• 按照提示完成卸载
• 清理残留文件：

# 删除用户配置文件
Remove-Item -Recurse -Force "$env:USERPROFILE.codex"
# 删除应用数据
Remove-Item -Recurse -Force "$env:LOCALAPPDATAPackagesOpenAI.Codex_9plm9xgg6vks"

7.2 CLI 工具版卸载

以管理员身份打开 PowerShell

卸载全局包：

npm uninstall -g @openai/codex

清理残留文件：

Remove-Item -Recurse -Force "$env:USERPROFILE.codex"

删除环境变量：

[System.Environment]::SetEnvironmentVariable('OPENAI_API_KEY', $null, [System.EnvironmentVariableTarget]::User)

7.3 IDE 集成版卸载

VS Code 扩展卸载

1. 打开 VS Code
2. 点击左侧扩展图标
3. 找到 "OpenAI Codex" 扩展
4. 点击 "卸载"
5. 重启 VS Code

JetBrains 插件卸载

1. 打开 JetBrains IDE
2. 进入 File → Settings → Plugins
3. 找到 "OpenAI Codex" 插件
4. 点击 "Uninstall"
5. 重启 IDE

八、常用命令速查

命令	说明
codex --version	查看版本信息
codex help	查看帮助信息
codex	启动交互式会话
codex init	初始化当前项目
codex run "任务描述"	运行指定任务
codex plan "任务描述"	生成任务执行计划
codex history	查看历史记录
codex config	查看和修改配置

九、总结

本文详细介绍了 OpenAI Codex 在 Windows 系统上的三种安装方式及其配置方法，并提供了完整的卸载流程和常见问题解决方案。对于新手用户，推荐从桌面应用版开始使用；对于有一定开发经验的用户，CLI 工具版提供了更强大的功能和灵活性；而 IDE 集成版则可以无缝融入你的日常开发工作流。