Claude Code 五条原则：从 83 条技巧到 47 行 CLAUDE.md

原文链接：https://mp.weixin.qq.com/s/8UZzB_2PcbLGY3cqsKS92A 来源：ferlich，2026-05-05

摘要

作者用了一年 Claude Code，从狂搜 83 条技巧到提炼出 5 条底层原则。精华部分是 CLAUDE.md 从 498 行砍到 47 行的 V1→V30 进化实录：上下文过四成 Claude 开始变笨、规则要"真犯过才记"不是"预设会犯"、用 .claude/rules/ 按文件类型懒加载、Gotchas 占 30% 内容贡献 80% 价值。核心理念：把 Claude 当团队成员——它资源有限、需要反馈、能并行工作、会从错误中学习、但不该被过度设计。

五条原则

原则一：把上下文当内存管理

核心发现： 上下文过 40% Claude 开始变笨，过 60% 选择性漏掉指令。大模型能同时顾好的指令大约一百多条，Claude Code 系统指令已占掉一大块。不会突然崩，会慢慢变笨，像内存泄漏。

做法：

• 50% 就手动 /compact
• 长任务主动拆成多段，每段新开会话
• 切换前让 Claude 写交接总结
• 走偏了 Esc Esc 回滚，别在污染上下文里修修补补
• 子代理价值在上下文隔离不在炫技
• CLAUDE.md 控制在 60 行以内

原则二：给 Claude 一个验证自己工作的办法

Boris（Claude Code 创建者）原话：让 Claude 自己检查自己的工作，产出质量翻两三倍。

对比： 老路子——Claude 写 → 人跑 → 人对结果 → 人贴偏差 → Claude 理解 → Claude 改，四五轮一下午。新路子——Claude 写 → 自己跑 → 自己对比 → 自己改，一两轮。

关键区别： 反馈回路短了。每一步人介入都在加延迟和误读可能。

注意度： 验证条件天然清晰的任务（数据处理输入输出数值对就是错）适合自动化闭环。验证条件本身模糊的任务（"拟合合不合理"），人的判断少不了。

原则三：并行不是多开窗口

真正的并行是把任务拆成相互独立的单元。例子：重构代码管线——会话 1 读代码画数据流图，会话 2 写重构代码，会话 3 以第三方身份审查会话 2 的改动。三者独立输入输出，不需要频繁同步。

技巧：

• 代码审查开多个子代理：一个查风格、一个翻历史找模式、一个找 bug
• git worktree 让多个 Claude 在不同分支上并行
• Agent Teams 注意：每多一个 agent 上下文多一份消耗

原则四：规则是长出来的，不是写出来的（CLAUDE.md 进化实录）

这是全文最精华的部分。

版本	行数	关键发现
V1	498	疯狂塞东西：架构说明 3 页、编码规范、技术栈清单、调用约定、项目历史……沾沾自喜
V5	498→180	发现"选择性忽略"： 200 行以后的规则白写。大模型一次顾好约一百条指令，规则越多每条权重越低。砍掉 Claude 读代码能推断的信息和"以防万一"冗余
V10	180→90	从"预设它犯错"到"真犯了再记"： 原来 180 行里至少 100 行是凭经验预设的，命中率极差。"确保代码模块化"→ 太模糊忽略。 "utils/目录下 import 用项目根路径"→ 精确有边界，几乎每次遵守。CLAUDE.md 当 bug tracker 不是设计文档
V18	90→30-40/次	.claude/rules/ 拆分 + 懒加载： 用 paths: frontmatter 按文件类型加载规则。写 Python 看不到 C++ 规则。跨边界规则放主文件
V25	50	Gotchas 是最有价值的内容： "用 pandas 读取 SDF 文件时，不要直接用 read_csv，项目封装了 mol_parser（2025-12-14，浪费 40 分钟排查）"——一句包含场景/禁止/原因/日期/成本，信噪比极高。占 30% 内容贡献 80% 价值
V30	47	最终结构：8 行构建命令 + 12 行跨语言规则 + 3 行分支规范 + 6 行 MCP 配置 + 18 行 Gotchas。无一"以防万一"

核心教训：

• CLAUDE.md 不是文档，是上下文预算表——Claude 读代码能推断的就不写
• 规则价值跟精确程度成正比——越模糊越被忽略
• Gotchas 是最值得维护的部分——每一条背后都是真实踩过的坑
• 别用 CLAUDE.md 代替 Code Review——静态检查该交给 linter 和类型检查器

原则五：简单任务别上重武器

三档任务分级：

档位	规模	做法
一档	五分钟内	直接说需求，不用 Plan Mode、工作流、重型编排。原生最快
二档	半小时~几小时	先 Plan Mode 讨论方案，确认后 Normal Mode 执行
三档	跨天跨模块	上工作流，Subagent 拆分，Worktree 并行

踩坑： 容易把二档当成一档。规则：如果做之前不确定大概要多久，直接升一档。

五条原则拧成一句话

把 Claude 当成一个团队成员——它资源有限、需要反馈、能并行工作、会从错误中学习、但不该被过度设计。

不是工具。工具用完就放下。团队成员你会不断改善协作方式。