Claude Code 乍看之下或许有些困难。
终端、MCP、钩子、技能和 API 这些术语一股脑儿全冒出来，让你在最初的一个小时里很容易迷失方向。
在这篇文章中，我会把 Claude Code 整理成"老师教两个初中生的一堂课"。
看完之后，你就会明白学习基础操作、外部集成、技能、记忆、钩子、MCP 和 API 的正确顺序。
头图由 AI 生成。提示词可在 这篇文章 中找到。
Claude Code 是"执行型 AI"，而非"回答型 AI"
Claude Code 不仅仅回答问题，它是在你电脑里执行任务的 AI。
在官方文档中，它被描述为一种 Agent 类型的开发工具，可以编辑文件、执行命令、进行 Git 操作，并与 MCP 集成。
一旦理解了这一点，所有功能就都串联起来了。
老师把这句话写在了黑板上：
"聊天 AI 是给建议的老师。Claude Code 是在教室里和你一起干活的班长。"
美奈问：
"那么，Claude Code 只适合会编程的人用吗？"
老师摇了摇头。
"它最初确实因为编写代码的工具而出名。但它的本质是一个能读取文件夹、修改文件、执行流程的 AI。它也可以用于写作、文档、网页、研究笔记和制作教材。"
莲说：
"所以，与其告诉 ChatGPT '写一篇文章'，不如告诉 Claude Code '看看这个文件夹，修改一下，再检查一遍'。"
正是如此。
教 Claude Code 时，从这三类开始就足够了：
- 读取
- 修改
- 检查
例如，如果老师正在教如何为校园文化节制作网页，他们应该这样要求 Claude Code。
这里的关键不是向 AI 索取一个"答案"，而是给 Claude Code 一系列的任务。
目录
- Claude Code 是"执行型 AI"，而非"回答型 AI"
- 基本操作："请求、确认、修改"
- 记忆：老师的交接簿
- 技能：必杀技卡片
- 钩子：上课铃和巡逻老师
- MCP：校外教学巴士
- API 与 SDK：将 Claude Code 用作一个组件
- 入门 30 分钟练习菜单
基本操作："请求、确认、修改"
Claude Code 的基础包含请求、确认和修改的流程。
与其死记硬背复杂的命令，不如掌握这种对话模式，进步会更快。
一开始，带着"一起修改"的预期来使用它，而不是想着"一次性完成"。
老师把第一个模式交给了两个学生。
美奈松了一口气说：
"我还担心它会突然把所有东西都改了。看来只要先让它提出建议就行。"
老师回答说：
"没错。比起让 Claude Code 自己全权处理，设置一些确认点会更稳妥。"
基本用法包含以下五点：
- 使用
claude启动对话 - 使用
claude "请求内容"传递初始请求 - 使用
claude -p "请求内容"进行一次性非交互式执行 - 使用
/help查看可用命令 - 使用
/status查看状态
不过，没必要一开始就把所有东西都教给初中生。第一节课，只需打开 claude 并说一句话就够了。
莲说：
"如果第一个指令只需要这样，那也没什么好怕的嘛。"
老师继续说：
"没错。你可以一边向 Claude Code 询问使用方法，一边用它。不明白怎么用时，就直接问它怎么用。"
基础操作的目标不是记住命令，而是让人来决定把哪些工作交给 AI。
记忆：老师的交接簿
记忆是用于写下你希望每次 Claude Code 都读取的前提条件的地方。
在官方文档中，它被解释为一个可以根据用户或项目使用不同指令文件的系统。放在教室里，就像老师之间的交接簿。
老师把 CLAUDE.md 写在了黑板上。
美奈问：
"这是什么？"
老师回答：
"这是 Claude Code 开始工作前会阅读的教室规则手册。"
对于一个校园文化节项目，可以这样写：
莲说：
"这样我就不用每次都重复说了。"
老师点了点头。
"正是。如果你每次都解释同样的事情，那就把它放进记忆里。"
适合放入记忆的信息包括：
- 项目目标
- 写作风格或设计规则
- 常用命令
- 禁止触碰的文件
反之，有些信息不适合放入记忆：
- 仅限当天的请求
- 未经确认的想法
- 密码或 API 密钥
- 个人信息
如果是教初中生，可以这样传达：
"记忆不是让 AI 变聪明的魔法。它是为了防止 AI 每次忘记规则而准备的笔记。"
这样的解释就足够了。
技能：必杀技卡片
技能是将常用的工作流程转化为可调用格式的功能。
在官方文档中，它被解释为一个以 SKILL.md 为核心，组织模板、示例、脚本和参考材料的系统。在教室里，这些就像是只有在需要时才拿出来的必杀技卡片。
老师画了三张卡片：
- 读书报告检查
- 校园文化节页面创建
- 英语单词测验生成
美奈问：
"这和提示词合集有什么区别？"
老师回答：
"提示词合集是你每次都要粘贴的一张纸。技能是你可以存放在 Claude Code 工具箱里的卡片。"
技能的基本结构如下：
在 SKILL.md 中，你需要写明何时使用、做什么以及需要读取什么。Claude Code 可以根据对话内容自动使用匹配的技能，或者用户也可以用 /技能名 来调用。
莲说：
"那么，我就可以把老师常用的批改规则做成一个技能了。"
正是如此。
对于读书报告技能，你可以这样设计：
这里的关键点是，不要把每件事都做成技能。对于一次性的请求，当场询问就够了。
需要做成技能的任务应符合以下标准：
- 重复频率高
- 有固定的流程
- 有判断标准
- 有参考资料或模板
- 质量因人而异
最后，老师说道：
"技能不会给 AI 增加天赋。它们是将人类的工作流程转化为可复用格式的工具。"
也请参考 Claude Code 词典网站。
钩子：上课铃和巡逻老师
钩子是一种在 Claude Code 工作前后自动运行的机制。
在官方文档中，它们被解释为根据 PreToolUse 或 PostToolUse 等特定事件来执行命令或流程的设置。在教室里，这些就像是上课铃和巡逻老师。
美奈问：
"上课铃？"
老师回答：
"是的。上课前会响铃。提交前也会响铃。如果你想去危险的地方，它会拦住你。这就是钩子的作用。"
例如，在 Claude Code 重写文件之前，它可以进行如下巡逻：
- 它是否试图触碰
.env文件？ - 它是否试图破坏重要的配置文件？
- 重写后是否应该运行测试？
- 是否应该格式化文本？
- 是否应该留下日志？
莲的眼睛亮了起来：
"那么，当 AI 快要犯错的时候，你就能阻止它了！"
老师稍微严肃地说：
"但是，钩子是强大的工具。因为它们可以自动执行 Shell 命令，所以不加理解就添加是很危险的。"
向初中生解释钩子时，一开始不需要让他们写配置。只要教给他们这些角色就够了：
工作前：阻止危险操作。工作后：运行测试或检查。完成后：检查是否有未完成的任务。
在实践中，按以下顺序引入：
- 首先，手动检查。
- 如果相同的检查频繁出现，将其制作成检查清单。
- 一旦检查清单稳定下来，再将其转化为钩子。
不要突然进行自动化。如果你自动化了一个连人都不理解的检查，那么失败也会被自动化。
老师写在了黑板上：
"钩子不是方便的机器人，而是遵循你制定规则的巡逻老师。"
MCP：校外教学巴士
MCP（模型上下文协议）是一种将 Claude Code 连接到外部服务和数据的机制。
在官方文档中，MCP 被解释为一种将 AI 工具与外部数据源连接起来的开放标准。在教室里，它就是前往教室外进行校外教学的巴士。
老师画了一张教室的图。教室外面，他画了图书馆、教师办公室、市政厅和博物馆。
莲说：
"Claude Code 能走出教室吗？"
老师回答：
"就是这么个概念。连接 MCP 后，Claude Code 就能访问外部信息了，比如 GitHub、Sentry、PostgreSQL、Slack、Google Drive 和 Figma。"
当然，你不能让它随意查看所有内容。你需要决定连接服务器、身份验证和权限。
在 Claude Code 的 MCP 设置中，你可以添加 HTTP 服务器或在本地运行的 stdio 服务器。
美奈担心地说：
"连接到外面有点吓人。"
老师回答：
"有这种感觉是对的。MCP 很方便，但连接得越多，它能接触到的信息就越多。所以，先从只读模式开始。"
教授 MCP 的顺序如下：
- 首先，仅使用本地文件。
- 接着，连接到安全的只读数据。
- 然后，连接到 GitHub 或工单管理系统。
- 最后，再考虑写入或生产环境数据。
MCP 的价值不在于让 AI 变得更聪明，而在于 AI 可以自己去获取工作所需的材料。
老师总结道：
"MCP 是带 AI 去看外面世界的巴士。但是，由老师决定它可以去哪里。"
API 与 SDK：将 Claude Code 用作一个组件
API（应用程序编程接口）和 SDK（软件开发工具包）是将 Claude Code 集成到应用程序或自动化流程中的方法。
在官方文档中，Claude Code SDK 被解释为一个可以从 CLI、TypeScript 和 Python 中使用的系统。在教室里，这就像让班长在教室外参与工作。
莲问：
"API 到底是什么？"
老师回答：
"不是人在屏幕上对话，而是从程序里请求 Claude Code 完成工作的入口。"
例如，常规用法如下所示。这是人在终端里发出一次请求。
使用 SDK，你可以在应用程序或批处理过程中调用 Claude Code。Python SDK 以 claude-code-sdk 的形式提供，同时也提供了 TypeScript SDK。
美奈问：
"这是初学者应该首先尝试的吗？"
老师回答：
"不。这不是你一开始就应该做的事情。"
API 和 SDK 在以下阶段使用：
- 当你希望每天自动运行相同任务时。
- 当你希望在 CI 中辅助进行代码审查或测试时。
- 当你希望从内部工具中调用 Claude Code 时。
- 当你希望并行运行多个进程时。
- 当你希望以 JSON 格式接收结果时。
对于初中生，可以这样解释：
"手动向班长下指令是 Claude Code 的基础。从广播室自动发送请求则是 API 和 SDK。"
它虽然方便，但一开始就用会让人困惑。正确的顺序是：先学基础，再学记忆、技能、MCP、钩子，最后才是 API。
入门 30 分钟练习菜单
你不需要一次性掌握 Claude Code 的所有知识。
如果你把最初的 30 分钟要做的事情限定好，恐惧感就会消失。教初中生的时候，要先创造小的成功体验。
最后，老师展示了一个 30 分钟的课程菜单。
美奈说：
"我觉得我在课堂上就能做到！"
莲说：
"所以 MCP 和钩子可以后面再学。"
老师回答：
"没错。顺序很重要。如果你直接跳到外部集成或自动执行，你会完全搞不清楚发生了什么。"
最初的三个目标是：
- 让 Claude Code 解释一个文件夹的内容。
- 让它修改一个小文件。
- 让它解释修改的原因。
如果能做到这些，你就已经掌握了 Claude Code 的精髓。之后，根据自己的需求继续学习：
- 如果每次都解释同样的事情很麻烦：学记忆。
- 如果每次都做相同的事情：学技能。
- 如果你想展示外部资料：学 MCP。
- 如果你想自动化检查：学钩子。
- 如果你想将其构建到系统中：学 API 和 SDK。
Claude Code 不是一个用来记忆功能的工具。它是一个用来培养你如何分配工作的工具。
最后，老师说道：
"擅长使用 AI 的人，不是那些 AI 方面的专家。他们是那些能够拆分工作、移交规则并执行检查的人。"
这是教初中生 Claude Code 时最重要的结论。
相关文章
[初学者适用] Claude Code 个人辅导
*前 10 名的早鸟名额已售罄。
Claude Code 设计模式
~深度解析文件夹结构、技能、数据库及内容生成流程~
咨询、个人辅导及企业培训需求请联系：
