Claude Code 学习路线图(claude-howto):11 小时从新手到高阶用户的系统化进阶指南
导读:本文以 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/ 按推荐学习顺序编号,背后是三个原则:
- 依赖关系——先学基础概念:例如 Hooks 依赖工具与命令,Skills 依赖 Slash Commands 的使用习惯;
- 复杂度——先学简单功能,再学高级功能:从 ⭐ 的 Slash Commands 逐步爬到 ⭐⭐⭐⭐⭐ 的 Advanced Features;
- 使用频率——先学最常用的功能: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 字段参考(name、description、argument-hint、allowed-tools、disable-model-invocation 等),以及 $ARGUMENTS、$0/$1 参数替换和 !`command` 动态上下文注入的完整写法。
深入理解 Memory:Memory 让 Claude Code 跨会话保留上下文。仓库 zh/02-memory/README.md 给出了三条常用命令——/init(初始化项目级 CLAUDE.md)、/memory(打开记忆编辑器,在受管策略/项目/用户/本地记忆之间切换)、#(快速把当前规则写入 memory)。记忆按"受管策略 > 项目记忆 > 目录记忆 > 用户记忆"分层,越具体的规则优先级越高。可参考仓库中的 project-CLAUDE.md、directory-api-CLAUDE.md 和 personal-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,两者互补。
深入理解 CLI:claude 命令同时承载交互模式与打印模式。交互模式支持多轮对话、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)
- [ ] 会在命令行使用
claude和claude -p(CLI)
有空缺? 继续之前,先回顾上面的链接教程。
里程碑 2A:自动化(Skills + Hooks)
主题:Skills + Hooks;时间:2-3 小时;复杂度:⭐⭐ Intermediate;目标:自动化常见工作流和质量检查。
你将完成什么
- ✅ 通过 YAML frontmatter 自动触发专门能力(包含
effort和shell字段) - ✅ 在 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.md、scripts/、templates/、references/ 等目录——仓库中的 code-review-specialist、refactor、doc-generator 都是带脚本和模板的完整示例。SKILL.md 的 frontmatter 必填 name 与 description,description 应写明触发条件与关键词,Claude 才能准确自动调用。
深入理解 Hooks:Hooks 是事件驱动的自动化机制,覆盖 31 个事件,分四类——Tool Hooks(PreToolUse、PostToolUse 等)、Session Hooks(SessionStart、Setup 等)、Task Hooks(UserPromptSubmit、MessageDisplay 等)、Lifecycle Hooks(ConfigChange、FileChanged 等);handler 类型共 5 种:command、http、mcp_tool、prompt、agent。仓库 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 文件(name、description、tools、model、prompt、context),放在 .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 重设计,可用 /plan 或 claude --permission-mode plan 启动,配合 opusplan 模型别名(Opus 规划、Sonnet 执行)与 Ctrl+G 外部编辑计划;Auto mode 在每个动作执行前用后台安全分类器评估风险,默认阻止危险文件操作、高风险 shell 命令与凭据泄露类操作;后台任务让长任务不阻塞对话;/loop 与 /schedule 支持周期性与一次性定时任务。配置层面,所有高级行为都可写入 ~/.claude/settings.json(含 permissions.defaultMode、thinking、autoCheckpoint 等),完整示例见 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.json、templates/、scripts/),并提供了三个真实示例:pr-review、devops-automation、documentation——每个都包含 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 分钟
目标:先拿到一个立竿见影的成果。
- 复制一个 slash command:
cp zh/01-slash-commands/optimize.md .claude/commands/ - 在 Claude Code 中试一下:
/optimize - 阅读:Slash Commands 参考
结果:你会得到一个能用的 slash command,并理解基础用法。
如果你有 1 小时
目标:搭好基础生产力工具。
- Slash commands(15 分钟):复制并测试
/optimize和/pr - 项目 memory(15 分钟):用项目规范创建
CLAUDE.md - 安装一个 skill(15 分钟):配置 code-review skill
- 一起试用(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 Commands 与 Memory
- [ ] 创建第一个自定义 slash command
- [ ] 设置项目 memory
- [ ] 达到里程碑 1A
- [ ] 完成 Checkpoints 与 CLI 基础部分
- [ ] 创建并回退到一个 checkpoint
- [ ] 使用交互模式和 print mode
- [ ] 达到里程碑 1B
🔵 Level 2:Intermediate
- [ ] 完成 Skills 与 Hooks
- [ ] 安装第一个 skill
- [ ] 设置 PreToolUse hook
- [ ] 达到里程碑 2A
- [ ] 完成 MCP 与 Subagents
- [ ] 连接 GitHub MCP
- [ ] 创建自定义 subagent
- [ ] 把多个集成组合进一个工作流
- [ ] 达到里程碑 2B
🔴 Level 3:Advanced
- [ ] 完成 高级功能
- [ ] 成功使用 planning mode
- [ ] 配置权限模式(包含 auto 在内的 6 种)
- [ ] 使用带安全分类器的自动模式(Auto mode)
- [ ] 使用 extended thinking 切换
- [ ] 探索通道(Channels)和语音输入(Voice Dictation)
- [ ] 达到里程碑 3A
- [ ] 完成 Plugins 与 CLI 高级用法
- [ ] 配置 print mode(
claude -p)用于 CI/CD - [ ] 为自动化创建 JSON 输出
- [ ] 把 Claude 集成到 CI/CD 流水线
- [ ] 创建团队 plugin
- [ ] 达到里程碑 3B
🆘 常见学习难题与解决
- "概念一下子太多了":一次只关注一个里程碑,完成所有练习后再往下走。
- "不知道什么时候该用哪个功能":回到主 README 里的 Use Case Matrix 与 Feature Comparison 表,按触发方式(手动
/cmd、自动加载、自动委派、事件触发)与持久性维度区分。 - "配置没有生效":检查文件路径与命名、frontmatter 语法、文件权限,并确认 Claude Code 版本兼容性。
- "概念之间好像重叠":核心区分是——Slash Commands 手动调用、Skills 自动触发、Subagents 隔离委派、Hooks 事件驱动、MCP 实时数据、Memory 跨会话长期上下文。
- "太多东西记不住":自己做一份速查表;同时用 checkpoints 安全试验。
- "我经验很足,但不知道从哪里开始":先做自我评估测验,直接跳到你的水平,并用前置条件检查找出空缺。
🎯 学完之后做什么:15 条进阶方向
完成所有里程碑后,可以继续做这些事:
- 写团队文档——记录团队的 Claude Code 配置
- 构建自定义 plugins——把团队工作流打包起来
- 探索 Remote Control——通过外部工具以编程方式控制 Claude Code 会话
- 试试 Web Sessions——用浏览器界面远程开发
- 使用 Desktop App——通过原生桌面应用访问 Claude Code
- 使用自动模式(Auto Mode)——让 Claude 在后台安全分类器保护下自主工作
- 启用 Auto Memory——让 Claude 随时间自动学习你的偏好
- 设置 Agent Teams——让多个 agent 协同处理复杂、多维任务
- 使用通道(Channels)——用结构化的多会话工作流组织工作
- 试试语音输入(Voice Dictation)——用语音无障碍地与 Claude Code 交互
- 使用 Scheduled Tasks——借助
/loop和 cron 工具自动化周期性检查 - 贡献示例——把经验分享给社区
- 带新人——帮助队友快速上手
- 持续优化工作流——根据使用情况不断改进
- 保持更新——跟进 Claude Code 发布和新功能
📚 仓库内延伸资源
完成路线图后,你可以在仓库中继续深入:浏览完整的 功能目录(含全部安装命令)、查阅 索引 与 快速参考(速查命令与配置)、阅读 资源列表 获取更多学习材料、参考 STYLE_GUIDE.md 了解本仓库的文档规范。每个功能模块的中文指南(Slash Commands、Memory、Skills、Subagents、MCP、Hooks、Plugins、Checkpoints、Advanced Features、CLI)都包含可直接复制的配置文件、脚本与故障排查章节,可作为日常使用的常驻参考。
atomcodeClaude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get StartedRust4.21 K635- DDeepSeek-V4.1-FlashDeepSeek-V4.1-Flash 是一个多模态混合专家(MoE)模型,拥有 5520 亿骨干参数,并支持最多一百万 token 的上下文长度。该模型原生支持图像和文本输入,并以自回归方式生成文本Python70
jforgamejforgame是一个一站式游戏服务器开发框架。包含游戏服务器开发所需要的各种组件,比如网关,socket服务端与客户端,自定义高效消息编解码,游戏热更新,游戏通用工具等等。包含游戏服,跨服,匹配服,后台管理系统等实现,同时提供大量业务案例以供学习。亦可用于其他socket应用,例如及时聊天等。Java161
fizz-gateway-nodeAn Aggregation API Gateway in Java . FizzGate 是一个基于 Java开发的微服务聚合网关,是拥有自主知识产权的应用网关国产化替代方案,能够实现热服务编排聚合、自动授权选择、线上服务脚本编码、在线测试、高性能路由、API审核管理、回调管理等目的,拥有强大的自定义插件系统可以自行扩展,并且提供友好的图形化配置界面,能够快速帮助企业进行API服务治理、减少中间层胶水代码以及降低编码投入、提高 API 服务的稳定性和安全性。Java90
certd开源SSL证书管理工具;全自动证书申请、更新、续期;通配符证书,泛域名证书申请;证书自动化部署到阿里云、腾讯云、主机、群晖、宝塔;https证书,pfx证书,der证书,TLS证书,nginx证书自动续签自动部署JavaScript120
Spark-X2.5-1.7BSpark-X2.5-1.7B 旨在让强大的 AI 更加实用、高效且易于获取。这些模型在广泛的日常任务中表现出色,涵盖对话、写作、翻译、推理、编程、工具调用和智能体工作流,并在同等规模的开源模型中取得领先结果。Spark-X2.5 将面向效率的架构与最高 1M tokens 的原生上下文窗口相结合,并支持 200 多种语言。Python300