首页
/ Claude Code 学习路线图(claude-howto):11 小时从新手到高阶用户的系统化进阶指南

Claude Code 学习路线图(claude-howto):11 小时从新手到高阶用户的系统化进阶指南

2026-09-09 20:39:11作者:昌雅子Ethen

导读:本文以 claude-howto 仓库中的 学习路线图 为骨架,为你完整拆解从"第一次输入 claude"到"编排 agents、hooks、skills 与 MCP servers"的全过程。你将学会通过自我评估找到自己的水平,按 11 个模块、三大 Level、六个里程碑循序渐进,并把 slash commands、memory、checkpoints、skills、hooks、MCP、subagents、plugins 组合成真实可用的工作流。读完后,你能为自己或团队设计一条有依赖顺序、有复杂度梯度、有时间预估的 Claude Code 学习路径,并借助内置测验持续检验掌握程度。


🧭 找到你的水平:先做一次自我评估

claude-howto 的学习路线图把用户划分为三个水平层级,起点由一份 8 项勾选测验决定。请诚实回答以下问题:

  • [ ] 我可以启动 Claude Code 并与它对话(claude
  • [ ] 我创建或编辑过 CLAUDE.md
  • [ ] 我至少使用过 3 个内置 slash command(例如 /help/compact/model
  • [ ] 我创建过自定义 slash command 或 skill(SKILL.md
  • [ ] 我配置过 MCP server(例如 GitHub、数据库)
  • [ ] 我在 ~/.claude/settings.json 中设置过 hooks
  • [ ] 我创建或使用过自定义 subagents(.claude/agents/
  • [ ] 我使用过 print mode(claude -p)做脚本或 CI/CD

根据勾选数量对照下表,即可确定你的起点:

勾选数 水平 从这里开始 完成时间
0-2 Level 1:Beginner - 从这里开始 里程碑 1A(第一个命令与 Memory) 约 3 小时
3-5 Level 2:Intermediate - 构建工作流 里程碑 2A(自动化 Skills + Hooks) 约 5 小时
6-8 Level 3:Advanced - 高阶用户与团队负责人 里程碑 3A(高级功能) 约 5 小时

提示:如果不确定,宁可从低一级开始。先回顾熟悉内容,总比漏掉基础概念更划算。

交互式版本:在 Claude Code 中运行 /self-assessment,即可获得一份引导式、交互式测验,它覆盖全部 10 个功能领域,并根据你的回答生成个性化学习路径——这是路线图推荐的第一站,也是后续所有 /lesson-quiz <topic> 测验的配套工具。


🎯 学习理念:文件夹为什么按编号排列

claude-howto 仓库把全部教程目录从 01-slash-commands/10-cli/推荐学习顺序编号,背后是三个原则:

  1. 依赖关系——先学基础概念:例如 Hooks 依赖工具与命令,Skills 依赖 Slash Commands 的使用习惯;
  2. 复杂度——先学简单功能,再学高级功能:从 ⭐ 的 Slash Commands 逐步爬到 ⭐⭐⭐⭐⭐ 的 Advanced Features;
  3. 使用频率——先学最常用的功能:Slash Commands 与 Memory 排在首位,因为它们能带来最即时的生产力提升。

这样的编排让你能一边建立扎实基础,一边尽快获得实际收益,避免"什么都学、什么都没学透"。


🗺️ 学习路径总览:一条可视化的进阶主线

完整的学习路径可以用一张 Mermaid 流程图概括(这也是本仓库各 README 采用可视化讲解的典型体现):

graph TD
    Q["🧭 自我评估测验<br/>找到你的水平"] --> L1
    Q --> L2
    Q --> L3

    subgraph L1["🟢 Level 1:Beginner - 从这里开始"]
        direction LR
        A["1A:第一个命令与 Memory<br/>Slash Commands + Memory"] --> B["1B:安全探索<br/>Checkpoints + CLI Basics"]
    end

    subgraph L2["🔵 Level 2:Intermediate - 构建工作流"]
        direction LR
        C["2A:自动化<br/>Skills + Hooks"] --> D["2B:集成<br/>MCP + Subagents"]
    end

    subgraph L3["🔴 Level 3:Advanced - 高阶用户"]
        direction LR
        E["3A:高级功能<br/>Planning + Permissions"] --> F["3B:团队与分发<br/>Plugins + CLI 精通"]
    end

    L1 --> L2
    L2 --> L3

颜色说明:💜 紫色代表自我评估测验;🟢 绿色是 Level 1 路线;🔵 蓝色 / 🟡 金色是 Level 2 路线;🔴 红色是 Level 3 路线。Level 之间严格递进——只有完成低一级的里程碑,才建议进入下一级。


📊 完整路线图表:11 个模块一览

这是整条学习路径的速查总表,包含每个模块的复杂度、学习时间、水平归属、依赖关系与核心收益:

步骤 功能 复杂度 时间 水平 依赖 为什么学它 关键收益
1 Slash Commands ⭐ Beginner 30 分钟 Level 1 快速获得生产力提升(55+ 内置命令 + 5 个 bundled skills) 立即自动化、统一团队规范
2 Memory ⭐⭐ Beginner+ 45 分钟 Level 1 所有功能的基础 持久上下文、偏好设置
3 Checkpoints ⭐⭐ Intermediate 45 分钟 Level 1 会话管理 安全探索 试验、恢复
4 CLI Basics ⭐⭐ Beginner+ 30 分钟 Level 1 核心 CLI 用法 交互式与 print mode
5 Skills ⭐⭐ Intermediate 1 小时 Level 2 Slash Commands 自动化专业能力 可复用能力、一致性
6 Hooks ⭐⭐ Intermediate 1 小时 Level 2 工具、命令 工作流自动化(31 个事件、5 种类型) 校验、质量门禁
7 MCP ⭐⭐⭐ Intermediate+ 1 小时 Level 2 配置 实时数据访问 实时集成、API
8 Subagents ⭐⭐⭐ Intermediate+ 1.5 小时 Level 2 Memory、命令 处理复杂任务(包含 Bash 在内的 6 个内置 agent) 委派、专业分工
9 Advanced Features ⭐⭐⭐⭐⭐ Advanced 2-3 小时 Level 3 前面所有内容 高阶工具 Planning、自动模式(Auto Mode)、通道(Channels)、语音输入、权限控制
10 Plugins ⭐⭐⭐⭐ Advanced 2 小时 Level 3 前面所有内容 完整解决方案 团队入职、分发
11 CLI Mastery ⭐⭐⭐ Advanced 1 小时 Level 3 建议:全部 掌握命令行用法 脚本、CI/CD、自动化

总学习时间:约 11-13 小时。如果你已有基础,可以直接跳到对应水平,节省大量时间。


🟢 Level 1:Beginner - 从这里开始

适合:测验勾选数 0-2;时间:约 3 小时;重点:立刻提升生产力、理解基础概念;结果:可以熟练日常使用,并准备进入 Level 2。

里程碑 1A:第一个命令与 Memory

主题:Slash Commands + Memory;时间:1-2 小时;复杂度:⭐ Beginner;目标:通过自定义命令和持久上下文,快速提升效率。

你将完成什么

  • ✅ 为重复性任务创建自定义 slash commands
  • ✅ 为团队规范设置项目 memory
  • ✅ 配置个人偏好
  • ✅ 理解 Claude 如何自动加载上下文

实战练习

# 练习 1:安装你的第一个 slash command
mkdir -p .claude/commands
cp zh/01-slash-commands/optimize.md .claude/commands/

# 练习 2:创建项目 memory
cp zh/02-memory/project-CLAUDE.md ./CLAUDE.md

# 练习 3:试用一下
# 在 Claude Code 中输入:/optimize

深入理解 Slash Commands:Slash command 是交互式会话中的快捷控制方式,分为四类——内置命令(/help/clear/model 等 55+ 个)、Skills 命令(基于 SKILL.md)、插件命令(/plugin-name:command-name)和 MCP prompts(/mcp__github__list_prs)。需要特别注意的是,自定义 slash command 已经合并进 Skills.claude/commands/ 仍可使用,但更推荐 .claude/skills/<name>/SKILL.md,两者都会生成 /command-name 形式的快捷命令,同名时 skill 优先。仓库中的 zh/01-slash-commands/README.md 提供了完整的 frontmatter 字段参考(namedescriptionargument-hintallowed-toolsdisable-model-invocation 等),以及 $ARGUMENTS$0/$1 参数替换和 !`command` 动态上下文注入的完整写法。

深入理解 Memory:Memory 让 Claude Code 跨会话保留上下文。仓库 zh/02-memory/README.md 给出了三条常用命令——/init(初始化项目级 CLAUDE.md)、/memory(打开记忆编辑器,在受管策略/项目/用户/本地记忆之间切换)、#(快速把当前规则写入 memory)。记忆按"受管策略 > 项目记忆 > 目录记忆 > 用户记忆"分层,越具体的规则优先级越高。可参考仓库中的 project-CLAUDE.mddirectory-api-CLAUDE.mdpersonal-CLAUDE.md 三个现成模板。

成功标准

  • [ ] 成功执行 /optimize
  • [ ] Claude 记住了 CLAUDE.md 中的项目规范
  • [ ] 你知道什么时候用 slash command,什么时候用 memory

下一步:阅读 Slash Commands 参考Memory 指南

检查理解:在 Claude Code 中运行 /lesson-quiz slash-commands/lesson-quiz memory,检验你学会了多少。

里程碑 1B:安全探索(Checkpoints + CLI Basics)

主题:Checkpoints + CLI Basics;时间:1 小时;复杂度:⭐⭐ Beginner+;目标:学会安全试验,并使用核心 CLI 命令。

你将完成什么

  • ✅ 创建和恢复 checkpoints,安全试验
  • ✅ 理解交互模式与 print mode
  • ✅ 使用基本 CLI 参数和选项
  • ✅ 通过管道处理文件

实战练习

# 练习 1:尝试 checkpoint 工作流
# 在 Claude Code 中:
# 做一些实验性修改,然后按 Esc+Esc 或使用 /rewind
# 选择你实验之前的 checkpoint
# 选择"恢复代码和对话"返回

# 练习 2:交互模式 vs 输出模式(Print mode)
claude "explain this project"           # 交互模式
claude -p "explain this function"       # 输出模式(非交互)

# 练习 3:通过管道处理文件内容
cat error.log | claude -p "explain this error"

深入理解 Checkpoints:Checkpoint 是对话状态的快照,包含所有交换的消息、已做的文件修改、工具使用历史和会话上下文。按两次 Esc 或运行 /rewind(别名 /checkpoint)即可打开回退界面,回退时有五个选项:恢复代码和对话、恢复对话、恢复代码、从这里开始总结、算了。Claude Code 会在每次用户输入时自动创建 checkpoint,跨会话保留,30 天后自动清理;默认开启,可在设置中用 "autoCheckpoint": true 控制(详见 zh/08-checkpoints/README.md)。值得注意的是,checkpoints 不是 git 的替代品——会话内试错用 checkpoint,长期保存用 git,两者互补。

深入理解 CLIclaude 命令同时承载交互模式与打印模式。交互模式支持多轮对话、Tab 补全、历史记录和 slash commands;打印模式(claude -p)适合脚本化、管道化和 JSON 输出。常用参数还包括 -c(继续最近会话)、-r <session>(按 ID 或名称恢复会话)、--output-format json(结构化输出)、--model(选择模型)与 --permission-mode(设置权限模式),完整参考见 zh/10-cli/README.md

成功标准

  • [ ] 成功创建并回退到一个 checkpoint
  • [ ] 使用过交互模式和 print mode
  • [ ] 把文件通过管道传给 Claude 做分析
  • [ ] 明白什么时候该用 checkpoints 做安全试验

下一步:阅读 Checkpoints 指南CLI 参考,然后准备进入 Level 2

检查理解:运行 /lesson-quiz checkpoints/lesson-quiz cli,确认你准备好进入 Level 2。


🔵 Level 2:Intermediate - 构建工作流

适合:测验勾选数 3-5;时间:约 5 小时;重点:自动化、集成、任务委派;结果:可以构建自动化工作流、接入外部服务,并准备进入 Level 3。

前置条件检查

开始 Level 2 之前,先确认你已经掌握 Level 1 内容:

  • [ ] 会创建和使用 slash commands(Slash Commands
  • [ ] 会通过 CLAUDE.md 设置项目 memory(Memory
  • [ ] 知道如何创建和恢复 checkpoints(Checkpoints
  • [ ] 会在命令行使用 claudeclaude -pCLI

有空缺? 继续之前,先回顾上面的链接教程。

里程碑 2A:自动化(Skills + Hooks)

主题:Skills + Hooks;时间:2-3 小时;复杂度:⭐⭐ Intermediate;目标:自动化常见工作流和质量检查。

你将完成什么

  • ✅ 通过 YAML frontmatter 自动触发专门能力(包含 effortshell 字段)
  • ✅ 在 31 个 hook 事件上设置事件驱动自动化
  • ✅ 使用 5 种 hook 类型(command、http、prompt、agent、mcp_tool)
  • ✅ 强制执行代码质量标准
  • ✅ 为自己的工作流创建自定义 hooks

实战练习

# 练习 1:安装一个 skill
cp -r zh/03-skills/code-review-specialist ~/.claude/skills/

# 练习 2:设置 hooks
mkdir -p ~/.claude/hooks
cp zh/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"
          }
        ]
      }
    ]
  }
}

深入理解 Skills:Skill 是可复用、可自动触发的能力包,采用渐进式披露:Claude 先只看描述判断相关性,再加载 SKILL.md 核心说明,最后按需加载脚本、模板、参考资料。一个 skill 通常包含 SKILL.mdscripts/templates/references/ 等目录——仓库中的 code-review-specialistrefactordoc-generator 都是带脚本和模板的完整示例。SKILL.md 的 frontmatter 必填 namedescriptiondescription 应写明触发条件与关键词,Claude 才能准确自动调用。

深入理解 Hooks:Hooks 是事件驱动的自动化机制,覆盖 31 个事件,分四类——Tool Hooks(PreToolUsePostToolUse 等)、Session Hooks(SessionStartSetup 等)、Task Hooks(UserPromptSubmitMessageDisplay 等)、Lifecycle Hooks(ConfigChangeFileChanged 等);handler 类型共 5 种:commandhttpmcp_toolpromptagent。仓库 zh/06-hooks/README.md 还提供了 format-code.sh(写文件前格式化)、security-scan.sh(安全扫描)、pre-commit.sh(提交前测试)等可直接复用的脚本,以及 PreToolUse+PostToolUse 组合的 settings.json 完整示例。

成功标准

  • [ ] 在相关场景下,代码审查 skill 会自动触发
  • [ ] PreToolUse hook 会在工具执行前运行
  • [ ] 你理解 skill 自动触发和 hook 事件触发的区别

下一步:创建你自己的 custom skill、为工作流增加更多 hooks,并阅读 Skills 指南Hooks 参考

检查理解:运行 /lesson-quiz skills/lesson-quiz hooks 测试你的理解。

里程碑 2B:集成(MCP + Subagents)

主题:MCP + Subagents;时间:2-3 小时;复杂度:⭐⭐⭐ Intermediate+;目标:集成外部服务,并把复杂任务委派出去。

你将完成什么

  • ✅ 从 GitHub、数据库等位置访问实时数据
  • ✅ 把工作委派给专门化 AI agents
  • ✅ 明白什么时候该用 MCP,什么时候该用 subagents
  • ✅ 构建集成式工作流

实战练习

# 练习 1:设置 GitHub MCP
export GITHUB_TOKEN="your_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 zh/04-subagents/*.md .claude/agents/

集成练习:试试这个完整工作流——先用 MCP 获取一个 GitHub PR,再让 Claude 把审查任务委派给 code-reviewer subagent,最后用 hooks 自动运行测试。

深入理解 MCP:MCP(Model Context Protocol)是 Claude Code 访问外部工具、服务和 API 的标准协议,由 Claude Code、MCP server、外部工具/数据源三部分构成。安装方式支持 HTTP(推荐)、stdio(本地)、WebSocket 等传输,OAuth 2.0 认证也内建支持。配置成功后,MCP 工具会自动出现在 Claude 的可用工具列表中,其 prompt 也可以暴露为 /mcp__<server>__<prompt> 形式的 slash command。仓库 zh/05-mcp/README.md 提供了 GitHub、数据库、文件系统等现成配置示例,以及"用 MCP 做实时查询、避免把大数据集全量塞进上下文"的性能建议。

深入理解 Subagents:Subagent 是拥有隔离上下文、独立提示词和工具权限的专门化 AI 助手。它是一份带 frontmatter 的 Markdown 文件(namedescriptiontoolsmodelpromptcontext),放在 .claude/agents/(项目级)或 ~/.claude/agents/(用户级)。Claude Code 自带 6 个内置 agent(包括 Bash agent),仓库 zh/04-subagents/README.md 还收录了 code-reviewer、test-engineer、documentation-writer、secure-reviewer、implementation-agent 等 8 个可直接复用的示例。

成功标准

  • [ ] 能通过 MCP 成功查询 GitHub 数据
  • [ ] Claude 会把复杂任务委派给 subagents
  • [ ] 你理解 MCP 和 subagents 的区别
  • [ ] 能把 MCP + subagents + hooks 组合进一个工作流

下一步:配置更多 MCP servers(数据库、Slack 等)、为你的领域创建自定义 subagents,阅读 MCP 指南Subagents 参考,然后准备进入 Level 3

检查理解:运行 /lesson-quiz mcp/lesson-quiz subagents,确认你准备好进入 Level 3。


🔴 Level 3:Advanced - 高阶用户与团队负责人

适合:测验勾选数 6-8;时间:约 5 小时;重点:团队工具、CI/CD、企业功能、插件开发;结果:成为高阶用户,能够搭建团队工作流和 CI/CD。

前置条件检查

开始 Level 3 之前,先确认你已经掌握 Level 2 内容:

  • [ ] 会创建并自动触发 skills(Skills
  • [ ] 会配置 hooks 做事件驱动自动化(Hooks
  • [ ] 会配置 MCP servers 访问外部数据(MCP
  • [ ] 知道如何用 subagents 分派任务(Subagents

有空缺? 继续之前,先回顾上面的链接教程。

里程碑 3A:高级功能

主题:高级功能(Planning、Permissions、Extended Thinking、自动模式 Auto Mode、通道 Channels、语音输入 Voice Dictation、Remote/Desktop/Web);时间:2-3 小时;复杂度:⭐⭐⭐⭐⭐ Advanced;目标:掌握高级工作流和高阶工具。

你将完成什么

  • ✅ 为复杂功能使用 planning mode
  • ✅ 用 6 种模式进行细粒度权限控制(default、acceptEdits、plan、auto、dontAsk、bypassPermissions)
  • ✅ 用 Alt+T / Option+T 切换 extended thinking
  • ✅ 管理后台任务
  • ✅ 使用 Auto Memory 记住偏好
  • ✅ 使用自动模式(Auto Mode)和后台安全分类器
  • ✅ 使用通道(Channels)组织多会话工作流
  • ✅ 使用语音输入(Voice Dictation)解放双手
  • ✅ 远程控制、桌面应用和 Web 会话
  • ✅ 使用 Agent Teams 协作

实战练习

# 练习 1:使用 planning mode
/plan Implement user authentication system

# 练习 2:尝试权限模式(共有 6 种: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:启用 extended thinking
# 在会话中按 Alt+T(macOS 上是 Option+T)切换

# 练习 4:高级 checkpoint 工作流
# 1. 创建名为 "Clean state" 的 checkpoint
# 2. 使用 planning mode 设计功能
# 3. 通过 subagent 委派实现
# 4. 在后台运行测试
# 5. 如果测试失败,回退到 checkpoint
# 6. 尝试另一种方案

# 练习 5:尝试自动模式(Auto mode,后台安全分类器)
claude --permission-mode auto "implement user settings page"

# 练习 6:启用 agent teams
export CLAUDE_AGENT_TEAMS=1
# 让 Claude 执行:"Implement feature X using a team approach"

# 练习 7:定时任务
/loop 5m /check-status
# 或使用 CronCreate 创建持久化定时任务

# 练习 8:用通道(Channels)管理多会话工作流
# 用 channels 来组织跨会话工作

# 练习 9:语音输入(Voice Dictation)
# 用语音输入和 Claude Code 进行无手操作

深入理解高级功能:这层能力在 zh/09-advanced-features/README.md 中有系统化阐述——Planning mode 是"先规划、后实现"的两阶段流程,适合多文件重构与大型 API 重设计,可用 /planclaude --permission-mode plan 启动,配合 opusplan 模型别名(Opus 规划、Sonnet 执行)与 Ctrl+G 外部编辑计划;Auto mode 在每个动作执行前用后台安全分类器评估风险,默认阻止危险文件操作、高风险 shell 命令与凭据泄露类操作;后台任务让长任务不阻塞对话;/loop/schedule 支持周期性与一次性定时任务。配置层面,所有高级行为都可写入 ~/.claude/settings.json(含 permissions.defaultModethinkingautoCheckpoint 等),完整示例见 config-examples.json

成功标准

  • [ ] 为复杂功能使用过 planning mode
  • [ ] 配置过权限模式(plan、acceptEdits、auto、dontAsk)
  • [ ] 用 Alt+T / Option+T 切换过 extended thinking
  • [ ] 使用过带后台安全分类器的自动模式(Auto mode)
  • [ ] 使用过后台任务处理长时间操作
  • [ ] 探索过通道(Channels)做多会话工作流
  • [ ] 尝试过语音输入(Voice Dictation)做无手输入
  • [ ] 理解 Remote Control、Desktop App 和 Web 会话
  • [ ] 启用并使用过 Agent Teams 做协作任务
  • [ ] 用过 /loop 做周期任务或定时监控

下一步:阅读 高级功能指南

检查理解:运行 /lesson-quiz advanced,测试你对高阶功能的掌握程度。

里程碑 3B:团队与分发(Plugins + CLI 精通)

主题:Plugins + CLI 精通 + CI/CD;时间:2-3 小时;复杂度:⭐⭐⭐⭐ Advanced;目标:搭建团队工具、创建插件、熟练集成 CI/CD。

你将完成什么

  • ✅ 安装和创建完整的 bundled plugins
  • ✅ 掌握 CLI,用于脚本和自动化
  • ✅ 使用 claude -p 做 CI/CD 集成
  • ✅ 为自动化流水线输出 JSON
  • ✅ 管理会话与批处理

实战练习

# 练习 1:安装一个完整 plugin
# 在 Claude Code 中:/plugin install pr-review

# 练习 2:让 print mode 服务于 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
done

CI/CD 集成练习:创建一个简单的 CI/CD 脚本——用 claude -p 审查变更文件,把结果输出成 JSON,用 jq 处理特定问题,再集成进 GitHub Actions 工作流。

深入理解 Plugins:Plugin 是把 slash commands、subagents、MCP servers 和 hooks 打包在一起的功能集合,用一条命令即可安装。仓库 zh/07-plugins/README.md 展示了完整的插件结构(.claude-plugin/plugin.json 清单 + commands/agents/skills/hooks/.mcp.jsontemplates/scripts/),并提供了三个真实示例:pr-reviewdevops-automationdocumentation——每个都包含 agents、commands、hooks、mcp 与 scripts 的完整组合。发布流程是:创建插件结构 → 编写清单 → 本地用 claude --plugin-dir ./my-plugin 测试 → 提交市场 → 用户 /plugin install

深入理解 CLI 精通:这一层要求把 claude -p 变成流水线里的可靠组件。核心要点包括:--output-format json 产出结构化结果供 jq 解析;--max-turns 限制自主回合数保证 CI 可控;--json-schema 做 schema 校验;claude -r/-c 管理多会话;--permission-mode plan 做只读审计。仓库 zh/10-cli/README.md 给出了从 cat error.log | claude -p--agents JSON 定义自定义 subagent 的完整命令矩阵。


🧪 测试你的知识:内置测验命令

根据你刚学完的内容,直接运行对应的测验:

/lesson-quiz slash-commands
/lesson-quiz memory
/lesson-quiz checkpoints
/lesson-quiz cli
/lesson-quiz skills
/lesson-quiz hooks
/lesson-quiz mcp
/lesson-quiz subagents
/lesson-quiz advanced-features

这些测验与 /self-assessment 共同构成闭环:先评估定位起点,学完每个里程碑后用对应测验查漏补缺,随时重新评估更新技能画像。


⚡ 快速开始路径:按可用时间选择入口

如果你只有 15 分钟

目标:先拿到一个立竿见影的成果。

  1. 复制一个 slash command:cp zh/01-slash-commands/optimize.md .claude/commands/
  2. 在 Claude Code 中试一下:/optimize
  3. 阅读:Slash Commands 参考

结果:你会得到一个能用的 slash command,并理解基础用法。

如果你有 1 小时

目标:搭好基础生产力工具。

  1. Slash commands(15 分钟):复制并测试 /optimize/pr
  2. 项目 memory(15 分钟):用项目规范创建 CLAUDE.md
  3. 安装一个 skill(15 分钟):配置 code-review skill
  4. 一起试用(15 分钟):感受它们如何协同工作

结果:命令、memory 和自动 skills 带来基础效率提升。

如果你有一个周末

目标:熟悉大部分功能。

周六上午(3 小时):完成里程碑 1A(Slash Commands + Memory)与里程碑 1B(Checkpoints + CLI Basics)。 周六下午(3 小时):完成里程碑 2A(Skills + Hooks)与里程碑 2B(MCP + Subagents)。 周日(4 小时):完成里程碑 3A(高级功能)与里程碑 3B(Plugins + CLI 精通 + CI/CD),并为你的团队构建一个自定义 plugin。

结果:你会成为 Claude Code 的高阶用户,能够培训别人并自动化复杂工作流。


💡 学习建议:该做与不该做

✅ 建议做

  • 先做测验,找到自己的起点
  • 完成每个里程碑的实战练习
  • 先从简单开始,再逐步增加复杂度
  • 在进入下一个功能前先测试当前功能
  • 记下哪些做法最适合你的工作流
  • 学习新内容时回头复习基础概念
  • 借助 checkpoints 安全试验
  • 把经验分享给团队

❌ 不建议做

  • 不要跳过前置条件检查
  • 不要试图一次学完所有内容
  • 不要照搬配置却不理解它们
  • 不要忘记测试
  • 不要急着跳过里程碑
  • 不要忽视文档
  • 不要把自己隔离起来

🎓 学习风格:找到适合自己的方式

  • 视觉型学习者:阅读每个 README 里的 Mermaid 图,观察命令执行流程,自己画工作流图,使用路线图的可视化路径图。
  • 动手型学习者:完成每个实战练习,试试不同变体,先搞坏再修复(记得用 checkpoints),创建自己的示例。
  • 阅读型学习者:认真阅读每个 README,研究代码示例,看对比表,阅读资源区链接的文章。
  • 社交型学习者:组织结对编程,给队友讲解概念,参与 Claude Code 社区讨论,分享你的自定义配置。

📈 进度追踪:三级清单

用这些清单按水平追踪进度,随时运行 /self-assessment 更新技能画像,或运行 /lesson-quiz [lesson] 验证理解。

🟢 Level 1:Beginner

  • [ ] 完成 Slash CommandsMemory
  • [ ] 创建第一个自定义 slash command
  • [ ] 设置项目 memory
  • [ ] 达到里程碑 1A
  • [ ] 完成 CheckpointsCLI 基础部分
  • [ ] 创建并回退到一个 checkpoint
  • [ ] 使用交互模式和 print mode
  • [ ] 达到里程碑 1B

🔵 Level 2:Intermediate

  • [ ] 完成 SkillsHooks
  • [ ] 安装第一个 skill
  • [ ] 设置 PreToolUse hook
  • [ ] 达到里程碑 2A
  • [ ] 完成 MCPSubagents
  • [ ] 连接 GitHub MCP
  • [ ] 创建自定义 subagent
  • [ ] 把多个集成组合进一个工作流
  • [ ] 达到里程碑 2B

🔴 Level 3:Advanced

  • [ ] 完成 高级功能
  • [ ] 成功使用 planning mode
  • [ ] 配置权限模式(包含 auto 在内的 6 种)
  • [ ] 使用带安全分类器的自动模式(Auto mode)
  • [ ] 使用 extended thinking 切换
  • [ ] 探索通道(Channels)和语音输入(Voice Dictation)
  • [ ] 达到里程碑 3A
  • [ ] 完成 PluginsCLI 高级用法
  • [ ] 配置 print mode(claude -p)用于 CI/CD
  • [ ] 为自动化创建 JSON 输出
  • [ ] 把 Claude 集成到 CI/CD 流水线
  • [ ] 创建团队 plugin
  • [ ] 达到里程碑 3B

🆘 常见学习难题与解决

  1. "概念一下子太多了":一次只关注一个里程碑,完成所有练习后再往下走。
  2. "不知道什么时候该用哪个功能":回到主 README 里的 Use Case Matrix 与 Feature Comparison 表,按触发方式(手动 /cmd、自动加载、自动委派、事件触发)与持久性维度区分。
  3. "配置没有生效":检查文件路径与命名、frontmatter 语法、文件权限,并确认 Claude Code 版本兼容性。
  4. "概念之间好像重叠":核心区分是——Slash Commands 手动调用、Skills 自动触发、Subagents 隔离委派、Hooks 事件驱动、MCP 实时数据、Memory 跨会话长期上下文。
  5. "太多东西记不住":自己做一份速查表;同时用 checkpoints 安全试验。
  6. "我经验很足,但不知道从哪里开始":先做自我评估测验,直接跳到你的水平,并用前置条件检查找出空缺。

🎯 学完之后做什么:15 条进阶方向

完成所有里程碑后,可以继续做这些事:

  1. 写团队文档——记录团队的 Claude Code 配置
  2. 构建自定义 plugins——把团队工作流打包起来
  3. 探索 Remote Control——通过外部工具以编程方式控制 Claude Code 会话
  4. 试试 Web Sessions——用浏览器界面远程开发
  5. 使用 Desktop App——通过原生桌面应用访问 Claude Code
  6. 使用自动模式(Auto Mode)——让 Claude 在后台安全分类器保护下自主工作
  7. 启用 Auto Memory——让 Claude 随时间自动学习你的偏好
  8. 设置 Agent Teams——让多个 agent 协同处理复杂、多维任务
  9. 使用通道(Channels)——用结构化的多会话工作流组织工作
  10. 试试语音输入(Voice Dictation)——用语音无障碍地与 Claude Code 交互
  11. 使用 Scheduled Tasks——借助 /loop 和 cron 工具自动化周期性检查
  12. 贡献示例——把经验分享给社区
  13. 带新人——帮助队友快速上手
  14. 持续优化工作流——根据使用情况不断改进
  15. 保持更新——跟进 Claude Code 发布和新功能

📚 仓库内延伸资源

完成路线图后,你可以在仓库中继续深入:浏览完整的 功能目录(含全部安装命令)、查阅 索引快速参考(速查命令与配置)、阅读 资源列表 获取更多学习材料、参考 STYLE_GUIDE.md 了解本仓库的文档规范。每个功能模块的中文指南(Slash CommandsMemorySkillsSubagentsMCPHooksPluginsCheckpointsAdvanced FeaturesCLI)都包含可直接复制的配置文件、脚本与故障排查章节,可作为日常使用的常驻参考。

热门项目推荐
相关项目推荐

项目优选

收起
ops-transformerops-transformer
本项目是CANN提供的transformer类大模型算子库,实现网络在NPU上加速计算。
C++
1.15 K
2.77 K
kernelkernel
deepin linux kernel
C
34
18
docsdocs
暂无描述
Markdown
900
5.83 K
ops-nnops-nn
本项目是CANN提供的神经网络类计算算子库,实现网络在NPU上加速计算。
C++
929
1.85 K
pytorchpytorch
作为 Ascend for PyTorch 社区的核心组件,TorchNPU 是昇腾专为 PyTorch 打造的深度学习适配插件,使 PyTorch 框架能够直接调用昇腾 NPU,为开发者提供昇腾 AI 处理器的超强算力。
Python
860
1.36 K
jiuwenswarmjiuwenswarm
JiuwenSwarm 是一款基于openJiuwen开发的智能AI Agent,它能够将大语言模型的强大能力,通过你日常使用的各类通讯应用,直接延伸至你的指尖。
Python
3.94 K
1.03 K
ops-mathops-math
本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
1.37 K
1.47 K
kernelkernel
openEuler内核是openEuler操作系统的核心,既是系统性能与稳定性的基石,也是连接处理器、设备与服务的桥梁。
C
534
603
AscendNPU-IRAscendNPU-IR
AscendNPU-IR是基于MLIR(Multi-Level Intermediate Representation)构建的,面向昇腾亲和算子编译时使用的中间表示,提供昇腾完备表达能力,通过编译优化提升昇腾AI处理器计算效率,支持通过生态框架使能昇腾AI处理器与深度调优
C++
548
398
leetcodeleetcode
🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer(第 2 版)》、《程序员面试金典(第 6 版)》题解
Markdown
77
23