安装 Codex 桌面应用

OpenAI 当前的文档将 Codex 桌面端体验描述为 ChatGPT 桌面应用的一部分。在 macOS 上从 chatgpt.com/download 安装,在 Windows 上从 Microsoft Store 安装,在 Linux 上使用 OpenAI 的预览版安装包。然后登录,添加项目文件夹,并在模式菜单中选择 Codex,即可开始编程对话。

适用于: ChatGPT desktop app, macOS, Windows, Linux (preview)

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

1. 下载

操作系统下载位置
macOSchatgpt.com/download
WindowsMicrosoft Store 页面,或 winget install --id 9PLM9XGG6VKS -s msstore
Linux(预览版)来自 OpenAI Linux 页面的 .deb、.rpm 或 Arch 安装脚本

2. 登录

打开应用,用你的 ChatGPT 账号登录。如果想改用 API 密钥,请在未登录界面中选择 Sign in another way(使用其他方式登录)。OpenAI 提示,使用 API 密钥登录时部分功能不可用。

3. 选择 Codex 的工作位置

通过 Add new project(添加新项目)或 Cmd+O / Ctrl+O 添加一个项目文件夹。Codex 可以读取和修改你所选文件夹中的文件。请用 Git 管理项目,以便审查和撤销更改。

4. 开始 Codex 对话

在模式菜单中选择 Codex,然后开始一个 New chat(新对话),描述你想做的事。例如:

Inspect this app, identify one high-impact usability improvement, implement it, update the relevant tests, and verify the result.

这条提示词来自 OpenAI 的快速入门。如果是第一次使用,可以从更小的任务开始。参见你的第一个任务。

Windows:原生智能体还是 WSL

在 Windows 上,应用默认在 PowerShell 中原生运行 Codex 智能体;选择 Ask for approval(请求审批)时会使用 Windows 沙盒。如需在 WSL2 中运行智能体,请在 Settings(设置)中切换,然后重启应用。详情:在 WSL2 中使用 Codex。

Linux:尚未提供的功能

Linux 应用目前是预览版。OpenAI 列明 Computer Use 暂不支持 Linux,原生 Wayland 支持仍为实验性功能。

常见问题

我搜索的是 Codex 应用,为什么显示的是 ChatGPT?

OpenAI 的文档现在介绍的是一个内置 Codex 的 ChatGPT 桌面应用。在 macOS 上,故障排查文档中仍提到一个 Codex.app 兼容包路径。两个名称指的都是同一个用于编程工作的桌面端体验。

桌面应用和 CLI 使用相同的设置吗?

在同一个 Codex 主机上,MCP 服务器在桌面应用、CLI 和 IDE 扩展之间共享。在 Windows 上,应用使用 %USERPROFILE%\.codex 作为 Codex 主目录,在 WSL 中运行的 CLI 不会自动共享该目录。

来源

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