⭐⭐⭐ Spring Boot 项目实战 ⭐⭐⭐ Spring Cloud 项目实战
《Dubbo 实现原理与源码解析 —— 精品合集》 《Netty 实现原理与源码解析 —— 精品合集》
《Spring 实现原理与源码解析 —— 精品合集》 《MyBatis 实现原理与源码解析 —— 精品合集》
《Spring MVC 实现原理与源码解析 —— 精品合集》 《数据库实体设计合集》
《Spring Boot 实现原理与源码解析 —— 精品合集》 《Java 面试题 + Java 学习指南》

摘要: 原创出处 http://www.iocoder.cn/Fight/GitHubshangyilubiaodao46k-StardeClaude-Codezuijiashijiankaiyuanle/ 「芋道源码」欢迎转载,保留摘要,谢谢!

候选标题(用户选用第 4 个):

  1. 开源 60 天斩获 51k Star!Claude Code 最佳实践库——前后端必看
  2. 60 天爆 51k Star!Claude Code 最佳实践开源——这是社区给的”用对手册”
  3. 51k Star 的 Claude Code 最佳实践,60 天爆出来的——前后端 / 全栈都该看
  4. 开源了!Claude Code 最佳实践 60 天斩获 51k Star,从「会用」到「用对」一次讲清
  5. Claude Code 怎么用对?60 天斩获 51k Star 的最佳实践库——前后端都要刷一遍

🙂🙂🙂关注微信公众号:【芋道源码】有福利:

  1. RocketMQ / MyCAT / Sharding-JDBC 所有源码分析文章列表
  2. RocketMQ / MyCAT / Sharding-JDBC 中文注释源码 GitHub 地址
  3. 您对于源码的疑问每条留言都将得到认真回复。甚至不知道如何读源码也可以请教噢。
  4. 新的源码解析文章实时收到通知。每周更新一篇左右。
  5. 认真的源码交流微信群。

一个项目把”Claude Code 怎么用对”全捋清楚了

如果你日常用 Claude Code 写代码,应该和我有同样的体感——它不是”会用就行”,是”用对了 vs 用错了”差距能有 10 倍。

新人装好 Claude Code 之后,往往就两种姿势:

  • 当 ChatGPT 用——把任务一股脑丢给它,「帮我写一个 OAuth 登录」,然后等它输出 800 行代码,自己再边读边发现问题;
  • 依赖直觉踩坑——/compact 什么时候用、CLAUDE.md 该怎么写、Subagents 该装哪几个、Hook 该不该加——全靠自己摸索。

但其实社区已经把这些坑全踩过了。最近在 GitHub 上发现一个项目—— claude-code-best-practice——它干的就一件事:把社区已经验证过的 Claude Code 最佳实践,按”概念 → 功能 → 工作流 → 技巧”四档系统化整理出来。

仓库地址:https://github.com/shanraisshan/claude-code-best-practice

它的 slogan 也很实在——“From vibe coding to agentic engineering—practice makes claude perfect”(从随性写代码到工程化 Agent,熟能生巧让 Claude 更完美)。

关键数据:开源不到两个月就拿下了 GitHub 51.2k+ Star——不到 60 天 5 万 Star,这种增速在 GitHub 工具类项目里也算非常猛。

它和官方文档 / Anthropic Cookbook 有啥区别

先搞清楚生态位——这一类内容已经有官方资源了:

资源 立场 内容深度 适合谁
Anthropic 官方文档 官方说明书 概念解释完整、案例少 想搞清楚”它能做什么”
Anthropic Cookbook 官方代码示例 端到端 demo,但不”踩坑” 想看官方推荐怎么写
claude-code-best-practice 社区踩坑总结 避坑 + 多工作流对比 想知道”高手是怎么用的”
个人 YouTube / 公众号教程 单一视角 深度参差不齐 看具体某个用法

这个项目的差异化很清楚——它不是教”会用”,是教”用对”。官方文档告诉你 /compact 是干嘛的;这个项目告诉你“context 涨到 300-400k token 时上下文开始腐烂、最好维持在 40% 利用率以下、什么时候压缩才合适”。

后者才是研发想要的——踩坑后的真知。

四大板块:从”我能装啥”到”高手怎么避坑”

按官方仓库的结构,整个项目分成 4 大板块:

板块 1:核心概念(10 个 Claude Code 关键概念)

包括 Subagents、Commands、Skills、Workflows、Hooks、MCP Servers、Plugins、Settings、Status Line、Memory 这 10 个。每个概念都配一个红色 Best Practice 按钮——点进去就是”该怎么用对”的实战案例。

比如 MCP Servers 板块——它不仅讲 MCP 的协议规范,还会列目前最值得装的 MCP:chrome-devtools-mcp(让 Claude 调浏览器调试)、github-mcp(直接操作 PR)、sequential-thinking(强制 Claude 分步推理)等。

板块 2:热门功能(20+ 个最近上线的特性)

紧跟 Anthropic 最新 beta 功能——Ultrareview、Devcontainers、Channels、Ultraplan、Auto Mode、Computer Use、Agent SDK、Code Review、GitHub Actions、Agent Teams、Scheduled Tasks 等。

这块的价值是“提前一步”——很多 beta 功能 Anthropic 官方文档还没补全的时候,这个项目已经把社区第一批用户的实践整理出来了。

随便点开一个 Power-ups 章节——里面是详细的图文教程,从开启入口到常见踩坑都覆盖了:

板块 3:开发工作流(13 个主流工作流的对比)

这块特别实用——它把 GitHub 上最有名的 13 个 Claude Code 工作流(Superpowers、Everything Claude Code、Spec Kit、gstack、Get Shit Done 等)摆在一起对比。每个工作流都标了Star 数、独特性、是否有 Plan 阶段、用了几个 Subagents (A) / Commands (C) / Skills (S)——一张表你就能选出适合自己团队的工作流。

更重要的是项目识别出了一个共同模式:Research → Plan → Execute → Review → Ship——所有真正能跑得通的工作流最后都收敛到这 5 步。这是踩坑总结出的规律。

里面还提到一个跨模型 Claude Code + Codex 工作流——Claude Code 写代码、Codex 来评审。两个不同模型互相挑刺,比单一模型自审客观得多。这个组合我自己平时也在用,确实能挑出 Claude 自己看不出的边界条件问题。

板块 4:83 条 tips(15 个分类的实战技巧)

整个项目最值钱的部分。83 条 tips 按 15 个分类:Prompting (3) · Planning (7) · Context (5) · Session Management (6) · Memory (8) · Agents (4) · Commands (3) · Skills (9) · Hooks (5) · Workflows (5) · Advanced Workflows (9) · Git/PR (5) · Debugging · Utilities · Daily practices。

调试板块里有几条特别有用——遇到问题先截图 + 跟 Claude 分享、用 chrome-devtools-mcp 让 Claude 自己看控制台日志——很多时候 Claude 答不出来不是它笨,是你给它的信息量不够。

3 个最值得抄走的 tips

83 条都过一遍太累,下面挑 3 条研发同学立刻能用上的:

Tip 1:context 维持在 40% 以下,超过 300k 就压

项目原话——“Context rot at ~300-400k tokens”——上下文超过 300k 之后,Claude 的”理解力”开始打折,老指令被新内容稀释,最佳实践是维持在总 context 的 40% 以下。

操作:当你看到 status line 显示 context 利用率 >40% 时,就该 /compact 一次了——别等到爆了再压。

Tip 2:Plan 阶段单独跑、Execute 阶段不带 Plan 的废料

Research → Plan → Execute → Review → Ship 这 5 步要分阶段跑——尤其是 Plan 阶段产出的中间稿不要带到 Execute 阶段,会污染 Claude 的判断。

操作:Plan 阶段结束后,把方案 commit 到一个 markdown 文件,开新 session 让 Claude 读这个 markdown 直接 Execute——新 session = 干净的 context。

Tip 3:Hook 用来强制纪律,不是用来”加功能”

很多新人把 Hook 用来”扩展功能”——错了。Hook 真正的价值是强制工程纪律——比如设一个 PostToolUse hook:只要 Claude 改了 src/ 下的文件,自动跑 mvn test——这是 Claude 自己不会想起来做的事。

操作:在 yudao-cloud 这种多模块 Spring Boot 项目里特别有用——Claude 改了一个模块的代码,自动 trigger 该模块的单测,省掉”忘了跑测试就 commit”这个最常见的坑。

yudao-cloud 仓库地址:https://github.com/YunaiV/yudao-cloud

中文版本:Pull Request 里能找到

claude-code-best-practice 默认是英文的。如果你想看中文版本,不用去找其他翻译稿——直接去这个仓库的 Pull Requests 里找,社区已经有人提过中文 PR。作者一直没合并是因为更新太频繁怕翻译跟不上,但英文每次更新后社区中文 PR 也会跟着更新,可以直接 checkout 那个 PR 的分支用。

我的判断

用 Claude Code 用得不顺手的同学,80% 的问题不是工具本身的问题,是你不知道”高手是怎么用的”——而高手的经验过去散落在 100 个公众号、50 个 YouTube 视频、20 个 Twitter thread 里。

这个项目把它们收敛到了一个仓库——51k Star 不是因为它做了什么新东西,是因为它把”该怎么用对”这件事系统化了。

值得抽 1 小时把”83 条 tips”扫一遍,挑 3-5 条最适合自己工作流的,落到 CLAUDE.md 里——剩下的等需要时再来翻。

仓库地址:https://github.com/shanraisshan/claude-code-best-practice

文章目录
  1. 1. 一个项目把”Claude Code 怎么用对”全捋清楚了
  2. 2. 它和官方文档 / Anthropic Cookbook 有啥区别
  3. 3. 四大板块:从”我能装啥”到”高手怎么避坑”
    1. 3.0.1. 板块 1:核心概念(10 个 Claude Code 关键概念)
    2. 3.0.2. 板块 2:热门功能(20+ 个最近上线的特性)
    3. 3.0.3. 板块 3:开发工作流(13 个主流工作流的对比)
    4. 3.0.4. 板块 4:83 条 tips(15 个分类的实战技巧)
  • 4. 3 个最值得抄走的 tips
    1. 4.0.1. Tip 1:context 维持在 40% 以下,超过 300k 就压
    2. 4.0.2. Tip 2:Plan 阶段单独跑、Execute 阶段不带 Plan 的废料
    3. 4.0.3. Tip 3:Hook 用来强制纪律,不是用来”加功能”
  • 5. 中文版本:Pull Request 里能找到
  • 6. 我的判断