文章目录
- [Codex 核心玩法全梳理(技能/MCP/派生/分叉/Git/钩子)](#Codex 核心玩法全梳理(技能/MCP/派生/分叉/Git/钩子))
- [一、基础必懂:工作树(Work Tree)](#一、基础必懂:工作树(Work Tree))
- 二、最常用:派生(Derive)
- 三、进阶:分叉(Fork)
- 四、超级神器:Skills(技能)
-
- [1. 什么是 Skills?](#1. 什么是 Skills?)
- [2. 为什么强?](#2. 为什么强?)
- [3. 存放位置](#3. 存放位置)
- [4. 最简单创建方式](#4. 最简单创建方式)
- [5. 使用](#5. 使用)
- [6. 官方支持的技能类型](#6. 官方支持的技能类型)
- 7.推荐的skills
- [五、最强扩展:MCP(Model Control Protocol)](#五、最强扩展:MCP(Model Control Protocol))
-
- [1. MCP 是什么?](#1. MCP 是什么?)
- [2. 能做什么?](#2. 能做什么?)
- [3. 一句话理解](#3. 一句话理解)
- 六、自动化:钩子(Hooks)
-
- [1. 钩子 = 触发式自动化脚本](#1. 钩子 = 触发式自动化脚本)
- [2. 支持的钩子](#2. 支持的钩子)
- [3. 用途示例](#3. 用途示例)
- [4. 配置位置](#4. 配置位置)
- 七、codex子智能体
-
- [0、什么是 Codex 子智能体(Subagent)](#0、什么是 Codex 子智能体(Subagent))
- 1、最通俗的比喻
- 2、它和普通"新开页面"唯一的小区别(很重要)
- [八、与 Git 深度集成(Codex 原生支持)](#八、与 Git 深度集成(Codex 原生支持))
-
- [1. 不用你手动敲 Git 命令](#1. 不用你手动敲 Git 命令)
- [2. Codex 会自动:](#2. Codex 会自动:)
- [3. 最强功能:AI 帮你写 commit 信息](#3. 最强功能:AI 帮你写 commit 信息)
- [4. 最安全:AI 自动检查冲突](#4. 最安全:AI 自动检查冲突)
- [九、最常用组合 workflow(直接照抄用)](#九、最常用组合 workflow(直接照抄用))
-
- [1. 安全开发流](#1. 安全开发流)
- [2. 标准化开发流](#2. 标准化开发流)
- [3. 全自动化流](#3. 全自动化流)
- [4. 多项目管理流](#4. 多项目管理流)
Codex 核心玩法全梳理(技能/MCP/派生/分叉/Git/钩子)
一、基础必懂:工作树(Work Tree)
什么是工作树?
= Codex 操作的"当前项目目录"
你每次打开 Codex,选的那个文件夹,就是一个工作树。
作用
- Codex 只会读写这个目录里的文件
- 切换工作树 = 切换项目
- 所有修改、历史、技能、配置都绑定当前工作树
常用操作
- 打开新目录 = 新工作树
- 切换已有目录 = 切换工作树
- 关闭 = 退出当前工作树
二、最常用:派生(Derive)

两个选项详细区别
1. 派到本地

- 工作空间 :完全沿用你当前正在打开的本地文件夹/原有Git工作区,不会新建独立代码目录。
- 文件影响:新分支对话里AI后续生成、修改的代码,会直接改动你现在磁盘里的文件。如果之前轮次改动过文件系统,新分支内容会和当前磁盘文件存在不一致的风险。
- 适用场景:只想基于旧消息开一条新对话思路,继续在当前项目目录里迭代,不需要物理隔离代码文件。
还是在当前目录,只不过新开了一个分支对话
2. 派到新工作树

- 工作空间 :会基于Git的
worktree功能,创建一个全新、物理隔离的独立代码文件夹(共享同一个Git仓库版本库,但文件目录完全分开)。 - 文件影响 :AI后续所有代码操作都在这个新目录里进行,完全不会干扰你原本打开的项目文件,天然规避新旧内容冲突的问题。
- 适用场景:想并行做两套完全独立的方案、做高风险实验性修改,需要两套代码互不干扰、可以同时查看编辑。
不在当前目录,默认会在codex的worktree里面复制新建一个与刚刚完全一样的环境
核心对比表
| 对比维度 | 派到本地 | 派到新工作树 |
|---|---|---|
| 代码目录 | 沿用当前已有目录 | 新建独立隔离目录 |
| 原文件安全性 | 后续改动会直接影响原文件 | 原文件完全不受新分支改动影响 |
| 并行开发 | 不能同时看新旧两套代码 | 可以同时打开两个目录并行推进不同方案 |
| 冲突风险 | 存在和当前磁盘文件不一致的冲突风险 | 几乎无文件冲突风险 |
简单举例子
你现在在/project/main做开发,想基于3轮前的消息换思路:
- 选派到本地 :新对话改的代码直接写进
/project/main里; - 选派到新工作树 :会自动生成
/project/new-fork新文件夹,新对话所有改动都在这个新文件夹里,原来的main文件夹内容纹丝不动。
三、进阶:分叉(Fork)
分叉 = 给当前工作树创建一个"可回溯的版本快照"
不是 Git 分叉,是 Codex 内部快照。
用途
- 改代码前先分叉
- 改错了可以一键切回去
- 相当于手动版本控制
用法
右键工作树 → Fork
改崩了 → 切回旧分叉
四、超级神器:Skills(技能)
1. 什么是 Skills?
= 你教给 Codex 的固定工作流
= 可复用的提示词模板 + 规则 + 自动化步骤
2. 为什么强?
你写一次规则,Codex 永远记住 ,以后一句话就能调用。

你可以通过codex里面的插件商城安装skil
3. 存放位置
你的项目目录/.codex/skills/

上面是我自己装的一些skills。
4. 最简单创建方式
在 .codex/skills/ 新建文件:
vue3-component.md
内容示例:
# 技能:生成 Vue3 组件
规则:
- 必须用 script setup
- 必须定义 props
- 必须带注释
- 样式用 scoped
输出:一个完整单文件组件
5. 使用
直接在 Codex 里说:
使用技能 vue3-component 生成一个用户卡片组件
6. 官方支持的技能类型
- 代码规范
- 项目架构规则
- 接口开发模板
- 数据库建模模板
- 自动化流程
- 代码审查标准
Skills 是 Codex 效率提升最大的功能。
7.推荐的skills

github上有非常多好的skill,比如👆上面这些,可根据需求安装对应的skills使你的codex更上一层楼
五、最强扩展:MCP(Model Control Protocol)

1. MCP 是什么?
Codex 的插件系统
让 AI 能调用外部工具:浏览器、数据库、Redis、设计图、API 等。
2. 能做什么?
- 读取网页内容生成代码
- 连接数据库生成 CURD
- 读取 Figma 设计稿生成页面
- 调用 API 生成接口代码
- 读取 PDF/Excel 生成解析脚本
3. 一句话理解
MCP = 给 Codex 装上眼睛和手脚
让它不只写代码,还能读外部数据。
六、自动化:钩子(Hooks)
1. 钩子 = 触发式自动化脚本
Codex 在特定事件自动执行命令。
2. 支持的钩子
- 生成代码前
- 生成代码后
- 保存文件前
- 派生前/后
- 分叉前/后
3. 用途示例
- 代码生成后自动格式化
- 保存后自动运行 lint
- 派生后自动安装依赖
- 修改后自动运行测试
4. 配置位置
.codex/hooks/
写脚本即可自动触发。
七、codex子智能体

Subagent 子智能体 ≈ 就是在 Codex 里新开了一个独立页面
0、什么是 Codex 子智能体(Subagent)
你是项目经理 ,Codex 主 Agent 是总负责人 ,子智能体就是专门干活的程序员。
- 主Agent(父智能体)
接收你的整体需求,拆解任务、分配工作、汇总所有子智能体的结果,最后统一交付给你。 - 子智能体(Subagent)
由主Agent自动创建、单独执行细分任务的独立AI实例,每个子智能体拥有独立上下文、独立文件操作环境、独立对话窗口,互不干扰,可以并行干活。
两大核心特性
- 上下文隔离
每个子智能体有专属对话记忆,不会污染主对话、不会互相抢上下文,主对话不会堆满细碎代码日志。 - 并行执行
可以同时启动多个子智能体,一个改前端、一个写接口、一个写单元测试,同步推进,不用排队等AI跑完一个任务再开下一个。
1、最通俗的比喻
主对话 = 你的主微信窗口
Subagent(子智能体)= 你点开的一个单独聊天窗口**(分支对话)**
它们的关系就是:
- 独立聊天
- 独立记忆
- 独立干活
- 互相不干扰
2、它和普通"新开页面"唯一的小区别(很重要)
普通新开页面:
- 空白的
- 没有历史上下文
- 不知道你之前写了什么代码
Subagent(子智能体)新开的页面:
- 带着你之前的代码、历史、项目环境一起过去
- 相当于从当前对话"分叉"出去一个独立版本
- 可以单独改代码、单独跑命令、单独生成文件
- 不会影响主对话
你在 Codex 里看到:
- 主窗口
- Singer
- Dirac
- Bacon
- Dewey
每一个名字,就是一个 subagent,就是一个独立页面!
总结
Subagent 子智能体 = Codex 里的独立对话页面
八、与 Git 深度集成(Codex 原生支持)
关于这部分的内容有兴趣可以翻看本系列中我对git的详细讲解的相关博客。这里只大概介绍下
1. 不用你手动敲 Git 命令
你只需要说:
- 提交代码
- 撤销修改
- 切换分支
- 合并分支
- 查看改动
2. Codex 会自动:
- git add
- git commit
- git push
- git diff
- git checkout
- git merge
3. 最强功能:AI 帮你写 commit 信息
你只需要说:
提交本次修改,生成清晰的 commit 信息
4. 最安全:AI 自动检查冲突
Codex 会:
- 告诉你哪里冲突
- 帮你自动解决
- 不会乱覆盖代码
九、最常用组合 workflow(直接照抄用)
1. 安全开发流
Fork(分叉)→ 写代码 → 测试 → Derive(派生)→ Git 提交
永远不弄脏原项目
2. 标准化开发流
Skills(加载规范)→ 生成代码 → Hooks(自动格式化)→ Git 提交
3. 全自动化流
MCP(读取Figma/接口)→ Skills → 生成代码 → Hooks → Git 提交
4. 多项目管理流
工作树 1 → 派生 → 新工作树 2
工作树 A ↔ 工作树 B 自由切换