desktop-setup

桌面版适合不想一直盯着终端的新手，也适合同时管理多个项目、多个任务的人。

> 前置教程：Windows 安装与启动

> 如果你的 Windows、Git、Node.js、编辑器和练习目录还没有准备好，先完成前置教程，再回到本篇。

> 依据来源：OpenAI Codex 官方手册中的 Codex app、Windows app、Authentication and sessions、Configuration 等章节。

完成本篇后，你应该能做到：

知道桌面版和 CLI 不是同一个安装入口。
在 Windows 上安装 Codex 桌面版。
打开 Codex 桌面版并完成登录。
分清 ChatGPT 登录和 API Key 登录的区别。
知道登录成功后下一步应该选择项目，而不是急着改代码。

第 1 步：先确认你要安装的是桌面版

Section titled “第 1 步：先确认你要安装的是桌面版”

Codex 常见入口有很多：

Codex 桌面版。
Codex CLI。
Codex IDE 扩展。
Codex Cloud / Web。

本篇只讲 Codex 桌面版。

你可以把它理解成一个独立 App：打开以后，可以选择项目、开线程、让 Codex 做任务、看 diff、处理审批、管理多个任务。

它和 CLI 的区别是：

| 对比项 | 桌面版 | CLI |

| ---- | ------------------------ | ------------------------ |

| 启动方式 | 打开 App | 在终端输入 codex |

| 适合人群 | 新手、喜欢图形界面、多任务管理 | 熟悉终端、重度本地项目开发 |

| 项目选择 | 在 App 里选择文件夹 | 在项目目录运行命令 |

| 配置文件 | 共享 \~/.codex/config.toml | 共享 \~/.codex/config.toml |

| 模型配置 | 基本同一套配置层 | 基本同一套配置层 |

所以结论是：安装方式不一样，配置体系高度一致。

请打开 Codex 官方文档里的桌面版页面：


https://developers.openai.com/codex/app


如果你只想看 Windows 相关内容，也可以打开：


https://developers.openai.com/codex/app/windows


只从官方入口下载。不要从网盘、群文件、第三方安装包下载 Codex。
第 3 步：下载 Windows 版本
Section titled “第 3 步：下载 Windows 版本”
在官方页面中找到 Windows 下载入口。
你要检查 3 件事：


页面域名是 OpenAI 官方域名。
2. 下载内容明确指向 Codex app。
3. 系统是 Windows。

如果页面提示 Microsoft Store 安装，就按页面提示跳转安装。
第 4 步：安装 Codex 桌面版
Section titled “第 4 步：安装 Codex 桌面版”
下载完成后，按安装器提示操作。
常见安装过程大致是：


双击安装文件，或在 Microsoft Store 点击安装。
2. 等待系统下载和安装。
3. 安装完成后，点击打开。

你不需要在这一步配置模型，也不需要改任何项目文件。
第 5 步：第一次打开 Codex
Section titled “第 5 步：第一次打开 Codex”
打开 Codex 桌面版。
第一次打开时，你通常会看到登录入口。
你可能会看到两种登录方式：

使用 ChatGPT 账号登录。
使用 OpenAI API Key 登录。

新手优先选择 ChatGPT 账号登录。
原因是：

操作更直观。
不需要先管理 API Key。
更适合桌面版完整体验。

API Key 登录更适合：

公司统一发放 API Key。
自动化或程序化使用。
你非常清楚密钥权限和费用边界。

点击登录后，Codex 可能会打开浏览器。
你要做的是：


在浏览器里登录你的 ChatGPT 账号。
2. 按页面提示授权。
3. 登录成功后回到 Codex 桌面版。

如果浏览器没有自动跳回桌面版，先不要重装。
你可以按这个顺序排查：


看浏览器页面是否显示登录成功。
2. 回到 Codex 桌面版，看是否已经进入主界面。
3. 关闭 Codex 桌面版后重新打开。
4. 仍然不行，再看后续排障手册。

登录成功后，你应该能看到 Codex 桌面版主界面。
最小验收标准是：

Codex 桌面版能正常打开。
不再停留在登录页面。
能看到选择项目、创建会话、打开设置等入口之一。

不要在这一步直接让 Codex 修改项目。
这一步只确认：桌面版已经装好，并且你已经登录。
我已经装了 CLI，还需要装桌面版吗
Section titled “我已经装了 CLI，还需要装桌面版吗”
不一定。
如果你习惯终端，CLI 已经够用。
如果你希望：

更容易查看多个任务。
更直观看 diff。
更方便选择项目。
更适合新手演示。

那桌面版值得装。
正常不会。

官方手册说明，CLI、IDE 扩展、Codex app 会共享配置层。也就是说，你在用户级 ~/.codex/config.toml 里设置的默认模型、provider、审批和沙箱偏好，通常可以被多个入口复用。


但要注意：不同入口的临时选择不一定完全等同。例如 CLI 里一次性传的命令参数，只对那次 CLI 会话生效。
可以按 Codex 的配置层思路配置，但不要把它理解成“在 App 里随便填一个国内模型就行”。
更稳的路线是：

先写好 ~/.codex/config.toml。

2. 把 API Key 放到 ~/.codex/.env` 或安全的环境变量位置。

3. 重启 Codex 桌面版。

4. 开一个新会话验证模型是否可用。

后面有单独一篇：桌面版如何使用国内大模型配置。

完成后，你应该得到这些结果：

已安装 Codex 桌面版。
已完成登录。
能看到 Codex 桌面版主界面。
知道桌面版安装和 CLI 安装不是一回事。
知道桌面版和 CLI 会共享一部分配置层。

下一篇看：Codex 桌面版第一次选择项目。