Codex 新手第一课:别急着装插件,先把这 5 件事搞明白

最近开始学 Codex，第一个感受是：它不难上手，但新手很容易在概念上绕晕。项目和任务有什么区别？Local、Worktree、Cloud 该选哪个？Plan 是不是每次都要开？插件、Skill、MCP 又是什么关系？

这篇是我整理的新手笔记，不讲高深技巧，只把最容易卡住的几个点说清楚。如果你也是刚开始用，希望能帮你少走点弯路。

一、先分清项目和任务

Codex 里有两个最基本的单位：项目和任务。

项目对应一个长期的工作目录，比如你正在做的一个网站、一个小程序。任务是项目下面的一次独立对话，最好只负责一个明确的结果，比如“修掉登录页的报错”或者“给这个函数补上注释”。

一个实用的习惯是：一个任务只做一件事。如果旧任务里已经混进了不相关的内容，而你的新需求又完全是另一回事，那就新开一个任务，别在旧对话里接着聊。上下文越干净，它出错的概率越小。

二、工作区只给最小目录

开始任务之前，先问自己一个问题：完成这件事，需要的文件能不能集中到一个最小的文件夹里？

如果能，就只打开那个文件夹。不要顺手把整个桌面、整个用户目录或者好几个无关项目一起交给它。给的范围越大，它误改、误读的风险就越大，出了问题你也越难排查。

只分析不修改的时候尤其如此，先把权限收紧，再让它看。

三、Local、Worktree、Cloud 怎么选

这是新手最容易纠结的地方，其实按场景选就行，不用全学会。

Local 是最直接的：直接改你当前目录里的文件，适合绝大多数日常任务。缺点是，如果你同时在手动改同一个文件，两边可能互相干扰。

Worktree 是给同一个仓库开一个隔离副本，适合两种情况：一是想并行做两个互不依赖的改动，二是想先试验一下，效果好再合并回来。小改动没必要每次都用，流程反而变重。

Cloud 是在远端隔离环境里跑，适合边界很清楚、可以慢慢等的活，比如审一段代码、修一个明确的 Issue、批量重构。做完先看 Diff，满意再合并。

一句话总结：日常用 Local，想并行或先试验用 Worktree，能异步等的远程活用 Cloud。

四、Plan 不是必选项

很多人以为每次都要先列计划，其实不用。

任务复杂、多文件、不好回退，或者需要先调查再比较方案的时候，先做计划是值得的。改个标题、查个报错位置、执行一条确定的命令，直接做就行，硬列计划反而浪费时间。

一份有用的计划不用很长，只要能回答四个问题：真正要解决的是什么？需要看哪些材料？会改哪些地方？最后怎么证明做完了？

还有一个原则：能直接完成就别额外搭流程，能复用就别重做，能局部改就别推倒重来，能一条命令解决就别写脚本。

五、权限别图省事开满

Codex 的沙盒权限一般分三档，日常记住两档就够了。

Workspace-write 能覆盖大多数工作，是日常默认的好选择。只分析不修改的时候，用 Read-only。Full access 不要为了少点几次确认就开着，尤其不要用在无人值守的定时任务上，风险和便利不成正比。

每次它请求审批的时候，别急着点通过，先看一眼：这条命令要做什么？在哪个目录执行？需不需要联网？跟当前目标有没有关系？安装依赖、上传文件、删除数据、改账号设置、对外发布、碰到凭据的时候，都值得停下来确认一下。

六、写一份 AGENTS.md，比记一堆技巧管用

AGENTS.md 是 Codex 进入项目时会读取的长期规则文件，相当于你给它的项目说明书。里面适合写：构建命令、目录结构、代码规范、验收方式，还有明确的禁做事项。

新手可以先用 /init 生成一份初稿，再删掉没用的部分，只留下真正踩过坑才总结出来的规则。规则贵在短而准，来自真实问题，而不是一开始就写一大套用不上的条条框框。

七、Skill、Plugin、MCP 一句话分清

这三个词最容易混，其实分工很清楚。

Skill 是操作手册，教它怎么做一类事情，本质上是一个目录，核心是一份 SKILL.md，加上步骤、模板或者脚本。

Plugin 是能力包，把一组 Skill、连接器打包在一起分发，装一个就能用一整套能力。

MCP 是外部接口，让它能连上外部工具和数据，比如文档、设计稿、报错监控这些系统。

实际工作里缺哪一层补哪一层就行，不必五个一起上。重复出现的工作才值得固化成 Skill，需要外部系统的数据或动作才接 MCP，需要一整套现成能力才装 Plugin。

八、新手从 0 到 1 的练习顺序

给自己排个顺序，比同时学所有功能靠谱。

第一阶段，只练三件事：选对工作区、新建任务、学会看 Diff。能独立判断它改了什么、有没有越界，就算基础过关。

第二阶段，加入 Plan 和检查：复杂任务先看计划，做完自己先运行检查，再让它独立审查一次改动。

第三阶段，才碰 Worktree 和多任务并行，前提是确实有两个互不依赖的任务。能顺手做完的事，别硬拆成多份。

第四阶段，按真实需求装扩展：重复工作固化成 Skill，需要外部系统才接 MCP，需要定时或跨天运行才开 Automation 和长期目标。

新手第一天清单

对照着走一遍，基本就入门了：

• 选一个最小的工作目录，只打开它
• 新建一个任务，只交代一件明确的事
• 权限保持 Workspace-write，别开 Full access
• 做完先看 Diff，确认改了什么再提交
• 把一条真实踩坑经验写进 AGENTS.md

最后说一句

用得熟不熟，不取决于装了多少插件，也不取决于提示词写得多长，而取决于三件事：给没给对材料和边界，执行中能不能及时纠偏，能不能用 Diff、终端输出和测试结果判断它到底做对了没有，而不只是看一句“已经完成”。

这篇是学习整理笔记，知识点参考了公开资料和官方文档，具体功能以你手头版本的官方文档为准。如果你也在学 Codex，欢迎在评论区说说你卡住的第一步是什么。