首页
手游
资讯
专题
首页 > 教程攻略 > ai教程 >Codex在Windows中的安装、配置与卸载的完整指南

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

来源：互联网 时间：2026-07-10 07:10:13

先说说手里这份指南。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 RAM8GB 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，需要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 安装步骤

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

3.2 首次配置

启动后出现登录界面，两种方式可选：

方式一：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
# 应输出你设置的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" 重启
  6. 按提示登录 OpenAI 账号或输入 API Key
  7. 配置好后就能在编辑器里用代码生成和补全了

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. 输入 API Key 并点 "Test Connection"
  8. 测试成功点 "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 验证失败

解决方案

：

  1. 检查 Key 有没有多余空格
  2. 确认余额够不够
  3. 确认 Key 有 Codex 模型访问权限
  4. 如果用第三方 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查看和修改配置

九、总结

到这里，OpenAI Codex在Windows上的三种安装方式就全交代完了。对于新手，先试试桌面应用版最省心；如果你有一定开发经验，CLI版能给你更多灵活度和自动化空间；而IDE集成版直接把能力和日常开发环境拧在一起，用起来最顺手。不论选哪条路，按步骤来、遇到问题翻翻解决方案，应该不会卡太久。

相关阅读

相关下载