当前位置：首页 > news >正文

Claude Code × Codex 协作手册（零基础版）

news 2026/7/29 18:10:36

写给谁：不懂编程、但正在用（或准备用）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.md，Codex 认的名字叫 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），两边保持一致。"