claude-code-best-practice 是一个面向 claude code 用户的开源系统化实践指南，聚焦从“氛围编程”向“智能体工程”演进。项目整合了 86+ 条经实战验证的技巧，深度覆盖 agents、commands、skills、hooks 和 mcp 等核心模块，并横向对比 10+ 主流开发工作流。该指南被 claude code 原作者 boris cherny 多次公开引用，提供清晰、可落地的入门到高阶学习路径。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
claude-code-best-practice 的主要功能
- 结构化知识体系：逐层解析 Claude Code 关键组件（Subagents、Commands、Skills、Hooks、MCP Servers），构建概念→配置→应用的完整认知链。
- Beta 功能动态追踪：持续更新 Ultraplan、Auto Mode、Computer Use、Agent Teams 等前沿特性配置表，确保用户第一时间掌握新能力。
- 多维工作流比对：系统评估 10+ 流行方案（如 Everything Claude Code、Superpowers、Spec Kit），标注 GitHub Star 数、适用阶段与团队规模，辅助理性选型。
- 真实问题解决方案库：沉淀 69+ 条社区高频踩坑经验，覆盖提示词设计、CLAUDE.md 迭代、Git 工作流协同、PR 自动审查等典型场景。
- 权威资源聚合中心：集中整理 Boris Cherny、Thariq 等核心贡献者的博客、技术推文、视频访谈及实操演示，降低信息获取成本。
如何使用 claude-code-best-practice
- 直达源码仓库：访问 GitHub 地址 https://www.php.cn/link/92f75eaab29dd31e16b4b88cff13c6fb。
-
重点浏览板块：
- Hot：查阅最新 Beta 功能（Ultraplan、Auto Mode、Computer Use）的启用方式与调试建议；
- Workflows：比对 Superpowers、Spec Kit 等方案差异，结合团队技术栈与协作习惯快速决策；
- Tips：按需检索 Prompting、Git/PR、Debugging、CLAUDE.md 等分类技巧，即学即用。
-
本地项目集成（实践落地）：在目标代码库根目录初始化标准
.claude/结构：
.claude/ ├── commands/ # 自定义命令（如 /refactor、/techdebt） ├── skills/ # 可复用技能（含 SKILL.md、scripts/、examples/） ├── agents/ # 领域专用子代理（如 frontend-agent、security-agent） ├── hooks/ # 生命周期钩子（如 pre-commit 格式化、post-push 检查） └── settings.json # 项目级行为配置（模型选择、工具权限、清理策略）
- 同时创建精简版
CLAUDE.md（建议 ≤200 行），明确项目技术栈、编码规范与协作约定。 -
日常高效使用：
- 新手启动：优先阅读 Tips 中的 Prompting Fundamentals 与 Workflow Selection Guide，建立高质量交互基础；
- 高频动作封装：将重复性操作（如批量重构、依赖审计、测试覆盖率分析）抽象为 Commands 或 Skills，存入对应子目录；
- 疑难问题定位：针对具体场景（如 CI 失败归因、分布式日志排查），直击 Tips 对应分类获取已验证解法。
claude-code-best-practice 的关键信息和使用要求
- 作者身份：由 shanraisshan（Shayan Rais）主导维护，其方法论获 Claude Code 创始人 Boris Cherny 多次推荐与引用。
- 内容体量：包含 86+ 条可复现技巧，覆盖 Agents、Commands、Skills、Hooks、MCP 五大支柱模块。
- 突出特色：集成 10+ 工作流对比矩阵、实时 Beta 功能追踪表（Ultraplan/Auto Mode 等）、69 条一线开发者踩坑记录。
- 前置依赖：需已安装并配置好 Claude Code CLI 工具链（含有效 API 密钥与基础环境）。
-
项目结构要求：须在代码库根目录创建
.claude/目录（含 agents/、commands/、skills/、hooks/）及CLAUDE.md规则文件。 - 使用模式：纯文档型资源，无需安装；支持在线浏览、Fork 定制或本地克隆后嵌入团队知识库。
claude-code-best-practice 的核心优势
- 体系化强：非碎片化技巧罗列，而是以模块化架构贯穿 Concepts → Workflows → Tips 全流程，支撑可持续进阶。
- 强实战属性：所有技巧均源于真实开发场景（如“CLAUDE.md 严格控于 200 行”、“Esc Esc 撤销优于逐步修正”），拒绝空泛理论。
- 时效性领先：专人维护 Hot Features 表格，同步 Ultraplan 推理调度、Auto Mode 上下文感知、Computer Use 桌面操作等最新能力落地指南。
- 决策支持完备：提供 10+ 工作流横向对比（Everything Claude Code、Superpowers 等），标注活跃度、复杂度与适配边界，显著缩短团队试错周期。
claude-code-best-practice 的项目地址
claude-code-best-practice 的同类竞品对比
| 对比维度 | **claude-code-best-practice** | **GitHub Copilot Cookbook** | **awesome-cursor / cursor.directory** |
|---|---|---|---|
| **定位** | Claude Code 系统化实战手册 | Copilot 官方示例与最佳实践 | Cursor 社区规则与提示词市场 |
| **维护方** | 社区驱动（shanraisshan） | 微软官方团队 | 社区驱动（多贡献者） |
| **核心内容** | 86+ 条踩坑经验、10+ 工作流对比 | 功能演示代码、场景化提示词 | 提示词模板、.cursorrules 规则集 |
| **内容深度** | 从入门到进阶全路径（Concepts→Workflows→Tips） | 侧重功能演示和快速上手 | 侧重提示词工程和规则配置 |
| **工作流选型** | ✅ 横向对比 10+ 套方案（Superpowers/Spec Kit 等） | ❌ 无系统工作流对比 | ❌ 无工作流架构对比 |
| **实时 Beta 追踪** | ✅ Hot Features 表格（Ultraplan/Auto Mode 等） | ⚠️ 随官方文档更新 | ❌ 无系统追踪 |
| **官方背书** | ✅ 被 Claude Code 创造者多次引用 | ✅ 微软官方出品 | ❌ 纯社区资源 |
| **多媒体资源** | ✅ 整合视频/播客（Boris 访谈等） | ❌ 以代码和文档为主 | ❌ 以文本为主 |
| **资源形式** | 知识库 + 配置文件模板 | 代码示例仓库 | 规则市场 + Awesome 列表 |
claude-code-best-practice 的应用场景
- 个体效能跃迁：开发者通过 69 条技巧快速掌握提示工程精髓、上下文精准控制与故障根因分析，规避常见低效交互陷阱。
- 团队工作流共建：基于 10+ 方案对比表，结合组织成熟度与技术债现状，科学选定并落地 Superpowers 或 Spec Kit 类工作流。
- 新能力敏捷集成：借助 Hot Features 表格，快速完成 Auto Mode 启用、Computer Use 权限配置、Ultraplan 模式调优，抢占技术红利。
- 质量门禁自动化：组合 Subagents 与内置 Code Review 工作流，实现 PR 多视角审查（风格/安全/性能）、CI 失败自动诊断与修复建议生成。
- 超大型项目协同：依托 CLAUDE.md 统一规范 + Agent Teams 分布式执行，在 Monorepo 或跨云微服务架构中实现任务隔离、上下文收敛与并行交付。
