IDEA 里跑 Claude Code 和 Codex 的最佳搭子,3.3k Star 开源免费太爽了!
如果你平时用Claude Code写代码,大概会有同样的感受:这东西不是“会用就行”,而是“用对了”和“用错了”之间,效率能差出一个数量级。
新人装好Claude Code之后,通常就两种状态:
-
一是把它当ChatGPT用——丢一个“帮我写个OAuth登录”的任务过去,等它吐出几百行代码,然后自己一行行看、一点点改。
-
二是靠自己摸索——/compact什么时候该用、CLAUDE.md怎么写、Subagents该装哪几个、Hook要不要加——全凭试错。
最近GitHub上有个项目挺有意思——claude-code-best-practice。它做了一件事:把社区验证过的Claude Code最佳实践,按“概念→功能→工作流→技巧”四个层次系统性地整理了出来。
它的口号很实在:“From vibe coding to agentic engineering—practice makes claude perfect”(从随性写代码到工程化Agent,熟能生巧)。
有个数据挺能说明问题:开源不到两个月,GitHub Star数突破了54.1k。不到60天拿下5万Star,这在工具类项目里算是相当猛的增长速度。
先搞清楚这个项目在生态里的位置。官方其实已经有一些资源了:
这个项目的差异化很清楚——它不是教“会用”,是教“用对”。
举个例子:官方文档告诉你/compact是干什么的;这个项目告诉你,上下文涨到300k-400k token时理解力会开始下降,最好维持在40%利用率以下,以及什么时候该压缩。后者才是研发真正想要的——踩过坑的人总结出来的真知。
涵盖了Subagents、Commands、Skills、Workflows、Hooks、MCP Servers、Plugins、Settings、Status Line、Memory这10个Claude Code的关键概念。每个概念都配了一个“最佳实践”按钮,点进去就是实战案例。
比如MCP Servers这块,它不仅讲协议规范,还会列出当前最值得装的MCP:chrome-devtools-mcp(让Claude调浏览器调试)、github-mcp(直接操作PR)、sequential-thinking(强制Claude分步推理)等。
紧跟Anthropic的最新beta功能——Ultrareview、Devcontainers、Channels、Ultraplan、Auto Mode、Computer Use、Agent SDK、Code Review、GitHub Actions、Agent Teams、Scheduled Tasks等。
这块的价值在于“提前一步”。很多beta功能官方文档还没补全的时候,这个项目已经把第一批用户的实践整理出来了。
这块特别实用。它把GitHub上最有名的13个Claude Code工作流(Superpowers、Everything Claude Code、Spec Kit、gstack、Get Shit Done等)放在一起做了对比。
每个工作流都标注了Star数、独特性、是否有Plan阶段、用了几个Subagents/Commands/Skills。一张表就能选出适合自己团队的工作流。
更重要的是,项目识别出了一个共同模式:Research → Plan → Execute → Review → Ship。所有真正跑得通的工作流,最后都收敛到了这五步——这是踩坑总结出来的规律。
里面还提到了一个跨模型组合:Claude Code写代码,Codex来评审。两个不同模型互相挑刺,比单一模型自审客观得多。这个组合我自己也在用,确实能挑出Claude自己看不出的边界问题。
这是整个项目最值钱的部分。83条tips按15个分类整理:Prompting、Planning、Context、Session Management、Memory、Agents、Commands、Skills、Hooks、Workflows、Advanced Workflows、Git/PR、Debugging、Utilities、Daily practices。
调试板块里有几条特别有用:遇到问题先截图发给Claude、用chrome-devtools-mcp让Claude自己看控制台日志——很多时候Claude答不出来不是它笨,是你给的信息量不够。
83条全看一遍挺累的,挑三条研发同学立刻能用上的:
技巧一:上下文保持在40%以下,超过300k就压缩
项目里明确写了:“Context rot at ~300-400k tokens”——上下文超过300k之后,Claude的理解力开始打折,老指令会被新内容稀释。最佳实践是维持在总context的40%以下。
操作很简单:看到status line显示context利用率超过40%,就执行一次/compact。别等到爆了再压。
技巧二:Plan和Execute分阶段跑,中间稿别带过去
Research → Plan → Execute → Review → Ship这五步要分阶段跑。尤其是Plan阶段产出的中间稿,不要带到Execute阶段,否则会污染Claude的判断。
正确做法:Plan阶段结束后,把方案commit到一个markdown文件里。开一个新session,让Claude读这个markdown直接执行。新session = 干净的context。
很多新人把Hook当成“扩展功能”来用——这是错的。Hook真正的价值是强制工程纪律。
举个例子:设一个PostToolUse hook,只要Claude改了src/下的文件,就自动跑mvn test。这是Claude自己不会想起来做的事。
在多模块Spring Boot项目里特别有用——Claude改了一个模块的代码,自动触发该模块的单测,省掉“忘了跑测试就commit”这个最常见的坑。
claude-code-best-practice默认是英文的。如果想看中文版,不用去找翻译稿——直接去这个仓库的Pull Requests里找,社区已经有人提过中文PR。
作者一直没合并是因为更新太频繁,怕翻译跟不上。但英文每次更新后,社区的中文PR也会跟着更新,可以直接checkout那个PR的分支来用。
用Claude Code用得不顺手的同学,80%的问题不是工具本身的问题,而是不知道“高手是怎么用的”。而高手的经验过去散落在上百个公众号、几十个YouTube视频、一堆Twitter thread里。
这个项目把它们收敛到了一个仓库里。51k Star不是因为它做了什么新东西,而是因为它把“该怎么用对”这件事系统化了。
值得抽一个小时把“83条tips”扫一遍,挑三五条最适合自己工作流的,落到CLAUDE.md里。剩下的,等需要的时候再来翻。
https://github.com/shanraisshan/claude-code-best-practice