Claude Code 101 · 9 集入门课中文笔记

把 Claude Code 当成一个会动手的工程同事

这份笔记按播放列表的 9 个视频顺序,把安装、工作原理、首次提示、CLAUDE.md、Explore → Plan → Code → Commit、上下文管理、MCP 和 Hooks 串成一套可执行的学习路径。

来源:YouTube 播放列表 主题:Claude Code 101 补充核对:Claude Code 官方文档 整理时间:2026-05-15
What is Claude Code thumbnailWhat is Claude Code?
How Claude Code Works thumbnailHow Claude Code Works
Workflow thumbnailExplore → Plan → Code → Commit
Context thumbnailContext Management
MCP thumbnailMCP in Claude Code
Hooks thumbnailHooks in Claude Code

先说清楚:这份笔记依据什么

YouTube 播放列表页面可以读取到 9 个视频的标题、顺序与缩略图;但逐个视频 watch 页面在本机请求时触发了 YouTube 的登录/反机器人校验,无法稳定抓取字幕全文。因此这份笔记没有伪装成逐字稿摘要,而是采用两层资料:

第一层是播放列表结构本身:9 集标题构成了明确的教学路径。第二层是 Claude Code 官方文档,用来校验术语、安装命令、工作原理、CLAUDE.md、MCP 和 Hooks 的细节。文末列出来源链接。

课程地图:9 集其实在讲一条主线

这套列表不是零散功能介绍,而是从“它是什么”一路走到“如何把它接进真实工程流程”。可以理解成四层:

认识工具 是什么 · 安装 · 登录 理解循环 读代码 · 动手 · 验证 建立上下文 Prompt · CLAUDE.md · Context 扩展能力 MCP · Hooks 最终目标:让 Claude Code 稳定参与真实开发,而不是只回答问题

不是聊天框

Claude Code 的关键不是“能解释代码”,而是它能读文件、改文件、运行命令、用 git、跑测试,把语言模型放进工程环境里。

不是一次性脚本

它以会话为单位工作:先理解,再行动,再验证。你可以随时打断、补充上下文、要求它重新计划。

不是无约束代理

权限、CLAUDE.md、Hooks、MCP 配置和上下文管理决定它能做什么、如何做、什么时候停下来问你。

核心心智模型:Agentic Loop

官方文档把 Claude Code 描述为运行在终端里的 agentic assistant。它的工作循环可以简化为三步:收集上下文、执行动作、验证结果。这个循环不是线性的,复杂任务会反复来回。

你的目标 Gather context 读文件、搜索、理解结构 Take action 编辑、运行命令、调用工具 Verify 测试、lint、查看 diff 结果不满足目标时,重新收集上下文并调整方案

学习这套视频时,最重要的不是记住命令,而是把 Claude Code 当成“带工具的模型外壳”。模型负责推理,工具负责行动,权限和上下文负责边界。

逐集笔记

1. What is Claude Code?2:56

开场建立定位:Claude Code 是面向工程任务的 agentic coding tool,不只是代码问答助手。它可以理解项目、编辑文件、运行命令,并和开发工具集成。

2. Installing Claude Code3:02

安装重点是选对入口:终端 CLI、IDE、桌面或 Web。终端版本适合本地项目,安装后在项目目录运行 claude 并登录。

3. How Claude Code Works2:51

讲工具的底层循环:Claude 不是一次性给答案,而是边看代码边行动,行动后再根据结果修正。你看到的是对话,背后是工具调用链。

4. Your first Claude Code prompt2:27

第一次提示不要太抽象。好的 prompt 应该说明目标、范围、验收标准和约束。让它先探索再修改,通常比直接说“修一下”更稳。

5. The CLAUDE.md file3:01

CLAUDE.md 是项目记忆和规则入口。把你反复解释的内容写进去:项目结构、测试命令、编码规范、禁止事项、提交要求。

6. Explore → Plan → Code → Commit3:12

这是最实用的工程节奏:先探索代码,再提出计划,确认后编码,验证后提交。它把 Agent 的自由度拆成可审查节点。

7. Context Management3:52

上下文是 Claude Code 的工作内存。要减少无关信息,保留任务目标、关键文件、规则、错误日志和验证结果。上下文乱,行动就容易漂。

8. MCP in Claude Code3:37

MCP 把外部系统接进 Claude Code,例如 GitHub、Jira、数据库、Sentry、文档系统。它解决“不要复制粘贴,让 Agent 直接读工具”的问题。

9. Hooks in Claude Code3:22

Hooks 是自动化控制层:在工具调用前后、任务结束、权限请求等时机触发命令、HTTP、MCP 工具或判断逻辑。

Explore → Plan → Code → Commit:最值得内化的工作流

这条工作流的价值,是把 Agent 的能力放进工程师熟悉的评审节奏里。不要一上来就让它改全项目,而是让每一步都有可检查输出。

阶段Claude Code 做什么你检查什么推荐提示
Explore读取目录、搜索关键函数、理解入口和数据流。它是否找到了真正相关的文件,而不是只看表面。先不要改代码,阅读相关文件并解释调用链。
Plan列出修改点、风险、测试计划。方案是否过度设计,是否会碰无关模块。给出最小修改方案,等我确认后再实现。
Code编辑文件、补测试、运行命令。diff 是否集中,测试是否覆盖核心行为。按刚才方案实现,只改必要文件。
Commit查看 git diff,写 commit message,可执行提交。提交是否只包含本次任务,信息是否可追溯。总结变更,确认测试结果,然后准备提交。
实用判断:当任务涉及未知代码库、生产风险、跨模块修改时,强制使用 Explore → Plan → Code → Commit。只有很小的机械改动才适合直接让它动手。

CLAUDE.md 与上下文管理

CLAUDE.md 放什么

CLAUDE.md 适合写“每次都应该知道”的内容。官方文档强调,它是你写给 Claude 的持久指令,而不是强制执行的配置。因此越具体、越短、越接近事实,效果越稳定。

# 项目约定
- 包管理器使用 pnpm,不要生成 package-lock.json
- 测试命令:pnpm test
- UI 组件放在 src/components
- 修改数据库 schema 前必须先说明迁移风险
- 提交前运行 pnpm lint 和 pnpm test

上下文怎么省

上下文窗口不是垃圾桶。你给它塞入大量无关文件,它会更慢,也更容易混淆。好的上下文是:目标、约束、关键文件、错误输出、已尝试方案、验收标准。

当前目标:修复登录失败后空白页
范围:只看 auth、router、LoginPage
错误:控制台 TypeError ...
约束:不要改后端 API
验收:错误密码时显示提示,页面不崩
长期规则 CLAUDE.md / rules 任务上下文 目标 / 错误 / 文件 工具反馈 测试 / diff / 日志 决策 下一步动作 上下文管理的目标:让 Claude 每一步看到“足够的信息”,而不是“最多的信息”。

MCP 与 Hooks:一个接外部世界,一个管执行时机

如果说 CLAUDE.md 是“记住规则”,那 MCP 和 Hooks 就是“接入工具”和“自动执行”。它们经常一起用,但职责不同。

MCP:外部工具接口

MCP 让 Claude Code 连接数据库、issue tracker、监控、设计稿、文档、Slack 等系统。你不必复制一段 Jira 内容到聊天里,而是让 Claude 直接读取对应资源。

Hooks:生命周期自动化

Hooks 在特定事件触发,例如工具调用前、工具调用后、任务完成、权限请求。典型用途是格式化、lint、阻止危险命令、发通知、记录审计日志。

组合:更接近真实工程

例如 PostToolUse hook 在改动关键文件后调用测试;MCP 连接 Sentry 后让 Claude 读取线上错误;CLAUDE.md 告诉它团队的修复流程。

能力解决的问题适合例子风险点
CLAUDE.md每次都要知道的项目规则测试命令、目录结构、编码规范写太长会稀释重点
Skills按需加载的专业流程部署流程、代码审计、报告模板技能过多会难以维护
MCP连接外部系统与数据源GitHub、Sentry、PostgreSQL、Notion权限与 prompt injection
Hooks在关键事件自动执行动作保存后格式化、提交前测试、危险命令拦截脚本本身可能破坏环境

一套可以直接照做的入门 Playbook

第一天:跑通基础

  1. 安装 Claude Code,并在一个真实项目目录运行 claude
  2. 先问:what does this project do?
  3. 让它解释目录结构、测试命令、入口文件。
  4. 做一个小改动,但要求它先计划再改。
  5. 让它运行测试并总结 diff。

第一周:建立工程规则

  1. 把反复解释的内容写进 CLAUDE.md
  2. 把常用工作流沉淀成固定 prompt 或 skill。
  3. 为高风险动作配置权限和 hook。
  4. 接一个最有价值的 MCP,例如 GitHub 或 issue tracker。
  5. 每次任务结束要求它给出测试结果和残余风险。
不要一开始就全自动。Claude Code 的强项是能行动,但真实工程需要可审查、可回滚、可验证。初期最稳的方式是:让它多探索、多解释、多给计划,少做未经确认的大范围修改。

最后的总括

Claude Code 101 的主线可以压缩成一句话:先把 Claude Code 当作能读写项目的工程同事,再逐步给它规则、记忆、工具和自动化边界。入门阶段最重要的是形成正确姿势:明确目标,控制范围,要求计划,验证结果,把重复上下文写进 CLAUDE.md,把外部数据交给 MCP,把确定性检查交给 Hooks。