Codex 桌面版安装教程：macOS 与 Windows 下载、登录和首次配置（2026）
更新时间：2026 年 8 月。Codex 桌面版的系统支持、登录方式和功能会持续更新，实际可用版本请以 OpenAI 官方下载页显示的内容为准。
OpenAI Codex 是面向软件开发的 AI 编程代理，可以阅读项目文件、修改代码、运行命令并解释变更。很多新用户搜索“Codex 桌面版安装”时，容易把桌面应用、命令行工具（CLI）和编辑器扩展混为一谈。本文只讲官方桌面应用的安装，同时说明何时应该改用 CLI。
一、安装前需要准备什么？
1. 确认系统与硬件
先打开 OpenAI 官方 Codex 页面（https://openai.com/codex/）或产品下载页（https://chatgpt.com/codex），查看当前提供的安装包。下载页显示哪个平台，就代表哪个平台已经得到官方支持；不要从搜索结果中的“破解版”“绿色版”下载。
- macOS：保持系统更新，并预留足够磁盘空间用于应用和项目依赖。
- Windows：优先使用受支持的 64 位版本；若页面提供 Windows 安装包，按页面说明安装。
- Linux：如果没有桌面安装包，可使用官方 Codex CLI，在终端中完成同样的代码代理工作。
还需要一个可正常登录 ChatGPT 的 OpenAI 账号。Codex 的可用模型、任务额度和团队权限取决于账号订阅及组织策略，安装成功不等于自动获得全部功能。
2. 安装前的安全检查
只认 openai.com、chatgpt.com 和下载页跳转出的官方域名。下载后检查文件签名和发布者名称；如果安装器要求关闭系统安全软件、索要账号密码或让你粘贴陌生脚本，请立即停止。不要把 API Key、SSH 私钥、生产数据库密码放进项目目录或提示词中。
二、Codex 桌面版官方下载与安装
macOS 安装步骤
- 打开 Codex 官方页面，点击下载按钮，获取适用于 macOS 的安装包。
- 下载完成后打开安装包，将 Codex 拖入 Applications（应用程序） 文件夹。
- 从“应用程序”启动 Codex。首次启动若出现“无法验证开发者”，不要绕过安全设置安装未知版本；先重新从官方页面下载，或在“系统设置 → 隐私与安全性”确认应用开发者为 OpenAI 后再允许打开。
- 选择 Sign in with ChatGPT，浏览器会打开 OpenAI 登录页。完成登录并授权后，回到 Codex 应用。
Windows 安装步骤
- 在同一官方页面选择 Windows 下载（如果当前页面尚未提供 Windows 桌面包，则使用 Codex CLI 或等待官方发布）。
- 运行下载的安装程序，选择安装范围和快捷方式位置，按向导完成安装。
- 启动 Codex，点击 Sign in with ChatGPT，在浏览器完成登录和授权。
- 如果 Windows Defender 弹出提示，先核对安装包来源和数字签名，再决定是否允许；不要为了启动未知安装包而关闭 Defender。
三、首次启动：连接项目并设置权限
登录后，Codex 通常会要求选择一个工作区或项目目录。建议先打开一个非生产项目，确认它的 Git 工作区干净，再进行以下设置：
- 选择项目目录：只授予当前项目所需的文件访问范围。
- 阅读权限提示：涉及写文件、安装依赖、执行终端命令或联网时，优先选择逐次确认。对删除文件、修改数据库、发布代码等高风险操作保持手动批准。
- 检查版本控制：让 Codex 先查看
git status和项目测试命令；每次任务结束都审阅 diff，再自行提交代码。 - 设置语言与模型：在设置中选择中文界面（若版本提供）以及适合任务的模型。模型列表和额度会随账号计划变化。
一个适合首次测试的提示词是：
请先阅读项目结构，不要修改文件；告诉我启动命令、测试命令，以及你认为最重要的三个入口文件。
这样可以验证登录、项目读取和终端检测是否正常，又不会立即产生代码变更。
四、桌面版与 Codex CLI 怎么选？
桌面版适合希望可视化查看任务、diff、审批记录的用户；CLI 更适合远程服务器、脚本化流程和没有桌面包的平台。CLI 的官方说明可参考 OpenAI Codex 文档。两者使用同一类账号能力，但配置文件、权限提示和可用功能可能不完全一致，遇到问题时应按对应版本文档操作。
五、常见安装与登录问题
下载按钮找不到
官方可能按地区、系统或灰度批次展示不同下载选项。刷新官方页面、确认系统版本，并查看页面是否明确标注“桌面版”；不要用第三方网盘包代替官方安装器。
浏览器登录后应用没有反应
关闭重复打开的登录窗口，回到 Codex 再次点击登录；检查默认浏览器是否拦截了回调，并暂时关闭会阻止跨站跳转的扩展。仍然失败时，退出应用后重新启动，不要把登录回调链接发给他人。
项目无法读取或命令执行失败
检查是否选择了正确目录、是否被系统权限拦截，以及项目依赖是否已经安装。macOS 可能需要在“隐私与安全性”中授予终端或应用必要权限；Windows 则要检查 Defender、代理和 PowerShell 执行策略。先运行一个只读命令，再逐步扩大权限。
如何更新或卸载？
优先使用应用内的更新提示，或从官方页面重新下载最新版覆盖安装。macOS 可将 Codex 移到废纸篓，Windows 可在“设置 → 应用 → 已安装的应用”中卸载。卸载应用通常不会删除项目代码，但请先备份需要保留的本地配置，并确认没有未提交的改动。
六、安全使用清单
- 在
.gitignore中排除.env、密钥和个人凭据，并在 Codex 中关闭不必要的敏感目录访问。 - 让代理先解释计划，再允许写文件或运行命令。
- 对依赖安装、网络请求、删除操作和部署操作逐项确认。
- 运行测试、检查
git diff，确认没有泄露密钥或引入破坏性变更后再提交。 - 遇到异常安装包、索要验证码或要求转账的页面，立即回到官方入口核验。
七、快速回顾
Codex 桌面版的正确流程是：从 OpenAI 官方页面下载 → 校验安装包 → 安装并用 ChatGPT 登录 → 打开非生产项目 → 采用逐次审批权限 → 用只读提示词完成首次测试。若系统没有官方桌面包，使用官方 Codex CLI 是更稳妥的替代方案。