如果你最近刚听说 OpenAI Codex Desktop，脑子里第一个问题大概率不是“它的架构是什么”，而是很现实的那几个：去哪里下载、装起来麻不麻烦、第一次打开该怎么配、会不会乱动我的项目。
这篇文章就是来解决这些问题的。我们不绕概念，直接把下载、安装、登录、首发配置和避坑点一口气讲明白。

Codex Desktop 的主界面。你可以把它理解成一个围绕本地项目工作的 AI 协作台。

先说结论：Codex Desktop 适合谁

如果你符合下面任意一种情况，这个桌面客户端就值得装一下试试：

• 你想让 AI 直接围绕本地项目工作，而不是只在聊天框里“口头建议”
• 你希望它能读文件、看目录、改代码、跑命令
• 你想把 AI 助手从“会聊天”升级成“能干活的 coding agent”
• 你想先从桌面端入门，再考虑 IDE 插件、CLI 或团队协作

一句话总结就是：

Codex Desktop 更像一个坐在你电脑旁边、能进项目现场干活的 AI 工程搭子，而不只是一个会答题的聊天机器人。

---

OpenAI Codex Desktop 是什么

你可能会想，Codex 不就是写代码的 AI 吗，和普通 AI 助手有什么区别？

区别还真不小。

普通聊天式 AI，更像你把代码截图发给它，它给你建议。
Codex Desktop 不一样，它是直接进你项目目录里看现场、翻文件、执行任务、给出改动，很多时候甚至还能沿着 Git 工作流继续往下走。

换句话说：

• 普通 AI 更像“场外顾问”
• Codex Desktop 更像“进场协作的代理人”

根据 OpenAI 官方 Quickstart，Codex 登录后默认会以 Agent 模式工作，也就是它可以读取文件、运行命令、并在项目目录里写入修改。这个能力很强，但也正因为强，所以第一次配置时一定要稳一点，别一上来就把门全打开。

---

安装前的准备工作

很多人安装失败，不是卡在下载，而是前置条件没理顺。先把这几件事准备好，后面会顺很多。

1. 一个可用的 OpenAI 账号

官方文档写得很清楚，Codex 可以用两种方式登录：

• ChatGPT 账号
• OpenAI API key

如果你只是第一次体验，我建议直接用 ChatGPT 账号。
原因很简单，省事，而且官方也明确提到，如果你使用 API key 登录，部分功能可能不可用。

说白了，API key 更像是“开发者模式入口”，适合后面做自动化、CLI、SDK 之类的玩法。第一次上手，账号登录最稳。

2. 确认你的系统版本

截至 2026 年 6 月 23 日，OpenAI 官方 Quickstart 页面给出的桌面下载入口包括：

• macOS（Apple Silicon）
• macOS（Intel）
• Windows

Linux 目前是“登记通知”状态，不是正式桌面安装入口。

这一步别嫌啰嗦。尤其是 Mac 用户，一定先看清楚自己是 Apple Silicon 还是 Intel。装错版本，就像给柴油车加汽油，后面全是麻烦。

3. 准备一个测试项目

第一次别直接拿生产项目开刀。

更推荐的做法是：

• 准备一个练手仓库
• 找一个你熟悉的小项目
• 或者干脆新建一个测试目录

这样你后面验证权限、跑首个任务、看改动差异时，心里更有底。

4. Windows 用户可以提前把常用开发工具准备好

OpenAI 的 Windows 文档里专门提到，如果你在 Windows 上使用 Codex，常见开发工具越齐，体验通常越顺。常见包括：

• Git
• Node.js
• Python
• .NET SDK
• GitHub CLI

这里要特别说明一下：这些不是安装 Codex 桌面客户端本身的硬性前置条件。
更准确地说，它们属于“后续深度使用时会明显提升体验”的工具。

如果你只是想先把客户端装起来、登录进去、读一读本地项目，其实不需要一次把这些都配齐。
但如果你后面想让 Codex 跑脚本、装依赖、查仓库状态，这些工具迟早会碰到。

---

去哪里下载 OpenAI Codex Desktop

目前最稳妥的官方入口有两个：

• Codex 产品页
• ChatGPT / Codex 统一下载页

在 OpenAI 的统一下载页里，已经能看到单独的 Download Codex 区块，页面提供：

• macOS
• Windows

如果你是 Windows 用户，下载按钮会跳到微软侧的官方分发入口。
如果你是 Mac 用户，官方 Quickstart 页面会区分：

• Download for macOS (Apple Silicon)
• Download for macOS (Intel)

下载时要注意什么

这一步最容易犯的错有三个：

1. 下错平台版本
2. 从非官方镜像站下载
3. 看到旧教程就照抄过期入口

一个简单原则就够了：

只认 OpenAI 官方页面，或者 OpenAI 官方页面跳转出去的下载链接。

---

Windows 和 macOS 安装步骤

Windows 安装

Windows 这边的路径比较直接。

图形化安装方式

1. 打开 OpenAI 官方下载入口
2. 选择 Windows
3. 跳转后完成安装
4. 安装完成后启动 Codex

如果你更习惯命令行方式，OpenAI 官方 Windows 文档给出的安装命令是：

winget install Codex -s msstore

Windows 用户通常会跳转到微软商店安装页。看到 OpenAI 发布者信息以后，再继续安装会更稳妥。

Windows 用户额外注意两件事

第一件事是终端环境。

官方文档说明，Codex 在 Windows 上支持原生 PowerShell，也支持 WSL2。
你可以简单理解成两条路：

• 原生 PowerShell 路线
• Linux 风格的 WSL2 路线

如果你平时主要就是 Windows 原生开发，先用 PowerShell 就够了。
如果你本来就长期在 Linux 风格环境里工作，再考虑 WSL2。

第二件事是 PowerShell 执行策略。

官方 Troubleshooting 里专门提到，如果你以前没怎么在 PowerShell 里跑过 Node.js、npm 这类工具，可能会遇到执行策略拦截。翻译成人话就是：终端不是坏了，是系统把脚本拦住了。

macOS 安装

Mac 这边反而更简单，关键只有一个：别下错芯片版本。

安装步骤

1. 打开 OpenAI 官方下载页
2. 选择对应版本
3. 下载完成后正常安装
4. 首次启动时按系统提示完成授权
5. 进入登录页面

如果你看到系统安全提醒，不用慌。
这类提示本质上是在问你：要不要允许这个应用正常运行。只要来源确认是官方，就按系统提示处理即可。

---

首次登录怎么选

安装完打开 Codex，接下来就是登录。

官方 Quickstart 给出的方式是：

• 使用 ChatGPT 账号登录
• 使用 OpenAI API key 登录

这里我还是建议新手优先走 ChatGPT 账号路线。
原因前面提过一次，再强调一遍：API key 登录下，部分功能可能不可用。

第一次体验更推荐直接点“Sign in with ChatGPT”。如果你是高级用户，再考虑 API key 入口。

登录时如果卡住，先排查这几个方向

• 当前网络是否能正常访问 OpenAI 页面
• 是否是企业设备，浏览器登录受到了策略限制
• 是否存在代理、登录跳转、白屏或安全拦截问题
• 关闭应用重新打开后是否恢复正常

别急着怀疑自己操作错了。很多登录问题，其实不是步骤错了，而是环境没放行。

---

首发配置怎么配最稳

这部分很关键。
同样一个 Codex，有人觉得“太强了”，也有人第一次就被权限和改动吓住。区别往往不在模型，而在首发配置有没有收住。

你可以把首发配置理解成“先给它哪几把钥匙”。

门都开了，它当然能干更多。
但门开太多，第一次也容易慌。

第一步：先只选一个项目目录

官方 Quickstart 里写得很明确，登录后要先选一个项目文件夹，让 Codex 在这个目录里工作。

第一次建议这样做：

• 只选一个小项目
• 不要一上来就给整个工作盘
• 不要直接让它碰生产仓库

说白了，先让它进一个房间，不要先把整栋楼钥匙给出去。

这张不是官方截图，而是我补的一张示意图。它的作用很简单，让你更直观的看懂“只给当前项目目录权限”这件事。

第二步：确认使用 Local 模式

官方 Quickstart 的核心意思是：选完项目以后，优先按“本地项目协作”的方式开始第一条任务。

这里要补一句更稳妥的话：不同版本的 Codex 界面，运行位置或模式的文案可能不完全一样。
有的版本会明确看到类似 Local 的选项，有的版本可能直接按本地流程进入，不一定给你一个很显眼的切换按钮。

这一步的意思其实很朴素：

让 Codex 直接在你这台机器的本地项目里工作。

所以如果你当前界面里能看到本地模式、项目模式、运行位置之类的选择，优先选本地项目模式就行。
如果你压根没看到显式切换项，也别慌，通常按默认本地流程继续即可。

Local 模式可以简单理解成“它就在你这台电脑和当前项目里干活”。

第三步：权限别一开始开太大

OpenAI 的权限文档里给了几种典型的权限层级。这里也要说清楚一件事：

文档里出现的这些名称，更像是官方权限体系里的典型表达，不一定会原样出现在你当前桌面客户端的每一个界面里。

你不需要上来就研究配置文件，先理解概念就够了。

最常见的几种，可以先这么理解：

• read-only：只能看，不能改
• workspace：可以在当前工作区里写入
• danger-full-access：基本不受限制，风险最高

换句话说，你可以把它们当成三层权限思路，而不是“你一定会在界面里看到完全同名的三个按钮”。

第一次上手的建议很简单：

• 先看项目时，优先只读
• 要改当前项目文件时，再给工作区写权限
• 不要上来就给 full access

为什么？

因为权限一旦放太大，Codex 的手脚会非常灵活。灵活当然是好事，但第一次上手，你更需要的是“可控”，不是“无上限”。

如果你只记一件事，就记这张图。新手顺序建议是从 read-only 开始，熟悉后再逐步放开。

第四步：网络权限也先保守一点

OpenAI 的权限文档还给了“工作区写入 + 公网访问”的配置示例，并明确提醒，只有在你真的打算开放公网访问时，才应该用全局放开的规则。

翻译成人话就是：

• 本地试用阶段，先不开公网最稳
• 真要联网查资料、访问文档、调用服务，再按需打开
• 能限制域名范围，就别默认全放开

这一步特别像家里装修时配电箱。
平时你不需要把每一路都推到最大，够用、稳妥、出问题好排查，反而更重要。

第五步：顺手看一眼设置项

Codex App Settings 文档里有一些设置值得第一次顺手看看，尤其是：

• 默认文件打开方式
• 集成终端默认使用哪个环境
• 命令输出显示多少内容
• 通知要不要开
• 浏览器访问是否先询问
• 外部集成和 MCP 是否暂时保持关闭

这一块不用第一次就全研究透。
核心原则就一句：

先把本地项目协作这条主线跑通，再慢慢加高级能力。

---

如何验证自己有没有装成功

很多人装完以后，最尴尬的不是报错，而是不知道“现在到底算不算装好了”。

最简单的办法不是看界面，而是做一次最小任务验证。

第一条消息，建议这样发

请先阅读这个项目，并告诉我它的目录结构、主要技术栈和启动方式。

为什么推荐这句？

因为它刚好能测试四件事：

• 它能不能读项目目录
• 它能不能理解主要文件
• 它能不能整理出结构信息
• 它会不会在需要时正常请求权限

如果这一步跑通，说明“能进门、能看图纸、能说人话”基本没问题。

第二步，再试一个小改动

比如：

帮我做一个最小范围的改动，并说明你修改了哪些文件。

这一步主要是验证：

• 文件写入是否正常
• 改动范围是否可控
• 差异视图是否清楚
• 它有没有乱改不该动的东西

第三步，如果项目用了 Git，再看一眼变更记录

官方 Quickstart 里还建议使用 Git checkpoints。
这点非常重要。

你可以把 Git checkpoint 理解成“先拍一张现场照片”。
后面就算你不满意，也知道该退回哪一步。

判断安装成功，别只看能不能打开应用。真正有用的是这条最小闭环能不能走通。

---

新手最容易踩的几个坑

1. 版本下对了，结果登录方式选得不合适

第一次上手最稳的还是 ChatGPT 账号登录。
API key 更适合后面做自动化和高级玩法。

2. 一上来就给太大权限

这是最常见的误区之一。

很多人会觉得，既然它很强，那就干脆把权限全给了。
问题来了，第一次你最需要的是建立信任边界，不是让它火力全开。

更稳的顺序是：

1. 只读
2. 工作区写入
3. 按需放开网络
4. 最后才考虑更高权限

3. 用生产项目做第一次试验

这个真不推荐。
不是 Codex 一定会乱来，而是你第一次还不熟悉它的节奏、审查方式和改动风格。先用测试项目磨合一下，后面你会轻松很多。

4. 把“能运行”误以为“已经配置好”

应用能打开，只能说明它装上了。
它能正常读项目、请求权限、改文件、展示差异、配合终端工作，才算真正进入“可用状态”。

5. Windows 下终端报错就以为客户端坏了

很多时候不是 Codex 坏了，而是 PowerShell 执行策略、Node.js 环境、npm 脚本权限或者终端选项没理顺。

别急着卸载重装。
先看报错信息，再回到终端环境和执行策略这条线上排查，往往更快。

---

第一次使用 Codex，建议从什么任务开始

如果你第一次就让它“重构整个仓库”，那体验很容易失控。
更好的做法是从小任务开始，像先让一个新同事看懂工位和文档，而不是第一天就让他接手整条产线。

适合新手的起手任务

• 解释项目目录结构
• 总结技术栈和启动方式
• 找出某段功能在哪个文件里
• 给函数补注释
• 修一个小 bug
• 做一个最小可见改动

暂时不建议一上来就做的事

• 全仓库大规模重构
• 自动执行大量脚本
• 在没看差异的情况下直接应用全部改动
• 给整个系统过大的访问权限

一个很稳的提问模板

请先阅读这个项目，告诉我它的结构、关键文件和运行方式。
在没有高置信度之前，不要做大范围修改。
如果需要改代码，请先说明计划，再执行最小改动。

这段话为什么好用？

因为它同时做了三件事：

• 先让它理解，再让它动手
• 先缩小范围，再逐步放开
• 先说计划，再看执行

说白了，这不是“限制 AI”，而是在建立合作节奏。

---

FAQ

OpenAI Codex Desktop 免费吗？

根据 OpenAI 当前的 Codex Pricing 页面，Codex 已经覆盖在多种 ChatGPT 计划里，包括 Plus、Pro、Business 和 Enterprise / Edu，不同计划的额度和能力范围不一样。是否需要额外购买额度，要看你具体使用的模型、功能和配额。

OpenAI Codex Desktop 支持 Linux 吗？

截至 2026 年 6 月 23 日，官方 Quickstart 页面给出的桌面安装入口主要是 macOS 和 Windows，Linux 仍然是通知登记状态。

第一次登录用 ChatGPT 账号还是 API key？

如果你是第一次体验，优先建议用 ChatGPT 账号。
因为官方说明里明确提到，使用 API key 登录时，部分功能可能不可用。

首发配置时权限应该怎么选？

第一次建议从保守配置开始：

• 先只给当前项目目录
• 先用只读或工作区写入
• 先不开公网访问
• 需要更高权限时再逐步放开

Windows 用户一定要用 WSL2 吗？

不一定。
官方文档说明，Codex 在 Windows 上支持 PowerShell，也支持 WSL2。你平时如果就是原生 Windows 开发，直接从 PowerShell 开始就可以。

---

结语

很多人第一次装这类 AI coding agent，心里都会有点拧巴。

一方面很期待，想看看它到底能干到什么程度。
另一方面也会担心，怕它乱动文件、权限太大、把项目搞乱。

这种感觉很正常。

本质上，Codex Desktop 不是一个“装完就完事”的工具，它更像一个新同事。
你要先给它安排工位，告诉它能进哪个房间、先看什么、先别碰什么。等这套节奏跑顺了，它才会从“看起来很厉害”，变成“真的好用”。

如果你只是想顺利完成第一次上手，记住这条最短路径就够了：

1. 从官方入口下载正确版本
2. 用 ChatGPT 账号登录
3. 先选一个测试项目
4. 用保守权限启动
5. 先做阅读和小改动验证
6. 用 Git checkpoint 保护现场

把这六步走稳，你后面再去玩更高级的能力，心里会踏实很多。

---

参考资料

• OpenAI Codex Quickstart
• OpenAI Codex App for Windows
• OpenAI Codex Permissions
• OpenAI Codex Pricing
• OpenAI Codex App Settings
• ChatGPT / Codex 官方下载页
• Codex 产品页