他把Claude Code给玩通关了
Claude Code 通关的秘密，就一个字
昨天半夜两点，一个做开发的朋友给我打电话，声音都快哭了。
他说：“什么破 Claude Code，每次开头都跟初恋一样激动，三分钟后就变成仇人。昨天刚教会它改接口格式，今天又犯同样的错。我是不是养了个金鱼啊？记忆七秒那种。”
我听完笑死了。不是因为嘲笑他，是因为我当初比他惨十倍。
后台最近总有人问 Claude Code 的事：
“值不值得折腾一整天配置？”
“上手就翻车怎么办？”
“那些配置列表比我项目代码还长，有没有捷径？”
先给你泼盆冷水：能通关的人，不是技术多牛，而是学会了一个字——收。
不是“冲”，也不是“拼”，是“收”。
第一关：为什么你的 Claude 永远不长记性？
这问题排第一，九个新人里九个都栽在这。
大家以为装完 Claude Code 就能干活了？天真。
第二次打开新会话，Claude 又变回一张白纸。你得重新告诉它“测试用 vitest，断言用 toBe”。每开一个新会话就复制粘贴一遍——你是在当复读机还是在写代码？
根源就一个：CLAUDE.md 是空的，或者压根没建。
有个朋友说得特别对：“每次你纠正完 Claude 的错误，最后都要补一句——去把 CLAUDE.md 更新一下，省得下次再犯同样的错。”
我一开始不信。觉得 AI 不都自己能学习吗？
后来在一个 React 项目里让 Claude 改接口格式，改了三遍，同一个错反复犯。我火了，把报错记录和正确写法写进 CLAUDE.md。后来同类型问题再没出现过。Claude 开始自己给自己立规矩，这事儿确实有点意思。
更野的是那个做笔记系统的工程师。他每次提交完代码必须更新笔记，然后在 CLAUDE.md 里把路径指过去。等于给 Claude 装了个外挂记忆库。我试了一周，效果真的绝了——尤其适合那种有很多历史决策的大项目。以前交接新同事要讲半天，现在直接甩个文件，搞定。
所以第一关：把 CLAUDE.md 当圣经写。
别写废话。“语言用 TypeScript”这种就不用写了，默认就懂。
要写的是你项目里的坑：
- “数据库连接字符串只能从环境变量获取”
- “不要在 reducer 里写副作用”
- “版本锁在 pnpm.lock，别用 npm”
越具体越好，Claude 越稳定。
第二关：CLAUDE.md 的三大坑，我都替你踩了
光说“要写”是鸡汤，我也踩过几个坑，写出来帮你避开。
第一个坑：写成了聊天记录。
一开始我把所有对话里出现过的指令都塞进去。结果文件比我的代码还臃肿，Claude 反而被废话干扰。
后来我按类型分：开发规范、目录结构、常见错误修复、斜杠指令。每条规则前面加个优先级标签 [HIGH]。Claude 就像老员工一样，心里有本账。
第二个坑：忘记动态更新。
项目一跑就是几星期，规则会变。
那个“每次纠正错误后更新”的习惯才是关键。我逼自己每次查完 Claude 的 bug 都要追加一句“把这错误记录到 CLAUDE.md”。刚开始有点烦，一周后就成了肌肉记忆——犯错率确实降了，写文档的决心也更强了。
第三个坑：把配置当一劳永逸。
你得敢删。
有些规则写着写着发现没用了，或者跟新设计冲突了。别手软，大刀阔斧地改。我隔两周会重读一遍 CLAUDE.md，把那些已经不用的或者矛盾的去掉。就像给代码做重构，只不过现在重构的是 Claude 的行为。
现在我的 CLAUDE.md 大概 300 行，涵盖了项目结构、测试约定、数据库迁移流程、MCP 配置位置、还技术债的斜杠指令等等。基本每次开新会话不用再啰嗦。
第三关：那些吹上天的 Skill、Subagent，到底香不香？
说实话，我第一次看到 Everything Claude Code 那个项目——48 个智能体、182 个技能，头都大了。 这玩意儿真的是给人用的？
但仔细看了看代码和作者的实战数据，又不得不佩服。
有个黑客松冠军，8 小时靠这套配置从零搭了个带 AI 的客户发现平台。数据也挺亮眼：功能完成速度据说提了 65%，代码审查问题数从 12.3 降到 3.1，测试覆盖率从 48% 飙到 82%，会话切换次数减少 70%。
我自己没全盘抄，挑了最实用的几个：
Planner： 写代码前让 AI 先生成架构图和实施计划，特别适合大功能。以前我手写设计文档要一小时，现在扔给 planner 草稿我再改，能省一半时间。
Tdd-guide： 这个是真香。我写 API 爱先跑测试再补逻辑，但经常写着写着就忘了测试风格。tdd-guide 会在每次写测试前自动注入规则，少扯皮。
Security-reviewer： 偶尔用。我项目不大，暂时没感觉到明显差异。但有次它提醒我用户输入没做深度校验——确实是个雷。
Subagent 这块，有个案例让我印象很深：让 Claude 查看 Docker 日志排查分布式系统故障，它在这方面的表现出乎意料地强。我试了一次，直接把一段复杂的环境隔离日志丢给 Claude，让它用 subagents 分析。结果 5 分钟就定位到一个配置死锁。以前我自己查至少半小时。
不过 Subagent 是把双刃剑。任务越复杂它越香，但 token 烧得也快。我的口诀是：常规代码改动用单 agent，跨模块分析或者修复杂 bug 再加 subagents。 别什么活都上小分队，费钱。
斜杠指令里最实用的是 /techdebt。收工前跑一次自动消灭重复代码。我改成了 /cleanup，每次下班前跑，第二天代码清爽得跟新的一样。
第四关：让 Claude 自己修 Bug，到底靠不靠谱？
说到这儿，想起一个故事。
数学天才、菲尔兹奖得主陶哲轩第一次让 Claude 做形式化证明时，说了句“把整个事情做完”。结果 Claude 花了 45 分钟在引理证明的泥潭里打转，最后把他电脑跑崩了。
这个教训很典型：不是 AI 不行，是你指令给得太模糊。
第二次陶哲轩换了方法：先形式化记号，再搭证明骨架（引理 1、2、3 先用 sorry 占位），最后逐行转代码。25 分钟成功，比上次快了一倍。
说白了，就是把“大问题”拆成了“小步骤”，每条指令都有边界。
我自己修 Bug 也是这样。可以先开启 Slack MCP，把讨论 bug 的帖子甩给 Claude，只丢个“修”字。我试过，如果 bug 描述清晰（比如“登录页面在 Safari 下 CSS 布局崩了”），效果确实惊艳——Claude 能自己补全上下文，直接定位问题改好。
但如果是那种描述模糊的问题（比如“性能页面加载慢”），丢“修”字它就瞎猜。得先问清楚，比如：“用户列表页面在 1000 条数据时点击排序延迟 3 秒，看看是不是渲染机制问题。”Claude 就会锁定范围。
总结：小 bug 放心放，大问题先拆解。 别迷信 AI 的推理能力，一定要给它划跑道。
另外，让 Claude 修复挂掉的 CI 测试这招也特实用。我试过一次，Jenkins 上有个单元测试突然不通过，把日志直接贴给 Claude。它分析完说是 Mock 方法名变了，然后自动改了测试代码。整个流程没超过 2 分钟，比我手动排查快了一个世纪。
第五关：普通人到底值不值得花一天时间搞配置？
看你怎么定性。
如果你只是偶尔用 Claude 写个脚本或者翻译代码，那确实没必要。CLAUDE.md 写几行你常用的路径就够了。
但如果你是开发者，每天跟 Claude 协作——那配置就是生产力投资。 花半天配好，后面每天省一小时。
我的建议顺序：
1. 先建一个 CLAUDE.md，里面只写项目规范和自己踩过的坑，别贪多。
2. 装一两个最常用的 Skill，比如 planner 或者 tdd-guide，自己用着顺手的。
3. 加一个斜杠指令，比如 /techdebt 或者 fetch-context（一键把 Slack、GitHub 近 7 天数据拉下来喂给 Claude）。我能保证这个指令用三次就回不去。
至于 Everything Claude Code，我欣赏它的思路，但不建议新人全盘照抄。里面的 48 个 agent 很多是重叠的，182 条 skill 有些跟你的技术栈无关。我花了一下午挑了大概 10 条，跑了两个月，觉得够了。
对了，关于国产模型跑 Claude Code 这件事。有人用 DeepSeek 跑通了，但我试过几次，效果差不少。不是不能用，而是模态理解力和代码纠错能力明显有断层。如果你预算敏感可以用，但主力工具我还是推荐 Claude Code + 官方 API。
多模态倒是可以补充一句：把截图、录音、视频直接丢给 AI，效率比你打一百个字高多了。 但那是另一个话题了。
最后补几个你可能没想到的
终端配置很重要。
很多人不知道 Ghostty 这个终端，渲染色彩和 Unicode 好太多，还能用 /statusline 显示 context 用量和分支。我换了 Ghostty 之后，眼睛舒服了不少。tmux 爱好者也可以每个任务一个 tab，命名加颜色，一目了然。
语音输入是隐藏加速器。
语音输入通常比打字快两三倍。我试过，确实一次能生成更长的提示词。但建议用方言音或者英语语境下使用，有些助手中文识别还不完美。
任务清单 /tasks 是持久战神器。
有个跑“一生一芯”的哥们儿给 Claude 创建了 30 多个任务，硬跑了 10 个小时，中途断电都没打断。我后来把一个大功能拆成 12 个任务，周末挂机跑，第二天差不多搞完了。前提是 Claude 版本够新（Opus 4.7 的任务遵循度确实强）。
千万别在 Claude 面前当导游。
很多人害怕它犯错，每一步都告诉它“先做 A 再做 B 再检查 C”。结果它反而不动了——因为它会把更多 token 浪费在解析你的指令上，不如让它自己规划。你只需要定好边界和验收标准即可。
好了，暂时就这些。
说到最后，我突然想起开头那个半夜打电话的朋友。前几天他跑来跟我说：“兄弟，我通了！”
我问怎么通的。
他说：“我以前总觉得 AI 越聪明越好，越自由越好。后来才发现——好的协作，是给 AI 划好跑道，然后放手让它跑。
这不是放弃控制，而是更高层次的信任。
Claude Code 通关的人，不是用了多少高级技巧，而是学会了一个字——收。把规则写清楚，不该管的部分就放心放手操作。少即是多，收得住才能放得开。”
祝你也早点通关。
对了，如果你看完有启发，转发给你那个还在跟 Claude 打架的朋友吧。救一个是一个。
读者评论 3