Claude Code × Codex 协作手册(零基础版)
写给谁不懂编程、但正在用或准备用Claude Code、Codex 这类 AI 编程工具做产品的人。 读完你会得到3 个保命习惯 1 套可以直接复制的话术。照着做AI 换着用、账号被封、隔几天再打开项目都不会乱随时有人能接着干。 全程不需要你会写代码、不需要记任何命令——所有配置都是复制一段话发给 AI它自己搞定。 本手册是零基础版想看底层原理和命令细节的技术版一、先搞懂一件事AI 工程师的失忆症把 Claude Code 和 Codex 想象成两位很能干的外包工程师手速快、不喊累、半夜也在线。但他们有两个致命毛病。第一失忆。每次新开一个对话他就忘了之前的一切。你上周教他的规矩、他自己踩过的坑这周得从头再说一遍。第二可能突然消失。账号被封、额度用完、服务抽风……说没就没。更麻烦的是他小本本上记的东西聊天记录也跟着一起没了。这份手册的全部内容其实就是下面这一句话别把重要的东西留在 AI 的聊天记录里。要让 AI 把它们写成文件存进项目文件夹。项目文件夹就像办公室文件放在办公室里哪位工程师来上班都看得到聊天记录是工程师自己的小本本人走了就带走了。做到这一点Claude Code 和 Codex 就像同一家公司的两位同事——随时换人无缝交接。二、三个保命习惯全景习惯干什么什么时候做立一本工作手册让 AI 把项目的规矩写成文件每次开工自动读每个项目做一次交接班开工先问现场收工留交接单每次开工、收工勤存档每做好一小步就存档随时可以吃后悔药每完成一个小功能下面逐个讲怎么做。每一步都有现成话术复制发给 AI 就行。习惯一给项目立一本《工作手册》解决的问题不用每次开工都重新给 AI 立规矩。AI 编程工具有个行业约定项目文件夹里如果有一个特定名字的文本文件AI 每次开工会自动先读它。Claude Code 认的名字叫 CLAUDE.mdCodex 认的名字叫 AGENTS.md——名字不同作用一样就是这个项目的《工作手册》。手册里写什么用大白话写就行这个项目是做什么的、怎么启动和检查、有哪些绝对不能碰的规矩比如界面文案一律用中文不要动 xx 文件夹。怎么做不用自己写。打开项目把这段发给 Claude Code 或 Codex 任何一个请帮我给这个项目建一本AI 工作手册要求 1. 先分析这个项目在项目根目录创建 CLAUDE.md 文件用中文写清楚这个项目是做什么的、主要文件在哪、怎么启动和验证、有什么注意事项。控制在 100 行以内。 2. 再让 AGENTS.md 指向同一份内容用符号链接做不了就保持两个文件内容完全一致这样 Claude Code 和 Codex 读到的是同一本手册。 3. 做完后把手册内容用大白话念给我听。我会补充几条我的规矩你帮我整理进去。以后想加规矩随口一句就行把删除任何文件前必须先问我这条规矩加进工作手册。习惯二交接班——开工问一句收工留一单解决的问题换工具、换电脑、隔几天再打开AI 都能立刻知道上回做到哪了。方法和工厂、医院的交接班一模一样收工的人留一张交接单AI 会写在项目里一个叫 WORKLOG.md 的文件中接班的人先看单、再干活。至于交接的两边是不是同一个 AI完全无所谓——这正是封号也不怕的底气所在。零安装用法把文末话术卡里的开工话术和收工话术存进备忘录每次复制着用。一次安装、永久省事推荐把下面这段发给 Claude Code装好后两个工具里都能用快捷命令——开工打/pickup接班收工打/handoff交班连话术都不用复制了。请帮我给 Claude Code 和 Codex 安装一对全局快捷命令 /handoff交班和 /pickup接班要求 1. 在 ~/.claude/commands/ 和 ~/.codex/prompts/ 两个目录没有就创建放置 handoff.md 和 pickup.md两边内容保持一致可以用符号链接共用同一份文件。 2. handoff.md 的指令内容是把当前工作状态写成交接单插入项目根目录 WORKLOG.md 的最上方文件不存在就创建包含时间和你是哪个工具、本次目标、已完成什么、做到一半的是什么、下一步该做什么、踩过什么坑、怎么验证功能正常。若有未存档的改动先问用户要不要存档。 3. pickup.md 的指令内容是你正在接手一项可能由另一个 AI 做到一半的工作。先查看项目最近的改动状态和存档记录再读项目根目录 WORKLOG.md 最上面一条交接单没有就跳过然后用不超过 5 句话向用户汇报进展到哪、上一班做到哪、你建议下一步做什么。等用户确认后再动手。 4. 把 WORKLOG.md 加入全局忽略清单确保它不会被存档进代码仓库。 5. 装好后告诉我怎么验证这两个命令可以用。习惯三勤存档——给项目吃后悔药解决的问题AI 改崩了、方向改错了随时退回之前好的版本。程序员的世界有一套非常成熟的存档系统叫 git名字记不住无所谓AI 用得很熟练。你只需要养成两句口头禅每当一个小功能做好、你亲眼验证没问题就说一句帮我存档完整话术见文末。发现改坏了想反悔就说帮我回到上一个存档。就像打游戏勤存档的人永远输得起。再配一条铁律同一时间只让一个 AI 动项目。两个 AI 同时改一个项目就像两个人同时改同一份文档会互相覆盖打架。想两个一起用让一个动手干活另一个只负责看和提意见——下一节正好讲这个。三、两个 AI 的三个聪明用法用法一主力加备胎备胎每周热热身。平时主力用顺手的那个另一个当备胎。但备胎不能一直闲着——每周找个小活让它干一次比如下面的检查作业确保它登录正常、配置没坏。别等封号那天才发现备胎生锈了。用法二互相检查作业强烈推荐。让 AI 检查自己写的东西就像让学生自己批改自己的卷子容易自我感觉良好。换另一个 AI 来审经常能揪出真问题——两家的盲区不一样。每次重要功能做完把检查作业话术发给另一个 AI相当于免费请了位二审质量提升立竿见影。用法三卡住了换个脑子。同一个问题让 AI 反复试了半个小时还没解决别恋战。把第二意见话术填好发给另一个 AI。换模型约等于换个脑子经常一下就通了。四、真被封号了四步无痛切换前面的习惯做到位封号当天你要做的只有这些打开备用工具Claude Code 被封就开 Codex反过来一样进入同一个项目文件夹发开工话术装过快捷命令就打 /pickup它会自己去看交接单和存档记录然后向你汇报进展到哪了你确认一句继续活儿接着干两个安心提醒封号不会删除你电脑上的项目文件和存档损失的只是那个账号的聊天记录——而你重要的东西早就都写进文件里了。申诉走官方渠道慢慢来期间备胎转正流程一切照旧。五、五条安全提醒密码、银行卡号、各种密钥绝对不要写进工作手册和交接单也尽量不要直接发在和 AI 的聊天里。这些文件将来可能被分享、被上传写之前当它是公开的。AI 要做删除文件、清空数据、对外发布这类动作时必须让它先说清楚影响、你点头才能执行。建议把这条直接写进工作手册。从官方渠道下载和登录工具不与人共用账号网络环境保持稳定——这些是封号的高频诱因别踩。大改动之前先说一句动手前帮我存档一次给自己留后路。隔一阵子让 AI 把整个项目备份一份到别处话术见文末电脑坏了也不慌。六、常见疑问问我需要学命令行吗不需要。这份手册所有操作都是复制话术发给 AI配置类的活让 AI 自己干。问CLAUDE.md 和 AGENTS.md 是两个文件要维护两份吗不用。配置时 AI 会把它们做成一份内容、两个名字你永远只当一本手册用、只改一处。问工作手册要写多长越短越管用100 行以内。只写规矩和关键信息写太长 AI 反而记不住重点。问手机 App、网页版上用这套还成立吗习惯本身在哪都成立。但正经干项目建议在电脑上进项目文件夹用手机和网页适合看进度、聊思路。问怎么确认配置成功了直接问 AI你现在能读到这个项目的工作手册吗念两条里面的规矩给我听。两个工具各问一遍。问我有些规矩想让所有项目通用怎么办发这段给 AI我有几条个人习惯希望所有项目都遵守【比如全程用中文交流删除任何文件前先问我】。请写进 Claude Code 的全局手册/.claude/CLAUDE.md和 Codex 的全局手册/.codex/AGENTS.md两边保持一致。七、话术卡收藏这一页就够了一次性配置每台电脑 / 每个项目做一次建工作手册在项目里发给任一 AI请帮我给这个项目建一本AI 工作手册要求 1. 先分析这个项目在项目根目录创建 CLAUDE.md 文件用中文写清楚这个项目是做什么的、主要文件在哪、怎么启动和验证、有什么注意事项。控制在 100 行以内。 2. 再让 AGENTS.md 指向同一份内容用符号链接做不了就保持两个文件内容完全一致这样 Claude Code 和 Codex 读到的是同一本手册。 3. 做完后把手册内容用大白话念给我听。我会补充几条我的规矩你帮我整理进去。安装交接班快捷命令发给 Claude Code一次装好两边请帮我给 Claude Code 和 Codex 安装一对全局快捷命令 /handoff交班和 /pickup接班要求 1. 在 ~/.claude/commands/ 和 ~/.codex/prompts/ 两个目录没有就创建放置 handoff.md 和 pickup.md两边内容保持一致可以用符号链接共用同一份文件。 2. handoff.md 的指令内容是把当前工作状态写成交接单插入项目根目录 WORKLOG.md 的最上方文件不存在就创建包含时间和你是哪个工具、本次目标、已完成什么、做到一半的是什么、下一步该做什么、踩过什么坑、怎么验证功能正常。若有未存档的改动先问用户要不要存档。 3. pickup.md 的指令内容是你正在接手一项可能由另一个 AI 做到一半的工作。先查看项目最近的改动状态和存档记录再读项目根目录 WORKLOG.md 最上面一条交接单没有就跳过然后用不超过 5 句话向用户汇报进展到哪、上一班做到哪、你建议下一步做什么。等用户确认后再动手。 4. 把 WORKLOG.md 加入全局忽略清单确保它不会被存档进代码仓库。 5. 装好后告诉我怎么验证这两个命令可以用。每天都用开工、收工开工话术接班装过快捷命令就直接打 /pickup开工前先了解现场请查看这个项目最近的改动状态和存档记录读一下项目根目录的 WORKLOG.md如果有然后用几句话告诉我项目进展到哪、上次做到什么程度、你建议下一步做什么。我确认后你再动手。收工话术交班装过快捷命令就直接打 /handoff今天先到这里。请把当前状态写成交接单插入项目根目录 WORKLOG.md 的最上方没有这个文件就创建本次做了什么、做到一半的是什么、下一步该做什么、有什么坑要注意、怎么验证功能是好的。如果还有没存档的改动问我要不要先存档。随时会用存档每完成一个小功能这个功能我验证过没问题了帮我存档一次git 提交如果这个项目还没启用 git先帮我启用再存档备注用中文写清楚这次做了什么。回档改坏了想反悔刚才的改动有问题我想回到上一个存档点。先告诉我这样会丢掉哪些改动等我确认后再执行。检查作业发给另一个AI这个项目刚由另一个 AI 工具改过【改了什么功能】。请你作为独立审查员检查最近的改动有没有逻辑漏洞、安全隐患、会不会破坏原有功能。用大白话告诉我结论能不能放心用哪里需要小心只检查先不要改任何东西。第二意见卡住半小时以上我卡在一个问题上【一句话描述问题】。已经试过【试过的办法和结果】。请你换个思路分析先告诉我你的判断和建议方案不要直接动手改。加规矩随时补充工作手册把这条规矩加进项目的工作手册CLAUDE.md【你的规矩】。保持手册简洁。备份项目隔一阵做一次请把这个项目完整备份一份到【备份位置如桌面的项目备份文件夹】文件夹名带上今天日期。注意跳过密钥、密码类的敏感文件备份完告诉我放在哪了。核心就一句文件在项目就在聊天记录随时可以不要。