Claude Code Best Practice - Claude Code 最佳实践知识库

约 1209 字大约 4 分钟

Claude CodeAgentic EngineeringAI CodingSkills

2026-04-14

简介

Claude Code Best Practice 是一个关于 Claude Code 最佳实践的开源知识库，涵盖从 Vibe Coding 到 Agentic Engineering 的完整演进路径。该项目由开发者 shanraisshan 创建，目前拥有 42.3k Stars 和 4k Forks，采用 MIT 许可证。

项目收集、整理并实现了 Anthropic 官方团队成员（Boris Cherny、Claude Code 创始人、Thariq 等）的使用技巧和工作流程。核心目标是帮助开发者从被动式 Prompt 转向主动式 Agentic Engineering，掌握 Claude Code 的高级功能，建立规范的 AI Coding 工作流。

解决什么问题？

被动 Prompt 困境：从"给一句指令等 AI 执行"转变为"主动规划、渐进式披露"的开发模式
高级功能掌握不足：Subagents、Commands、Skills、Hooks、MCP Servers 等功能分散，缺少系统性学习资源
工作流不规范：缺乏标准化的 AI Coding 工作流程，导致人机协作效率低下
微观管理问题：开发者过度干预 AI 操作，难以实现真正的自主执行
技巧经验碎片化：官方团队的实际使用技巧散落在博客、推文、视频中，难以系统获取

核心概念

概念	类型	说明
Subagents	Agent	独立上下文中的自主执行者，可自定义工具、权限、模型、记忆，适合复杂任务的隔离执行
Commands	Command	用户调用的提示模板，用于工作流编排，适合重复性高的日常操作
Skills	Skill	可配置、可预加载、自动发现的技能，支持上下文分叉，适合渐进式披露和可复用逻辑
Hooks	Hook	在特定事件时运行的脚本、HTTP 请求或 Agent，用于自动化触发和监控
MCP Servers	MCP	Model Context Protocol，连接外部工具、数据库和 API，扩展 AI 能力边界
Plugins	Plugin	Skills、Subagents、Hooks、MCP 的分发包，方便社区分享和复用

编排模式

Command → Agent → Skill

重复性高的日常操作 → Commands
复杂任务需要隔离上下文 → Subagents
需要渐进式披露和可复用逻辑 → Skills

安装与配置

无需安装，直接使用：

# 克隆仓库
git clone https://github.com/shanraisshan/claude-code-best-practice.git

# 进入目录阅读学习
cd claude-code-best-practice

# 在 Claude Code 中让 AI 推荐适合你的最佳实践
claude

前提条件：已安装 Claude Code

使用方式

基本用法

在 Claude Code 中直接参考仓库内容进行开发：

# 启动 Claude Code
claude

# 让 AI 参考最佳实践仓库
# 例如：解释某个概念或推荐合适的实践

CLAUDE.md 配置最佳实践

每个文件控制在 200 行以内；monorepo 使用多 CLAUDE.md（祖先 + 后代加载）：

# CLAUDE.md（根目录）
---
run:
  maxSubagents: 3
---

# 子目录 CLAUDE.md
---
run:
  maxSubagents: 1
---

使用 attribution.commit: "" 替代在 CLAUDE.md 中写"不要 Co-Authored-By"。

Prompting 技巧

# 挑战模式 - 让 AI 严格审查
"grill me on these changes and don't make a PR until I pass your test"

# 中等方案 - 让 AI 提出优雅方案
"knowing everything you know now, scrap this and implement the elegant solution"

Plan Mode 使用

始终使用 Plan Mode 进行规划
用最小 spec 开始，让 Claude 通过 AskUserQuestion 工具反问
分阶段制定计划，每阶段有多个测试

实际示例

使用 Subagents 并行处理多任务

// claude-code.ts
import { Agent } from '@anthropic-ai/claude-code';

// 创建多个 Subagent 并行处理
const agents = [
  new Agent({
    name: 'research-agent',
    instructions: '研究 React 18 新特性',
    tools: ['web-search']
  }),
  new Agent({
    name: 'review-agent',
    instructions: '审查当前代码库的架构问题',
    tools: ['read', 'grep']
  })
];

// 并行执行
await Promise.all(agents.map(agent => agent.run()));

使用 Hooks 自动化触发

// .claude/hooks/pre-commit-hook.js
export default async function({ agent, event }) {
  if (event.type === 'pre-commit') {
    await agent.run('运行测试和 lint 检查');
  }
}

如何更好地利用

建立自己的最佳实践库

从本项目学习核心概念和技巧
根据自己的开发场景，定制化 CLAUDE.md 配置
将常用的工作流封装为 Commands 或 Skills
使用 Hooks 自动化重复性检查

渐进式提升

初级：掌握基础 Prompting 技巧，使用 Plan Mode
中级：使用 Commands 编排工作流，使用 Subagents 处理复杂任务
高级：构建自定义 Skills，配置 MCP Servers 连接外部工具

关注官方资源

订阅 r/ClaudeCode Reddit 社区
关注 Boris Cherny（@bcherny）和 Thariq（@trq212）的 X/Twitter
观看 Building Claude Code 访谈视频