官方文档Claude Code 101写了啥(下)

上篇讲的那7节,说到底只是”怎么用”。CLI怎么敲、工作流怎么走、上下文怎么管——这些都是基本功。
但真正让Claude Code从”能用”变成”好用”的,是这5个东西。
CLAUDE.md解决的是”每次进来都要重新说一遍”,你建立的知识和习惯怎么让Claude每次都记住。Skills解决的是”重复操作”,有些活每周都干,封装起来一键执行。MCP解决的是”Claude只能动本地文件”,接了之后它能查网页、调数据库、对接飞书。Hooks解决的”忘了跑检查”,让自动化自动发生。
上篇是让你会上手,这篇是让你上道。用不用这些功能,决定了Claude Code在你手里是一个”高级的ChatGPT”还是一个”真正的AI工作站”。
八、The CLAUDE.md file(项目记忆文件)
这一节很重要。CLAUDE.md虽然只有几KB,但决定了Claude Code的性格和输出质量。它就是AI执行的准则——告诉它什么该做、什么不该做、按什么标准来。
但这里有一个常见误区:很多人想把所有东西都塞进去——目录结构、技术栈说明、命名规范——膨胀到200多行。
虽然LLM能读200行,但越往后执行力越差。你写100条规则,它记不住后50条。而且每多一条规则,其他规则的权重就被稀释一分。
GitHub上有一个被封神的CLAUDE.md——来自Andrej Karpathy,不到65行,只有4条规则,拿下了17万星。原文如下:1. Think Before Coding — 动手之前先想。不要假设,不确定就问,有歧义就列出来,有更简单的方案就说出来。2. Simplicity First — 保持简单。不多写一行不需要的代码,不搞没要求的抽象,不为不可能发生的场景做错误处理。能50行写完的就别写200行。3. Surgical Changes — 只动该动的。不改相邻代码,不重构没坏的东西,不删无关的代码。每行改动都应该直接对应你的需求。4. Goal-Driven Execution — 定义成功标准,循环直到验证通过。不做”看起来差不多了”就停的事。
这个案例说明一件事:CLAUDE.md不是说明书,是行为准则。你不用告诉Claude”项目里有哪些文件夹”——它自己会读目录。你要告诉它的是”你希望它怎么做决策”。
原文还给了一个具体的CLAUDE.md例子——写清楚用什么框架、什么命令、什么代码规范。这种写法和Karpathy的行为准则不冲突,可以结合用:前面几条指挥行为,后面列明项目信息。
我翻了一圈社区的最佳实践,总结下来该写什么、不该写什么:
应该写的:行为准则(Karpathy那种)、环境偏好(用什么工具跑)、质量门禁(改完必须跑什么验证)、反模式(明确说不要做什么)。
不应该写的:目录结构说明(Claude自己会读)、完整代码片段(指向文件路径就行)、任何”不说Claude也不会犯错”的东西。
我自己的经验:CLAUDE.md不超过50行。每条规则写之前问自己——”这条如果删了Claude会犯错吗?”——不会犯错就不写。越精简,执行越有力。
九、Subagents(子代理)
官方课程第9节讲怎么派子agent。主会话里输入:
/agent “帮我查一下这个目录下的文件结构”
Claude会在一个独立子对话里执行,干完回来汇报。主会话的上下文不被污染。
官网强调subagent的核心价值是”保持主context干净”。你的主会话有200K上下文上限,查资料、跑分析这类任务交给subagent去做,主会话只做决策和动手。
subagent的定义还可以存成.md文件放在项目里,下次直接引用。
十、Skills(技能封装)
有些操作反复做——”格式化代码””检查对接规范””生成周报”。官方课程里Skills不是单独一节,而是提了一个概念,附了一个专门的课程链接供深入学。
最简单的Skill就是一个.md文件,放在.claude/skills/目录。但完全体的Skill比你想象中正式——一个完整的Skill是一个目录:
.claude/skills/<技能名>/├── SKILL.md ← 入口,含 frontmatter(name/description 等)├── README.md ← 详细文档└── references/ ← 参考文件 ├── flow.md └── learnings.md
frontmatter里写触发条件、参数说明、调用方式。正文写流程、规则、边界。references里放参考材料。这样别人拿到你的Skill一看就知道怎么用。
对普通人来说,不需要手动写Skill——因为Anthropic官方有一个叫skill-creator的Skill,它就是用来帮你写Skill的,相当于”元Skill”。或者你也可以在CLI里用/find-skill搜索你需要的Skill,让Claude Code自己去搜去安装。
我自己的做法:如果我想写一个复盘任务的skill,我会先去社区调研相关skill都是怎么写的,拉取完整的文件结构再看看代码。再结合自己的系统架构和需求去重写。不重复造轮子,但也不直接拿来就用。
十一、MCP(外部工具连接)
Model Context Protocol,官方课程第11节。Claude Code默认只能操作本地的文件和终端,MCP就是给它装外挂。MCP是什么?AI的万能插头
接了MCP之后,Claude可以搜网页、查数据库、调API、对接飞书——能读你本地文件之外的实时数据。
MCP分两种情况。一种是有现成的官方MCP,比如飞书、Tavily、Exa——直接安装配置就能用,几行JSON的事。
另一种是没有现成的MCP,需要自己写。比如我本地建了一个RAG知识库,想让Claude Code能直接查,就得自己写一个MCP工具去连接这个知识库。
配置在 ~/.claude.json 或项目下的 .mcp.json:
{ “mcpServers”: { “search”: { “type”: “stdio”, “command”: “node”, “args”: [“path/to/server.js”] } }}
配完重启claude。跟Skill一样,你不需要知道怎么写MCP——有build-mcp-server这个skill,它帮你完成MCP的编写和配置。
MCP是让Claude Code从”代码助手”变成”工作平台”的那一步。有现成的直接装,没有就让Claude自己写——你只需要告诉它你想连什么。
十二、Hooks(自动化钩子)
官方课程最后一节技术内容。Hooks是事件触发器——在特定时机自动执行脚本。
官方列出了几种hooks:
Pre-commit — git commit前自动跑检查,不过关不让提交。
Pre-prompt — 每次发指令前自动注入当前项目状态。
Post-exit — 退出会话后自动备份或清理。
配置在settings.json里。大多数用不上,但如果你是重度用户,迟早会发现有些自动化不靠Hooks做不干净。
课程最后还有一个Quiz,5道选择题,通过后给证书。不难,上完这12节正常都能过。
Quiz里有一题问”上下文满了之后Claude Code会怎样”,答案是它会自动压缩对话。但即使有自动压缩,我还是习惯自己管理——每完成一个任务就clear,保持每个对话干净。这不冲突:自动压缩兜底,主动管理更优。
上篇+下篇 = Claude Code 101全部12节课程内容。
如果你之前装过Claude Code但没用起来,这两篇看完重新打开终端试试。多半比上次顺手。
有英文基础的可以直接去官方看原文——免费,注册即学。这两篇就是替你翻译了一遍,省你几小时。
本文基于Anthropic官方Claude Code 101课程编写,中文翻译仅供学习交流,原文版权归Anthropic所有。
相关文章上篇:What is Claude Code → Code review(第1-7节)安装教程:全网最简单安装Claude Code
📖 中文翻译PDF免费领取我把Claude Code 101全部11课原文逐字翻译成了中文PDF排版参考原版风格,适合离线阅读,私信我”claude-code-101″免费领取
夜雨聆风