乐于分享
好东西不私藏

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

官方文档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″免费领取