Codex Windows 版怎么下载安装:ChatGPT 桌面 App 官方入口、winget 命令、开发工具与 WSL 设置

Windows 上的 Codex 现在是 ChatGPT 桌面 App 里的一个入口。官方给了微软商店下载地址和 winget 安装命令,原生用 PowerShell 加 Windows 沙箱,也可切到 WSL2。本文按官方文档讲安装、登录、建议装的开发工具、管理员运行和常见小问题。

NNathaniel bigo··原创首发·AI 辅助撰写
11 分钟读完
资料核对于 2026-10-27 · 依据官方文档与公开资料整理 Plus 账号
本文根据 Codex 官方文档《ChatGPT desktop app for Windows》《Quickstart》《Windows sandbox》整理,资料核对于 2026-10-27。官方文档里,Windows 上的 Codex 是 ChatGPT 桌面 App 的一部分,不是单独的另一个安装包。配图为本站整理的示意图,不是软件截图。

适用于谁

  • 想在 Windows 电脑上装 Codex 桌面 App 的人;
  • 搜「Codex Windows 下载」,不知道官方入口在哪的人;
  • 装好了,不知道还要准备什么工具的人;
  • 想知道 Windows 上是原生运行还是要装 WSL 的人。

结论先说

  1. 官方入口是 ChatGPT 桌面 App。 官方 Windows 应用文档给了一个微软商店的下载链接,也给了命令行安装方式:winget install --id 9PLM9XGG6VKS -s msstore。
  2. 装好后用 ChatGPT 账号登录,在新对话里从 ChatGPT 下拉菜单选 Codex(做软件开发),或切到 Work(做研究、文档、表格等)。
  3. Windows 上默认原生运行:代理用 PowerShell 执行命令,并使用 Windows 沙箱;需要 Linux 工具链的话,可以在设置里把代理切换到 WSL2。
  4. 建议同时装 Git。 官方说没有原生 Windows 的 Git,App 的一些功能用不了,审查面板也靠 Git。
  5. 要让 Codex 用管理员权限执行命令,需要把 App 本身以管理员身份启动。

Windows 上安装并开始用 Codex

图:本站根据 Codex 官方文档:ChatGPT desktop app for Windows 与 Quickstart 整理的示意图

一、下载和安装

官方给了两种方式:

  • 下载链接:Windows 应用文档里的下载入口指向微软商店的安装器(地址形如 get.microsoft.com/installer/download/9PLM9XGG6VKS)。点文档里的链接进入,不要从来路不明的网站下载安装包;
  • 命令行:在 PowerShell 里运行官方给的命令:
powershell
winget install --id 9PLM9XGG6VKS -s msstore

企业需要批量部署和更新的,官方另有《Deploy the Windows app and Codex CLI》文档,支持用 Intune、SCCM 等方式,个人用户不用看。

官方的系统环境说明(来自 Windows 沙箱文档):Windows 11 是推荐的基线;最新且完全更新的 Windows 10 是尽力而为,实际需要 1809 或更新版本;更老的 Windows 10 不推荐。另外 winget 需要可用,缺失时更新 Windows 或安装 Windows 程序包管理器。

二、第一次打开:登录并发第一条消息

官方 Quickstart 的桌面端步骤:

  1. 安装 ChatGPT 桌面 App;
  2. 打开 App,用 ChatGPT 账号登录。也可以用 API 密钥使用 Codex,但部分功能可能不可用,具体看官方的功能可用性表;
  3. 选择 ChatGPT 工作的位置:开始一个对话、创建项目,或者打开一个文件夹。ChatGPT 可以读取并修改你选的文件夹里的文件;
  4. 开始对话:做软件开发、需要代码库上下文和开发者工具的,在 ChatGPT 下拉菜单里选 Codex;做研究、分析或文档、演示文稿、表格等成果的,选 ChatGPT,再在新对话页顶部切到 Work;
  5. 发第一条消息,说明目标,补充需要的文件或上下文。

登录遇到问题见 /guides/codex-cannot-sign-in-send-message-connect;Work 和 Codex 有什么区别见 /guides/chatgpt-work-vs-codex。想用 Codex 又没有付费套餐的,可以看 /chongzhi/chatgpt-plus,各套餐额度见 /guides/codex-usage-limits。

三、建议准备的开发工具

官方说 Codex 在已装了几种常见开发工具时效果最好:

  • Git:驱动 App 里的审查面板,让你查看或撤销改动;
  • Node.js、Python:代理做事常用;
  • .NET SDK:想构建 Windows 原生应用时有用;
  • GitHub CLI:驱动 App 里与 GitHub 相关的功能。

官方给了一组 winget 命令,可以粘到 App 的集成终端里,也可以让 Codex 自己装:

powershell
winget install --id Git.Git
winget install --id OpenJS.NodeJS.LTS
winget install --id Python.Python.3.14
winget install --id Microsoft.DotNet.SDK.10
winget install --id GitHub.cli

装好 GitHub CLI 后,运行 gh auth login 才能启用 App 里的 GitHub 功能。需要别的 Python 或 .NET 版本,把包 ID 换成对应版本即可。

装好后建议准备的开发工具

图:本站根据 Codex 官方文档:ChatGPT desktop app for Windows 整理的示意图

四、原生运行还是 WSL

官方说明:默认使用 Windows 原生的 Codex 代理,也就是在 PowerShell 里执行命令,并用 Windows 沙箱。App 仍然可以通过 wsl 命令处理放在 WSL2 里的项目。

  • 想添加放在 WSL 里的项目:点 Add new project 或按 Ctrl+O,在文件资源管理器里输入 \\wsl$\,选发行版和文件夹;
  • 继续用原生代理的话,官方建议把项目放在 Windows 文件系统里,在 WSL 里通过 /mnt/<盘符>/... 访问,比直接打开 WSL 文件系统里的项目更可靠;
  • 想让代理本身跑在 WSL2 里:打开 Settings,把代理从 Windows native 切换到 WSL,并重启 App,重启后才生效,项目会保留;
  • 沙箱的实施方式在 Windows 和 WSL 里不同;要应用沙箱保护,在发消息前选择输入框下方的 Ask for approval。

集成终端可以单独选择(PowerShell、命令提示符、Git Bash、WSL),只对新终端会话生效,已经打开的终端要重启 App 或新开对话。

五、几个官方列的小问题

  • 需要管理员权限的命令:从开始菜单找到 App,选择 Run as administrator,Codex 代理会继承这个权限级别;
  • PowerShell 执行策略阻止命令:你从没在 PowerShell 里用过 Node.js、npm 的话,可能遇到类似 npm.ps1 cannot be loaded because running scripts is disabled on this system. 的错误。官方说常见做法是 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned,修改前先看微软的执行策略说明;
  • Git 功能不可用:没有在 Windows 上原生安装 Git,运行 winget install Git.Git;
  • 从 \\wsl$ 打开的项目检测不到 Git:目前最可靠的办法是把项目放在原生 Windows 盘,再从 WSL 里用 /mnt/<盘符>/... 访问;
  • 和 WSL 里的 CLI 共享配置和登录:Windows App 用 %USERPROFILE%\.codex,WSL 里的 CLI 默认用 Linux 主目录,不共享。办法是同步两个目录,或在 WSL 里设 export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex;
  • 沙箱设置失败、错误 1385:见 /guides/codex-windows-sandbox-setup-failed。

常见问题

Q:我只想用命令行,不想装桌面 App?

Codex CLI 有单独的安装方式,见 /guides/codex-cli-install-update;入门总览见 /guides/codex-getting-started。

Q:App 打不开或更新失败?

ChatGPT 桌面 App 的更新问题见 /guides/chatgpt-desktop-app-wont-open-update。

Q:必须付费吗?

官方 Pricing 页写明 ChatGPT Work 和 Codex 包含在 Free、Go、Plus、Pro、Business、Edu 或 Enterprise 套餐里,额度不同,以官方页面为准。

Q:Windows 版有 Linux 版吗?

官方文档里另有 Linux 桌面 App 页面,面向 Ubuntu、Debian、Fedora 和 Arch Linux,本文不展开。

参考资料

  • Codex 官方文档:ChatGPT desktop app for Windows — https://learn.chatgpt.com/docs/windows/windows-app
  • Codex 官方文档:Quickstart — https://learn.chatgpt.com/docs/quickstart
  • Codex 官方文档:Windows sandbox — https://learn.chatgpt.com/docs/windows/windows-sandbox
  • Codex 官方文档:Deploy the Windows app and Codex CLI — https://learn.chatgpt.com/docs/enterprise/windows-deployment
需要开通或续费?ChatGPT Plus 充值 →

Nathaniel 的更多内容

  1. 01

    Claude 登录报错对照(账号被停用以外):There was an error logging you in、收不到登录邮件、验证码、Google 登录的处理

    Claude 登录不上,除了账号被停用,还有登录出错、收不到登录邮件、在另一台设备点链接、想设密码、Google 登录异常等情况。本文按官方登录帮助整理各提示的原文和处理,账号被停用另见专门文章。

    Claude0
  2. 02

    Claude 提示「Something went wrong」怎么办:限额、消息过长、容量紧张、登录出错的官方报错对照

    Claude 报 Something went wrong 或别的错误?官方《Troubleshoot Claude error messages》把常见错误分成限额、消息过长、登录出错、容量紧张四类,并给了各自的原文和处理。本文逐项整理,并说明官方没有单独解释笼统的出错提示。

    Claude0
  3. 03

    DeepSeek 除了「服务器繁忙」还有哪些报错:网页版提示对照和 API 错误码 400、401、402、422、429、500、503

    DeepSeek 报错不只有服务器繁忙。本文把官方常见问题里的网页版提示(上传失败、运行环境异常、账号停用、邮箱域名不支持)和 API 错误码汇成对照表,给出官方的原因和处理,并链到各篇详细文章。

    其他 AI 工具0
  4. 04

    Gemini 提示「此账号无法使用」(Can't access this service)怎么办:账号类型、年龄、Family Link 与工作学校账号的官方条件

    Gemini 提示 Can't access this service,意思是这个账号目前不符合使用条件。官方写明了可用的账号类型、年龄要求和 Family Link 账号不能用。本文按账号类型对照,并给出 Something went wrong 的处理。

    Gemini0
  5. 05

    Gemini Pro 免费试用、学生优惠到期后怎么办:自动转付费、重新验证 SheerID、取消后会失去什么

    Google AI Pro 学生优惠或试用到期后会怎样?官方说会自动转为正常付费的 Plus 或 Pro,会提前通知;没有按时重新验证 SheerID 会失去优惠。本文按官方帮助中心整理到期规则、取消后失去的内容和第三方订阅的处理。

    Gemini0
  6. 06

    Gemini 怎么切换模型:Flash-Lite、Flash、Pro、Argon 的选择步骤、思考等级和自动选择

    Gemini 网页版怎么手动切换模型?官方步骤是点聊天框底部当前模型再选,需要有 Google AI 方案,带锁图标的要升级。本文按官方说明整理各方案可选模型、思考等级默认值和自动模型选择。

    Gemini0

同产品的其他教程

  1. 01

    Codex 常见报错总表:429、401、登录失败、连接中断、缺少环境变量、沙箱、Computer Use、远程控制,看到哪条读哪篇

    把 Codex 最常见的报错和问题汇成一张对照表:429、401、Token exchange failed、stream disconnected、missing environment variable、Windows 沙箱失败、Computer Use 找不到、远程控制连不上,各给一句处理方向并链到详细文章。

    ChatGPTCodex0
  2. 02

    Codex 插件在哪装:桌面 App 的 Plugins 标签、CLI 的 /plugins、IDE 为什么没有,以及插件和技能、MCP 的区别

    Codex 的插件在 ChatGPT 桌面 App 的 Plugins 标签里装,命令行输入 /plugins,IDE 插件不支持。本文按官方文档讲各入口怎么装、装完怎么用、用 API 密钥登录时有什么限制,以及插件、技能、MCP 服务器的区别。

    ChatGPTCodex0
  3. 03

    Codex 远程控制授权失败怎么办、远程 SSH 怎么用:手机配对电脑、Remote Control、连接 SSH 主机的官方步骤

    用手机远程控制电脑上的 Codex,配对不成功或授权失败?官方 Remote connections 文档写了配对步骤和五类常见问题,也讲了怎么把桌面 App 连到 SSH 主机、怎么在主机之间交接对话。本文按官方文档整理,并给出一张排查对照图。

    ChatGPTCodex0
  4. 04

    Codex 沙箱初始化失败怎么办(Windows):沙箱设置失败、错误 1385、Everyone 可写警告与 MXC、elevated、unelevated 怎么选

    Windows 上 Codex 沙箱设置失败、命令跑不起来、提示错误 1385 或 Everyone 可写?官方文档列了常见原因和处理,本文逐项整理,并说明 mxc、elevated、unelevated 三种实现的区别。

    ChatGPTCodex0
  5. 05

    Codex 找不到 Computer Use 怎么办:插件在哪装、地区限制、macOS 权限与 Windows 前台运行说明

    ChatGPT 桌面 App 的 Computer Use 能让 Codex 看屏幕、点鼠标、操作桌面应用,但官方写明它只在支持的地区可用,需要装 Computer Use 插件并开启开关。本文按官方文档讲插件在哪装、macOS 要给哪两个权限、Windows 为什么会占用前台,以及找不到时的排查。

    ChatGPTCodex0
  6. 06

    Codex 报「missing environment variable」怎么办:env_key、MCP 环境变量、命令读不到变量的官方配置说明

    Codex 提示缺少环境变量,多半出在自定义模型提供方的 env_key、MCP 服务器的 env_vars 或 shell_environment_policy 上。官方没有单独解释这条报错,本文按官方配置文档说明每个设置的作用和排查顺序。

    ChatGPTCodex0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~