claude-code-best-practice:Claude Code 最佳实践合集

shanraisshan/claude-code-best-practice 是一个 Claude Code 使用技巧与最佳实践的汇总项目,目前在 GitHub 上获得了 57,409 个 Star。

正文顶部截图

README区域截图

这个项目由社区维护,汇集了 Claude Code 的核心概念、热门功能、开发工作流、跨模型协作方案以及 83 条来自业内的实用技巧。项目口号是 “from vibe coding to agentic engineering”,目标是从随意的编码方式过渡到系统化的智能体工程。

项目内容分为几个板块。

概念与功能

项目整理了 Claude Code 的核心概念,包括 Subagents、Commands、Skills、Workflows、Hooks、MCP Servers、Plugins、Settings、Status Line、Memory 等。每个概念都附有最佳实践文档和实际实现示例。

热门功能部分涵盖了 Ultrareview、Devcontainers、Auto Mode、Fast Mode、Advisor、Computer Use、Agent SDK、Scheduled Tasks、Git Worktrees 等。这些功能大多处于 beta 阶段,项目提供了使用入口和参考链接。

编排工作流

项目重点介绍了 Command → Agent → Skill 的编排模式。用户可以通过 slash command 触发一个编排器,由它调用专门的 agent,再由 agent 加载对应的 skill 文件来完成复杂任务。这种模式可以将大任务拆解为多个子任务,在独立的上下文窗口中执行。

开发工作流合集

项目收集了 12 个知名的 Claude Code 工作流项目,按 Star 数排序。这些工作流遵循 “Research → Plan → Execute → Review → Ship” 的统一架构。代表性的工作流包括 Superpowers(224k Stars)、Everything Claude Code(213k Stars)、Matt Pocock Skills(125k Stars)等。每个工作流都定义了从头脑风暴到代码审查再到部署的完整步骤。

跨模型协作

项目还整理了与其他 AI 模型协同工作的三种机制:Plugin(在 Claude Code 内运行其他模型的 CLI)、MCP(通过 Model Context Protocol 调用其他模型作为工具)、Router(将 Claude Code 的 API 端点切换到其他提供商)。涉及 Codex、Gemini、GPT、Kimi、DeepSeek 等主流模型。

技巧汇总

项目收集了 83 条来自 Boris Cherny(Claude Code 作者)、Thariq(Anthropic)、Dex 等专家的实用技巧,按主题分类:

提示工程方面,建议用 “grill me on these changes” 或 “prove to me this works” 来让 Claude 主动审查代码,而不是被动接受输出。

规划方面,建议始终从 plan mode 开始,将 PRD 拆分为纵向切片而非横向分层,以获得更早的端到端反馈。

上下文管理方面,指出 1M 上下文模型在 300k-400k tokens 左右会出现上下文衰减,建议将使用率控制在 40% 以下。遇到失败时,用 /rewind 回退到错误之前的状态,而不是在污染的上下文中继续修正。

会话管理方面,建议每个新任务开启新会话,用 /compact 保留动量的同时压缩上下文,用 /rename 命名重要会话以便后续恢复。

CLAUDE.md 方面,建议单文件控制在 200 行以内,用 .claude/rules/ 拆分大型指令,用 标签包裹关键规则以避免被模型忽略。

Agent 使用方面,建议按功能创建专门的子代理而非通用的后端工程师角色,用 “use subagents” 将计算密集型任务分流到独立上下文窗口。

这个项目没有提供安装包或命令行工具,本质上是一个知识库。用户可以直接浏览 README 中的表格和链接,按需查阅对应功能的最佳实践。对于希望深入使用 Claude Code 的开发者来说,这是一个省时的入口。

应功能的最佳实践。对于希望深入使用 Claude Code 的开发者来说,这是一个省时的入口。

更多推荐