首页 > AI教程 >Codex在Windows中的安装配置与卸载完整指南

Codex在Windows中的安装配置与卸载完整指南

来源：互联网 2026-07-18 06:26:09

windows资讯合集

OpenAICodex在Windows上支持桌面应用、命令行工具和IDE集成三种安装方式，完整覆盖从系统检查、API密钥配置、中文界面设置到常见故障排除的全过程，并提供详细卸载步骤，确保无残留文件，彻底清除。

先说说手里这份指南。OpenAI Codex在Windows上怎么装、怎么配、怎么用，甚至最后怎么卸干净——这里一次性的交代清楚。核心覆盖了三种主流方案：桌面应用版（走Microsoft Store）、命令行工具版（Codex CLI）以及IDE集成版（VS Code和JetBrains全家桶）。从检查系统够不够格开始，一直到API密钥配置、中文界面设置，连常见的微软商店下载失败、安装报错、公司网络袋里问题都给了经过验证的解法。放心，卸载部分也完整，不会给你留一堆残留文件添堵。

长期稳定更新的攒劲资源： >>>点此立即查看<<<

一、概述

OpenAI Codex是基于GPT系列模型针对编程任务深度优化的AI编程助手，能帮你写代码、解释代码、调试甚至重构。跟GitHub Copilot不太一样的地方在于，Codex更侧重“自主编程袋里”的能力——它可以在沙箱环境里独立完成复杂的编程任务，直接生成完整的Pull Request等你来审核。

截至2026年5月，Windows上用Codex有这三种路子：

桌面应用版：图形界面，新手友好
命令行工具版（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，需要22.0及以上版本：

# 方法一：用winget安装（这个更省事）
winget install --id OpenJS.NodeJS.LTS -e
# 方法二：官网下载 .msi 安装包自行安装
# 地址：https://nodejs.org/

完了验证一下：

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

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

3.1 安装步骤

打开 Microsoft Store
搜索 "Codex" 或直接访问官方链接
点击 "获取" 下载安装
完成后点 "打开" 启动应用

3.2 首次配置

启动后出现登录界面，两种方式可选：
方式一：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。
先设置执行策略（首次需要）：

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
# 应输出你设置的Key

4.3 基本使用

启动交互式会话：

codex

常用命令：

# 查看帮助
codex help

# 初始化项目
codex init

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

# 查看历史记录
codex history

五、IDE 集成版安装与配置

5.1 VS Code 集成

打开 VS Code
左侧扩展图标点一下（或 Ctrl+Shift+X）
搜索 "OpenAI Codex"
找官方扩展点 "安装"
安装完 "Reload" 重启
按提示登录 OpenAI 账号或输入 API Key
配置好后就能在编辑器里用代码生成和补全了

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

打开 JetBrains IDE
File → Settings → Plugins
搜索 "OpenAI Codex"
找到官方插件点 "Install"
重启 IDE
File → Settings → Tools → AI Assistant → Codex
输入 API Key 并点 "Test Connection"
测试成功点 "Apply" 和 "OK"

六、常见问题与解决方案

6.1 安装问题

问题 1：Microsoft Store 下载失败

解决方案：检查网络连接，重置 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 验证失败

解决方案：

检查 Key 有没有多余空格
确认余额够不够
确认 Key 有 Codex 模型访问权限
如果用第三方 Key，确认服务商支持 Codex

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

解决方案：配置系统袋里：

setx HTTP_PROXY "http://你的袋里地址:端口"
setx HTTPS_PROXY "http://你的袋里地址:端口"

或者在 Codex 配置文件里加袋里——编辑 C:Users你的用户名.codexconfig.toml，加：

[proxy]
http = "http://你的袋里地址:端口"
https = "http://你的袋里地址:端口"

6.3 使用问题

问题 1：Codex 响应慢

解决方案：查查网络速度，换更快的模型（比如 GPT-5.1-Codex-Mini），减少上下文长度。

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

解决方案：把提示词写细一点、分步骤来，别一次性甩整个项目。先用 /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 扩展卸载：打开 VS Code，扩展图标 → 找到 "OpenAI Codex" → 卸载 → 重启。

JetBrains 插件卸载：File → Settings → Plugins → 找到插件 → Uninstall → 重启 IDE。

八、常用命令速查

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