IDEA 里跑 Claude Code 和 Codex 的最佳搭子，3.3k Star 开源免费太爽了！

做过技术负责人的都懂，工具链这东西，从来不是“先到先得”，而是“用对了”和“用错了”之间，效率差出一个数量级。

• 一是当ChatGPT使唤——丢一句“帮我写个OAuth登录”，等它吐出几百行代码，然后自己一行行审、一点点改。
• 二是靠自己摸索——/compact什么时候该按，CLAUDE.md该怎么写，Subagents选哪几个，Hook要不要上——全凭试错。

它和官方文档有什么不同？

先搞清楚这个项目在生态里的位置。官方其实已经有了一些资源：

这个项目的差异化路径很清楚——不是教“会用”，是教“用对”。

举个例子：官方文档告诉你/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条实战技巧

这是整个项目最值钱的部分。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当成“扩展功能”来用——这是错的。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