# gpt-codex

**Repository Path**: ohjone2015/gpt-codex

## Basic Information

- **Project Name**: gpt-codex
- **Description**: 这是一个关于 OpenAI CodeX 的完整教程网站，专为国内开发者打造。
- **Primary Language**: HTML
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://codex.maynorai.top/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-06-18
- **Last Updated**: 2026-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 写给 Codex 小白用户的全网最详细教程：从 0 到 1，把 Codex 真正用起来

**更新时间：2026-04-27**
**作者：MaynorAI**

如果你最近经常刷到 **Codex**，但又总觉得它离自己很远，这篇文章就是写给你的。

很多小白第一次看到 Codex，脑子里都会冒出同样几个问题：

- **这玩意到底是什么？**
- **它跟 ChatGPT、Claude Code 有什么区别？**
- **我不会写代码，真的能用吗？**
- **为什么别人已经开始拿它做项目了，我还在看概念？**

先说结论：

> **Codex 不只是"会写代码的 AI"，而是一个能围绕任务持续推进、真正开始干活的 Agent。**

这也是为什么，我会觉得：

> **对小白来说，Codex 的价值，甚至可能比对程序员还大。**

因为它改变的不是"你写代码快一点"，而是——**很多原本你根本做不了的事，现在第一次有机会做成了。**

和普通教程不同，这篇专门做了 4 件事：

- **README 里的图片全部保留，不省略**
- **重点信息全部加粗，阅读更省力**
- **能做成表格的尽量做成表格**
- **补充 GPT-5.5 的最新官方信息**

> **真正写给 Codex 小白用户、能从认知到上手一口气讲清楚的长文**

那就继续往下看。

---

## 一、什么是 Codex？

### 1.1 Codex 简介

先把最关键的一句话放前面：

> **Codex 是 OpenAI 对标 Claude Code 的编程 Agent 产品。**

"编程 Agent"听起来像行业黑话，但你完全不用管那些术语，直接按更好懂的方式理解：

> **Codex 不是只会跟你聊天的 AI。它更像一个能围绕项目目录、文件、任务目标持续干活的 AI 助手。**

它跟普通问答式 AI 最大的区别，不在于"它更聪明"，而在于：

- **它更像一个工作流工具**
- **它会围绕任务持续推进**
- **它的重点不是回答一句，而是把一件事往前做**

先看基础对比表：

| 特性 | Codex | Claude Code |
|------|-------|-------------|
| **开发商** | **OpenAI** | **Anthropic** |
| **底层模型** | **GPT-5.5 / GPT-5.3-codex** | **Claude Opus 4.6** |
| **定位** | **编程 Agent（趋近通用 Agent）** | **编程 Agent** |

> **Codex 本质上不是"聊天工具的升级版"，而是"执行型 AI"的一个成熟形态。**

### 1.2 为什么编程 Agent 如此重要？

很多人对 AI 的认知还停留在：回答问题、写几段代码、润色文案。但如果把视角拉高一点，你会发现真正的变化是：

> **编程 Agent 正在从"辅助工具"，变成一种新的通用生产力接口。**

为什么这么说？因为过去几十年，几乎所有信息化成果，最后都沉淀在：

- **代码**
- **软件**
- **接口**
- **自动化流程**
- **系统配置**
- **数据处理链路**

只要一个 AI 足够擅长这些东西，它能做的事，就远远不只是"写代码"。

> **AI 正在通过代码，开始接管越来越多的实际工作流程。**

编程 Agent 的终点，越来越接近通用 Agent。

### 1.3 模型对比：GPT-5.5 到底是什么定位？

Codex 和 Claude Code 都是上层应用，真正驱动它们的是底层模型：

| 产品 | 模型 | 特点 |
|------|------|------|
| **Codex** | **GPT-5.5 / GPT-5.3-codex** | **GPT-5.5 是最新旗舰模型**，兼顾推理、编程 Agent、知识工作和长链路任务；GPT-5.3-codex 是历史上更偏编程特化的主打模型 |
| **Claude Code** | **Claude Opus 4.6** | **通用能力和前端审美通常更强** |

> ⚠️ **不要再把 Codex 只理解成 GPT-5.3-codex。GPT-5.5 让它更接近“强推理 + 强执行”的工程 Agent。**

在以下场景它会很强：

- **代码生成**
- **工程修改**
- **项目推进**
- **命令执行**
- **技术任务拆解**

过去的 GPT-5.3-codex 更像“纯编程工人”；现在的 GPT-5.5 更像“工程负责人”：能规划、能执行、能检查，也更适合长上下文和多阶段任务。

![图片](https://upload.maynor1024.live/file/1774358257887_image.png#imgIndex=8)

### 1.4 GPT-5.5 补充说明（基于 OpenAI 官方信息）

如果你只看旧版 README，很容易得到一个印象：**Codex = GPT-5.3-codex**。

但在 **2026-04-23**，OpenAI 官方已经发布 **GPT-5.5**。官方定位可以概括成一句话：

> **GPT-5.5 是 OpenAI 最新旗舰模型，也是目前最强的 Agentic Coding 模型。**

这次更新和 Codex 关系非常直接：

- **GPT-5.5 已进入 ChatGPT 和 Codex**，Plus、Pro、Business、Enterprise 等账号可在 ChatGPT 和 Codex 中使用
- Codex 侧可用人群还包括 **Edu 和 Go**，上下文窗口扩展到 **400K tokens**
- Codex 提供新的 **Fast mode**，速度约 **1.5 倍**，但 token 成本约 **2.5 倍**，适合赶时间的任务
- 官方 API 文档目前也已将 **gpt-5.5** 标为最新旗舰模型；实际能否调用，以你账号的模型列表和官方文档为准

GPT-5.5 对 Codex 的意义，不只是“模型名换新”。它重点加强的是这些能力：

| 维度 | 旧认知 | GPT-5.5 最新补充 |
|------|--------|------------------|
| **Codex 主打模型认知** | **GPT-5.3-codex** | **GPT-5.5 已成为最新旗舰选择** |
| **模型风格** | **纯编程特化** | **强推理 + 强执行 + 更稳的工具使用** |
| **适合场景** | **代码生成、重构、工程任务** | **复杂工程、长上下文、多阶段任务、调试与验证闭环** |
| **对小白的意义** | **更像专业编码工具** | **更像能拆任务、改文件、跑检查的工程负责人** |

一句话总结：

> **如果 GPT-5.3-codex 让 Codex 像一个很强的代码工人，那么 GPT-5.5 正在让它更像一个会规划、会执行、会复盘的工程负责人。**

**官方参考：**

- **OpenAI：Introducing GPT-5.5**
  https://openai.com/index/introducing-gpt-5-5/
- **OpenAI API Docs：GPT-5.5 model page**
  https://developers.openai.com/api/docs/models/gpt-5.5
- **OpenAI API Docs：Latest model guide**
  https://developers.openai.com/api/docs/guides/latest-model

### 1.5 会员权限对比

| 会员类型 | Codex 可用模型 |
|----------|----------------|
| **Plus / Pro / Business / Enterprise** | ✅ **GPT-5.5 可在 ChatGPT 和 Codex 中使用** |
| **Edu / Go** | ✅ **官方发布页列入 Codex 可用范围** |
| **免费用户** | ⚠️ **官方 GPT-5.5 Codex 可用列表未明确包含，建议以账号内模型列表为准** |

> ⚠️ **模型权限会随地区、账号、套餐和灰度节奏变化。** 这部分只写官方在 **2026-04-23** 发布 GPT-5.5 时明确给出的信息；实际可用模型，以 **OpenAI 官方页面**和**你账号里的实际模型列表**为准。

---

## 二、如何获取 Codex

连入口都没有，后面谈什么 Plan、Thread、Skills 都没意义。

### 2.1 获取方式一：官网订阅（需要自备魔法）

**codex 20 刀充值链接（自备魔法）**：
https://maynorai.jichiyun.sbs/buy/7

核心特点：

- **路径直**
- **理解成本低**
- **更接近官方体验**
- **需要自己解决网络访问环境**

### 2.2 获取方式二：第三方中转（不需要自备魔法）

如果不想自己处理网络环境，可以走第三方中转方案。这里有两类入口：

| 方案 | 说明 | 链接 |
|------|------|------|
| **国内官网入口** | **进入 Codex 国内站登录和配置** | https://codex.chatgpt-plus.top/login |
| **备用网址** | **主入口访问不稳定时使用备用入口登录** | https://codex2.chatgpt-plus.top/login |
| **Codex&GPTimage2 套餐** | **第三方中转套餐，不需要自备魔法** | https://maynorai.jichiyun.sbs/buy/30 |
| **配置中转 API** | **配合 cc-switch 使用，每天 150 刀额度，不需要自备魔法** | https://maynorai.jichiyun.sbs/buy/13 |

> ⚠️ **说明**：Codex&GPTimage2 套餐和配置中转都属于第三方中转方案，不是 OpenAI 官方订阅；优点是不用自备魔法，适合想快速跑通的人。

### 2.3 获取方式三：安装 cc-switch

也可以按 README 提供的 `cc-switch` 方案来：

| 步骤 | 说明 | 链接 |
|------|------|------|
| **1. 下载安装** | **GitHub 自行安装** | https://github.com/farion1231/cc-switch/releases/ |
| **2. 配置中转 API** | **第三方中转，不需要自备魔法** | https://maynorai.jichiyun.sbs/buy/13 |
| **3. 详细配置教程** | **飞书文档** | https://ai.feishu.cn/wiki/JnefwEQRKiNyg6kTnN4cNphnnSh?from=from_copylink |
| **4. 完整上手教程** | **飞书文档** | https://my.feishu.cn/wiki/Vjulwif06izNiMkPor0cM9uYn1e |

这条路线更适合：

- **想直接按现成教程跑通**的人
- **不想自己从零排查接入方式**的人
- **更在意"快速能用"而不是完全原始路径**的人

### 2.4 下载安装 Codex

Codex 客户端安装包，也可以理解成 **Codex Desktop App**。官方动作路径很简单：

1. 进入 OpenAI 的 Codex 官网：**https://chatgpt.com/codex**
2. 点击大大的 **"下载应用"** 按钮

![图片](https://upload.maynor1024.live/file/1774358235775_image.png#imgIndex=9)

#### Mac 用户

Mac 用户最简单，直接打开：**App Store**，搜索：**Codex**，下载安装即可。

官方 macOS 下载链接：

- https://persistent.oaistatic.com/codex-app-prod/Codex.dmg

下载 Mac 安装包后，安装、登录即可。

![图片](https://upload.maynor1024.live/file/1774358277038_image.png#imgIndex=10)

#### Windows 用户

Windows 用户可以通过微软商店下载安装。

官方地址：

- https://pan.quark.cn/s/0f1763fe2ac9?pwd=rTQw

进入页面后：点击 **获取 / 下载**，按照提示安装即可。

系统要求：

- **Windows 10 19041 以上**
- **需要联网**

下载本身一点都不复杂。真正复杂的，从来不是"下载应用"，而是后面你如何理解它、配置它、组织你的任务。

> 💡 **现实提醒**：客户端下载地址、商店上架状态和系统要求都有时效性，后续请以官方页面实际展示为准。

### 2.5 第一次使用：从打开 App 到完成一个小任务

下载安装只是第一步。真正建议小白练的，是先跑通一个**很小、很具体、能马上验证**的任务。

推荐按这个顺序来：

| 步骤 | 动作 | 目的 |
|------|------|------|
| **1** | **打开 Codex App 并登录** | **确认账号和模型可用** |
| **2** | **添加一个项目文件夹** | **让 Codex 能看到要处理的文件** |
| **3** | **新建一条 Thread** | **把本次任务单独装起来，避免上下文混乱** |
| **4** | **用一句话描述目标** | **例如：把 README 的下载方式同步到首页** |
| **5** | **先让它列计划** | **确认会改哪些文件、怎么改** |
| **6** | **执行后检查结果** | **看 diff、预览页面、必要时再微调** |

最适合新手的练习任务，不是“一上来做个大系统”，而是：

- **改一个标题**
- **补一段说明**
- **把 README 内容同步到网页**
- **修一个明显的错别字或链接**
- **让它先分析项目结构，再给你改动建议**

> **核心原则：第一次不要追求大而全，先追求可验证。** 你能看懂它改了什么、能确认结果对不对，就已经跑通了最重要的一步。

### 2.6 Codex 多入口地图：不要只盯着一个按钮

很多教程会把 Codex 讲成一个单一工具：要么是 CLI，要么是桌面 App。更准确的理解是：

> **Codex 是一组入口协同的工作系统。**

不同入口适合不同任务，新手先理解这张表，后面会少走很多弯路：

| 入口 | 更适合什么 | 典型任务 |
|------|------------|----------|
| **桌面 App** | **本地多任务工作台** | **管理项目文件夹、开 Thread、用 Skills、跑自动化任务** |
| **CLI** | **贴近终端和本地仓库** | **修 bug、跑命令、补测试、解释项目结构** |
| **Cloud / Web** | **后台长任务和仓库协作** | **连接 GitHub、分析仓库、生成 PR、处理较长任务** |
| **IDE** | **编辑器上下文里的局部修改** | **解释代码、改当前文件、做局部审查** |
| **ChatGPT 手机端 Codex** | **离开电脑后继续跟进任务** | **查看进度、回复问题、审批操作、调整方向** |
| **MCP / 插件生态** | **连接外部工具和数据源** | **浏览器测试、Notion、Figma、飞书、GitHub、文件系统等** |

最简单的选择方法：

- **要频繁看命令输出**：用 CLI
- **要本地多任务、Skills、定时任务**：用桌面 App
- **要后台跑仓库任务、生成 PR**：用 Cloud / Web
- **正在编辑某个文件**：用 IDE
- **人离开电脑但任务不能停**：用 ChatGPT 手机端跟进

> **真正影响效率的不是你用了哪个入口，而是你有没有把任务放到合适的入口里。**

### 2.7 手机端协同：不是远程桌面，而是随身工作台

现在 Codex 也可以通过 **ChatGPT 手机 App** 来跟进任务。这里要说清楚一件事：

> **手机端 Codex 不是单独的手机 Codex App，也不是把手机变成远程桌面鼠标。**

更准确地说，它是让你在手机上连接正在运行的 Codex 环境，继续处理这些事情：

- **查看正在跑的 Thread 和任务进度**
- **阅读 Codex 的阶段性输出、终端日志、截图和 diff**
- **回复 Codex 的澄清问题**
- **审批命令、网络访问或其他需要人工确认的操作**
- **补充上下文，调整任务方向**

典型场景是：

```text
电脑上启动一个长任务
-> 人离开电脑
-> 手机端查看进度
-> 需要确认时直接回复或审批
-> 回到电脑后再做完整 diff review
```

但高风险操作，最好还是回到电脑上确认，比如：

- **删除文件**
- **发布部署**
- **数据库迁移**
- **支付、认证、权限相关修改**
- **需要长时间阅读大量 diff 的代码合并**

一句话总结：

> **手机端适合跟进和审批，不适合替代最终审查。**

---

## 三、核心概念解析

前面解决的是"怎么进门"，这一段解决的是：

> **你进门以后，怎么不迷路。**

> **大部分小白用 Codex 不顺，不是因为不会操作，而是因为没建立对它工作结构的理解。**

### 3.1 Threads（线程）系统

下载好、登录到 Codex 首页后，大概会看到类似这样的界面：

![图片](https://upload.maynor1024.live/file/1774358264919_image.png#imgIndex=11)

这里最核心的概念之一，就是 **Threads（线程）**。

这个词听起来有点技术，但你先不用怕。你就把它理解成：

> **一条围绕某个具体目标持续推进的任务线。**

### 3.2 两层结构详解

**Codex 左边这栏，其实是两层结构。**

| 层级 | 名称 | 作用 | 类比 |
|------|------|------|------|
| **第一层** | **文件夹（工作区）** | **项目目录 / 主题盒子** | **像一个项目群** |
| **第二层** | **Thread** | **独立的对话任务线** | **像群里的具体话题贴** |

> **文件夹装项目，Thread 装任务。**

- **一个文件夹里可以有很多条 Thread**
- **每条 Thread 都围绕一个明确目标推进**
- **文件夹负责放代码和资料，Thread 负责放过程和思路**

### 3.3 为什么这样设计？

> **它把最容易搅混的两件事，硬生生拆开了。**

| 传统方式的痛点 | Codex 的解决方案 |
|----------------|------------------|
| **上午写网页、下午算 Excel、晚上改文案，所有内容搅在一起** | **不同任务放进不同 Thread** |
| **上下文污染严重** | **对话和目标互不污染** |
| **AI 开始胡编乱造** | **可以断点续写，重新收束任务** |
| **找不到文件在哪** | **文件和资源分层更清晰** |

这张表讲的根本不是产品设计，而是：

> **为什么很多人第一次用 Codex，会突然觉得"终于没那么乱了"。**

### 3.4 黄金法则

> 🎯 **同一个文件夹里做同一个大方向，同一个 Thread 里只推进一件具体的事。**

对小白来说，这一句的重要性，甚至经常高于"怎么写 prompt"。因为你一旦把任务组织好，AI 才更容易稳定。

### 3.5 给 Codex 派任务的六要素

Codex 能不能稳定干活，不只取决于模型，也取决于你有没有把任务讲清楚。一个好任务，最好包含 6 个要素：

| 要素 | 写什么 | 示例 |
|------|--------|------|
| **目标** | **一句话说明要得到什么结果** | **修复登录页刷新后状态丢失的问题** |
| **背景** | **说明现象、上下文和为什么要改** | **用户登录后刷新页面会回到未登录状态** |
| **范围** | **限定目录、模块或文件** | **优先检查 `src/auth` 和相关测试** |
| **约束** | **明确禁止事项** | **不改数据库，不引入新依赖** |
| **验证** | **告诉它怎么检查结果** | **运行 `pnpm test auth`** |
| **交付** | **要求它最后怎么总结** | **说明根因、改动文件、验证结果和风险** |

模糊写法：

```text
帮我优化登录逻辑。
```

更好的写法：

```text
请修复登录页刷新后状态丢失的问题。

背景：
- 用户登录后刷新页面，会回到未登录状态。
- 期望刷新后仍能恢复已登录状态。

范围：
- 优先检查 src/auth 和相关测试。
- 不改数据库和后端接口。

验证：
- 运行 pnpm test auth。
- 如果需要新增测试，请覆盖刷新恢复状态的场景。

交付：
- 说明根因、改动文件、验证结果和剩余风险。
```

如果任务比较大，可以先这样说：

```text
请先不要修改代码。先阅读相关文件，分析这个任务会影响哪些模块，并输出：
1. 影响面
2. 推荐实施步骤
3. 每一步的验证方式
4. 第一阶段最小改动建议
```

> **小任务直接做，大任务先拆开。先让 Codex 看清边界，再让它动手。**

---

## 四、项目文件夹管理

> **你后面越用越乱，大概率不是因为 Codex 不行，而是因为你的项目组织方式从一开始就乱。**

### 4.1 推荐的文件夹结构

**正式开始前，最好先把分类想清楚。** 例如作者自己电脑上的一个目录结构：

```text
dev/
├── Learning/      # 学习资料
├── notes/         # 文章和笔记
├── Projects/      # 真实开发项目任务
├── sandbox/       # 沙盒（乱七八糟的东西）
└── tools/         # 通用脚本、可复用组件、小工具
```

![图片](https://upload.maynor1024.live/file/1774358310568_image.png#imgIndex=12)

这个结构好在哪？天然就把不同用途拆开了：

- **学习资料** 不会混进正式项目
- **真实项目** 不会跟测试垃圾混在一起
- **通用工具** 不会散落各个目录

### 4.2 Projects 示例

| 项目 | 说明 |
|------|------|
| **AI 热点** | **热点追踪项目** |
| **飞书机器人** | **多个不同功能的飞书机器人** |

![图片](https://upload.maynor1024.live/file/1774358254412_image.png#imgIndex=13)

比如这里提到的一个具体案例：

> **把公众号数据定时爬下来，再存到多维表格里的飞书机器人。**

![图片](https://upload.maynor1024.live/file/1774358297085_image.png#imgIndex=14)

这说明了一件事：

> **Codex 并不只适合"纯代码项目"，它也适合很多真实业务型任务。**

### 4.3 添加项目文件夹

本地建好文件夹之后，可以从入口把项目目录加进 Codex：

![图片](https://upload.maynor1024.live/file/1774358266229_image.png#imgIndex=15)

比如你想开发一个 AI 热点网站，就可以把对应文件夹加进去，再在里面开一条 Thread：

![图片](https://upload.maynor1024.live/file/1774358248581_image.png#imgIndex=16)

> ⚠️ **前期分类非常重要。真的不要什么任务都随手乱开，更不要把完全不同的事情全塞进同一个地方。** 你前面懒一次，后面会乱很多次。

---

## 五、功能与配置项

这一部分会让很多小白第一次意识到：

> **原来 Codex 不是"一个会写代码的框"，而是一整套图形化工作流。**

### 5.1 功能一：定时任务

![图片](https://upload.maynor1024.live/file/1774358230424_image.png#imgIndex=17)

> **Codex 可以在特定日期去干特定的事。**

代入真实场景就知道它为什么厉害了：

| 场景 | 说明 |
|------|------|
| **服务器托管** | **多个项目跑在云服务器上，但作者本人并不懂服务器** |
| **自动化巡检** | **Codex 每天早上 9 点自动巡检服务器，检查报错** |
| **自动修复** | **如果有报错，会自己解决并总结原因** |
| **通知推送** | **再通过飞书机器人发给作者** |

![图片](https://upload.maynor1024.live/file/1774358321275_image.png#imgIndex=18)

这一套组合起来，体现的是：

> **你不是在"偶尔问一下 AI"，而是在把 AI 接进你的日常工作流程。**

### 5.2 功能二：Skills（技能）

![图片](https://upload.maynor1024.live/file/1774358326352_image.png#imgIndex=19)

如果说定时任务让 Codex 更像一个"自动执行者"，那么 Skills 则让它更像一个"可扩展能力平台"。

> **这是第一次，Skills 真正拥有了自己的可视化、图形化管理界面。**

传统命令行风格的 Skill 体验，最大的问题就是：

- **不知道自己装了什么**
- **不知道装到哪了**
- **不知道这个 Skill 到底能干嘛**

| 对比项 | Codex | Claude Code / OpenCode |
|--------|-------|------------------------|
| **Skills 管理** | ✅ **图形化界面，轻松管理** | ❌ **不知道装了哪些、装到哪、有什么用** |
| **Skills 创建** | ✅ **内置 Skill Creator** | ❌ **需要自己找、自己安装** |

### 5.3 Skill Creator 使用

Codex 自带 **Skill Creator**——以前你得先知道怎么装、怎么找、怎么配；现在你可以先说"我要什么"，再让系统帮你往下走。

**步骤 1：点击右上角的 "New Skill"**

![图片](https://upload.maynor1024.live/file/1774358326136_image.png#imgIndex=20)

**步骤 2：直接告诉它，你想做什么 Skill**

![图片](https://upload.maynor1024.live/file/1774358309454_image.png#imgIndex=21)

对小白最大的价值不是"省一点操作"，而是：

> **你终于可以从功能需求出发，而不是先被安装和配置门槛拦住。**

### 5.4 进阶能力：MCP、记忆系统、云端运行和电脑自动化

视频里还提到几类更进阶的能力，建议小白先建立概念，不必一开始全都配置。

| 能力 | 简单理解 | 适合什么时候用 |
|------|----------|----------------|
| **MCP** | **给 Codex 接更多外部工具和数据源** | **需要连浏览器、数据库、GitHub、文件系统等工具时** |
| **记忆系统** | **让 Codex 记住你的长期偏好和项目规则** | **固定协作风格、固定输出格式、固定代码规范时** |
| **云端运行** | **把任务放到云端环境里跑** | **本地电脑不方便长时间运行，或希望异步推进任务时** |
| **电脑自动化** | **让 Codex 操作浏览器或桌面应用** | **需要填表、点页面、检查网页效果、处理重复操作时** |

这几项能力可以让 Codex 从“改代码工具”继续升级成“工作流助手”。但新手要注意顺序：

```text
先学会文件夹 + Thread + Plan Mode
再学会设置规则和看 diff
最后再接 MCP、云端运行和电脑自动化
```

> ⚠️ **不要为了高级而高级。** MCP、云端和自动化都涉及权限、账号和数据访问，接入前一定要想清楚它能看到什么、能改什么、会不会碰到敏感信息。

---

## 六、设置配置

> **你后面用起来顺不顺，很多时候就取决于前面这几项配没配对。**

### 6.1 General 设置

先改这两项：

| 配置项 | 推荐设置 | 说明 |
|--------|----------|------|
| **保持电脑开机** | ✅ **打开** | **允许后台运行** |
| **Follow-up behavior** | **steer** | **开发过程中可随时发消息调整任务** |

![图片](https://upload.maynor1024.live/file/1774358287646_image.png#imgIndex=22)

简单理解：

- **保持电脑开机**：让它能继续跑
- **steer**：让你能在开发过程中不断纠偏

### 6.2 Personalization（个性化设置）

> **Personalization，本质上就是图形界面的 `AGENT.md` / `AGENTS.md`。**

![图片](https://upload.maynor1024.live/file/1774358223960_image.png#imgIndex=23)

这里不是"随便写点喜好"的地方，而是你告诉 Codex：

- **你喜欢它怎么协作**
- **你要求它怎么改代码**
- **你希望它怎么解释和输出**

### 6.3 推荐的全局规则

README 里给了一套很适合新手抄走就能用的规则模板，压缩成最好记的版本就 7 条：

- **改动要小，方便审查**
- **动手前先说文件和计划**
- **不胡编路径和配置**
- **不要泄露密钥和敏感信息**
- **行为变化尽量补测试**
- **执行命令前说明为什么**
- **默认中文，表达简洁，可复制**

> **提前把你的协作原则写进去，让 Codex 从第一轮开始就按你的规则工作。**

### 6.4 项目级 AGENTS.md：让 Codex 真正懂你的仓库

Personalization 更像全局规则，而 **`AGENTS.md`** 更适合写进具体项目。它的作用是告诉 Codex：

- **这个项目是什么**
- **常用命令怎么跑**
- **哪些目录不能乱改**
- **代码风格是什么**
- **测试和交付要求是什么**
- **哪些操作必须先问你**

建议放在项目根目录：

```text
your-project/
├── AGENTS.md
├── package.json
└── src/
```

可以直接用这个最小模板：

```markdown
# AGENTS.md

## 项目概览

- 项目类型：
- 主要语言：
- 关键目录：

## 常用命令

- 安装依赖：`...`
- 本地开发：`...`
- 运行测试：`...`
- 类型检查：`...`
- 格式化：`...`

## 代码规范

- 遵循现有代码风格。
- 不做无关重构。
- 新增功能必须补充或更新测试。

## 安全边界

- 不读取或提交 `.env`、密钥和私有凭据。
- 不执行删除生产数据的命令。
- 修改数据库迁移前先说明影响。

## 交付要求

- 说明改动文件。
- 说明验证命令和结果。
- 说明未验证项和剩余风险。
```

新手只要先写清 3 件事就够了：

1. **项目命令**
2. **不要改什么**
3. **改完怎么验证**

> **提示词解决一轮对话，AGENTS.md 解决长期协作。**

### 6.5 权限设置

在对话首页，把权限改成 **Full access**：

![图片](https://upload.maynor1024.live/file/1774358260172_image.png#imgIndex=24)

> 💡 **好处：让 Codex 对你的电脑有更高访问权限，不用每次都来回征求确认，任务推进效率会高很多。**

- **想要更顺、更连贯、更像真人干活** → **Full access**
- **想每一步都自己确认** → **保守模式**

没有绝对对错，主要看你的环境和风险偏好。

### 6.6 沙盒、审批和安全边界

Full access 的效率很高，但不代表所有任务都应该无脑放行。建议把任务分成两类：

| 类型 | 可以更快推进 | 建议先确认 |
|------|--------------|------------|
| **低风险任务** | **改文档、补测试、修本地可复现 bug、运行已有测试命令** | **一般确认计划后就能做** |
| **高风险任务** | **删除文件、数据库迁移、发布部署、生产服务、支付/认证/权限、读取敏感数据** | **必须先说明影响，再人工确认** |

可以把这段直接写进全局规则或 `AGENTS.md`：

```text
请在动手前先说明你计划运行的命令和可能影响的文件。
不要读取 .env、密钥、token 或任何私有凭据。
不要执行删除数据、发布、部署或迁移命令，除非我明确确认。
```

尤其要注意这几类操作：

- **删除、覆盖、批量移动文件**
- **安装新依赖或大版本升级**
- **访问生产数据库或生产服务器**
- **提交表单、付款、改权限**
- **读取 cookie、token、API Key、私有配置**

> **效率和安全不是二选一。正确做法是：低风险自动化，高风险人工确认。**

---

## 七、对话功能详解

到了这里，真正开始进入"怎么用"的层面。

### 7.1 斜杠命令

在对话框里输入 `/`，就能调起特殊功能：

![图片](https://upload.maynor1024.live/file/1774358312531_image.png#imgIndex=25)

> **Codex 不是单纯聊天，它有明确的任务模式和系统操作入口。**

### 7.2 重要功能：Plan Mode（规划模式）

如果这篇文章你只记住一个功能，那就是：

> **Plan Mode。**

你最容易卡住的不是"不会写"，而是：

- **不知道从哪开始**
- **不知道要改哪些文件**
- **不知道先做什么后做什么**
- **不知道需求有没有漏项**

Plan Mode 干的事，就是先帮你把这些理顺。

| 功能 | 说明 |
|------|------|
| **作用** | **只规划，不写代码** |
| **图标** | **会出现一个小图标** |
| **适用场景** | **每个大型项目（从 0 到 1）的起始阶段** |

![图片](https://upload.maynor1024.live/file/1774358329472_image.png#imgIndex=26)

推荐工作流：

```text
大型项目 → 先用 Plan 模式规划 → 形成规范文档和实现计划 → 再开始开发
```

实际案例：构建一个管理 AI 热点网站信源的 Skill。

![图片](https://upload.maynor1024.live/file/1774358329359_image.png#imgIndex=27)

过一段时间后，你就能拿到这样一份计划：

![图片](https://upload.maynor1024.live/file/1774358281596_image.png#imgIndex=28)

确认没问题后，选择 **"是"** 即可。然后 Plan 图标消失，正式进入开发：

![图片](https://upload.maynor1024.live/file/1774358293804_image.png#imgIndex=29)

> **Plan Mode 对小白最大的价值，不是它多了个按钮，而是它帮你把"乱做"变成"先想清楚再做"。**

### 7.3 重要功能：Status（状态查看）

输入 `/status`，就能看到：

- **当前周期的用量**
- **剩余额度**
- **当前模型 / 会话状态等信息**

![图片](https://upload.maynor1024.live/file/1774358301530_image.png#imgIndex=30)

越用越多，就越需要知道 **自己当前到底在什么状态、还剩多少资源**。

### 7.4 模型推理深度

![图片](https://upload.maynor1024.live/file/1774358245009_image.png#imgIndex=31)

| 等级 | 说明 | 推荐场景 |
|------|------|----------|
| **Low** | **最快最省** | **简单任务** |
| **Medium** | **平衡** | **一般任务** |
| **High** | **日常推荐** | **日常开发** |
| **Extra High** | **最稳最全** | **难活、硬活、大活** |

不想记太多，直接记这句就够了：

> **平时用 High，难活用 Extra High。**

---

## 八、开始 Vibe Coding

讲到这里，很多人会突然发现：

> **原来最难的不是操作，而是前面那些认知。**

一旦前面的结构你理解了，真正开始开发反而简单。

### 8.1 开发方式

> **Coding 这块反而没啥好说的了，直接用嘴描述你的需求就行。**

Codex 右下角有 **麦克风**，作者在 README 里提到自己经常就是直接开麦说：

![图片](https://upload.maynor1024.live/file/1774358337645_image.png#imgIndex=32)

这背后真正体现的不是"语音很酷"，而是：

> **你和 AI 的协作门槛，已经从"会不会写代码"越来越变成"会不会描述需求"。**

### 8.2 我的开发习惯

非常建议直接照着练：

| 步骤 | 操作 |
|------|------|
| **1** | **先打开 Plan 模式** |
| **2** | **用自然语言描述需求**（前端强调设计 Skill，服务器问题用对应 Skill） |
| **3** | **计划生成后再开始开发** |
| **4** | **开发完第一时间看前端效果** |
| **5** | **效果可行就继续微调；效果不好就重做前端** |

最值钱的不是某个具体按钮，而是这个顺序本身：

> **先规划，再开发；先看结果，再决定下一步。**

### 8.3 前端问题的解决方案

README 也很坦诚，没有故意把 Codex 神化：

> ⚠️ **Codex 的前端能力有时候确实一般。**

![图片](https://upload.maynor1024.live/file/1774358238088_image.png#imgIndex=33)

很多小白最容易陷入的误区：

> **既然用了 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 是可以并行推进的**：

![图片](https://upload.maynor1024.live/file/1774358284315_image.png#imgIndex=34)

意味着你可以从"一次只做一件事"，升级到"不同目标拆成不同 Thread，同时推进"。这其实就是 AI 协作能力真正开始变强的标志。

### 8.5 代码管理：让 Codex 改代码，但不要把项目弄乱

Codex 越能干，越要养成基本的代码管理习惯。尤其是小白，不要只看“它帮我改完了”，还要看“它到底改了什么”。

建议每次任务都按这套检查：

| 检查项 | 建议动作 |
|--------|----------|
| **改动范围** | **先看它准备改哪些文件，不要让小任务变成大重构** |
| **代码差异** | **用 `git diff` 或界面里的 diff 看每个改动** |
| **运行检查** | **能跑测试就跑测试，静态网页至少本地预览一下** |
| **提交节奏** | **一个明确目标提交一次，不要把很多无关修改混在一起** |
| **回退意识** | **不确定的改动先别提交，确认结果没问题再 commit** |

可以直接这样要求 Codex：

```text
先不要动代码，先告诉我要改哪些文件、每个文件为什么要改。
改完后请给我总结 diff，并告诉我应该运行哪个最小检查命令。
```

对新手来说，Git 不一定一开始就要很精通，但至少要记住三件事：

1. **改之前知道目标**
2. **改之后看 diff**
3. **确认没问题再提交**

> **会让 Codex 写代码只是第一层，会让 Codex 在可控范围内写代码，才是真正能长期用起来的关键。**

### 8.6 可以补充的真实工作流案例

如果只讲安装和写代码，很多小白还是不知道 Codex 到底能干什么。更容易理解的方式，是直接给场景：

| 场景 | Codex 可以怎么用 | 验证重点 |
|------|------------------|----------|
| **PPT / 演示文稿** | **根据主题生成结构、页面文案和初版素材** | **逻辑结构、视觉统一、导出效果** |
| **Obsidian / 知识库** | **整理文章、建立索引、生成选题池、补充引用** | **文件路径、链接、来源是否准确** |
| **浏览器自动化** | **检查网页、填写测试表单、截图验证前端效果** | **页面状态、点击路径、是否误提交** |
| **Figma / 设计协作** | **读取设计稿、提取布局和组件边界** | **设计 token、间距、组件还原度** |
| **Notion / 飞书** | **读取数据库、汇总内容、生成日报或同步资料** | **权限范围、字段映射、写回位置** |
| **GitHub Actions CI** | **分析失败日志、定位原因、提出最小修复** | **失败复现、测试通过、PR 描述清楚** |
| **远程服务器排障** | **读取日志、定位报错、给出修复步骤** | **不碰生产数据，先复现再修复** |

对非程序员来说，最有价值的不是让 Codex “写一段代码”，而是把它接进真实工作流：

```text
资料输入
-> Codex 分析和整理
-> 生成可检查产物
-> 人工确认
-> 沉淀成模板 / Skill / AGENTS.md
```

> **一次任务做成结果，多次任务沉淀流程。Codex 真正值钱的地方，是让你的工作方法可复用。**

---

## 九、总结

> **Vibe Coding 这个东西，对非程序员来说，可能比对程序员更有价值。**

对程序员来说，它更多是：提效、加速、减少重复劳动。但对非程序员来说，它更像是：

> **把一道原本根本跨不过去的门槛，第一次给你铲平了。**

| 人群 | AI 的价值 |
|------|-----------|
| **程序员** | **提效工具** |
| **非程序员** | **直接把一道原本过不去的坎给铲平了** |

> **在未来，会用 AI 写代码，会变成像会用 Excel 一样的基本技能。**

这不是鸡汤，这是趋势。而且已经在发生了。

---

## 快速参考卡

### Codex vs Claude Code 快速对比

| 对比项 | Codex | Claude Code |
|--------|-------|-------------|
| **开发商** | **OpenAI** | **Anthropic** |
| **核心模型** | **GPT-5.5（最新旗舰）/ GPT-5.3-codex（历史主打）** | **Claude Opus 4.6** |
| **界面** | ✅ **图形化** | **命令行** |
| **Skills 管理** | ✅ **图形化界面** | **命令行为主** |
| **定时任务** | ✅ **支持** | **需要自己配置** |
| **前端能力** | ⚠️ **有时一般** | ✅ **通常更强** |

### 推荐设置速查

| 设置项 | 推荐值 |
|--------|--------|
| **Follow-up behavior** | **steer** |
| **权限** | **Full access** |
| **推理深度（日常）** | **Medium** |
| **推理深度（大活）** | **High / Extra High** |

### 常用斜杠命令

| 命令 | 功能 |
|------|------|
| **`/plan`** | **进入规划模式** |
| **`/status`** | **查看用量和剩余额度** |

---

## 最后给小白一句最实用的话

如果你今天刚接触 Codex，我最建议的起步方式不是"上来就做一个大项目"，而是先做一件很小、很具体、很容易验证的事，比如：

- **改一个静态页面标题**
- **把获取方式提到首屏**
- **把 README 改成网页**
- **把图片融入正文**
- **把长链接改成蓝链**

小白用 Codex，真正最重要的不是先学会所有技术细节，而是先建立 3 个能力：

1. **会描述目标**
2. **会拆分任务**
3. **会检查结果**

只要这 3 件事你开始做顺了，后面你会越来越快地进入状态。而一旦你真的开始顺起来，你就会发现：

> **你不是在"学一个 AI 工具"，你是在学一种新的做事方式。**