shanraisshan/claude-code-best-practice - 学习路径

❤️❤️❤️❤️❤️❤️ 我们已经正式推出微信小程序，在微信中搜索 TrendForge Pro 即可使用小程序，如果使用 Telegram 请搜索 trendforge_tg ❤️❤️❤️❤️❤️❤️

项目介绍快速开始学习路径项目截图 3 贡献者 4 增长趋势 Commit 历史代码统计生态关系项目时间线项目竞品依赖分析上榜历史

学习路径指南

难度等级

初级

预计时长

3-5小时

适合人群

对AI编程助手（特别是Claude Code）感兴趣，希望从简单的提示交互转向结构化、自动化工作流的开发者。适合有一定编程基础，但可能是第一次接触“代理工程”概念的初学者。

学习目标：你将学会如何将Claude Code从一个聊天工具，升级为一个可编排、可扩展的自动化开发系统，掌握子代理、命令、技能等核心模块的创建与使用。

前置知识

Claude Code 基础使用了解

你需要知道如何安装和启动Claude Code，并能通过简单的文本提示让它帮你完成基础的编程任务（如写代码、解释代码）。这是使用本项目所有高级功能的基础。

Git 基础了解

项目中的配置文件和模块通常存放在`.claude`目录下，了解Git的基本操作（如克隆仓库、查看文件）有助于你更好地探索和部署这些配置。

命令行/终端基础了解

Claude Code主要通过命令行启动，并且很多高级功能（如CLI标志、Hooks脚本）需要在终端中操作。

学习步骤

环境准备与概念理解

30分钟

确认Claude Code已安装

打开终端，运行 `claude --version` 或直接输入 `claude`，确保Claude Code可以正常启动。如果未安装，请前往Anthropic官网下载安装。

确保你安装的是“Claude Code”，这是专为开发者设计的桌面应用，而不是网页版的Claude聊天。

克隆并浏览项目仓库

在GitHub上找到 `shanraisshan/claude-code-best-practice` 仓库，将其克隆到本地，或直接在线浏览README和目录结构。重点关注 `.claude/` 目录下的结构。

不要被大量的文件吓到，初期只需理解项目是“最佳实践指南”的集合，而不是一个需要运行的应用程序。

理解三大核心概念

阅读README中关于 Subagents（子代理）、Commands（命令）、Skills（技能）的简要描述。记住：子代理是独立的“员工”，命令是“快捷指令”，技能是“可复用的知识包”。

可以将其类比为：技能是工具箱里的工具，命令是使用这些工具的标准作业程序（SOP），而子代理是熟练运用SOP和工具的专家。

快速上手：创建你的第一个命令

1小时

在项目中创建 .claude 目录

在你自己的一个项目根目录下，创建一个名为 `.claude` 的隐藏文件夹。这是Claude Code读取配置的标准位置。

你可以先在一个临时或测试项目中尝试，避免干扰重要的工作目录。

创建第一个命令文件

在 `.claude` 目录下创建 `commands` 文件夹，然后在其中创建一个 `.md` 文件，例如 `explain-code.md`。文件内容可以是一个简单的提示模板，如：“请用通俗的语言解释以下代码： ``` {{code}} ```”

`{{code}}` 是一个占位符。当你在Claude Code中使用这个命令时，你需要提供具体的代码。命令的本质就是可复用的提示词模板。

在Claude Code中调用命令

启动Claude Code并进入你创建了 `.claude/commands` 目录的项目。在聊天输入框中，输入 `/`，你应该能看到你刚创建的 `explain-code` 命令出现在列表中。选择它，然后按照提示输入一段代码进行测试。

如果没看到命令，尝试重启Claude Code或检查命令文件路径和格式是否正确。

核心模块实践：技能与子代理

1.5小时

探索并创建一个简单技能

参考项目中的 `best-practice/claude-skills.md` 文档。在 `.claude/skills/` 目录下创建一个子文件夹（如 `my-first-skill`），并在其中创建 `SKILL.md` 文件。内容可以定义一些关于你常用技术栈（如React、Python）的编码规范或最佳实践。

技能是“知识注入”，当Claude处理相关话题时会自动引用这些知识。你可以先从一个非常具体的知识点开始，比如“如何用Python格式化日期”。

了解子代理的配置

阅读 `best-practice/claude-subagents.md`。子代理配置更复杂，初期建议以理解为主。浏览项目 `.claude/agents/` 下的示例文件，了解一个子代理如何定义自己的身份、职责和可用工具。

不要急于创建子代理。先思考：什么任务需要一個完全独立的、有记忆和特定工具的AI来执行？例如，一个专职代码审查的代理。

尝试一个预设工作流

查看项目中的 `orchestration-workflow/orchestration-workflow.md` 以及 `development-workflows/` 下的内容。选择一个简单的预设工作流（如“Superpowers”或“Get Shit Done”），按照其说明，在你的 `.claude/commands/` 目录下创建对应的计划命令文件。

工作流是命令、技能、子代理的组合拳。通过模仿一个成熟的工作流，你能最快地感受到结构化提示的威力。

进阶探索与个性化

1小时

配置基础设置

在 `.claude/` 目录下创建 `settings.json` 文件。参考项目的 `.claude/settings.json` 示例或 `best-practice/claude-settings.md`，设置一些基本选项，比如默认模型、权限模式（可以先设为 `auto` 体验自动模式）。

从最简单的配置开始，例如只设置 `{"permissionMode": "auto"}`。每次修改后需要重启Claude Code生效。

浏览“热门功能”与“技巧”

翻阅README的“🔥 Hot”功能列表和“💡 TIPS AND TRICKS”部分。选择1-2个你感兴趣的功能深入了解，例如“Simplify & Batch”（简化与批量操作）或“Voice Dictation”（语音输入）。

这些是提升效率的利器。重点关注每个功能描述中链接的推文或博客，那里有最生动的演示和背景信息。

规划你的下一个实践项目

基于所学，设想一个你想用Claude Code自动化的小任务。例如：自动为新增的API接口生成测试用例。思考这个任务需要组合使用命令、技能还是子代理。

从小处着手，一个能实际节省你5分钟时间的自动化脚本，其价值和学习意义远大于一个复杂但无法落地的构想。

学习路径常见错误

混淆“命令”和“技能”。

记住：命令（Commands）是用户主动调用的“动作”，以 `/` 开头；技能（Skills）是Claude在对话中自动调用的“知识”，用于丰富上下文。命令更偏向流程控制，技能更偏向知识库。

将配置文件放在错误的位置。

所有 `.claude/` 目录下的配置（agents, commands, skills, settings.json）都必须放在你希望Claude Code生效的“项目根目录”下，而不是克隆的本指南仓库里。每个项目都可以有自己的个性化配置。

过度设计，一开始就想创建复杂的子代理或工作流。

遵循“从命令开始”的路径。先用命令解决一个具体的、重复的提示需求。熟练后，再将其中可复用的知识抽象成技能，最后再考虑是否需要独立的子代理来执行多步骤复杂任务。

修改配置后忘记重启Claude Code。

Claude Code在启动时会加载配置。任何对 `.claude/` 目录下文件的增删改，都需要重启Claude Code（或至少重启当前会话）才能生效。

学习路径下一步步骤

1. 深入研究MCP协议：学习如何将外部工具（数据库、API）连接至Claude Code，极大扩展其能力边界。 2. 探索Hooks：实现事件驱动的自动化，如在文件保存后自动运行测试或格式化代码。 3. 参与社区：寻找并尝试他人分享的插件（Plugins），或将你自己打磨好的命令、技能打包分享。 4. 整合到团队流程：研究如何将Claude Code与GitHub Actions、Slack等工具结合，用于自动化代码审查、CI/CD等团队协作场景。