写给 Codex 小白用户的全网最详细教程：从 0 到 1，把 Codex 真正用起来
更新时间：2026-03-25
作者：MaynorAI
如果你最近经常刷到 Codex，但又总觉得它离自己很远，这篇文章就是写给你的。
很多小白第一次看到 Codex，脑子里都会冒出同样几个问题：
- • 这玩意到底是什么？
- • 它跟 ChatGPT、Claude Code 有什么区别？
- • 我不会写代码，真的能用吗？
- • 为什么别人已经开始拿它做项目了，我还在看概念？
先说结论：
Codex 不只是“会写代码的 AI”，而是一个能围绕任务持续推进、真正开始干活的 Agent。
这也是为什么，我会觉得：
对小白来说，Codex 的价值，甚至可能比对程序员还大。
因为它改变的不是“你写代码快一点”，而是——
很多原本你根本做不了的事，现在第一次有机会做成了。
这一版内容，完全基于 README.md 重写，不是凭空发挥。和普通教程不同，这篇专门做了 4 件事：
- • README 里的图片全部保留，不省略
- • 重点信息全部加粗，阅读更省力
- • 能做成表格的尽量做成表格
- • 补充 GPT-5.4 的最新官方信息
如果你想找一篇：
真正写给 Codex 小白用户、能从认知到上手一口气讲清楚的长文
那就继续往下看。
一、什么是 Codex？
1.1 Codex 简介
先把最关键的一句话放前面：
Codex 是 OpenAI 对标 Claude Code 的编程 Agent 产品。
很多人第一次看见这个定义，容易没感觉。
因为“编程 Agent”这四个字，看起来太像行业黑话了。
你可以先别管那些术语，直接按更好懂的方式理解：
Codex 不是只会跟你聊天的 AI。它更像一个能围绕项目目录、文件、任务目标持续干活的 AI 助手。
这就意味着，它跟普通问答式 AI 最大的区别，不在于“它更聪明”，而在于：
- • 它更像一个工作流工具
- • 它会围绕任务持续推进
- • 它的重点不是回答一句，而是把一件事往前做
先看 README 里的基础对比表：
| 特性 | Codex | Claude Code |
|---|---|---|
| 开发商 | OpenAI | Anthropic |
| 底层模型 | GPT-5.3-codex | Claude Opus 4.6 |
| 定位 | 编程 Agent（趋近通用 Agent） | 编程 Agent |
看到这里，你可以先建立一个基本认知：
Codex 本质上不是“聊天工具的升级版”，而是“执行型 AI”的一个成熟形态。
1.2 为什么编程 Agent 如此重要？
这一段非常关键。
因为很多人还停留在：
- • AI = 回答问题
- • AI = 帮我写几段代码
- • AI = 帮我润色一段文案
但如果你把视角再拉高一点，你会发现真正变化的不是这些。
真正的变化是：
编程 Agent 正在从“辅助工具”，变成一种新的通用生产力接口。
为什么这么说？
因为过去几十年，几乎所有信息化成果，最后都沉淀在：
- • 代码
- • 软件
- • 接口
- • 自动化流程
- • 系统配置
- • 数据处理链路
只要一个 AI 足够擅长这些东西，它能做的事，就远远不只是“写代码”。
所以你现在看到的，其实不是“AI 会写程序了”这么简单。
而是：
AI 正在通过代码，开始接管越来越多的实际工作流程。
这也是为什么我一直觉得，编程 Agent 的终点，越来越接近通用 Agent。
1.3 模型对比：GPT-5.3-codex 到底是什么定位？
这一段 README 讲得很明确。
Codex 和 Claude Code 都是上层应用，真正驱动它们的是底层模型。
当前 README 里的模型对比，可以先这样理解：
| 产品 | 模型 | 特点 |
|---|---|---|
| Codex | GPT-5.3-codex | 纯编程特化模型，创作、事实核查、世界知识不是强项 |
| Claude Code | Claude Opus 4.6 | 通用能力更强 |
这句话你一定要记住：
⚠️ GPT-5.3-codex 是偏“纯编程特化”的。
什么意思？
就是它在：
- • 代码生成
- • 工程修改
- • 项目推进
- • 命令执行
- • 技术任务拆解
这些地方会很强。
但如果你拿它去做：
- • 开放式创作
- • 泛知识问答
- • 复杂事实核查
- • 世界知识型内容生成
它未必是最理想的选手。
这不是缺点，而是定位问题。
图片
1.4 GPT-5.4 补充说明（基于 OpenAI 官方信息）
这部分不是 README 原文，而是我额外补充的。
因为如果你只看 README，很容易得到一个印象：
Codex = GPT-5.3-codex
但在 2026-03-05，OpenAI 官方已经发布了 GPT-5.4。
而且官方给出的定位非常强：
GPT-5.4 是 OpenAI 当前最强、最灵活的通用模型。
更重要的是，官方还明确提到：
- • GPT-5.4 已进入 ChatGPT、API、Codex 体系
- • 在 Codex 中，它被描述为：原生融合 GPT-5 推理能力与 GPT-5.3-codex 编码特长的主线推理模型
- • 官方还提到它在 Codex 里有 实验性的 100 万上下文窗口版本，适合更复杂、更长链路的工程任务
这意味着什么？
意味着你今天再理解 Codex，不能只停留在：
它只是一个纯编程特化工具。
更准确的理解应该是：
Codex 正在从“强编程执行”继续升级成“强推理 + 强执行”的新形态，而 GPT-5.4 是这件事里最关键的一步。
下面这个表，你一眼就能看懂：
| 维度 | README 当前表述 | 2026-03-05 OpenAI 官方补充 |
|---|---|---|
| Codex 主打模型认知 | GPT-5.3-codex | GPT-5.4 已进入 Codex 体系 |
| 模型风格 | 纯编程特化 | 更强通用推理 + 继承 codex 编码优势 |
| 适合场景 | 代码生成、重构、工程任务 | 复杂工程、长上下文、多阶段任务 |
| 对小白的意义 | 更像专业编码工具 | 更适合又要推理、又要执行的复杂任务 |
一句话总结：
如果 GPT-5.3-codex 让 Codex 像一个很强的代码工人，那么 GPT-5.4 正在让它更像一个能想、能拆、能执行的工程负责人。
官方参考：
- • OpenAI：Introducing GPT-5.4
openai.com/sq-AL/index…
1.5 会员权限对比（按 README 当前写法）
README 当前给出的会员与模型对应关系如下：
| 会员类型 | Codex 可用模型 |
|---|---|
| Plus 会员 / Pro 会员 | ✅ GPT-5.3-codex |
| 免费会员 / Go 会员（$8） | ⚠️ GPT-5.2-codex（非最新版） |
这里我建议你注意一句：
⚠️ 这部分是 README 当前写法，不代表未来套餐配置不会继续变化。
因为 GPT-5.4 已经在 2026-03-05 官方发布，后续具体哪个套餐、哪个产品入口、哪个账号层级能看到什么模型，最好还是以：
- • OpenAI 官方页面
- • 你自己账号里的实际模型列表
为准。
二、如何获取 Codex
这一段是所有新手最关心的问题。
如果连入口都没有，后面谈什么 Plan、Thread、Skills 都没意义。
2.1 获取方式一：官网订阅
README 给出的方式非常直接：
codex 20 刀充值链接（自备魔法） ：
maynorai.tqfk.xyz/item/10
如果你走这条路线，核心特点就是：
- • 路径直
- • 理解成本低
- • 更接近官方体验
2.2 获取方式二：安装 cc-switch
如果你不走上面的原始路径，也可以按 README 提供的 cc-switch 方案来。
| 步骤 | 说明 | 链接 |
|---|---|---|
| 1. 下载安装 | GitHub 自行安装 | github.com/farion1231/… |
| 2. 配置中转 API | 每天 100 刀额度 | maynorai.tqfk.xyz/item/15 |
| 3. 详细配置教程 | 飞书文档 | ai.feishu.cn/wiki/JnefwE… |
这条路线更适合：
- • 想直接按现成教程跑通的人
- • 不想自己从零排查接入方式的人
- • 更在意“快速能用”而不是完全原始路径的人
2.3 下载安装 Codex
README 这里给出的官方动作路径也很简单：
-
- 进入 OpenAI 的 Codex 官网：chatgpt.com/codex
-
- 点击大大的 “下载应用” 按钮
图片
-
- 下载 Mac 安装包，安装、登录即可
图片
看到这里你会发现，下载本身一点都不复杂。
真正复杂的，从来不是“下载应用”，而是后面你如何理解它、配置它、组织你的任务。
💡 补一句现实提醒：README 写这段时提到，Windows 应用版本当时还没正式上线。这类信息有时效性，后续请以官方页面实际展示为准。
三、核心概念解析
如果说前面解决的是“怎么进门”，那这一段解决的就是：
你进门以后，怎么不迷路。
而且我可以很直接地说：
大部分小白用 Codex 不顺，不是因为不会操作，而是因为没建立对它工作结构的理解。
3.1 Threads（线程）系统
当你下载好、登录到 Codex 首页后，大概会看到类似这样的界面：
图片
这里最核心的概念之一，就是 Threads（线程） 。
这个词听起来有点技术，但你先不用怕。
你就把它理解成：
一条围绕某个具体目标持续推进的任务线。
3.2 两层结构详解
README 对这个结构讲得很到位：
Codex 左边这栏，其实是两层结构。
| 层级 | 名称 | 作用 | 类比 |
|---|---|---|---|
| 第一层 | 文件夹（工作区） | 项目目录 / 主题盒子 | 像一个项目群 |
| 第二层 | Thread | 独立的对话任务线 | 像群里的具体话题贴 |
你可以把它记成一句更口语化的话：
文件夹装项目，Thread 装任务。
再拆开看：
- • 一个文件夹里可以有很多条 Thread
- • 每条 Thread 都围绕一个明确目标推进
- • 文件夹负责放代码和资料，Thread 负责放过程和思路
3.3 为什么这样设计？
这套设计对小白特别友好，原因很简单：
它把最容易搅混的两件事，硬生生拆开了。
来看 README 给出的对照：
| 传统方式的痛点 | Codex 的解决方案 |
|---|---|
| 上午写网页、下午算 Excel、晚上改文案，所有内容搅在一起 | 不同任务放进不同 Thread |
| 上下文污染严重 | 对话和目标互不污染 |
| AI 开始胡编乱造 | 可以断点续写，重新收束任务 |
| 找不到文件在哪 | 文件和资源分层更清晰 |
这张表你一定要认真看。
因为它讲的根本不是产品设计，而是：
为什么很多人第一次用 Codex，会突然觉得“终于没那么乱了”。
3.4 黄金法则
最后用 README 这句金句收住：
🎯 同一个文件夹里做同一个大方向，同一个 Thread 里只推进一件具体的事。
你别小看这句话。
对小白来说，这一句的重要性，甚至经常高于“怎么写 prompt”。
因为你一旦把任务组织好，AI 才更容易稳定。
四、项目文件夹管理
很多人一开始觉得，文件夹结构这种事没什么好说的。
但现实往往是：
你后面越用越乱，大概率不是因为 Codex 不行，而是因为你的项目组织方式从一开始就乱。
4.1 推荐的文件夹结构
README 非常强调：正式开始前，最好先把分类想清楚。
例如作者自己电脑上的一个目录结构：
dev/
├── Learning/ # 学习资料
├── notes/ # 文章和笔记
├── Projects/ # 真实开发项目任务
├── sandbox/ # 沙盒（乱七八糟的东西）
└── tools/ # 通用脚本、可复用组件、小工具
图片
这个结构好在哪？
好在它天然就把不同用途拆开了：
- • 学习资料 不会混进正式项目
- • 真实项目 不会跟测试垃圾混在一起
- • 通用工具 不会散落各个目录
4.2 Projects 示例
README 给的 Projects 示例也很典型：
| 项目 | 说明 |
|---|---|
| AI 热点 | 热点追踪项目 |
| 飞书机器人 | 多个不同功能的飞书机器人 |
图片
比如这里提到的一个具体案例，就是：
把公众号数据定时爬下来，再存到多维表格里的飞书机器人。
图片
这背后其实说明了一件很重要的事：
Codex 并不只适合“纯代码项目”，它也适合很多真实业务型任务。
4.3 添加项目文件夹
本地建好文件夹之后，可以从入口把项目目录加进 Codex：
图片
比如你想开发一个 AI 热点网站，就可以把对应文件夹加进去，再在里面开一条 Thread：
图片
这一段我特别想再强调一句：
⚠️ 前期分类非常重要。真的不要什么任务都随手乱开，更不要把完全不同的事情全塞进同一个地方。
你前面懒一次，后面会乱很多次。
五、功能与配置项
这一部分会让很多小白第一次意识到：
原来 Codex 不是“一个会写代码的框”，而是一整套图形化工作流。
5.1 功能一：定时任务
图片
README 对这个功能的描述非常直白：
Codex 可以在特定日期去干特定的事。
如果你第一次听到这句话，可能会觉得一般。
但你把它代入真实场景，就知道它为什么厉害了。
README 给出的案例是：
| 场景 | 说明 |
|---|---|
| 服务器托管 | 多个项目跑在云服务器上，但作者本人并不懂服务器 |
| 自动化巡检 | Codex 每天早上 9 点自动巡检服务器，检查报错 |
| 自动修复 | 如果有报错，会自己解决并总结原因 |
| 通知推送 | 再通过飞书机器人发给作者 |
图片
这一套组合起来，真正体现出来的是：
你不是在“偶尔问一下 AI”，而是在把 AI 接进你的日常工作流程。
5.2 功能二：Skills（技能）
图片
如果说定时任务让 Codex 更像一个“自动执行者”，那么 Skills 则让它更像一个“可扩展能力平台”。
README 对 Skills 的核心判断是：
这是第一次，Skills 真正拥有了自己的可视化、图形化管理界面。
为什么这件事对小白特别重要？
因为传统命令行风格的 Skill 体验，最大的问题就是：
- • 不知道自己装了什么
- • 不知道装到哪了
- • 不知道这个 Skill 到底能干嘛
README 的表格对比很清楚：
| 对比项 | Codex | Claude Code / OpenCode |
|---|---|---|
| Skills 管理 | ✅ 图形化界面，轻松管理 | ❌ 不知道装了哪些、装到哪、有什么用 |
| Skills 创建 | ✅ 内置 Skill Creator | ❌ 需要自己找、自己安装 |
5.3 Skill Creator 使用
Codex 自带 Skill Creator。
你可以把它理解成：
以前你得先知道怎么装、怎么找、怎么配；现在你可以先说“我要什么”，再让系统帮你往下走。
具体步骤也很直白：
步骤 1：点击右上角的 “New Skill”
图片
步骤 2：直接告诉它，你想做什么 Skill
图片
这对小白最大的价值，不是“省一点操作”，而是：
你终于可以从功能需求出发，而不是先被安装和配置门槛拦住。
六、设置配置
很多人第一次打开 Codex，最容易忽略的就是设置。
但现实往往是：
你后面用起来顺不顺，很多时候就取决于前面这几项配没配对。
6.1 General 设置
README 推荐先改这两项：
| 配置项 | 推荐设置 | 说明 |
|---|---|---|
| 保持电脑开机 | ✅ 打开 | 允许后台运行 |
| Follow-up behavior | steer | 开发过程中可随时发消息调整任务 |
图片
你可以简单理解成：
- • 保持电脑开机：让它能继续跑
- • steer：让你能在开发过程中不断纠偏
6.2 Personalization（个性化设置）
这一块非常重要。
README 的意思其实很清楚：
Personalization，本质上就是图形界面的
AGENT.md/AGENTS.md。
图片
也就是说，这里不是“随便写点喜好”的地方。
这里其实是你告诉 Codex：
- • 你喜欢它怎么协作
- • 你要求它怎么改代码
- • 你希望它怎么解释和输出
6.3 推荐的全局规则
README 里给了一套很适合新手抄走就能用的规则模板。
如果把它压缩成最好记的版本，其实就 7 件事：
- • 改动要小，方便审查
- • 动手前先说文件和计划
- • 不胡编路径和配置
- • 不要泄露密钥和敏感信息
- • 行为变化尽量补测试
- • 执行命令前说明为什么
- • 默认中文，表达简洁，可复制
说白了，这一块做的事情就是：
提前把你的协作原则写进去，让 Codex 从第一轮开始就按你的规则工作。
6.4 权限设置
在对话首页，把权限改成 Full access：
图片
README 对这部分的态度非常明确：
💡 好处：让 Codex 对你的电脑有更高访问权限，这样它就不用每次都来回征求确认，任务推进效率会高很多。
对小白来说，这件事怎么理解最实际？
可以直接这么记：
- • 想要更顺、更连贯、更像真人干活 → Full access
- • 想每一步都自己确认 → 保守模式
没有绝对对错，主要看你的环境和风险偏好。
七、对话功能详解
到了这里，真正开始进入“怎么用”的层面。
7.1 斜杠命令
在对话框里输入 /，就能调起特殊功能：
图片
这一步看起来很小，但意义其实很大。
因为它代表着：
Codex 不是单纯聊天，它有明确的任务模式和系统操作入口。
7.2 重要功能：Plan Mode（规划模式）
如果这篇文章你只记住一个功能，那我建议就是这个：
Plan Mode。
因为它对小白特别重要。
你最容易卡住的不是“不会写”，而是：
- • 不知道从哪开始
- • 不知道要改哪些文件
- • 不知道先做什么后做什么
- • 不知道需求有没有漏项
而 Plan Mode 干的事情，就是先帮你把这些事理顺。
README 给出的定义非常清楚：
| 功能 | 说明 |
|---|---|
| 作用 | 只规划，不写代码 |
| 图标 | 会出现一个小图标 |
| 适用场景 | 每个大型项目（从 0 到 1）的起始阶段 |
图片
README 推荐工作流如下：
大型项目 → 先用 Plan 模式规划 → 形成规范文档和实现计划 → 再开始开发
实际案例：构建一个管理 AI 热点网站信源的 Skill。
图片
过一段时间后，你就能拿到这样一份计划：
图片
确认没问题后，选择 “是” 即可。
然后 Plan 图标消失，正式进入开发：
图片
这里我想额外说一句：
Plan Mode 对小白最大的价值，不是它多了个按钮，而是它帮你把“乱做”变成“先想清楚再做”。
7.3 重要功能：Status（状态查看）
输入 /status，你就能看到：
- • 当前周期的用量
- • 剩余额度
- • 当前模型 / 会话状态等信息
图片
这个功能看起来普通，但非常实用。
因为你后面越用越多，就越需要知道：
自己当前到底在什么状态、还剩多少资源。
7.4 模型推理深度
这一块小白也经常忽略，但其实非常重要。
图片
README 对推理深度的总结已经很实用了：
| 等级 | 说明 | 推荐场景 |
|---|---|---|
| Low | 最快最省 | 简单任务 |
| Medium | 平衡 | 一般任务 |
| High | 日常推荐 | 日常开发 |
| Extra High | 最稳最全 | 难活、硬活、大活 |
如果你不想记太多，直接记这句就够了：
平时用 High，难活用 Extra High。
这已经覆盖了大多数实际场景。
八、开始 Vibe Coding
讲到这里，很多人会突然发现：
原来最难的不是操作，而是前面那些认知。
一旦前面的结构你理解了，真正开始开发反而简单。
8.1 开发方式
README 对这一段的态度特别直接：
Coding 这块反而没啥好说的了，直接用嘴描述你的需求就行。
Codex 右下角有 麦克风，作者在 README 里提到自己经常就是直接开麦说：
图片
这背后真正体现的不是“语音很酷”，而是：
你和 AI 的协作门槛，已经从“会不会写代码”越来越变成“会不会描述需求”。
8.2 我的开发习惯（按 README 原思路整理）
这一段我非常建议你直接照着练。
| 步骤 | 操作 |
|---|---|
| 1 | 先打开 Plan 模式 |
| 2 | 用自然语言描述需求（前端强调设计 Skill，服务器问题用对应 Skill） |
| 3 | 计划生成后再开始开发 |
| 4 | 开发完第一时间看前端效果 |
| 5 | 效果可行就继续微调；效果不好就重做前端 |
这里面最值钱的一点是什么？
不是某个具体按钮。
而是这个顺序本身：
先规划，再开发；先看结果，再决定下一步。
8.3 前端问题的解决方案
README 也很坦诚，没有故意把 Codex 神化。
原话的核心意思其实就是：
⚠️ Codex 的前端能力有时候确实一般。
图片
这件事特别重要，因为很多小白最容易陷入一个误区：
既然用了 AI，就应该什么都一次做到最好。
不是这样的。
工具也有分工。
README 给出的解决思路很现实：
| 方案 | 适用条件 |
|---|---|
| Claude Code + Claude Opus 4.6 | 有 Claude Opus 4.6（推荐） |
| Claude Code + K2.5 + Frontend Design Skill | 没有 Claude Opus 4.6 |
这背后真正的思路是：
前端效果不好，就换更适合前端的组合，不要跟工具硬较劲。
8.4 小技巧：并行开发
在 Codex 里，多个 Thread 是可以并行推进的：
图片
这意味着什么？
意味着你后面可以逐步从：
- • 一次只做一件事
升级到：
- • 不同目标拆成不同 Thread，同时推进
这其实就是 AI 协作能力真正开始变强的标志。
九、总结
README 最后的判断我非常认同，而且我建议你认真记住。
Vibe Coding 这个东西，对非程序员来说，可能比对程序员更有价值。
为什么？
因为对程序员来说，它更多是：
- • 提效
- • 加速
- • 减少重复劳动
但对非程序员来说，它的意义完全不一样。
它更像是：
把一道原本根本跨不过去的门槛，第一次给你铲平了。
README 里这个表总结得很好：
| 人群 | AI 的价值 |
|---|---|
| 程序员 | 提效工具 |
| 非程序员 | 直接把一道原本过不去的坎给铲平了 |
最后，把这句也记住：
在未来，会用 AI 写代码，会变成像会用 Excel 一样的基本技能。
这不是一句鸡汤。
这是趋势。
而且已经在发生了。
快速参考卡
Codex vs Claude Code 快速对比
| 对比项 | Codex | Claude Code |
|---|---|---|
| 开发商 | OpenAI | Anthropic |
| 核心模型 | GPT-5.3-codex / GPT-5.4（官方已补充进入体系） | Claude Opus 4.6 |
| 界面 | ✅ 图形化 | 命令行 |
| Skills 管理 | ✅ 图形化界面 | 命令行为主 |
| 定时任务 | ✅ 支持 | 需要自己配置 |
| 前端能力 | ⚠️ 有时一般 | ✅ 通常更强 |
推荐设置速查
| 设置项 | 推荐值 |
|---|---|
| Follow-up behavior | steer |
| 权限 | Full access |
| 推理深度（日常） | High |
| 推理深度（大活） | Extra High |
常用斜杠命令
| 命令 | 功能 |
|---|---|
/plan | 进入规划模式 |
/status | 查看用量和剩余额度 |
最后给小白一句最实用的话
如果你今天刚接触 Codex，我最建议你的起步方式不是：
“上来就做一个大项目。”
而是先做一件很小、很具体、很容易验证的事，比如：
- • 改一个静态页面标题
- • 把获取方式提到首屏
- • 把 README 改成网页
- • 把图片融入正文
- • 把长链接改成蓝链
因为小白用 Codex，真正最重要的，不是先学会所有技术细节。
而是先建立 3 个能力：
-
- 会描述目标
-
- 会拆分任务
-
- 会检查结果
只要这 3 件事你开始做顺了，后面你会越来越快地进入状态。
而一旦你真的开始顺起来，你就会发现：
你不是在“学一个 AI 工具”，你是在学一种新的做事方式。
