claude-howto 学习路线图11–13 小时从零到 Claude Code 高级用户的系统性进阶指南【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howtoclaude-howto 是一个以可视化、示例驱动方式讲解 Claude Code 的仓库而LEARNING-ROADMAP.md正是这套教程的总纲它把仓库中从01-slash-commands到10-cli的 10 个功能模块按依赖关系 → 复杂度 → 使用频率重排为一条渐进式学习路径并配以自评测试、里程碑实战练习、进度核对清单与时间估算。读完本文你将掌握如何为自己的水平定位、如何按 3 个 Level / 6 个里程碑系统学习 Claude Code 的全部核心能力并获得一套可复制的动手演练命令。学习理念为什么模块要按特定顺序学仓库中所有模块目录01-slash-commands 至 10-cli都以数字编号其排序遵循三条原则依赖关系Dependencies先学作为地基的概念例如 Slash Commands 与 Memory 被排在首位因为 Skills 建立在命令机制之上复杂度Complexity简单功能先于进阶功能从斜杠命令到权限模式逐级递进使用频率Frequency of Use日常最高频的功能如/optimize、项目记忆最早引入让学习者在第一天就获得生产力回报。这样做的好处是在建立扎实基础的同时立刻获得即时收益而不是什么都扫一遍、什么都学不精。先定位8 项自评清单学习路径文档建议所有人先诚实回答 8 个问题据此定位起点我能启动 Claude Code 并完成一次对话claude我创建或编辑过CLAUDE.md文件我使用过至少 3 个内置斜杠命令如/help、/compact、/model我创建过自定义斜杠命令或 SkillSKILL.md我配置过 MCP 服务器如 GitHub、数据库我在~/.claude/settings.json中配置过 hooks我创建或使用过自定义 subagents.claude/agents/我在脚本或 CI/CD 中使用过打印模式claude -p对照结果确定级别勾选数级别起点预计完成时间0–2Level 1入门Getting Started里程碑 1A约 3 小时3–5Level 2进阶Building Workflows里程碑 2A约 5 小时6–8Level 3高级Power User Team Lead里程碑 3A约 5 小时拿不准时建议降一级起步——快速复习熟悉内容好过错过关键基础概念。学习路径总览从自评出发三条主线串起全部 6 个里程碑10 个模块的完整路线信息如下表覆盖复杂度、时长、依赖关系与学习理由步骤功能模块复杂度时间级别依赖为什么学核心收益1Slash Commands⭐30 分钟Level 1无快速生产力60 内置命令 10 个内置 skill即时自动化、团队标准2Memory⭐⭐45 分钟Level 1无一切功能的基础持久化上下文、个性化偏好3Checkpoints⭐⭐45 分钟Level 1会话管理安全探索试验与恢复4CLI 基础⭐⭐30 分钟Level 1无核心 CLI 用法交互式与打印模式5Skills⭐⭐1 小时Level 2Slash Commands自动化的专业能力可复用能力、一致性6Hooks⭐⭐1 小时Level 2工具、命令工作流自动化31 类事件、5 种类型校验、质量关卡7MCP⭐⭐⭐1 小时Level 2配置实时数据访问实时集成、API8Subagents⭐⭐⭐1.5 小时Level 2Memory、Commands复杂任务处理6 个内置含 Bash委派、专业化能力9高级功能⭐⭐⭐⭐⭐2–3 小时Level 3前面所有高级用户工具Planning、Auto Mode、Channels、语音听写、权限10Plugins⭐⭐⭐⭐2 小时Level 3前面所有完整解决方案团队上手、分发11CLI 精通⭐⭐⭐1 小时Level 3建议全部精通命令行用法脚本化、CI/CD、自动化总学习时间约 11–13 小时当然也可以直接跳到适合自己的级别以节省时间。Level 1入门 — Getting Started适用对象自评勾选 0–2 项总时长约 3 小时目标成为熟练的日常用户为 Level 2 打底里程碑 1A首次命令与记忆Slash Commands Memory主题Slash Commands Memory时长1–2 小时复杂度⭐你将掌握为重复任务创建自定义斜杠命令为团队标准建立项目记忆配置个人偏好理解 Claude 如何自动加载上下文。动手练习# 练习 1安装你的第一个斜杠命令 mkdir -p .claude/commands cp 01-slash-commands/optimize.md .claude/commands/ # 练习 2创建项目记忆 cp 02-memory/project-CLAUDE.md ./CLAUDE.md # 练习 3在 Claude Code 中尝试 # 输入/optimize其中optimize.md见 01-slash-commands/optimize.md是仓库内置的代码优化命令它要求 Claude 按优先级顺序检查性能瓶颈、内存泄漏、算法改进空间、缓存机会与并发问题并以严重级别 代码位置 解释 修复示例的固定格式输出。需要补充的背景知识CLAUDE.md 的分层加载机制Claude Code 会在每次会话启动时按层级把 CLAUDE.md 文件拼接进上下文而非覆盖。顺序从组织级 managed policy如 Linux 下的/etc/claude-code/CLAUDE.md、用户级~/.claude/CLAUDE.md、项目级./CLAUDE.md或./.claude/CLAUDE.md到个人项目级./CLAUDE.local.md建议加入.gitignore。子目录下的 CLAUDE.md 会在 Claude 读取该子目录文件时按需加载。详见 02-memory/README.md。Auto MemoryClaude 也会自动把学到的模式写入~/.claude/projects/project/memory/MEMORY.md会话启动时加载其前 200 行或前 25KB主题文件按需加载可用autoMemoryEnabled或环境变量CLAUDE_CODE_DISABLE_AUTO_MEMORY控制。记忆维护命令/init生成初始 CLAUDE.md/memory打开编辑器维护记忆文件path/to/file语法可在 CLAUDE.md 中导入外部文档递归导入上限 4 层。完成标准能成功调用/optimizeClaude 能根据 CLAUDE.md 记住项目标准你能分清何时该用斜杠命令、何时该用记忆。里程碑 1B安全探索Checkpoints CLI 基础主题Checkpoints CLI 基础时长约 1 小时复杂度⭐⭐你将掌握创建与恢复 checkpoint 以安全实验理解交互模式 vs 打印模式使用基本 CLI 参数通过管道处理文件。动手练习# 练习 1尝试 checkpoint 工作流 # 在 Claude Code 中 # 做若干实验性修改然后按 EscEsc 或使用 /rewind # 选择实验开始前的 checkpoint # 选择 Restore code and conversation 回到过去 # 练习 2交互模式 vs 打印模式 claude explain this project # 交互模式 claude -p explain this function # 打印模式非交互 # 练习 3通过管道处理文件内容 cat error.log | claude -p explain this error原理补充checkpoint 会自动在每次用户输入时创建保留会话消息、文件修改与工具调用历史。/rewind别名/checkpoint打开恢复界面后可选择多种回退选项。其配置位于 08-checkpoints/README.md关键设置{ fileCheckpointingEnabled: true, cleanupPeriodDays: 30 }fileCheckpointingEnabled默认true需 v2.1.119决定是否在每次编辑前对文件做快照cleanupPeriodDays默认 30决定会话历史与 checkpoint 的保留天数——自 v2.1.117 起它统一治理包括~/.claude/checkpoints/、~/.claude/tasks/、~/.claude/shell-snapshots/与~/.claude/backups/四类磁盘缓存。另外注意 checkpoint不会跟踪 Bash 命令造成的文件系统改动也不是 git 的替代品两者配合使用——checkpoint 负责快速试错git 负责永久可审计的提交。完成标准创建并回退到某个 checkpoint使用过交互与打印两种模式能向 Claude 管道传入文件进行分析。Level 2进阶 — Building Workflows适用对象自评勾选 3–5 项总时长约 5 小时目标自动化工作流、外部集成、任务委派进入 Level 2 的前置检查能创建和使用斜杠命令01-slash-commands/已通过 CLAUDE.md 建立项目记忆02-memory/知道如何创建与恢复 checkpoint08-checkpoints/能从命令行使用claude与claude -p10-cli/有缺口先复习对应教程再继续。里程碑 2A自动化Skills Hooks主题Skills Hooks时长2–3 小时复杂度⭐⭐你将掌握通过 YAML frontmatter 自动触发专项能力含effort与shell字段在 31 类 hook 事件上建立事件驱动自动化使用全部 5 种 hook 类型command、http、mcp_tool、prompt、agent落实代码质量关卡为工作流定制 hooks。动手练习# 练习 1安装一个 Skill cp -r 03-skills/code-review-specialist ~/.claude/skills/ # 练习 2设置 hooks mkdir -p ~/.claude/hooks cp 06-hooks/pre-tool-check.sh ~/.claude/hooks/ chmod x ~/.claude/hooks/pre-tool-check.sh # 练习 3在 settings 中配置 hooks # 在 ~/.claude/settings.json 中添加 { hooks: { PreToolUse: [ { matcher: Bash, hooks: [ { type: command, command: ~/.claude/hooks/pre-tool-check.sh } ] } ] } }源码级佐证code-review-specialist是仓库里结构最完整的 Skill 示例见 03-skills/code-review-specialist/SKILL.md其 frontmatter 中的description专门写明触发条件Use when users ask to review code...这是让 Claude自动调用Skill 的关键它还在templates/与scripts/下打包了评审清单模板、问题记录模板、指标分析脚本与复杂度对比脚本。在 03-skills/README.md 中可以看到 Skill 采用渐进式披露加载架构启动时只加载约 100 token 的元数据name description被触发后才读取正文控制在 5k token 内脚本等资源按需执行而不占上下文——因此可以安装大量 Skill 而无上下文代价。而pre-tool-check.sh见 06-hooks/pre-tool-check.sh是 hook 协议的完整范例它从 stdin 读取{tool_name:Bash,tool_input:{command:...}}对rm -rf /、fork bomb、mkfs等危险命令exit 2拦截stderr 作为拦截原因回传对rm -rf、git push --force、DROP TABLE等高风险命令仅记录告警并放行同时把每次判定写入$CLAUDE_PROJECT_DIR/.claude/hooks/audit.log。关于 5 种 hook 类型与 31 类事件Tool / Session / Task / Lifecycle 四大类的完整枚举参考 06-hooks/README.md。完成标准相关场景下 code review skill 能被自动触发PreToolUse hook 在工具执行前运行能区分skill 自动调用与hook 事件触发两种自动化机制。里程碑 2B集成MCP Subagents主题MCP Subagents时长2–3 小时复杂度⭐⭐⭐你将掌握从 GitHub、数据库等外部服务获取实时数据把工作委派给专业 AI 子代理判断何时用 MCP、何时用 subagents构建集成工作流。动手练习# 练习 1设置 GitHub MCP export GITHUB_TOKENyour_github_token claude mcp add github -- npx -y modelcontextprotocol/server-github # 练习 2测试 MCP 集成 # 在 Claude Code 中输入/mcp__github__list_prs # 练习 3安装 subagents mkdir -p .claude/agents cp 04-subagents/*.md .claude/agents/完整集成练习① 用 MCP 拉取某个 GitHub PR② 让 Claude 把评审委派给code-reviewer子代理③ 用 hooks 自动运行测试。原理补充MCP 服务器可按作用域配置——--scope local写入~/.claude.json仅本人当前项目、--scope project写入.mcp.json团队经 git 共享首次使用需审批、--scope user跨项目可用。MCP 服务器暴露的 prompt 会成为斜杠命令命名规则为/mcp__server__prompt05-mcp/README.md 中还给出了 GitHub、Database、Filesystem、Multi-MCP 等完整 JSON 配置范例。仓库 05-mcp/ 目录下也直接提供了github-mcp.json、database-mcp.json、filesystem-mcp.json与multi-mcp.json可抄作业的配置。Subagent 则用 YAML frontmatter Markdown 系统提示定义详见 04-subagents/README.mddescription中写use PROACTIVELY可鼓励主代理自动委派tools限制其可用工具context: fork让子代理继承父会话上下文isolation: worktree为子代理提供独立 git worktree。仓库 04-subagents/ 内置了 code-reviewer、test-engineer、documentation-writer、secure-reviewer、implementation-agent 等多个可直接安装的示例。MCP vs Subagents 的选择逻辑需要外部实时数据/API → MCP需要把复杂任务拆分给拥有独立上下文的专职代理 → Subagents二者可与 hooks 组合成完整流水线。完成标准能通过 MCP 查询 GitHub 数据Claude 能把复杂任务委派给子代理理解 MCP 与 subagents 的本质区别在一条工作流中组合使用 MCP subagents hooks。Level 3高级 — Power User Team Lead适用对象自评勾选 6–8 项总时长约 5 小时目标团队工具化、CI/CD、企业级功能、插件开发进入 Level 3 的前置检查能创建并自动调用带 auto-invocation 的 skills03-skills/已配置事件驱动自动化 hooks06-hooks/能为外部数据配置 MCP 服务器05-mcp/会用 subagents 做任务委派04-subagents/里程碑 3A高级功能主题Planning、Permissions、Extended Thinking、Auto Mode、Channels、语音听写、Remote/Desktop/Web 等高级能力时长2–3 小时复杂度⭐⭐⭐⭐⭐你将掌握为复杂功能使用规划模式用 6 种权限模式做细粒度控制用AltT/OptionT切换扩展思考后台任务管理自动记忆偏好带后台安全分类器的 Auto Mode用 Channels 组织多会话结构化工作流免提语音听写远程控制、桌面应用与 Web 会话Agent Teams 多代理协作。动手练习# 练习 1使用规划模式 /plan Implement user authentication system # 练习 2尝试权限模式6 种manual[原 default]、acceptEdits、plan、auto、dontAsk、bypassPermissions claude --permission-mode plan analyze this codebase claude --permission-mode acceptEdits refactor the auth module claude --permission-mode auto implement the feature # 练习 3开启扩展思考 # 会话中按 AltTmacOS 为 OptionT切换 # 练习 4高级 checkpoint 工作流 # 1. 创建名为 Clean state 的 checkpoint # 2. 用规划模式设计一个功能 # 3. 通过子代理委派实现 # 4. 在后台运行测试 # 5. 测试失败则回退到 checkpoint # 6. 尝试另一种方案 # 练习 5尝试 auto mode后台安全分类器 claude --permission-mode auto implement user settings page # 练习 6启用 Agent Teams export CLAUDE_AGENT_TEAMS1 # 然后告诉 ClaudeImplement feature X using a team approach # 练习 7定时任务 /loop 5m /check-status # 或使用 CronCreate 做持久化定时任务 # 练习 8用 Channels 组织跨会话工作流 # 练习 9使用语音听写解放双手与 Claude Code 交互补充说明关于权限模式、规划模式与 Auto Mode 等更完整的 JSON 配置示例含扩展思考、后台任务、会话管理等配置项参见 09-advanced-features/config-examples.json 与 09-advanced-features/README.md。其中manual即原先的defaultdefault作为别名仍被接受auto模式配合后台安全分类器让 Claude 以更高自主度工作。完成标准为复杂功能使用过规划模式配置过多种权限模式能用快捷键切换扩展思考用过带安全分类器的 auto mode用后台任务跑过长操作探索过 Channels 多会话工作流试过语音听写理解 Remote Control、Desktop App 与 Web 会话启用并体验过 Agent Teams用/loop建立过循环或定时监控。里程碑 3B团队与分发Plugins CLI 精通主题Plugins CLI 精通 CI/CD时长2–3 小时复杂度⭐⭐⭐⭐你将掌握安装并创建完整打包的插件精通 CLI 用于脚本化与自动化用claude -p做 CI/CD 集成为自动化流水线输出 JSON会话管理与批处理。动手练习# 练习 1安装一个完整插件 # 在 Claude Code 中输入/plugin install pr-review # 练习 2用打印模式跑 CI/CD 任务 claude -p Run all tests and generate report # 练习 3为脚本输出 JSON claude -p --output-format json list all functions # 练习 4会话管理与恢复 claude -r feature-auth continue implementation # 练习 5带约束的 CI/CD 集成 claude -p --max-turns 3 --output-format json review code # 练习 6批处理 for file in *.md; do claude -p --output-format json summarize this: $(cat $file) ${file%.md}.summary.json doneCI/CD 集成练习① 用claude -p评审变更文件② 结果输出为 JSON③ 用jq提取具体问题④ 集成进 GitHub Actions 工作流。CLI 的真实使用场景代码评审自动化在 CI/CD 流水线里跑 code review、日志分析分析错误日志与系统输出、文档批量生成、测试洞察分析测试失败、性能分析审查性能指标、数据处理转换与分析数据文件。仓库 07-plugins/ 内含三个开箱即用的完整插件包pr-review、devops-automation、documentation每个插件都按agents/、commands/、hooks/、mcp/的组织方式打包了子代理、命令与脚本可作为团队插件的最佳范式。完成标准安装并使用过插件为团队构建或改写过插件在 CI/CD 中使用过打印模式能生成供脚本消费的 JSON成功恢复过历史会话编写过批处理脚本把 Claude 集成进了 CI/CD 工作流。交互式测试/self-assessment与/lesson-quiz仓库为学得怎么样内置了两套可在 Claude Code 中直接运行的自评 Skill将本仓库相关配置安装到本地后可用Skill命令用途自评/self-assessment评估你在全部 10 大功能域的综合熟练度可选 Quick2 分钟或 Deep5 分钟模式生成个人技能画像与学习路径课程测验/lesson-quiz [lesson]针对特定课程出 10 道题测试理解可在课前前测、课中进度检查或课后掌握度验证使用示例/self-assessment # 定位你的整体水平 /lesson-quiz hooks # 课程 06 Hooks 测验 /lesson-quiz 03 # 课程 03 Skills 测验 /lesson-quiz advanced-features # 课程 09 测验快速路径15 分钟 / 1 小时 / 一个周末只有 15 分钟复制一个斜杠命令cp 01-slash-commands/optimize.md .claude/commands/在 Claude Code 里输入/optimize试运行阅读 01-slash-commands/README.md结果获得一个可工作的斜杠命令并理解其原理。有 1 小时斜杠命令15 分钟复制并测试/optimize与/pr项目记忆15 分钟用你的项目标准创建 CLAUDE.md安装 Skill15 分钟配置code-review-specialist组合验证15 分钟观察三者如何协同工作结果获得命令 记忆 自动 skill 的基础生产力提升。有一个周末周六上午3 小时完成里程碑 1ASlash Commands Memory与 1BCheckpoints CLI 基础周六下午3 小时完成里程碑 2ASkills Hooks与 2BMCP Subagents周日4 小时完成里程碑 3A高级功能与 3BPlugins CLI 精通 CI/CD并为团队构建一个自定义插件结果成为一名能培训他人、自动化复杂工作流的 Claude Code 高级用户。学习建议Do 与 Dont✅ 应当先做测验找到起点逐里程碑完成动手练习从简单开始逐步增加复杂度学下一个功能前先验证当前功能记录对你工作流有效的内容学高阶概念时回看前面的内容利用 checkpoints 安全实验把知识分享给团队。❌ 不要跳级时跳过前置检查试图一次学完所有东西容易失控不理解就照抄配置否则无法排错忘记测试——总是验证功能是否生效草草赶完里程碑忽略文档——每个 README 都有价值闭门造车——多和队友讨论。学习风格匹配视觉型学习者研究各 README 中的 mermaid 图观察命令执行流画出自己的流程图为学习路径留档。动手型学习者完成每一个动手练习大胆做变体实验故意弄坏再修好用 checkpoints创建自己的示例。阅读型学习者逐字精读各 README研究代码示例与对比表格。社交型学习者组织结对编程把概念教给队友分享你的自定义配置。进度追踪清单Level 1入门完成 01-slash-commands完成 02-memory创建首个自定义斜杠命令建立项目记忆达成里程碑 1A完成 08-checkpoints完成 10-cli 基础创建并回退过一个 checkpoint使用过交互与打印模式达成里程碑 1BLevel 2进阶完成 03-skills完成 06-hooks安装首个 skill配置 PreToolUse hook达成里程碑 2A完成 05-mcp完成 04-subagents连接 GitHub MCP创建自定义 subagent组合集成一条工作流达成里程碑 2BLevel 3高级完成 09-advanced-features成功使用规划模式配置权限模式含 auto 共 6 种使用带安全分类器的 auto mode使用扩展思考切换探索 Channels 与语音听写达成里程碑 3A完成 07-plugins完成 10-cli 高级用法在 CI/CD 中使用打印模式claude -p为自动化输出 JSON将 Claude 集成进 CI/CD 流水线创建团队插件达成里程碑 3B常见学习困难与对策困难对策概念太多一次消化不了一次只聚焦一个里程碑做完所有练习再前进不知道某个场景该用哪个功能查阅主 README 中的 Use Case Matrix配置不生效查阅 Troubleshooting 一节核对文件位置概念似乎重叠分不清复习 Feature Comparison 对比表理解差异内容太多记不住制作自己的速查表用 checkpoints 安全实验有经验但不知从哪开始回到上文的 8 项自评跳到对应级别用前置检查补缺口完成之后进阶方向完成全部里程碑后可以继续① 撰写团队 Claude Code 配置文档② 把团队工作流打包成自定义插件③ 探索 Remote Control——从外部工具以编程方式控制 Claude Code 会话④ 尝试 Web 会话做远程开发⑤ 使用桌面应用⑥ 让 Auto Mode 在后台安全分类器护航下自主工作⑦ 利用 Auto Memory 让 Claude 随使用自动学习偏好⑧ 用 Agent Teams 协调多代理处理复杂多面任务⑨ 用 Channels 组织结构化多会话工作流⑩ 试试语音听写⑪ 用/loop与 cron 工具自动化周期检查⑫ 为社区贡献示例⑬ 指导他人上手⑭ 依据使用情况持续优化工作流⑮ 跟进 Claude Code 的新版本与新特性。适用范围说明本路线图的内容与命令以仓库当前所同步的 Claude Code 版本文档标注 v2.1.235与兼容模型Claude Fable 5、Opus 5、Sonnet 5、Sonnet 4.6、Opus 4.8、Haiku 4.5为准。功能名称、权限模式与事件数量会随版本演进实际使用前请结合官方 changelog 与 CHANGELOG.md 核对。仓库的README.md还提供了 15 分钟快速上手安装参考与完整的 功能目录可作为本路线图的配套速查入口。【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 claude-howto 学习路线图：11–13 小时从零到 Claude Code 高级用户的系统性进阶指南
claude-howto 学习路线图11–13 小时从零到 Claude Code 高级用户的系统性进阶指南【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howtoclaude-howto 是一个以可视化、示例驱动方式讲解 Claude Code 的仓库而LEARNING-ROADMAP.md正是这套教程的总纲它把仓库中从01-slash-commands到10-cli的 10 个功能模块按依赖关系 → 复杂度 → 使用频率重排为一条渐进式学习路径并配以自评测试、里程碑实战练习、进度核对清单与时间估算。读完本文你将掌握如何为自己的水平定位、如何按 3 个 Level / 6 个里程碑系统学习 Claude Code 的全部核心能力并获得一套可复制的动手演练命令。学习理念为什么模块要按特定顺序学仓库中所有模块目录01-slash-commands 至 10-cli都以数字编号其排序遵循三条原则依赖关系Dependencies先学作为地基的概念例如 Slash Commands 与 Memory 被排在首位因为 Skills 建立在命令机制之上复杂度Complexity简单功能先于进阶功能从斜杠命令到权限模式逐级递进使用频率Frequency of Use日常最高频的功能如/optimize、项目记忆最早引入让学习者在第一天就获得生产力回报。这样做的好处是在建立扎实基础的同时立刻获得即时收益而不是什么都扫一遍、什么都学不精。先定位8 项自评清单学习路径文档建议所有人先诚实回答 8 个问题据此定位起点我能启动 Claude Code 并完成一次对话claude我创建或编辑过CLAUDE.md文件我使用过至少 3 个内置斜杠命令如/help、/compact、/model我创建过自定义斜杠命令或 SkillSKILL.md我配置过 MCP 服务器如 GitHub、数据库我在~/.claude/settings.json中配置过 hooks我创建或使用过自定义 subagents.claude/agents/我在脚本或 CI/CD 中使用过打印模式claude -p对照结果确定级别勾选数级别起点预计完成时间0–2Level 1入门Getting Started里程碑 1A约 3 小时3–5Level 2进阶Building Workflows里程碑 2A约 5 小时6–8Level 3高级Power User Team Lead里程碑 3A约 5 小时拿不准时建议降一级起步——快速复习熟悉内容好过错过关键基础概念。学习路径总览从自评出发三条主线串起全部 6 个里程碑10 个模块的完整路线信息如下表覆盖复杂度、时长、依赖关系与学习理由步骤功能模块复杂度时间级别依赖为什么学核心收益1Slash Commands⭐30 分钟Level 1无快速生产力60 内置命令 10 个内置 skill即时自动化、团队标准2Memory⭐⭐45 分钟Level 1无一切功能的基础持久化上下文、个性化偏好3Checkpoints⭐⭐45 分钟Level 1会话管理安全探索试验与恢复4CLI 基础⭐⭐30 分钟Level 1无核心 CLI 用法交互式与打印模式5Skills⭐⭐1 小时Level 2Slash Commands自动化的专业能力可复用能力、一致性6Hooks⭐⭐1 小时Level 2工具、命令工作流自动化31 类事件、5 种类型校验、质量关卡7MCP⭐⭐⭐1 小时Level 2配置实时数据访问实时集成、API8Subagents⭐⭐⭐1.5 小时Level 2Memory、Commands复杂任务处理6 个内置含 Bash委派、专业化能力9高级功能⭐⭐⭐⭐⭐2–3 小时Level 3前面所有高级用户工具Planning、Auto Mode、Channels、语音听写、权限10Plugins⭐⭐⭐⭐2 小时Level 3前面所有完整解决方案团队上手、分发11CLI 精通⭐⭐⭐1 小时Level 3建议全部精通命令行用法脚本化、CI/CD、自动化总学习时间约 11–13 小时当然也可以直接跳到适合自己的级别以节省时间。Level 1入门 — Getting Started适用对象自评勾选 0–2 项总时长约 3 小时目标成为熟练的日常用户为 Level 2 打底里程碑 1A首次命令与记忆Slash Commands Memory主题Slash Commands Memory时长1–2 小时复杂度⭐你将掌握为重复任务创建自定义斜杠命令为团队标准建立项目记忆配置个人偏好理解 Claude 如何自动加载上下文。动手练习# 练习 1安装你的第一个斜杠命令 mkdir -p .claude/commands cp 01-slash-commands/optimize.md .claude/commands/ # 练习 2创建项目记忆 cp 02-memory/project-CLAUDE.md ./CLAUDE.md # 练习 3在 Claude Code 中尝试 # 输入/optimize其中optimize.md见 01-slash-commands/optimize.md是仓库内置的代码优化命令它要求 Claude 按优先级顺序检查性能瓶颈、内存泄漏、算法改进空间、缓存机会与并发问题并以严重级别 代码位置 解释 修复示例的固定格式输出。需要补充的背景知识CLAUDE.md 的分层加载机制Claude Code 会在每次会话启动时按层级把 CLAUDE.md 文件拼接进上下文而非覆盖。顺序从组织级 managed policy如 Linux 下的/etc/claude-code/CLAUDE.md、用户级~/.claude/CLAUDE.md、项目级./CLAUDE.md或./.claude/CLAUDE.md到个人项目级./CLAUDE.local.md建议加入.gitignore。子目录下的 CLAUDE.md 会在 Claude 读取该子目录文件时按需加载。详见 02-memory/README.md。Auto MemoryClaude 也会自动把学到的模式写入~/.claude/projects/project/memory/MEMORY.md会话启动时加载其前 200 行或前 25KB主题文件按需加载可用autoMemoryEnabled或环境变量CLAUDE_CODE_DISABLE_AUTO_MEMORY控制。记忆维护命令/init生成初始 CLAUDE.md/memory打开编辑器维护记忆文件path/to/file语法可在 CLAUDE.md 中导入外部文档递归导入上限 4 层。完成标准能成功调用/optimizeClaude 能根据 CLAUDE.md 记住项目标准你能分清何时该用斜杠命令、何时该用记忆。里程碑 1B安全探索Checkpoints CLI 基础主题Checkpoints CLI 基础时长约 1 小时复杂度⭐⭐你将掌握创建与恢复 checkpoint 以安全实验理解交互模式 vs 打印模式使用基本 CLI 参数通过管道处理文件。动手练习# 练习 1尝试 checkpoint 工作流 # 在 Claude Code 中 # 做若干实验性修改然后按 EscEsc 或使用 /rewind # 选择实验开始前的 checkpoint # 选择 Restore code and conversation 回到过去 # 练习 2交互模式 vs 打印模式 claude explain this project # 交互模式 claude -p explain this function # 打印模式非交互 # 练习 3通过管道处理文件内容 cat error.log | claude -p explain this error原理补充checkpoint 会自动在每次用户输入时创建保留会话消息、文件修改与工具调用历史。/rewind别名/checkpoint打开恢复界面后可选择多种回退选项。其配置位于 08-checkpoints/README.md关键设置{ fileCheckpointingEnabled: true, cleanupPeriodDays: 30 }fileCheckpointingEnabled默认true需 v2.1.119决定是否在每次编辑前对文件做快照cleanupPeriodDays默认 30决定会话历史与 checkpoint 的保留天数——自 v2.1.117 起它统一治理包括~/.claude/checkpoints/、~/.claude/tasks/、~/.claude/shell-snapshots/与~/.claude/backups/四类磁盘缓存。另外注意 checkpoint不会跟踪 Bash 命令造成的文件系统改动也不是 git 的替代品两者配合使用——checkpoint 负责快速试错git 负责永久可审计的提交。完成标准创建并回退到某个 checkpoint使用过交互与打印两种模式能向 Claude 管道传入文件进行分析。Level 2进阶 — Building Workflows适用对象自评勾选 3–5 项总时长约 5 小时目标自动化工作流、外部集成、任务委派进入 Level 2 的前置检查能创建和使用斜杠命令01-slash-commands/已通过 CLAUDE.md 建立项目记忆02-memory/知道如何创建与恢复 checkpoint08-checkpoints/能从命令行使用claude与claude -p10-cli/有缺口先复习对应教程再继续。里程碑 2A自动化Skills Hooks主题Skills Hooks时长2–3 小时复杂度⭐⭐你将掌握通过 YAML frontmatter 自动触发专项能力含effort与shell字段在 31 类 hook 事件上建立事件驱动自动化使用全部 5 种 hook 类型command、http、mcp_tool、prompt、agent落实代码质量关卡为工作流定制 hooks。动手练习# 练习 1安装一个 Skill cp -r 03-skills/code-review-specialist ~/.claude/skills/ # 练习 2设置 hooks mkdir -p ~/.claude/hooks cp 06-hooks/pre-tool-check.sh ~/.claude/hooks/ chmod x ~/.claude/hooks/pre-tool-check.sh # 练习 3在 settings 中配置 hooks # 在 ~/.claude/settings.json 中添加 { hooks: { PreToolUse: [ { matcher: Bash, hooks: [ { type: command, command: ~/.claude/hooks/pre-tool-check.sh } ] } ] } }源码级佐证code-review-specialist是仓库里结构最完整的 Skill 示例见 03-skills/code-review-specialist/SKILL.md其 frontmatter 中的description专门写明触发条件Use when users ask to review code...这是让 Claude自动调用Skill 的关键它还在templates/与scripts/下打包了评审清单模板、问题记录模板、指标分析脚本与复杂度对比脚本。在 03-skills/README.md 中可以看到 Skill 采用渐进式披露加载架构启动时只加载约 100 token 的元数据name description被触发后才读取正文控制在 5k token 内脚本等资源按需执行而不占上下文——因此可以安装大量 Skill 而无上下文代价。而pre-tool-check.sh见 06-hooks/pre-tool-check.sh是 hook 协议的完整范例它从 stdin 读取{tool_name:Bash,tool_input:{command:...}}对rm -rf /、fork bomb、mkfs等危险命令exit 2拦截stderr 作为拦截原因回传对rm -rf、git push --force、DROP TABLE等高风险命令仅记录告警并放行同时把每次判定写入$CLAUDE_PROJECT_DIR/.claude/hooks/audit.log。关于 5 种 hook 类型与 31 类事件Tool / Session / Task / Lifecycle 四大类的完整枚举参考 06-hooks/README.md。完成标准相关场景下 code review skill 能被自动触发PreToolUse hook 在工具执行前运行能区分skill 自动调用与hook 事件触发两种自动化机制。里程碑 2B集成MCP Subagents主题MCP Subagents时长2–3 小时复杂度⭐⭐⭐你将掌握从 GitHub、数据库等外部服务获取实时数据把工作委派给专业 AI 子代理判断何时用 MCP、何时用 subagents构建集成工作流。动手练习# 练习 1设置 GitHub MCP export GITHUB_TOKENyour_github_token claude mcp add github -- npx -y modelcontextprotocol/server-github # 练习 2测试 MCP 集成 # 在 Claude Code 中输入/mcp__github__list_prs # 练习 3安装 subagents mkdir -p .claude/agents cp 04-subagents/*.md .claude/agents/完整集成练习① 用 MCP 拉取某个 GitHub PR② 让 Claude 把评审委派给code-reviewer子代理③ 用 hooks 自动运行测试。原理补充MCP 服务器可按作用域配置——--scope local写入~/.claude.json仅本人当前项目、--scope project写入.mcp.json团队经 git 共享首次使用需审批、--scope user跨项目可用。MCP 服务器暴露的 prompt 会成为斜杠命令命名规则为/mcp__server__prompt05-mcp/README.md 中还给出了 GitHub、Database、Filesystem、Multi-MCP 等完整 JSON 配置范例。仓库 05-mcp/ 目录下也直接提供了github-mcp.json、database-mcp.json、filesystem-mcp.json与multi-mcp.json可抄作业的配置。Subagent 则用 YAML frontmatter Markdown 系统提示定义详见 04-subagents/README.mddescription中写use PROACTIVELY可鼓励主代理自动委派tools限制其可用工具context: fork让子代理继承父会话上下文isolation: worktree为子代理提供独立 git worktree。仓库 04-subagents/ 内置了 code-reviewer、test-engineer、documentation-writer、secure-reviewer、implementation-agent 等多个可直接安装的示例。MCP vs Subagents 的选择逻辑需要外部实时数据/API → MCP需要把复杂任务拆分给拥有独立上下文的专职代理 → Subagents二者可与 hooks 组合成完整流水线。完成标准能通过 MCP 查询 GitHub 数据Claude 能把复杂任务委派给子代理理解 MCP 与 subagents 的本质区别在一条工作流中组合使用 MCP subagents hooks。Level 3高级 — Power User Team Lead适用对象自评勾选 6–8 项总时长约 5 小时目标团队工具化、CI/CD、企业级功能、插件开发进入 Level 3 的前置检查能创建并自动调用带 auto-invocation 的 skills03-skills/已配置事件驱动自动化 hooks06-hooks/能为外部数据配置 MCP 服务器05-mcp/会用 subagents 做任务委派04-subagents/里程碑 3A高级功能主题Planning、Permissions、Extended Thinking、Auto Mode、Channels、语音听写、Remote/Desktop/Web 等高级能力时长2–3 小时复杂度⭐⭐⭐⭐⭐你将掌握为复杂功能使用规划模式用 6 种权限模式做细粒度控制用AltT/OptionT切换扩展思考后台任务管理自动记忆偏好带后台安全分类器的 Auto Mode用 Channels 组织多会话结构化工作流免提语音听写远程控制、桌面应用与 Web 会话Agent Teams 多代理协作。动手练习# 练习 1使用规划模式 /plan Implement user authentication system # 练习 2尝试权限模式6 种manual[原 default]、acceptEdits、plan、auto、dontAsk、bypassPermissions claude --permission-mode plan analyze this codebase claude --permission-mode acceptEdits refactor the auth module claude --permission-mode auto implement the feature # 练习 3开启扩展思考 # 会话中按 AltTmacOS 为 OptionT切换 # 练习 4高级 checkpoint 工作流 # 1. 创建名为 Clean state 的 checkpoint # 2. 用规划模式设计一个功能 # 3. 通过子代理委派实现 # 4. 在后台运行测试 # 5. 测试失败则回退到 checkpoint # 6. 尝试另一种方案 # 练习 5尝试 auto mode后台安全分类器 claude --permission-mode auto implement user settings page # 练习 6启用 Agent Teams export CLAUDE_AGENT_TEAMS1 # 然后告诉 ClaudeImplement feature X using a team approach # 练习 7定时任务 /loop 5m /check-status # 或使用 CronCreate 做持久化定时任务 # 练习 8用 Channels 组织跨会话工作流 # 练习 9使用语音听写解放双手与 Claude Code 交互补充说明关于权限模式、规划模式与 Auto Mode 等更完整的 JSON 配置示例含扩展思考、后台任务、会话管理等配置项参见 09-advanced-features/config-examples.json 与 09-advanced-features/README.md。其中manual即原先的defaultdefault作为别名仍被接受auto模式配合后台安全分类器让 Claude 以更高自主度工作。完成标准为复杂功能使用过规划模式配置过多种权限模式能用快捷键切换扩展思考用过带安全分类器的 auto mode用后台任务跑过长操作探索过 Channels 多会话工作流试过语音听写理解 Remote Control、Desktop App 与 Web 会话启用并体验过 Agent Teams用/loop建立过循环或定时监控。里程碑 3B团队与分发Plugins CLI 精通主题Plugins CLI 精通 CI/CD时长2–3 小时复杂度⭐⭐⭐⭐你将掌握安装并创建完整打包的插件精通 CLI 用于脚本化与自动化用claude -p做 CI/CD 集成为自动化流水线输出 JSON会话管理与批处理。动手练习# 练习 1安装一个完整插件 # 在 Claude Code 中输入/plugin install pr-review # 练习 2用打印模式跑 CI/CD 任务 claude -p Run all tests and generate report # 练习 3为脚本输出 JSON claude -p --output-format json list all functions # 练习 4会话管理与恢复 claude -r feature-auth continue implementation # 练习 5带约束的 CI/CD 集成 claude -p --max-turns 3 --output-format json review code # 练习 6批处理 for file in *.md; do claude -p --output-format json summarize this: $(cat $file) ${file%.md}.summary.json doneCI/CD 集成练习① 用claude -p评审变更文件② 结果输出为 JSON③ 用jq提取具体问题④ 集成进 GitHub Actions 工作流。CLI 的真实使用场景代码评审自动化在 CI/CD 流水线里跑 code review、日志分析分析错误日志与系统输出、文档批量生成、测试洞察分析测试失败、性能分析审查性能指标、数据处理转换与分析数据文件。仓库 07-plugins/ 内含三个开箱即用的完整插件包pr-review、devops-automation、documentation每个插件都按agents/、commands/、hooks/、mcp/的组织方式打包了子代理、命令与脚本可作为团队插件的最佳范式。完成标准安装并使用过插件为团队构建或改写过插件在 CI/CD 中使用过打印模式能生成供脚本消费的 JSON成功恢复过历史会话编写过批处理脚本把 Claude 集成进了 CI/CD 工作流。交互式测试/self-assessment与/lesson-quiz仓库为学得怎么样内置了两套可在 Claude Code 中直接运行的自评 Skill将本仓库相关配置安装到本地后可用Skill命令用途自评/self-assessment评估你在全部 10 大功能域的综合熟练度可选 Quick2 分钟或 Deep5 分钟模式生成个人技能画像与学习路径课程测验/lesson-quiz [lesson]针对特定课程出 10 道题测试理解可在课前前测、课中进度检查或课后掌握度验证使用示例/self-assessment # 定位你的整体水平 /lesson-quiz hooks # 课程 06 Hooks 测验 /lesson-quiz 03 # 课程 03 Skills 测验 /lesson-quiz advanced-features # 课程 09 测验快速路径15 分钟 / 1 小时 / 一个周末只有 15 分钟复制一个斜杠命令cp 01-slash-commands/optimize.md .claude/commands/在 Claude Code 里输入/optimize试运行阅读 01-slash-commands/README.md结果获得一个可工作的斜杠命令并理解其原理。有 1 小时斜杠命令15 分钟复制并测试/optimize与/pr项目记忆15 分钟用你的项目标准创建 CLAUDE.md安装 Skill15 分钟配置code-review-specialist组合验证15 分钟观察三者如何协同工作结果获得命令 记忆 自动 skill 的基础生产力提升。有一个周末周六上午3 小时完成里程碑 1ASlash Commands Memory与 1BCheckpoints CLI 基础周六下午3 小时完成里程碑 2ASkills Hooks与 2BMCP Subagents周日4 小时完成里程碑 3A高级功能与 3BPlugins CLI 精通 CI/CD并为团队构建一个自定义插件结果成为一名能培训他人、自动化复杂工作流的 Claude Code 高级用户。学习建议Do 与 Dont✅ 应当先做测验找到起点逐里程碑完成动手练习从简单开始逐步增加复杂度学下一个功能前先验证当前功能记录对你工作流有效的内容学高阶概念时回看前面的内容利用 checkpoints 安全实验把知识分享给团队。❌ 不要跳级时跳过前置检查试图一次学完所有东西容易失控不理解就照抄配置否则无法排错忘记测试——总是验证功能是否生效草草赶完里程碑忽略文档——每个 README 都有价值闭门造车——多和队友讨论。学习风格匹配视觉型学习者研究各 README 中的 mermaid 图观察命令执行流画出自己的流程图为学习路径留档。动手型学习者完成每一个动手练习大胆做变体实验故意弄坏再修好用 checkpoints创建自己的示例。阅读型学习者逐字精读各 README研究代码示例与对比表格。社交型学习者组织结对编程把概念教给队友分享你的自定义配置。进度追踪清单Level 1入门完成 01-slash-commands完成 02-memory创建首个自定义斜杠命令建立项目记忆达成里程碑 1A完成 08-checkpoints完成 10-cli 基础创建并回退过一个 checkpoint使用过交互与打印模式达成里程碑 1BLevel 2进阶完成 03-skills完成 06-hooks安装首个 skill配置 PreToolUse hook达成里程碑 2A完成 05-mcp完成 04-subagents连接 GitHub MCP创建自定义 subagent组合集成一条工作流达成里程碑 2BLevel 3高级完成 09-advanced-features成功使用规划模式配置权限模式含 auto 共 6 种使用带安全分类器的 auto mode使用扩展思考切换探索 Channels 与语音听写达成里程碑 3A完成 07-plugins完成 10-cli 高级用法在 CI/CD 中使用打印模式claude -p为自动化输出 JSON将 Claude 集成进 CI/CD 流水线创建团队插件达成里程碑 3B常见学习困难与对策困难对策概念太多一次消化不了一次只聚焦一个里程碑做完所有练习再前进不知道某个场景该用哪个功能查阅主 README 中的 Use Case Matrix配置不生效查阅 Troubleshooting 一节核对文件位置概念似乎重叠分不清复习 Feature Comparison 对比表理解差异内容太多记不住制作自己的速查表用 checkpoints 安全实验有经验但不知从哪开始回到上文的 8 项自评跳到对应级别用前置检查补缺口完成之后进阶方向完成全部里程碑后可以继续① 撰写团队 Claude Code 配置文档② 把团队工作流打包成自定义插件③ 探索 Remote Control——从外部工具以编程方式控制 Claude Code 会话④ 尝试 Web 会话做远程开发⑤ 使用桌面应用⑥ 让 Auto Mode 在后台安全分类器护航下自主工作⑦ 利用 Auto Memory 让 Claude 随使用自动学习偏好⑧ 用 Agent Teams 协调多代理处理复杂多面任务⑨ 用 Channels 组织结构化多会话工作流⑩ 试试语音听写⑪ 用/loop与 cron 工具自动化周期检查⑫ 为社区贡献示例⑬ 指导他人上手⑭ 依据使用情况持续优化工作流⑮ 跟进 Claude Code 的新版本与新特性。适用范围说明本路线图的内容与命令以仓库当前所同步的 Claude Code 版本文档标注 v2.1.235与兼容模型Claude Fable 5、Opus 5、Sonnet 5、Sonnet 4.6、Opus 4.8、Haiku 4.5为准。功能名称、权限模式与事件数量会随版本演进实际使用前请结合官方 changelog 与 CHANGELOG.md 核对。仓库的README.md还提供了 15 分钟快速上手安装参考与完整的 功能目录可作为本路线图的配套速查入口。【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考