普通人也能装好Codex:从下载、登录到第一次成功运行

先看自己用的是什么电脑，只读对应的安装部分：

• Windows用户：继续往下看橙色「01｜Windows安装」
• Mac用户：直接找到蓝色「02｜macOS安装」
• Linux用户：桌面版暂不提供，直接看灰色「08｜可选进阶」里的CLI部分

后面Windows和Mac的安装步骤不同，但安装完成以后，都会回到同一个位置

第一步：打开官方下载页

打开：

https://developers.openai.com/codex/quickstart?setup=app

找到Windows下载按钮，下载安装程序。

OpenAI目前推荐Windows 11。保持更新的Windows 10也可能运行，但官方把它列为“尽力支持”，稳定性不如Windows 11。

第二步：运行安装程序

双击刚刚下载的安装程序，按照页面提示完成安装。

如果Windows弹出管理员确认窗口，先看清楚来源确实是你刚从OpenAI官方页面下载的程序，再确认继续。

不要为了“省一步”关闭Windows安全功能，也不要从其他网站重新找一个所谓免验证版本。

第三步：完成Windows沙盒设置

第一次运行时，Codex可能会设置Windows沙盒。点击设置即可。

（你可以把沙盒理解成一圈护栏：Codex可以在你选中的工作文件夹里做事，但默认不能随便改其他位置，也不能在没有允许的情况下访问网络。）

官方推荐使用安全性更强的elevated模式。设置过程中可能出现管理员权限提示，正常个人电脑可以按提示完成。

另外如果这是公司电脑，管理员策略可能不允许创建沙盒用户、调整防火墙或修改相关权限。这时候不要硬绕过去：

• 可以先使用Codex提供的unelevated备用模式；
• 长期使用前，最好找公司IT确认；

第四步：打开Codex

安装完成后，从开始菜单打开Codex。

能看到登录页面，就说明桌面程序已经装好了。

windows用户接下来请直接跳到：03｜软件装好了，先做三件事。

第一步：先看自己的Mac是什么芯片

点击屏幕左上角的苹果图标，选择“关于本机”。

然后看“芯片”或“处理器”这一行：

• 写着M1、M2、M3、M4等，选择Apple Silicon版本；
• 写着Intel，选择Intel版本。

下载错版本，最常见的结果就是打不开，或者系统提示不兼容。

第二步：从官方下载页选择对应版本

打开：

https://developers.openai.com/codex/quickstart?setup=app

页面会提供Apple Silicon和Intel两个Mac版本。按刚才查到的芯片选择，不要凭感觉下载。

第三步：安装到“应用程序”

下载完成后打开安装包，把Codex拖进“应用程序”文件夹。

然后从“应用程序”里打开Codex。

如果系统弹出安全提示，先确认安装包来自OpenAI官方页面，再按照macOS的正常提示处理。不要使用网上流传的命令去强行关闭系统安全检查。

能看到Codex登录页面，就说明安装已经完成。

接下来Windows和Mac的步骤一样。

先别急着让Codex整理桌面、处理工作资料。

第一次使用，我们把范围控制得小一点。这样每一步都能看明白，出现问题也容易退回来。

第一，创建一个空的练习文件夹

在桌面上直接新建一个文件夹，名字就叫：

Codex练习

后面第一次任务，只让Codex在这个文件夹里工作。

不要一上来选择整个桌面、“文档”文件夹或者整个硬盘。不是说它一定会乱改，而是第一次练习没有必要给这么大的范围。

第二，准备一个官方登录方式

Codex支持两种官方登录方式：

1. 使用ChatGPT账号登录；
2. 使用OpenAI Platform的API Key登录。

普通用户直接选择第一种ChatGPT登录就行，步骤更少，也不用自己处理API用量账单。

API Key适合已经在使用OpenAI API的人。它和ChatGPT订阅不是一回事，使用费用会按照API实际用量单独计算。

第三，先记住安全边界

重要文件先备份。

第一次只开放Codex练习文件夹，不要直接给整个电脑的访问范围。

如果页面申请的权限超出了当前任务，先不要确认。看不懂时宁可停一下，也不要一路点击允许。它不会催你，慢慢看。看完了在点击决策是否执行。

普通用户：优先选择ChatGPT登录

点击“使用ChatGPT登录”后，Codex会打开浏览器。

你在浏览器里完成官方登录，再返回Codex即可。

Codex能否使用哪些模型、可以使用多少次，会跟你的账号、套餐和当前页面显示的额度有关。

如果浏览器里已经登录了多个ChatGPT账号，注意确认自己选择的是准备使用Codex的那个账号。

API用户：也可以使用API Key

API Key需要从OpenAI官方后台创建：

https://platform.openai.com/api-keys

请注意三件事：

1. API Key不是ChatGPT密码；
2. API使用会单独计费；
3. 使用API Key登录时，一些依赖ChatGPT工作区或云端的功能可能不可用。
4. 普通用户建议就用ChatGPT账号登陆即可，不用选API登陆

登录完成后，Codex会让你选择一个项目文件夹。或者直接从桌面上把文件夹拖动到codex界面即可

找到我们刚刚创建的：

Codex练习

选择它。

如果页面里有Local和Cloud等工作位置，第一次请选择Local。

Local的意思是：Codex围绕你电脑上的这个文件夹工作。你能直接看到文件变化，也最容易检查它做了什么。

为什么不建议直接选桌面？

因为Codex会把你选择的文件夹当成工作范围。如果整个桌面里放着照片、合同、工作资料和其他文件，第一次练习就没有必要让这些内容进入它的上下文。

一个空的练习文件夹，够用了。

先不要急着让它做网站，也不要一上来就说“帮我优化整个电脑”。

第一条先测试它能不能正确看见当前文件夹。

把下面这段直接复制进去：

请先只读取当前文件夹，不要修改任何内容。告诉我这个文件夹里有哪些文件，以及你能在这里帮我做什么。

如果这是一个刚建好的空文件夹，它应该告诉你目前没有文件，或者内容为空。

接着发送第二条：

请在当前文件夹创建一个名为“测试说明.txt”的文件，写入三行内容：第一行“Codex安装成功”；第二行写当前日期；第三行“这是一份测试文件”。创建后告诉我文件位置，不要修改其他内容。

这一步可能会出现权限确认。

如果它申请的范围只是我们选中的Codex练习文件夹，可以允许。

任务完成后，打开这个文件夹，检查三件事：

1. 有没有出现测试说明.txt；
2. 文件里是不是三行指定内容；
3. 其他位置有没有被改动。

三项都对，恭喜你：

Codex已经安装成功，且已经可以正常使用了。

Codex目前提供三类常见权限范围，可以简单理解为：

只读

它可以查看和分析，但不能修改文件。

适合让它解释项目、检查问题、阅读资料。

工作区

它可以在你选中的项目文件夹里写入和修改。

这是普通用户最常用、也最建议默认选择的范围。

完全访问

它不再只受当前工作区限制，能接触更广的本地范围。

这不是“效果更好”的按钮，而是“权限更大”的按钮。只有你明确知道为什么需要时再开。

第一次使用，记住一句话就够了：

能用工作区完成，就先不要给完全访问，等你熟悉了这个软件之后再自行决定。

如果你已经成功创建测试说明.txt，前面的教程就完成了。

接下来是CLI和IDE扩展，主要给以后想把Codex放进终端或代码编辑器的人。

我们继续

IDE扩展：想在编辑器里用再装

Codex提供VS Code、Cursor和Windsurf等编辑器入口。

官方快速入门页里可以找到对应扩展：

https://developers.openai.com/codex/quickstart?setup=ide

安装后，编辑器侧边栏会出现Codex入口。登录方式与桌面版类似。

如果你平时根本不用这些编辑器，这一段直接跳过。

CLI：喜欢终端或者使用Linux再装

CLI就是终端版本的Codex。

macOS和Linux官方安装命令：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows PowerShell官方安装命令：

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

安装后关闭并重新打开终端，再运行：

codex

检查版本：

codex --version

排查本地安装、登录和运行环境问题：

codex doctor

Linux目前没有Codex桌面App，可以使用CLI，或者直接使用网页版：

https://chatgpt.com/codex

1. Mac安装后打不开

先确认有没有下载错芯片版本。M系列芯片用Apple Silicon，老款Intel Mac用Intel。

再确认安装包是否来自OpenAI官方下载页。

2. Windows安装时沙盒失败

先重启Codex，再尝试完成管理员确认。最好是以管理员身份运行软件。

如果在公司，电脑如果被策略阻止，不要自己关闭安全软件。可以暂时选择unelevated模式，并联系IT处理。

3. 登录后没有自动回到Codex

先回到Codex窗口看是否已经完成登录。

仍然没有时，退出Codex后重新打开，再走一次登录流程。检查浏览器是否拦截了本地回调页面。

4. API Key不能用

确认Key来自OpenAI Platform，而不是把ChatGPT密码填了进去。

再检查API账户是否具备可用额度。不要把完整Key贴到聊天、截图或报错帖子里。

5. 它看不到文件，或者无法修改

确认你选中的是正确文件夹。

如果当前是只读权限，它本来就不能写文件。需要修改时切换到工作区权限，不必直接开完全访问。

6. CLI提示找不到codex

关闭终端后重新打开，再运行codex --version。

如果仍然找不到，重新运行对应系统的官方安装命令。

7. 网络一直失败

先确认浏览器能正常打开OpenAI等官方文档和登录页面。然后在打开codex。你懂的。

Codex最容易劝退普通人的，往往不是它真的有多难，而是教程一上来就塞满命令、环境变量和专业词。

但如果目标只是先用起来，桌面版已经把最难的那部分藏到了后面。

下载安装、登录、选一个安全的练习文件夹，再让它创建第一份测试文件。

做到这里，你就已经跨过了真正的门槛。

CLI、IDE、自动化、插件当然有用，但它们不是入场券。先把桌面版用顺，再决定要不要继续往深处走。

官方资料

1. OpenAI Codex Quickstart

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

1. OpenAI Codex Windows Guide

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

1. OpenAI Codex Authentication

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

1. OpenAI Codex Permissions

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

1. OpenAI Codex Pricing and Feature Availability

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

资料时间：2026-07-03。Codex仍在持续更新，下载入口、界面名称和功能范围以后可能变化，请以OpenAI官方页面为准。

本文只提供软件安装和使用说明，不构成任何其他建议。

我是小豆，一个小人物的AI产业观察笔记。 这里没有标准答案，只有沉淀和思考。