暂无图片
暂无图片
暂无图片
暂无图片
暂无图片

Claude Code 最佳实践完全指南:84条技巧让你效率翻倍

源话编程 2026-03-23
83

你有没有想过,为什么有些人用 Claude Code 能一天搞定一周的工作量?

2026年3月,一个名为 claude-code-best-practice
 的 GitHub 仓库突然冲上 Trending 榜首。这不是普通的教程,而是 Claude Code 创始人 Boris Cherny 和核心团队成员亲自分享的实战心得——整整 84 条技巧,条条都是真金白银换来的经验。

今天这篇文章,我来帮你提炼精华,带你搞懂 Claude Code 的核心玩法。


一、先搞懂 Claude Code 的"四大金刚"

很多人用了一段时间 Claude Code,还是分不清 Agent、Command、Skill、Hook 到底有什么区别。搞清楚之后,你会发现这套设计真的很巧妙。

Agent(子代理)

位置.claude/agents/<name>.md

Agent 是一个"独立干活的小助手",它有自己独立的上下文、工具权限、模型配置,甚至还有自己的记忆。

用 Boris 的话说:**"让 subagents 去处理任务,保持你的主上下文干净。"** 比如你让一个 agent 专门做代码审查,另一个专门写测试,它们互不干扰,各自干活。

Command(斜杠命令)

位置.claude/commands/<name>.md

Command 是"知识注入",把你常用的提示词模板化。比如你每天都要做代码审查,就可以写一个 /review
 命令,一键调用。

Boris 的建议很直接:**"用 commands 替代 subagents 来编排你的工作流。"** 原因很简单——command 更轻量,适合高频操作。

Skill(技能)

位置.claude/skills/<name>/SKILL.md

Skill 是 Claude Code 最强大的扩展机制。它不只是单个文件,而是一个文件夹,可以包含:

  • SKILL.md
     - 核心提示词
  • references/
     - 参考资料
  • scripts/
     - 脚本工具
  • examples/
     - 示例代码

Thariq(Claude Code 核心成员)有个很关键的提醒:**"skill description 是触发器,不是摘要。写的时候要想:模型什么时候应该触发这个技能?"**

Hook(钩子)

位置.claude/hooks/

Hook 是"事件处理器",在特定时机自动执行。比如:

  • 写完代码自动格式化
  • 提交前自动运行 lint
  • Claude 想执行危险命令时自动拦截

二、84条技巧精华提炼

由于篇幅限制,这里提炼最实用的 12 条。想看完整 84 条清单,可以访问文末的原文链接。

Prompting(提示技巧)

技巧1:让 Claude 挑战你

不要只是接受 Claude 的输出。试试这样说:

"狠狠批评这些改动,在我通过你的测试之前,不要提交 PR。"

这招特别适合做架构决策的时候。让 Claude 扮演"魔鬼代言人",能帮你发现很多隐藏问题。

技巧2:修复 bug 时别微观管理

这是 Boris 亲口说的:

"Claude 自己能修大多数 bug——你把 bug 粘贴进去,说'fix',别去管它怎么修。"

很多人犯的错误是:看到 bug 就开始教 Claude 怎么改。其实你只需要描述问题,让 Claude 自己想办法。

技巧3:不满意?重头来

当 Claude 给了一个勉强能用的方案时,别在那缝缝补补。直接说:

"根据你现在知道的一切,把之前的方案扔掉,给我一个优雅的实现。"

Planning(规划)

技巧4:永远从 plan mode 开始

这是最重要的一条。不要一上来就让 Claude 写代码,先让它做计划。

技巧5:让 Claude 采访你

Thariq 的建议是:

"从一个简单的需求开始,让 Claude 用 AskUserQuestion 工具来采访你,然后再新开会话执行这个 spec。"

技巧6:原型 > PRD

Boris 的原话是:

"与其写规格文档,不如构建 20-30 个版本。构建成本很低,多尝试几次。"

CLAUDE.md(项目记忆)

技巧7:控制在 200 行以内

CLAUDE.md 是告诉 Claude 这个项目该怎么干的"项目说明书"。但太长反而会出问题:

"CLAUDE.md 应该控制在 200 行以内。超过这个长度,Claude 就开始'选择性忽略'了。"

技巧8:用条件标签避免被忽略

如果你有些规则特别重要,可以这样写:

<important if="修改认证相关代码">
必须先阅读 security.md
</important>

技巧9:测试命令要写清楚

Dex(HumanLayer 创始人)说:

"任何开发者启动 Claude,说'运行测试',第一次就应该成功。如果不行,说明你的 CLAUDE.md 缺少了关键的 setup/build/test 命令。"

Agents & Skills(进阶)

技巧10:让不同的 agent 互相检查

这就是所谓的"test time compute":

"用独立的上下文窗口,一个 agent 可能引入 bug,但另一个 agent(同样的模型)能找到它。"

技巧11:Skill 里要有 Gotchas 部分

每个 skill 都应该有一个"坑点记录"——把 Claude 失败过的地方记下来,这样下次就不会再踩同样的坑。

技巧12:不要在 skill 里写显而易见的内容

Thariq 说得很明白:

"只关注那些能把 Claude 推出默认行为的东西。不要写'写高质量代码'这种废话。"


三、工作流推荐

标准流程:Research → Plan → Execute → Review → Ship

这是所有成熟工作流的核心模式。不管你用什么工具,这个循环是不变的。

社区热门工作流

名称
Star 数
特色
Superpowers
100k
TDD-first,Iron Laws
Everything Claude Code
89k
instinct scoring,AgentShield
Spec Kit
79k
spec-driven,22+ 工具
BMAD-METHOD
41k
全 SDLC,agent personas

如果你刚入门,我建议从官方的 plan mode 开始,熟悉之后再尝试这些社区方案。


四、Boris Cherny 的"朴素配置"

最后分享一个有趣的点:Claude Code 的创始人 Boris,他的配置其实非常"朴素"。

他的原话是:

"我有一个惊人的朴素配置。"

他主要用:

  • iTerm 终端(不是 IDE)
  • 每天更新 Claude Code
  • 用 /rename 标记重要会话
  • 每小时至少提交一次

没有花里胡哨的配置,就是把基础功能用到极致。


五、我的建议

看完这 84 条技巧,你可能觉得信息量太大。我建议你分四个阶段来实践:

第一阶段(1-2周):掌握 plan mode,学会让 Claude 先做计划再动手。这是最关键的习惯转变。

第二阶段(2-4周):写好你的 CLAUDE.md,把项目的关键信息告诉 Claude。这是让 Claude "懂你项目"的基础。

第三阶段(1-2个月):尝试创建自己的 commands 和 skills,把重复工作自动化。这是效率飞跃的关键。

第四阶段(持续):用 hooks 做自动化检查,让 Claude 更可靠。这是进阶玩家的标志。

记住一句话:工具再好,也需要人来驾驭。Claude Code 不是来替代你的,而是来放大你的能力的。


参考资料/来源

claude-code-best-practice GitHub 仓库


文章转载自源话编程,如果涉嫌侵权,请发送邮件至:contact@modb.pro进行举报,并提供相关证据,一经查实,墨天轮将立刻删除相关内容。

评论