Codex 安装教程：Mac、Windows 与桌面客户端快速上手
Codex 安装专题入口，按普通用户的使用路径整理桌面客户端下载、Mac 与 Windows 安装、登录和第一次对话任务。
如果你的目标是用 Codex 对话、整理项目、制作网页或完成代码修改，最短路径不是先研究命令行，而是先安装官方桌面客户端。打开客户端、登录账号、选择项目，再用中文说清楚目标，就可以开始第一个任务。
普通用户先走“桌面客户端”路线；只有需要批量执行命令、运行测试或接入脚本时，再继续学习 CLI。
TL;DR：Codex 安装的最短流程
- 打开 OpenAI 官方 Codex 页面，进入对应的下载入口。
- 根据电脑系统安装 GPT 桌面客户端，打开后登录账号。
- 在客户端中进入 Codex，选择项目文件夹或新建工作目录。
- 先发一条只读任务，让 Codex 说明项目结构和准备修改的文件。
- 确认计划后，再让它完成一个范围小、容易验证的任务。
安装前先选对使用方式
桌面客户端适合不熟悉终端、希望通过对话完成项目的人。你可以让 Codex 解释文件、生成页面、排查报错、整理资料或一步步提示操作。CLI 更适合开发者和站长：它方便进入项目目录、运行测试、批量处理文件，并接入已有脚本。
| 你的目标 | 推荐入口 | 是否需要先学命令行 | | :--- | :--- | :--- | | 对话完成一个网页或小工具 | GPT 桌面客户端 | 不需要 | | 让 Codex 阅读本地项目并修改文件 | GPT 桌面客户端 | 不需要 | | 批量运行测试、处理多个目录 | Codex CLI | 需要基本终端知识 | | 接入自动化脚本或持续集成 | Codex CLI 与项目配置 | 需要 |
本文先覆盖桌面客户端的安装和首次使用。需要命令行时，可以继续阅读 Codex CLI 登录与认证教程 和 Codex Windows 安装教程。
Mac 安装 Codex：下载客户端后直接开始对话
第一步：确认 Mac 系统和网络
先点击左上角苹果菜单，打开“关于本机”，记下当前 macOS 版本和芯片类型。OpenAI 的下载页面会根据设备情况显示可用的桌面客户端入口；具体系统要求和下载方式以官方页面当前显示为准。
如果官方页面加载慢、下载按钮不出现或安装包下载中断，先确认浏览器能够正常打开 OpenAI 官方页面，再换一个稳定网络重试。不要为了省一步而从不明网盘、论坛附件或来历不清的安装包下载客户端。
第二步：从 OpenAI 官方页面下载
打开 OpenAI Codex 官方页面，找到桌面客户端入口，下载适用于 Mac 的安装包。下载完成后，双击安装文件，并按系统提示将应用放入“应用程序”文件夹。
首次打开时，如果 macOS 提示确认应用来源，请先确认安装包来自 OpenAI 官方页面，再继续打开。不要在第三方页面输入账号密码、验证码或 API Key。
第三步：登录并找到 Codex
打开应用后，使用自己的 GPT 账号登录。不同版本的导航名称可能会调整，登录后重点寻找带有 Codex 的工作入口或新建任务入口。看到项目选择界面时，可以先选择一个没有重要资料的测试项目。
如果没有看到 Codex，按这个顺序检查：
- 更新桌面客户端并重新打开。
- 确认登录的是有权使用当前功能的账号。
- 退出账号后重新登录，观察工作区和新建任务入口。
- 打开 OpenAI Developers 的 Codex 资料，核对当前版本的使用说明。
第四步：用中文发送第一条任务
第一次不要直接要求它修改整个项目。先复制下面这段话，让 Codex 只读了解项目：
请先读取当前项目的目录结构和入口文件，用中文说明：
1. 这个项目解决什么问题；
2. 启动、测试和构建分别使用什么命令；
3. 如果我要修改首页，最可能涉及哪些文件。
暂时不要修改文件、删除文件或执行联网命令。
等它说明完，再提出一个小任务，例如“请只修改首页标题，并告诉我修改了哪些文件，完成后给出验证方法”。每一步都先看计划和变更，再决定是否确认。
Windows 安装 Codex：从桌面客户端开始
第一步：打开官方 Windows 下载入口
Windows 用户同样建议先走 GPT 桌面客户端路线。打开 OpenAI Codex 官方页面，按页面提示进入 Windows 下载或安装入口。官方页面显示的入口、安装方式和系统要求可能随版本更新，实际操作时以当前页面为准。
如果你看到的是 Microsoft Store 入口，优先从官方页面进入商店，而不是直接搜索相似名称的第三方应用。安装完成后，从开始菜单打开 GPT 客户端并完成登录。
第二步：登录并选择项目
登录后进入 Codex，选择一个项目文件夹。第一次建议使用练习项目或副本，不要马上打开包含生产密钥、支付信息、客户隐私或未备份文件的目录。
如果 Windows 弹出文件访问、网络或安全确认，请先读清楚提示内容，再决定是否允许。Codex 是否可以读取、修改或运行某个动作，取决于当前项目权限和客户端给出的确认选项。
第三步：完成一个可验证的小任务
可以让 Codex 完成以下任一项：解释一个文件、补充一个简单测试、修改一段文案、修复一个明确的界面问题，或生成一份项目说明。任务要同时写清楚范围和验收方式：
请只检查当前项目的首页文件，不要修改其他目录。
先说明首页入口、依赖和当前运行方式，再提出一个最小修改方案。
如果需要执行命令，请先列出命令和用途，等待我确认后再执行。
完成后告诉我修改了哪些文件，以及我应该如何验证结果。
需要 CLI 时再安装命令行版
只有当你需要从 PowerShell 进入项目、运行测试或批量处理文件时，才继续看 Windows 安装 Codex CLI 的完整步骤。命令行环境中常见的基础检查如下：
node --version
npm --version
Get-Location
不要把桌面客户端和 CLI 的登录凭证、配置文件、代理设置混在一起。遇到认证或网络问题时，可以参考 Codex 网络连接排错，先确认错误发生在登录、下载还是项目访问阶段。
安装完成后，第一次任务这样做更稳
无论是 Mac 还是 Windows，第一次使用都建议遵循“了解、计划、修改、验证”的顺序：
- 了解：让 Codex 读取目录结构、入口文件和已有测试，不要一上来就让它全项目重构。
- 计划：要求它列出准备修改的文件、实现步骤、潜在风险和验证命令。
- 修改：把任务拆小，限制目录范围，涉及删除、覆盖、发布和联网动作时逐项确认。
- 验证：检查文件变更，运行项目原有测试或构建命令，再用浏览器或实际操作确认结果。
如果项目需要长期协作，可以补充一个 AGENTS.md 项目规则文件，把目录边界、命令、测试和验收标准写清楚。这样 Codex 每次进入项目时，都更容易遵循同一套工作方式。
常见安装问题与解决方法
| 现象 | 常见原因 | 建议处理 | | :--- | :--- | :--- | | 找不到官方下载入口 | 官方页面加载不完整或入口随版本调整 | 直接从 OpenAI Codex 官方页面进入，刷新后重新查看对应系统入口 | | 安装完成但看不到 Codex | 客户端版本、登录账号或功能入口不同 | 更新客户端、重新登录，并以当前账号实际显示的页面为准 | | 下载过程中断 | 网络不稳定、浏览器缓存或安全软件拦截 | 更换稳定网络后重试，确认下载来源仍是官方页面 | | 客户端无法读取项目 | 没有选择项目目录或当前目录权限不足 | 先选择项目文件夹，使用副本测试，不要直接开放敏感目录 | | Codex 修改后不知道是否正确 | 任务范围太大，缺少验证方式 | 先看计划和文件变更，再运行原有测试并逐项验收 | | 想运行命令但不熟悉终端 | 直接进入了 CLI 路线 | 回到桌面客户端，用中文描述任务；需要批处理时再看 CLI 教程 |
常见问题解答
普通用户安装 Codex 需要先安装 Node.js 吗？
不需要。普通用户先安装 GPT 桌面客户端，登录后在 Codex 中通过对话完成任务即可。只有准备使用 CLI、批量运行命令或接入脚本时，才需要单独准备命令行环境。
Mac 和 Windows 都能使用 Codex 桌面客户端吗？
官方当前提供面向 macOS 和 Windows 的桌面客户端入口，但可用功能和界面会随版本、账号和地区变化。安装时以 OpenAI 官方页面和登录后实际显示的功能为准。
不会写代码，可以让 Codex 帮我做项目吗？
可以。先让它解释项目和列出步骤，再从一个小范围任务开始。你需要自己确认文件变更、运行结果和权限提示，不能只根据“已完成”三个字判断任务已经验证成功。
为什么建议第一次使用测试项目？
测试项目可以让你熟悉权限确认、文件变更、命令执行和回滚方式。确认流程稳定后，再把同样的方法用于重要项目，并先完成备份或 Git 提交。
什么时候需要学习 Codex CLI？
当你需要在终端中进入项目、运行测试、处理多目录文件、接入脚本或自动化流程时，CLI 更合适。只想通过对话完成网页、小工具和资料整理时，桌面客户端已经足够作为起点。
继续阅读
安装完成后，可以继续查看 Codex 第一次任务教程，了解如何从只读分析过渡到安全修改；如果遇到中文界面问题，可阅读 Codex 设置中文教程；需要了解不同工具的使用边界，再看 Codex 与 Cursor 的对比。
本文中的下载入口、产品名称和功能说明以 OpenAI Codex 官方页面 与 OpenAI Developers Codex 资料 为参考。官方页面、客户端版本、账号权限和系统要求可能变化，安装前请以官方最新信息为准。