本文详细介绍了 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 工具都需要此依赖:
- 下载地址:https://aka.ms/vs/16/release/vc_redist.x64.exe
- 双击运行安装程序
- 按照向导完成安装,重启电脑生效
Node.js 环境(仅 CLI 版需要)
Codex CLI 基于 Node.js 开发,要求 Node.js 22.0 及以上版本:
|
1
2
3
4
5
|
# 方法一:使用winget安装(推荐)
winget install --id OpenJS.NodeJS.LTS -e
# 方法二:官网下载
# 访问 https://nodejs.org/ 下载LTS版本的.msi安装包
# 双击运行,一路下一步即可
|
验证安装:
|
1
2
|
node -v # 应输出v22.x.x或更高版本
npm -v # 应输出v10.x.x或更高版本
|
三、桌面应用版安装与配置
3.1 安装步骤
- 打开 Microsoft Store 应用商店
- 搜索 "Codex" 或直接访问官方地址
- 点击 "获取" 按钮开始下载安装
- 等待安装完成后,点击 "打开" 启动应用
3.2 首次配置
启动 Codex 桌面应用后,会出现登录界面
选择登录方式:
方式一:OpenAI 账号登录(推荐)
- 点击 "Sign in with OpenAI"
- 在浏览器中登录你的 OpenAI 账号
- 授权 Codex 访问你的账号信息
- 浏览器会自动跳回应用完成登录
方式二:API Key 登录
- 点击 "Use API Key"
- 输入你的 OpenAI API Key(格式:sk-...)
- 点击 "Verify" 验证密钥有效性
- 验证成功后点击 "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
设置执行策略(仅首次需要):
|
1
|
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
|
输入 "Y" 确认更改
安装 Codex CLI:
|
1
2
3
4
5
6
|
# 官方源安装
npm install -g @openai/codex
# 如果npm速度慢,可以使用淘宝镜像
npm config set registry https://registry.npmmirror.com
npm install -g @openai/codex
|
验证安装:
|
1
2
|
codex --version
# 应输出类似:0.130.0
|
4.2 配置 API Key
临时配置(仅当前会话有效)
|
1
|
$env:OPENAI_API_KEY="你的OpenAI API Key"
|
永久配置
|
1
2
3
4
5
6
7
|
# 写入用户环境变量
setx OPENAI_API_KEY "你的OpenAI API Key"
# 验证配置
# 关闭当前PowerShell窗口,重新打开一个新窗口
echo $env:OPENAI_API_KEY
# 应输出你设置的API Key
|
4.3 基本使用
启动交互式会话:
常用命令:
|
1
2
3
4
5
6
7
8
9
10
11
|
# 查看帮助
codex help
# 初始化项目
codex init
# 运行任务
codex run "创建一个简单的Python Web服务器"
# 查看历史记录
codex history
|
五、IDE 集成版安装与配置
5.1 VS Code 集成
- 打开 VS Code
- 点击左侧扩展图标(Ctrl+Shift+X)
- 搜索 "OpenAI Codex"
- 找到官方扩展并点击 "安装"
- 安装完成后,点击 "Reload" 重启 VS Code
- 按提示登录你的 OpenAI 账号或输入 API Key
- 配置完成后,你可以在编辑器中使用 Codex 的代码生成和补全功能
5.2 JetBrains IDE 集成(IntelliJ IDEA、PyCharm 等)
- 打开 JetBrains IDE
- 进入 File → Settings → Plugins
- 搜索 "OpenAI Codex"
- 找到官方插件并点击 "Install"
- 重启 IDE
- 进入 File → Settings → Tools → AI Assistant → Codex
- 输入你的 OpenAI API Key 并点击 "Test Connection"
- 测试成功后点击 "Apply" 和 "OK"
六、常见问题与解决方案
6.1 安装问题
问题 1:Microsoft Store 下载失败
解决方案:
检查网络连接是否正常
重置 Microsoft Store 缓存:
重启电脑后再次尝试下载
问题 2:npm 安装失败,提示权限错误(EPERM)
解决方案:
以管理员身份运行 PowerShell
使用 --force 参数强制安装:
|
1
|
npm install -g @openai/codex --force
|
如果仍然失败,修改 npm 全局目录:
|
1
2
3
4
|
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
[System.Environment]::SetEnvironmentVariable('Path', $env:Path + ";$env:USERPROFILE\.npm-global\bin", [System.EnvironmentVariableTarget]::User)
# 重新打开终端后再次安装
|
问题 3:安装时提示缺少 Visual C++ 运行库
解决方案:按照 2.2.1 节的说明安装 Visual C++ 2019 Redistributable
6.2 配置问题
问题 1:API Key 验证失败
解决方案:
- 检查 API Key 是否正确,注意不要有多余的空格
- 确认你的 OpenAI 账号有足够的余额
- 检查 API Key 是否有访问 Codex 模型的权限
- 如果使用的是第三方 API Key,确认服务商支持 Codex 模型
问题 2:公司网络环境下无法登录
解决方案:
配置系统代理:
|
1
2
3
|
# 设置HTTP代理
setx HTTP_PROXY "http://你的代理地址:端口"
setx HTTPS_PROXY "http://你的代理地址:端口"
|
或者在 Codex 配置文件中设置代理:
编辑C:\Users\你的用户名\.codex\config.toml
添加以下内容:
|
1
2
3
|
[proxy]
http = "http://你的代理地址:端口"
https = "http://你的代理地址:端口"
|
6.3 使用问题
问题 1:Codex 响应缓慢
解决方案:
- 检查网络连接速度
- 尝试切换到更快的模型(如 GPT-5.1-Codex-Mini)
- 减少上下文长度,只提供必要的信息
问题 2:生成的代码有错误
解决方案:
- 提供更详细的提示词,明确你的需求
- 分步骤生成代码,而不是一次性生成整个项目
- 使用/plan命令让 Codex 先生成计划,再生成代码
七、完整卸载方法
7.1 桌面应用版卸载
- 打开 Windows 设置 → 应用 → 已安装的应用
- 搜索 "Codex"
- 点击右侧三个点 → 卸载
- 按照提示完成卸载
- 清理残留文件:
|
1
2
3
4
|
# 删除用户配置文件
Remove-Item -Recurse -Force "$env:USERPROFILE\.codex"
# 删除应用数据
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\Packages\OpenAI.Codex_9plm9xgg6vks"
|
7.2 CLI 工具版卸载
以管理员身份打开 PowerShell
卸载全局包:
|
1
|
npm uninstall -g @openai/codex
|
清理残留文件:
|
1
|
Remove-Item -Recurse -Force "$env:USERPROFILE\.codex"
|
删除环境变量:
|
1
|
[System.Environment]::SetEnvironmentVariable('OPENAI_API_KEY', $null, [System.EnvironmentVariableTarget]::User)
|
7.3 IDE 集成版卸载
VS Code 扩展卸载
- 打开 VS Code
- 点击左侧扩展图标
- 找到 "OpenAI Codex" 扩展
- 点击 "卸载"
- 重启 VS Code
JetBrains 插件卸载
- 打开 JetBrains IDE
- 进入 File → Settings → Plugins
- 找到 "OpenAI Codex" 插件
- 点击 "Uninstall"
- 重启 IDE
八、常用命令速查
| 命令 |
说明 |
| codex --version |
查看版本信息 |
| codex help |
查看帮助信息 |
| codex |
启动交互式会话 |
| codex init |
初始化当前项目 |
| codex run "任务描述" |
运行指定任务 |
| codex plan "任务描述" |
生成任务执行计划 |
| codex history |
查看历史记录 |
| codex config |
查看和修改配置 |
九、总结
本文详细介绍了 OpenAI Codex 在 Windows 系统上的三种安装方式及其配置方法,并提供了完整的卸载流程和常见问题解决方案。对于新手用户,推荐从桌面应用版开始使用;对于有一定开发经验的用户,CLI 工具版提供了更强大的功能和灵活性;而 IDE 集成版则可以无缝融入你的日常开发工作流。
|