Claude Code 工作流:能长期复用的模式

一套撑得过第一周的 Claude Code 日常工作流:官方推荐的「探索 → 计划 → 实现 → 提交」循环、plan mode、用 /clear 和 /compact 管理上下文、子 agent、CLAUDE.md 维护,附 2026 年 6 月的套餐与模型细节。

一句话总结

Anthropic 官方推荐的循环就四步:探索 → 计划 → 实现 → 提交。研究和规划时待在 plan mode,要动手时再切出去,并且小步提交。撑过第一周后真正起作用的两个习惯是:(1)用 /clear/compact 狠抓上下文卫生;(2)给 Claude 一个它自己能跑的检查(测试、构建、lint),让它自我纠错,而不是干等你发现问题。下面是这套循环的日常版本,配上确切的快捷键、命令和 2026 年 6 月的套餐信息。

这篇讲什么

在真项目里日常用 Claude Code 的可复用模式——半年后还适用的那些,不是 demo 日的炫技。多数人学了基础、跑了几个炫的 demo,然后慢慢掉进悄悄侵蚀信任的习惯:大任务、步骤之间不 commit、CLAUDE.md 过期、一个臃肿的 session 跑一整天。这篇把能让 agent 长期有用的模式说清楚,每一条都对应到确切的命令或快捷键。

几个贯穿全文的概念:

  • Claude Code: Anthropic 的命令行 AI 编程 agent,能在终端里读、写、运行项目代码。截至 2026 年 6 月,它已捆绑进 Claude Pro 套餐($20/月,年付 $17/月),和 Claude Cowork 一起。
  • Plan mode(计划模式): 在这个模式里,Claude 能读、能搜、能联网取数据,但不能编辑、写入或执行 shell 命令。用 Shift+Tab 切换。
  • 上下文窗口: Claude 的工作记忆。Opus 4.7 和 Sonnet 4.6 都是 100 万 token 的窗口,但远没填满时性能就开始下降——所以上下文卫生才是整盘棋的关键。

这篇适合谁看

已经在拿 Claude Code 出活的开发者。如果你撞过那堵墙——前三周很顺,现在返工多于进展——这篇尤其值。如果你完全是新手,先看 Claude Code 新手指南,再回来读这篇。

什么时候用这套循环

日常项目工作:功能、重构、bug 修复、加测试、依赖升级。一行小修(改个 typo、加条日志、重命名)跳过完整循环就行——Anthropic 自己的说法是「如果改动一句话就能讲清楚,就别 plan 了」。绿地架构决策也留给人:agent 执行快,但「该不该这么做」它不够稳。

开始一个 session 前

  • 每次 session 当作一个小 PR。选一个目标,一句话写下来,抵抗范围蔓延。
  • 确认 CLAUDE.md 反映当前现实。一条过期约定比没约定还让 agent 糊涂。先跑一次 /init 从项目生成初始文件,再精简。
  • 开始前 main 上测试要通过。否则分不清是 agent 改坏还是你继承的坏。
  • 决定哪些命令 agent 可以不问就跑。用 /permissions 把安全的(如 npm run lintgit commit)加进白名单,或者整个任务用 --permission-mode auto,让分类器只拦危险调用。

核心循环:探索、计划、实现、提交

这是 Anthropic 文档里写的默认工作流,刚好对得上一个日常任务。

1. 探索(plan mode)

Shift+Tab 切进 plan mode,让 Claude 在不改动任何东西的前提下读相关代码:

读一下 /src/auth,讲清楚我们怎么处理 session 和登录。
也看看密钥的环境变量是怎么管理的。

在 plan mode 里 Claude 能用 Read、Glob、Grep、WebSearch、WebFetch 和子 agent,但不能用 Edit、Write、Bash。如果探索要读几十个文件,就交给子 agent,别让它淹没你的主上下文(下面细说)。先按一套 AI 编程上下文管理流程把相关文件喂进去,让计划基于真实代码。

2. 计划(仍在 plan mode)

要的是具体计划,不是代码:

我想加 Google OAuth。要改哪些文件?session 流程是怎样的?
列出要改的文件、要新建的文件、要加的测试、和范围外的内容。

然后严格审计划。计划涉及超过约 5 个文件就砍范围。没要的部分直接反推回去。你可以按 Ctrl+G 在编辑器里打开计划,让 Claude 动手前直接改它。

3. 实现(默认模式)

切出 plan mode,让 Claude 照自己的计划执行。每次实现请求都在同一条消息里配上验证步骤:

照你的计划实现 OAuth 流程。给 callback handler 写测试,跑测试套件,
修掉失败项。解决根因,别把错误吞掉。

那条验证指令是整套工作流里杠杆最高的一句。Claude 在工作「看起来完成」时就停;一个它能跑的测试或构建把「看起来完成」变成真正的通过/失败,循环就能在你不盯着的情况下自己闭合。

4. 提交

要求小而描述清楚的 commit——好回滚、好 bisect、好写 PR 描述:

用描述清楚的信息提交,并开一个 PR

如果你装并登录了 gh CLI,Claude 会直接用它开 PR。端到端配置见 Claude GitHub 集成工作流

上下文卫生:真正能放大产能的习惯

上下文是根本约束。窗口越满,Claude 越会忘掉早先的指令、出更多错——远在你撞到 100 万 token 上限之前就开始了。三个命令保持它干净:

命令作用什么时候跑
/clear整个清空上下文窗口不相关任务之间;或同一个 bug 纠正两次还没好时
/compact [重点]总结历史,保留要紧的在约 60% 容量时主动跑,别等 95%;加上重点,如 /compact 聚焦 API 改动和被改的文件
Esc / Esc Esc/rewind中途停下 / 回到之前的检查点一看到 Claude 跑偏就用

Anthropic 失败模式清单里的两条经验:「大杂烩」session(一个任务,再插一个不相关的,再回来)用 /clear 解决;同一个问题纠正超过两次,说明上下文已被失败的尝试污染——/clear,带着你刚学到的东西重写一个更精准的 prompt。干净 session 配更好的 prompt,几乎总是赢过堆满纠正的长 session。

你也可以在 CLAUDE.md 里加一行,告诉 Claude 自动压缩时保留特定内容,例如:压缩时始终保留被改文件的完整列表和测试命令。

用子 agent 做调研

Claude 研究你的代码库时会读很多文件,每读一个都消耗你的上下文。子 agent 在自己独立的上下文窗口里跑,只回报一段总结:

用子 agent 调查我们的认证系统怎么处理 token 刷新,
以及有没有现成的 OAuth 工具我可以复用。

实现完之后用同样的套路做一次「换双眼睛」的 review——一个在干净上下文里的 reviewer 会就 diff 本身评判,而不会偏袒它刚写的代码:用子 agent review 这个 diff 的边界情况。内置的 /code-review skill 就是专门做这件事来抓正确性 bug 的。当你反复需要同一个角色时,在 .claude/agents/ 里定义专用的(一个 security-reviewer、一个 test-writer)。

用 TODO 锚点跨 session 定位

把 TODO 注释当书签,让 agent 下次能跳到:// TODO(claude): 把这段抽成单独函数。下个 session 里直接按名字指到这个标记,而不是重新解释位置在哪。这是在不一直开一个巨型 session 的前提下,让多 session 工作保持连贯的办法。

维护 CLAUDE.md

CLAUDE.md 在每次对话开始时都会被加载,所以把它当代码对待:定期精简。Anthropic 的直白警告是:臃肿的 CLAUDE.md 会让 Claude 忽略你真正的指令,因为要紧的规则淹没在噪音里。每一行都问一句:「删掉这条会不会让 Claude 出错?」不会就砍。

该写别写
Claude 猜不到的 Bash 命令任何 Claude 读代码就能推出来的东西
与默认不同的代码风格规则Claude 已经知道的标准语言惯例
首选的测试 runner、怎么跑单个测试详细的 API 文档(贴链接就行)
分支命名和 PR 约定经常变的信息
必需的环境变量和环境怪癖逐文件的代码库描述
不显然的坑「写干净的代码」这种废话

每月审一次。Agent 已默认遵守的删掉;每次某个错反复出现就加一条规则。只在某些时候才相关的知识,放进 .claude/skills/ 里的 skill,让它按需加载,而不是塞满每个 session。如果某条规则明明在文件里却总被忽略,多半是文件太长了。

收尾前的质量检查

  • 每个 commit 测试和 lint 都过。Agent 不该在坏状态上进入下一步。
  • Diff 在范围内——只动计划里提到的文件。多出来的,合并前先问为什么。
  • PR 描述三句话自洽。讲不清这么短,说明打包过头了。
  • Claude 给的是证据,不是断言:真实的测试输出、它跑了什么命令、返回了什么。审证据比你自己重跑一遍快。

让这套工作流可复用

  • 把最爱的 planning prompt 存成 skill:.claude/skills/plan/SKILL.md。(2026 年 Anthropic 把自定义 slash command 并进了 skill;.claude/commands/ 里的文件仍然能用,但 .claude/skills/ 是推荐路径。)完整命令面见Claude Code 全部斜杠命令详解
  • 对有副作用的重复工作流,在 skill 里设 disable-model-invocation: true,让它只在你显式调用时才触发。
  • 对必须每次发生、零例外的事用 hook(每次编辑后跑 linter、禁止写 migrations 目录)。CLAUDE.md 只是建议,hook 是确定性的;跑 /hooks 查看已配置的。
  • /rename 给长期 session 命名(如 oauth-migration),用 claude --resume 恢复,把每条工作线当成有自己上下文的分支。

套餐与模型,截至 2026 年 6 月

套餐价格(美元/月)Claude Code 能得到什么
Free$0聊天里有限的 Sonnet 4.6;Claude Code 仅限付费套餐
Pro$20(年付 $17)捆绑 Claude Code + Cowork;主力 Sonnet 4.6,共享的 5 小时额度池里可用 Opus
Max 5x$100Pro 额度的 5 倍
Max 20x$200Pro 额度的 20 倍

对日常使用要紧的几点:

  • Pro 和 Max 上,额度在 Claude 聊天和 Claude Code 之间共享——两边的一切都计入同一个滚动的 5 小时池。
  • Opus 4.7 每 token 的成本大约是 Sonnet 4.6 的 5 倍,所以每个任务都上 Opus 会烧额度快得多。默认用 Sonnet 4.6,真正难的推理才上 Opus。用 /model 切换,它也是你账户当前有哪些模型的权威来源。
  • 2026 年 5 月 Anthropic 把 Claude Code 的速率上限翻了一倍,并取消了高峰时段限制,所以实际天花板比老文章说的高。
  • Claude Code 只跑 Anthropic 自家模型。如果你想把同一个任务路由给 GPT-5.5 或 Gemini 3.1 Pro,那是另一个工具(比如 Cursor)。价格和额度经常变;引用前先对照 Anthropic 定价页 核实。

常见问题

  • 单个 agent 任务该多大? 1–3 个文件,diff 约 200 行内。更大 review 就崩。计划超了就拆成多个 PR。
  • Agent 该跑我的测试吗? 该——而且让它把输出贴出来,不要只说「测试通过」。有的 agent 把一次「绿」总结出来,其实跳过了。测试数和通过/失败你自己核。
  • 什么时候能跳 plan mode? 改动一句话能讲清楚的(typo、日志、重命名)。涉及多文件或你不熟的代码:先 plan。
  • 长时间无人值守的运行怎么办? 给运行一个可验证的目标(测试或 /goal 条件)和干净的上下文,然后看证据。没有它能跑的检查,每个错都得等你发现。
  • 遇到 merge 冲突怎么办? 自己先解决,再让 agent 做下一步。Agent 解冲突不可靠。
  • Claude Code 能替我开 PR 吗? 能,装并登录 gh CLI 即可。见 Claude GitHub 集成工作流

容易踩的坑

  • 一次让它跨多文件大改——拿到没法 review 的 diff。
  • 任务之间不 commit——两步之后坏了没法 bisect。
  • 一个 session 跑一整天——上下文填满、性能下降、坏 diff 溜过去。任务之间 /clear
  • CLAUDE.md 写过头——要紧的规则被埋掉、被忽略。狠狠精简。
  • 跳过验证——一个看似合理、却没处理边界情况的实现,因为没有东西判它失败,就这么上线了。
  • 每条命令都无脑同意——危险那条迟早溜过去。白名单要刻意加,或用 auto 模式的分类器。
  • 把 agent 当架构决策权威——它执行快,但「该不该做」还是你的判断。

相关阅读

标签: #Claude #教程 #Claude Code