本文詳細(xì)介紹了 OpenAI Codex 在 Windows 系統(tǒng)上的完整安裝與配置流程，涵蓋三種主流使用方式：桌面應(yīng)用版（Microsoft Store）、命令行工具版（Codex CLI）和IDE 集成版（VS Code/JetBrains）。指南包含從系統(tǒng)要求檢查到具體安裝步驟、API 密鑰配置、中文界面設(shè)置等詳細(xì)說(shuō)明，并針對(duì)常見(jiàn)問(wèn)題如微軟商店下載失敗、安裝錯(cuò)誤代碼、網(wǎng)絡(luò)代理問(wèn)題等提供了經(jīng)過(guò)驗(yàn)證的解決方案。最后還提供了完整的卸載方法，幫助用戶(hù)徹底清理殘留文件。

一、概述

OpenAI Codex 是一款基于 GPT 系列模型專(zhuān)門(mén)針對(duì)編程任務(wù)優(yōu)化的 AI 編程助手，支持代碼生成、解釋、調(diào)試、重構(gòu)等功能。與 GitHub Copilot 不同，Codex 更側(cè)重于 ** 自主編程代理（Autonomous Coding Agent）** 能力，能夠在沙箱環(huán)境中獨(dú)立完成復(fù)雜的編程任務(wù)并生成完整的 Pull Request 供開(kāi)發(fā)者審核。

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

• 桌面應(yīng)用版：圖形界面，適合新手用戶(hù)
• 命令行工具版（CLI）：功能強(qiáng)大，適合開(kāi)發(fā)者和自動(dòng)化場(chǎng)景
• IDE 集成版：無(wú)縫集成到 VS Code、JetBrains 等開(kāi)發(fā)環(huán)境中

二、系統(tǒng)要求與前置準(zhǔn)備

2.1 系統(tǒng)要求

表格

2.2 必備依賴(lài)安裝

Visual C++ 2019 Redistributable

桌面應(yīng)用版和 CLI 工具都需要此依賴(lài)：

1. 下載地址：https://aka.ms/vs/16/release/vc_redist.x64.exe
2. 雙擊運(yùn)行安裝程序
3. 按照向?qū)瓿砂惭b，重啟電腦生效

Node.js 環(huán)境（僅 CLI 版需要）

Codex CLI 基于 Node.js 開(kāi)發(fā)，要求 Node.js 22.0 及以上版本：

# 方法一：使用winget安裝（推薦）
winget install --id OpenJS.NodeJS.LTS -e
# 方法二：官網(wǎng)下載
# 訪(fǎng)問(wèn) https://nodejs.org/ 下載LTS版本的.msi安裝包
# 雙擊運(yùn)行，一路下一步即可

驗(yàn)證安裝：

node -v  # 應(yīng)輸出v22.x.x或更高版本
npm -v   # 應(yīng)輸出v10.x.x或更高版本

三、桌面應(yīng)用版安裝與配置

3.1 安裝步驟

1. 打開(kāi) Microsoft Store 應(yīng)用商店
2. 搜索 "Codex" 或直接訪(fǎng)問(wèn)官方地址
3. 點(diǎn)擊 "獲取" 按鈕開(kāi)始下載安裝
4. 等待安裝完成后，點(diǎn)擊 "打開(kāi)" 啟動(dòng)應(yīng)用

3.2 首次配置

啟動(dòng) Codex 桌面應(yīng)用后，會(huì)出現(xiàn)登錄界面

選擇登錄方式：

方式一：OpenAI 賬號(hào)登錄（推薦）

1. 點(diǎn)擊 "Sign in with OpenAI"
2. 在瀏覽器中登錄你的 OpenAI 賬號(hào)
3. 授權(quán) Codex 訪(fǎng)問(wèn)你的賬號(hào)信息
4. 瀏覽器會(huì)自動(dòng)跳回應(yīng)用完成登錄

方式二：API Key 登錄

1. 點(diǎn)擊 "Use API Key"
2. 輸入你的 OpenAI API Key（格式：sk-...）
3. 點(diǎn)擊 "Verify" 驗(yàn)證密鑰有效性
4. 驗(yàn)證成功后點(diǎn)擊 "Continue"

完成初始設(shè)置向?qū)Вx擇你的主要編程語(yǔ)言和使用場(chǎng)景

點(diǎn)擊 "Finish" 進(jìn)入主界面

3.3 基本配置

中文界面設(shè)置：

• 點(diǎn)擊右上角頭像 → Settings → General
• 在 Language 下拉菜單中選擇 "簡(jiǎn)體中文"
• 重啟應(yīng)用生效

模型選擇：

• 點(diǎn)擊右上角頭像 → Settings → Models
• 選擇默認(rèn)使用的模型（推薦：GPT-5.5-Codex）
• 調(diào)整溫度參數(shù)（Temperature）：0.2-0.5 適合代碼生成，0.7-1.0 適合創(chuàng)意性任務(wù)

沙箱設(shè)置：

• 點(diǎn)擊右上角頭像 → Settings → Sandbox
• 啟用 "Windows Sandbox" 以獲得更好的安全性
• 設(shè)置允許的文件系統(tǒng)訪(fǎng)問(wèn)范圍

四、命令行工具版（CLI）安裝與配置

4.1 安裝步驟

以管理員身份打開(kāi) PowerShell

設(shè)置執(zhí)行策略（僅首次需要）：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

輸入 "Y" 確認(rèn)更改

安裝 Codex CLI：

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

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

驗(yàn)證安裝：

codex --version
# 應(yīng)輸出類(lèi)似：0.130.0

4.2 配置 API Key

臨時(shí)配置（僅當(dāng)前會(huì)話(huà)有效）

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

永久配置

# 寫(xiě)入用戶(hù)環(huán)境變量
setx OPENAI_API_KEY "你的OpenAI API Key"

# 驗(yàn)證配置
# 關(guān)閉當(dāng)前PowerShell窗口，重新打開(kāi)一個(gè)新窗口
echo $env:OPENAI_API_KEY
# 應(yīng)輸出你設(shè)置的API Key

4.3 基本使用

啟動(dòng)交互式會(huì)話(huà)：

codex

常用命令：

# 查看幫助
codex help

# 初始化項(xiàng)目
codex init

# 運(yùn)行任務(wù)
codex run "創(chuàng)建一個(gè)簡(jiǎn)單的Python Web服務(wù)器"

# 查看歷史記錄
codex history

五、IDE 集成版安裝與配置

5.1 VS Code 集成

1. 打開(kāi) VS Code
2. 點(diǎn)擊左側(cè)擴(kuò)展圖標(biāo)（Ctrl+Shift+X）
3. 搜索 "OpenAI Codex"
4. 找到官方擴(kuò)展并點(diǎn)擊 "安裝"
5. 安裝完成后，點(diǎn)擊 "Reload" 重啟 VS Code
6. 按提示登錄你的 OpenAI 賬號(hào)或輸入 API Key
7. 配置完成后，你可以在編輯器中使用 Codex 的代碼生成和補(bǔ)全功能

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

1. 打開(kāi) JetBrains IDE
2. 進(jìn)入 File → Settings → Plugins
3. 搜索 "OpenAI Codex"
4. 找到官方插件并點(diǎn)擊 "Install"
5. 重啟 IDE
6. 進(jìn)入 File → Settings → Tools → AI Assistant → Codex
7. 輸入你的 OpenAI API Key 并點(diǎn)擊 "Test Connection"
8. 測(cè)試成功后點(diǎn)擊 "Apply" 和 "OK"

六、常見(jiàn)問(wèn)題與解決方案

6.1 安裝問(wèn)題

問(wèn)題 1：Microsoft Store 下載失敗

解決方案：

檢查網(wǎng)絡(luò)連接是否正常

重置 Microsoft Store 緩存：

wsreset.exe

重啟電腦后再次嘗試下載

問(wèn)題 2：npm 安裝失敗，提示權(quán)限錯(cuò)誤（EPERM）

解決方案：

以管理員身份運(yùn)行 PowerShell

使用 --force 參數(shù)強(qiáng)制安裝：

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-global\bin", [System.EnvironmentVariableTarget]::User)
# 重新打開(kāi)終端后再次安裝

問(wèn)題 3：安裝時(shí)提示缺少 Visual C++ 運(yùn)行庫(kù)

解決方案：按照 2.2.1 節(jié)的說(shuō)明安裝 Visual C++ 2019 Redistributable

6.2 配置問(wèn)題

問(wèn)題 1：API Key 驗(yàn)證失敗

解決方案：

1. 檢查 API Key 是否正確，注意不要有多余的空格
2. 確認(rèn)你的 OpenAI 賬號(hào)有足夠的余額
3. 檢查 API Key 是否有訪(fǎng)問(wèn) Codex 模型的權(quán)限
4. 如果使用的是第三方 API Key，確認(rèn)服務(wù)商支持 Codex 模型

問(wèn)題 2：公司網(wǎng)絡(luò)環(huán)境下無(wú)法登錄

解決方案：

配置系統(tǒng)代理：

# 設(shè)置HTTP代理
setx HTTP_PROXY "http://你的代理地址:端口"
setx HTTPS_PROXY "http://你的代理地址:端口"

或者在 Codex 配置文件中設(shè)置代理：

編輯C:\Users\你的用戶(hù)名\.codex\config.toml

添加以下內(nèi)容：

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

6.3 使用問(wèn)題

問(wèn)題 1：Codex 響應(yīng)緩慢

解決方案：

1. 檢查網(wǎng)絡(luò)連接速度
2. 嘗試切換到更快的模型（如 GPT-5.1-Codex-Mini）
3. 減少上下文長(zhǎng)度，只提供必要的信息

問(wèn)題 2：生成的代碼有錯(cuò)誤

解決方案：

1. 提供更詳細(xì)的提示詞，明確你的需求
2. 分步驟生成代碼，而不是一次性生成整個(gè)項(xiàng)目
3. 使用/plan命令讓 Codex 先生成計(jì)劃，再生成代碼

七、完整卸載方法

7.1 桌面應(yīng)用版卸載

• 打開(kāi) Windows 設(shè)置 → 應(yīng)用 → 已安裝的應(yīng)用
• 搜索 "Codex"
• 點(diǎn)擊右側(cè)三個(gè)點(diǎn) → 卸載
• 按照提示完成卸載
• 清理殘留文件：

# 刪除用戶(hù)配置文件
Remove-Item -Recurse -Force "$env:USERPROFILE\.codex"
# 刪除應(yīng)用數(shù)據(jù)
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\Packages\OpenAI.Codex_9plm9xgg6vks"

7.2 CLI 工具版卸載

以管理員身份打開(kāi) PowerShell

卸載全局包：

npm uninstall -g @openai/codex

清理殘留文件：

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

刪除環(huán)境變量：

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

7.3 IDE 集成版卸載

VS Code 擴(kuò)展卸載

1. 打開(kāi) VS Code
2. 點(diǎn)擊左側(cè)擴(kuò)展圖標(biāo)
3. 找到 "OpenAI Codex" 擴(kuò)展
4. 點(diǎn)擊 "卸載"
5. 重啟 VS Code

JetBrains 插件卸載

1. 打開(kāi) JetBrains IDE
2. 進(jìn)入 File → Settings → Plugins
3. 找到 "OpenAI Codex" 插件
4. 點(diǎn)擊 "Uninstall"
5. 重啟 IDE

八、常用命令速查

九、總結(jié)

本文詳細(xì)介紹了 OpenAI Codex 在 Windows 系統(tǒng)上的三種安裝方式及其配置方法，并提供了完整的卸載流程和常見(jiàn)問(wèn)題解決方案。對(duì)于新手用戶(hù)，推薦從桌面應(yīng)用版開(kāi)始使用；對(duì)于有一定開(kāi)發(fā)經(jīng)驗(yàn)的用戶(hù)，CLI 工具版提供了更強(qiáng)大的功能和靈活性；而 IDE 集成版則可以無(wú)縫融入你的日常開(kāi)發(fā)工作流。

以上就是Codex在Windows中的安裝、配置與卸載的完整指南的詳細(xì)內(nèi)容，更多關(guān)于Codex安裝配置與卸載的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論