Appearance
00 账号与安装
你会学到：先确认账号能不能用，再按自己的电脑和使用习惯选择 Codex App、CLI、IDE 或 Web。不要急着复制命令。
先做这个
先完成这四件事，再进入后面的教程。
1. 登录账号打开 chatgpt.com，确认你能登录自己的 ChatGPT / OpenAI 账号。
2. 选入口新手优先选 Codex App；会终端再选 CLI；用编辑器就选 IDE；做远程仓库任务再选 Web。
3. 找官方下载页只用 OpenAI 官方文档、ChatGPT 下载页、Microsoft Store、VS Code Marketplace 等官方或平台页面。
4. 选练习目录先用 README、文档项目或 demo，别上来就打开生产项目、密钥目录、客户资料。
小白最重要的一句话 这页不是让你把所有入口都装一遍。你只需要选一个能安全开始的入口，完成第一个低风险任务。
官方入口一览
更新时间：2026-06-03。下面这些链接来自 OpenAI 官方文档或官方下载页；价格、套餐、地区可用性和权益仍要以打开页面时看到的最新信息为准。
| 你要做什么 | 推荐入口 | 官方页面 | 适合谁 |
|---|---|---|---|
| 本地项目第一次上手 | Codex App | Codex App 文档、ChatGPT 下载页的 Download Codex | 想看文件、看 diff、看任务过程的新手 |
| Windows 上安装 App | Codex App for Windows | Windows 文档、Microsoft Store 下载页 | Windows 用户 |
| 在终端里用 | Codex CLI | Codex CLI 文档 | 已经熟悉命令行的人 |
| 在 VS Code / Cursor / Windsurf / JetBrains 里用 | Codex IDE extension | IDE Extension 文档 | 已经习惯编辑器的人 |
| 让 Codex 在云端处理仓库任务 | Codex Web / Cloud | Codex Web 文档、Codex Web 入口 | 有 GitHub 仓库、PR、Issue 的人 |
先确认账号
打开 chatgpt.com，确认三件事：
- 你能登录。
- 你知道自己登录的是哪个账号。
- 你知道这个账号是否能访问 Codex。
截至 2026-06-03，OpenAI 的 Codex App、CLI、IDE 和 Web 文档都把 Codex 写在 ChatGPT Plus、Pro、Business、Edu、Enterprise 等计划说明里。这个信息和价格、地区、组织策略有关，阅读时请重新打开官方页面核对。
如果你在团队、学校或公司账号里使用 Codex，还要确认：
- 管理员是否允许使用 Codex。
- 是否需要连接 GitHub 或本地项目。
- 是否有组织策略限制网络访问、仓库访问、插件或扩展安装。
如果页面提示不能用，不要急着换安装方式。先检查：
- 你是不是登录错账号。
- 当前账号是不是组织账号，组织管理员是否关闭了 Codex。
- 你所在地区、套餐或工作区是否支持当前入口。
- 你是否需要先完成 ChatGPT / OpenAI 的账号验证。
不要把账号信息写进教程 截图里不要出现邮箱、手机号、账单、组织名、API Key、Cookie、token。对外分享图片时尤其要检查。
选哪条安装路线
路线 A：Codex App
如果你不知道选什么，就先选 Codex App。它是桌面端入口，适合小白看清楚项目、线程、改动和结果。
官方来源：
- Codex App 文档
- ChatGPT 下载页 里的
Download Codex
macOS 怎么选：
- 打开 ChatGPT 下载页。
- 找到
Download Codex。 - 如果你的 Mac 是 Apple Silicon，选 macOS 对应下载；如果是 Intel Mac，按 Codex App 文档 里的说明选择 Intel 构建。
- 不确定芯片时，点左上角苹果菜单，打开
About This Mac，看Chip或Processor。
Windows 怎么选：
- 打开 Codex App Windows 文档。
- 文档会指向 Microsoft Store 下载。
- 也可以在 Windows 的 Microsoft Store 里搜索
Codex，确认发布者和页面来自官方来源。 - 如果你偏命令行，Windows 文档也给出 Microsoft Store 的
winget安装方式。
安装后做什么：
- 打开 Codex。
- 使用 ChatGPT 账号或 OpenAI API key 登录。
- 选择一个低风险项目文件夹。
- 确认模式是让 Codex 在你的本机项目里工作。
- 第一条消息只让它阅读或总结，不要先让它大改项目。
推荐第一条消息：
text
请只阅读当前项目，不要修改文件。
请用小白能听懂的话说明这个项目是做什么的，并列出你认为适合新手尝试的 3 个低风险任务。完成标准：
- 你能打开 Codex App。
- 你能登录。
- 你能选择项目目录。
- 你知道在哪里看 Codex 产生的改动。
路线 B：Codex CLI
CLI 是终端入口。它适合已经知道 cd、当前目录、命令输出、文件权限是什么意思的人。
官方来源：
macOS / Linux 官方安装命令：
bash
curl -fsSL https://chatgpt.com/codex/install.sh | sh运行命令：
bash
codex第一次运行时，Codex 会要求你登录，可以用 ChatGPT 账号或 API key。
Windows 注意：
- Codex CLI 官方文档说明 CLI 可用于 macOS、Windows 和 Linux。
- Windows 用户可以在 PowerShell 中原生运行，也可以在需要 Linux 环境时使用 WSL2。
- Windows 的详细设置以 Windows setup guide 和 CLI 文档里的当前说明为准。
小白使用 CLI 前，先确认当前目录：
bash
pwd如果你不知道输出的路径是不是安全目录，先停下，不要继续运行 Codex。
完成标准：
- 你知道安装命令来自 Codex CLI 文档。
- 你知道自己在哪个目录里运行
codex。 - 你能说清楚 Codex 可能读写哪些文件。
路线 C：Codex IDE Extension
如果你每天都在 VS Code、Cursor、Windsurf 或 JetBrains IDE 里写代码，可以用 IDE 扩展。
官方来源：
怎么做：
- 打开 Codex IDE Extension 文档。
- 按你的编辑器选择下载入口。
- 安装后重启编辑器。
- 在侧边栏找到 Codex。
- 登录账号。
完成标准：
- 你能在编辑器侧边栏看到 Codex。
- 你知道 Codex 当前能看到哪些打开的文件和项目上下文。
- 你知道怎样关闭、撤回或检查它的改动。
路线 D：Codex Web / Cloud
如果你要让 Codex 处理 GitHub 仓库、PR、Issue 或远程任务，再考虑 Web / Cloud。
官方来源：
怎么做：
- 打开 chatgpt.com/codex。
- 按页面提示连接 GitHub。
- 选择仓库前，确认这是你有权限操作的仓库。
- 第一个任务只做小范围文档修改或问题排查，不要直接要求它部署、删库、改认证或改账单。
完成标准：
- 你知道 Codex 会访问哪个 GitHub 账号或组织。
- 你知道它会在哪个仓库、哪个分支工作。
- 你知道 PR 或 diff 在哪里看。
不确定时怎么选
| 你的情况 | 选这个 | 不要先做什么 |
|---|---|---|
| 只是想学，不想折腾 | Codex App | 不要同时装 CLI、IDE、Cloud |
| 已经会终端 | Codex CLI | 不要在生产目录里直接试 |
| 每天都用 VS Code / Cursor | IDE Extension | 不要让它自动改很多文件 |
| 任务来自 GitHub | Codex Web / Cloud | 不要跳过仓库权限检查 |
安全练习目录
适合：
- README 或文档项目。
- 自己的非隐私资料目录。
- 没有生产部署、密钥、客户资料的 demo 项目。
不适合：
- 生产项目。
- 账单、认证、权限、数据库迁移相关项目。
- 含客户截图、账号、Cookie、token、API Key 的资料目录。
下一步
完成账号和安装检查后，再进入：
完成标准
- 你知道自己能登录哪个账号。
- 你知道自己应该走 App、CLI、IDE 还是 Web / Cloud。
- 你打开过至少一个官方来源页面。
- 你没有从第三方网盘或群文件下载安装包。
- 你选好了一个低风险练习目录。
来源与复核
- 官方来源：Codex App、Codex App Windows、Codex CLI、Codex IDE Extension、Codex Web、ChatGPT 下载页。
- 整理依据：公开教程、项目学习笔记和本站实操验证。
- 需要持续复核：账号权限、价格、额度、模型、入口名称、安装命令、平台可用性。