下载 Windows 版 Codex

在 Windows 上,请新开一个 PowerShell 窗口,使用 chatgpt.com 提供的官方一行安装命令安装 Codex CLI。如果想用桌面应用,可从 Microsoft Store 安装 ChatGPT 桌面应用,或运行 winget install --id 9PLM9XGG6VKS -s msstore。桌面应用默认在 PowerShell 中原生运行 Codex,并使用 Windows 沙盒;你也可以切换为在 WSL2 中运行。

适用于: Windows 11, Codex CLI, ChatGPT desktop app

本页译自英文指南。命令和文件名保持不变。如两者有出入,以英文页面和官方来源为准。

方式 1:使用官方安装程序安装 Codex CLI

打开一个新的 PowerShell 窗口并运行:

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

以后再次运行同一条命令即可更新。打开一个新的终端,切换到你的项目文件夹,然后运行 codex。首次运行时选择 Sign in with ChatGPT(使用 ChatGPT 登录)。

如果你已经在 Windows 上使用 Node.js,也可以用 npm 安装(npm install -g @openai/codex)。

方式 2:从 Microsoft Store 安装 ChatGPT 桌面应用

OpenAI 通过 Microsoft Store 发布 Windows 桌面应用:

winget install --id 9PLM9XGG6VKS -s msstore

然后打开应用,登录,添加项目,并选择 Codex。

原生 Windows 还是 WSL2?

桌面应用默认使用 Windows 原生的 Codex 智能体。命令在 PowerShell 中运行;当你在输入框下方选择 Ask for approval(请求审批)时,会受到 Windows 原生沙盒的保护。如果你更希望智能体在 Linux 中运行,请打开 Settings(设置),将智能体从 Windows 原生切换为 WSL,然后重启应用。

对于原生智能体,OpenAI 的建议是将项目放在 Windows 文件系统中,并在 WSL 中通过 /mnt/<drive>/... 访问。直接从 \\wsl$\ 打开项目不太可靠。完整步骤:在 WSL2 中使用 Codex。

建议先安装的工具

预先装好几个开发者工具,Codex 会运行得更好。OpenAI 的 Windows 文档建议:

winget install --id Git.Git
winget install --id OpenJS.NodeJS.LTS
winget install --id GitHub.cli

Git 为审查面板提供支持。Node.js 和 Python 能帮助智能体更高效地工作。安装 GitHub CLI 后,运行 gh auth login 以启用 GitHub 相关功能。

以完全访问模式运行 Codex 意味着它不再局限于你的项目文件夹。OpenAI 警告这可能导致破坏性操作和数据丢失。除非有明确的理由,否则请保持沙盒开启。

常见问题

在 Windows 上使用 Codex 需要 WSL 吗?

不需要。ChatGPT 桌面应用和独立 CLI 安装程序都支持原生 Windows,命令在 PowerShell 中运行。WSL2 是可选的;如果你的项目和工具本来就在 Linux 环境中,可以使用它。

Codex 支持 WSL1 吗?

不支持。根据 OpenAI 的 Windows 文档,WSL1 的支持截止到 Codex 0.114。从 0.115 起,Linux 沙盒改用 bubblewrap,因此需要 WSL2。

为什么 PowerShell 提示禁止运行脚本?

这是 PowerShell 的执行策略导致的。在修改任何系统设置之前,请先参阅我们针对“cannot be loaded because running scripts is disabled”错误的解决方法。

来源

本页的每条说明都附有官方来源链接。如果本页内容与官方来源不一致,请以官方来源为准,并告诉我们。