ARTICLE · 1096069
Codex 从0到1保姆级教程:从安装到第一个项目跑通(2026最新版)
01 Codex 到底是什么？
02 Codex 有好几个入口，新手该选哪个？
桌面版最适合第一次使用 Codex 的人。可以直接选择本地项目，看文件改动和执行过程，不要求你先会一堆终端命令。 CLI 是命令行版本。如果你平时已经习惯 Git、npm、Python、Docker，这个入口反而更顺手。 IDE 扩展适合本来就在 VS Code、Cursor 等编辑器里写代码的人，不需要在编辑器和 Codex 之间来回切。 Web/Cloud 更偏把任务交给云端 Codex 执行，适合仓库已经在 GitHub、或者需要远程处理任务的场景。
03 普通用户怎么安装？直接下载安装包
npm install -g @openai/codex
打开新版ChatGPT 桌面端后，你会看到两个主要入口：ChatGPT 和 Codex。
如果你只是聊天、查资料、写内容，用 ChatGPT 就行；如果你想让 AI 直接打开本地项目、读取和修改代码、运行命令，就切到 Codex。
简单理解：ChatGPT 是“和 AI 聊”，Codex 是“让 AI 直接进项目干活”。
04 第一次打开 Codex，先认识几个地方
按钮放在哪儿以后可能会变，所以不用死记位置。你只需要先弄明白三个概念：Workspace、Model、Permissions。
1. Workspace：Codex 在哪个项目里工作
可以把 Workspace 理解成 Codex 当前的“工作区”。
比如我们创建一个：codex-todo，然后把这个文件夹交给 Codex，它后面的读文件、改代码、创建文件，大多数操作都会围绕这个目录进行。
所以新手最好养成一个习惯：一个项目建一个或N个单独文件夹。
不要一上来就把整个桌面、下载目录，甚至整个用户目录交给 Codex。范围越小，你越容易看清它改了什么，真出问题也更好处理。
2. Model：这次让哪个模型来干活
Model 就是选择当前使用的 AI 模型。不同模型在速度、能力、推理深度上可能会有区别，但第一次使用完全不用纠结：保持默认就行。
等以后你开始做复杂重构、难 Debug 或长时间任务，再研究不同模型怎么选。
3. Permissions：Codex 能做到什么程度
这个比 Model 更值得新手认真看，你会看到：
- Ask for approval：需要额外权限时，Codex 会先停下来问你
- Approve for me：部分操作可以自动审核，少一些确认弹窗
- Full access：限制更少，Codex 可以访问和执行更多内容、
这里最重要的一句话是：Full Access 不会让 Codex 更聪明，只会让它权限更大。
所以第一次使用，不建议急着把权限全部打开。先保留需要确认的模式，熟悉 Codex 会做哪些操作以后，再决定要不要放宽权限。
如果只想记住一句话，可以这样理解：
Workspace 决定它在哪儿干活，Model 决定谁来干，Permissions 决定它能干到什么程度。
05 先创建一个干净的项目目录
在正式开始，我们先做一个最简单的 Todo List。
Mac 用户打开 Finder，Windows 用户打开“文件资源管理器”，在自己方便找到的位置新建一个文件夹，名字就叫：codex-todo
接着回到 Codex，把这个 codex-todo 文件夹打开。
如果系统第一次弹出“是否允许访问这个文件夹”的提示，正常选择允许即可。因为后面 Codex 需要在这里创建和修改项目文件。
你可以把这个文件夹理解成 Codex 的“工作区”。
把 codex-todo 交给 Codex，相当于只给它这一间办公室，而不是把整台电脑都开放给它。
这也是为什么新手最好养成一个习惯：一个项目，一个/N个单独文件夹。
这样 Codex 后面创建了哪些文件、改了什么内容，你都能看得更清楚；真出问题了，也更容易定位和处理。
06 第一条 Prompt，别写“帮我做个网站”
现在可以把第一个任务交给 Codex 了。很多人第一次用 Coding Agent，会直接输入“帮我做一个网站”，但这种需求太宽泛：做什么网站、用什么技术、需不需要框架、什么状态才算完成，都没有说清楚，最后只能让 Codex 自己猜。
第一次练习，建议直接用一个简单、边界明确的 Prompt：
请在当前项目目录创建一个简单的 Todo Web 应用。使用原生 HTML、CSS 和 JavaScript，不使用 React、Vue 等框架，也不要安装第三方依赖。页面需要支持添加 Todo、标记完成、删除 Todo，并使用 localStorage 保存数据，刷新页面后内容不能丢失。只修改当前项目目录，页面保持简单、清爽。完成后检查代码，并告诉我如何运行和验证。
这段 Prompt 不复杂，但已经把几件关键事情说清楚了：要做什么、用什么方式做、哪些内容不要碰，以及什么结果才算完成。
对 Codex 来说，提示词并不是越长越好。OpenAI 近期也专门提醒，过度膨胀的 Prompt、AGENTS.md 和 Skill 指令可能增加不必要的上下文负担。真正重要的是：把任务边界和完成标准说清楚。
07 第一次看着 Codex 真正在项目里干活
codex-todo/├── index.html├── style.css└── app.js
这也是 Codex 和普通聊天式 AI 很不一样的地方。以前让 ChatGPT 写一个 Todo，通常是它把代码发给你，再由你自己新建文件、复制粘贴；而 Codex 会直接把文件创建到项目目录里。
所以接下来你真正需要关注的，不再是“这段代码该复制到哪里”，而是这些文件生成后，项目能不能正常运行，功能是不是符合要求。这也是 Coding Agent 更接近真实开发流程的地方。
08 第一个项目怎么真正跑起来？
这里我故意没有选 React、Next.js，就是想让第一次使用 Codex 的人少碰一点环境问题。像 npm install、node_modules、Node.js 版本这些，对新手来说很容易先把人卡住。
我们现在做的是一个最简单的原生 HTML 项目，所以运行也很直接。打开刚才的 codex-todo 文件夹，找到 index.html，双击后就会用 Chrome、Edge、Safari 或默认浏览器打开。
页面出来以后，别只看一眼就算了，最好自己完整试一遍：添加一条“学习 Codex”，标记完成，再删除一条；然后重新添加一条 Todo，刷新页面。如果刷新后内容还在，说明 localStorage 保存也正常。
做到这里，这个项目才算真正跑通。
不是 Codex 回复一句 “Done” 就算完成，而是你自己实际操作过，功能确实能用，才算完成。
09 如果 Codex 弹出“需要权限”，应该怎么办？
这块可能有点抽象了。第一次使用 Codex 时，遇到权限弹窗不用紧张，这通常不是报错，而是在确认某个操作能不能执行。毕竟 Codex 不只是聊天，它还会修改文件、运行命令，必要时也可能访问网络，所以有些动作需要你先点确认。
如何选择其实也不复杂：如果它只是创建 index.html、修改 style.css，或者运行当前项目的测试，这些都和任务直接相关，一般可以正常放行；但如果它突然要删除大量文件、修改系统设置、访问项目之外的目录，或者执行一条你完全看不懂的命令，就别急着点“允许”。可以直接问它：“为什么需要这个操作？不执行会有什么影响？有没有权限更小的做法？”
Codex 的权限本质上可以理解成两层：Sandbox 决定它能操作到哪里，Approval 决定哪些操作必须先问你。 比如 workspace-write + on-request，可以简单理解为：Codex 能在当前项目里正常读写和运行常规命令，但一旦想突破这个范围，就需要你确认。
对新手来说，这种方式通常比直接开 Full Access 更稳妥。
10 项目生成以后，别急着结束
Todo 页面能正常打开后，先别急着结束。可以再让 Codex 做一次完整检查，例如：
请重新检查刚才创建的项目，重点验证添加 Todo、完成状态、删除和 localStorage 保存是否正常。如果发现明显错误、重复代码或无用代码，可以直接修复。最后告诉我检查了哪些内容，以及我应该怎么手动验证。
这一步很重要。真正用 Codex 做开发时，生成代码只是开始，验证结果才决定任务是否真的完成。在真实项目里，通常还会让它继续运行：
npm run lintnpm testnpm run build
只要其中一步失败，就继续修，直到验证通过。
所以以后看到 Codex 回复“已完成”，最好顺手再问一句：“你是怎么验证的？”
对 Coding Agent 来说，这个习惯往往比很多复杂的 Prompt 技巧更实用。
11 再改一次，你就理解 Codex 真正好用在哪里了
接下来可以继续给 Codex 加一个小需求：
在现有 Todo 页面增加“全部、未完成、已完成”三个筛选按钮，保持现在的页面风格，不要重构无关代码。修改完成后，再检查添加、完成、删除和刷新保存功能是否正常。
这一轮和刚才不一样。前面是让 Codex 从零创建项目，现在则是让它先读取已有的 HTML、CSS 和 JavaScript，再在原来的基础上继续修改。
刷新浏览器后，如果三个筛选按钮已经出现，而且原来的功能也都正常，就说明 Codex 不只是会“生成一段代码”，还可以持续理解同一个项目，并在现有代码上继续开发。
12 这个时候，再学习 AGENTS.md
很多教程一上来就讲 AGENTS.md，但我更建议先把第一个项目跑通，再回来理解它。这样你会更容易明白它到底解决什么问题。
在 Codex 里输入：
/init该命令可以为当前项目快速生成 AGENTS.md。你可以把它理解成一份写给 Codex 的项目说明书，专门放那些长期都要遵守的规则。
比如这个 Todo 项目，可以写成：
# Project这是一个原生 HTML、CSS、JavaScript 的 Todo 项目。#Rules不使用 React、Vue 等框架不增加第三方依赖不修改项目目录之外的文件新增功能时不要破坏已有功能#Verification修改 JavaScript 后检查语法修改功能后说明如何手动验证
以后再让 Codex 修改这个项目，就不用每次重复“不要装 React”、“不要增加依赖”、“不要动其他目录”等这些要求了。
AGENTS.md 还支持分层读取：可以有全局规则，也可以在项目或子目录里放更具体的规则，越靠近当前目录的要求优先级越高。
不过不要把 AGENTS.md 写得太长。长期有效、每次都要遵守的内容放进去（减少Token浪费)；某一次具体需求，继续写在当次 Prompt 里。 这样最清楚，也最不容易让上下文变得臃肿。
13 复杂任务先用 Plan，别上来就改
像前面的 Todo 这种小需求，直接让 Codex 修改就可以，没必要先做规划。但如果以后遇到“把整个 JavaScript 项目迁移到 TypeScript”或者“重构认证模块，但不能影响现有用户”这类范围大、风险高的任务，最好不要一上来就让它开改。
这时候可以先输入：
/plan/plan 会让 Codex 先梳理任务，拆出实施步骤、影响范围和可能的风险，必要时还会先向你确认缺失的信息，再决定怎么动手。
可以简单记住一句话：
小任务直接做；大任务、复杂任务、风险高的任务，先 /plan。
它解决的核心问题就是：这件事准备怎么做。
14 Goal 又是什么？它和 Plan 不是一回事
Goal 很容易和 Plan 混在一起，但两者解决的不是同一个问题。Plan 更关注“这件事准备怎么做”，而 Goal 更像是在当前任务里设定一个持续有效、可以验证的最终目标。
比如：
/goal 把接口 p95 延迟降低到 120ms 以下，同时保证现有测试全部通过这种任务通常不是改一次代码就能结束。Codex 可能需要不断分析、修改、跑 Benchmark，再根据结果继续调整，直到达到目标。Goal 会把这个最终结果持续保留在当前任务里，你不用每一轮都重复说“继续优化”“再测一次”。
可以简单记成：
Plan：怎么做。Goal：做到什么才算完成。
第一次使用 Codex 时，其实不用急着用 Goal，先知道它适合这类需要多轮尝试、并且有明确验收标准的长任务就够了。
15 输入 /，很多功能其实都藏在这里
如果你不知道 Codex 有哪些命令，最简单的办法就是在输入框里输入：
/这时会打开命令面板。不同版本、账号和运行环境下，显示的命令可能会有些差别，不用要求自己的界面和别人截图完全一样。对新手来说，先认识下面这些常用命令就够了：
/init | AGENTS.md | |
/status | ||
/permissions | ||
/model | ||
/plan | ||
/goal | ||
/review | ||
/side | ||
/compact | ||
/fork |
刚开始其实不用把这些都背下来。最常用的通常就是 /init、/status、/permissions、/model 和 /plan，其他命令等真正遇到对应场景再用也不迟。
另外，如果你在旧教程里看到 /approvals，也不用奇怪。Codex 的命令和界面一直在更新，现在权限相关操作更常见的是 /permissions，所以看教程时最好顺手确认一下版本。
16 如果你是程序员，再补一个 CLI
如果你平时本来就习惯用终端，那 Codex CLI 会更顺手。它和桌面版用的是同一套 Codex，只是入口不同：桌面版靠界面操作，CLI 则直接在项目目录里通过命令使用。
目前常见的安装方式有几种。macOS / Linux 可以在 Terminal 里执行：
curl -fsSL https://chatgpt.com/codex/install.sh | shWindows 则打开 PowerShell：
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"如果电脑已经装了 Node.js，也可以直接用 npm：
npm install -g @openai/codexMac 用户还可以用 Homebrew：
brew install --cask codex安装完成后，先执行：
codex --version能正常显示版本号，就说明安装成功。接下来进入项目目录：
cd codex-todo再启动 Codex：
codex第一次使用按照提示选择 Sign in with ChatGPT 登录即可。API Key 也能用，但需要额外配置，新手没必要一开始就折腾。
所以不用把 CLI 和 Desktop 当成两套产品。一个是在界面里操作，一个是在终端里操作，真正的工作流程还是一样：读项目 → 理解任务 → 修改 → 运行 → 验证。
17 如果一直 Reconnecting，先别急着重装
还有一个比较常见的情况：Codex打开后一直显示 Reconnecting...，或者反复出现 1/5、2/5、3/5。这类问题在 Windows、WSL 或使用代理软件时更容易遇到，不建议上来就卸载重装。
如果安装了 CLI，可以先运行：
codex doctor它可以帮助检查 Codex 的启动、网络连接和运行环境。如果你正在使用代理，再重点检查 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 等环境变量，以及代理端口是否已经变化、TUN 模式是否正常。
需要注意的是，浏览器能正常打开 ChatGPT，并不代表 Codex 的网络连接一定正常，两者使用的网络链路可能不同。所以遇到 Reconnecting 时，优先检查代理和网络配置，再考虑重新安装 Codex。详细可以查看文章：
Codex一发送消息就 Reconnecting？4种方法解决连接问题
18 到这里，你才算真正完成了 Codex 的 0 到 1
回头看，这一篇其实没有讲太多高级功能。我们做的事情很简单：安装 Codex，准备一个干净的项目目录，把需求说清楚，让它创建项目，然后自己运行、检查和验证结果。
但我觉得，这一步比一开始研究几十个 Skill、MCP 或多 Agent 更重要。真正决定 Codex 能不能进入日常工作流的，不是你记住了多少命令，而是有没有养成几个基本习惯：任务说清楚、范围划清楚、权限别乱开、复杂任务先 Plan、生成以后要验证，长期规则再写进 AGENTS.md。
等这些基础功能用顺以后，再去研究 Skills、Plugins、MCP、Worktree、Remote、Automation，就会容易很多。那些属于后面的“1 到 10”，而这篇解决的是最重要的“0 到 1”。
如果你刚装好 Codex，现在就可以新建一个 codex-todo 文件夹，把文章里的 Todo Prompt 复制进去跑一遍。当你第一次看着 Codex 自己创建文件，再在浏览器里真的把页面跑起来时，你会很直观地感受到：AI Coding 已经不只是“问 AI 怎么写代码”，而是开始真正参与到你的开发流程里。