2. 核心概念速览

本节目标：把 Claude Code 涉及的核心术语一次性捋清楚，后面章节再遇到就不会懵。

为什么单独搞一章术语

你翻 Claude Code 的文档，会发现一堆词：智能体、上下文窗口、CLAUDE.md、MCP、Skills、Hooks、子代理、沙箱……每个单独解释都懂，但合在一起容易乱。

这章不展开讲怎么用，只把每个概念是什么、解决什么问题、彼此什么关系说清楚。像一张地图，先看清全貌，后面再逐个深入。

Tip

这章可以当字典用。后面读到某个词忘了，翻回来查一眼就行。

智能体（Agent）与代理循环

智能体（Agent） 是能自主行动的 AI。普通聊天机器人只能用文字回你，智能体能真的动手—读文件、改代码、跑命令。

Claude Code 就是一个智能体。它之所以能动手，是因为有工具（Tool）。工具是 Claude 可以执行的操作：读文件、编辑代码、运行 shell 命令、搜索网络等等。没有工具，Claude 只能回文字；有了工具，它能采取行动。

智能体干活靠的是代理循环（Agentic Loop）。你给一个任务，它反复执行三步：

收集上下文：读文件、搜索、看 git 状态
采取行动：编辑文件、跑命令
验证结果：看输出、跑测试

循环转好几圈，直到任务完成。每一步的结果都喂回给模型，决定下一步干什么。你随时能打断它给新指示。

Note

Claude Code 官方把它叫「agentic harness」—代理框架。Claude（模型）是大脑，Claude Code（框架）是手脚和神经系统。模型负责推理，框架提供工具、权限控制和执行环境。

上下文窗口（Context Window）

上下文窗口（Context Window） 是 Claude 的工作记忆。它保存对话历史、文件内容、命令输出、CLAUDE.md、加载的 Skills 等所有信息。

打个比方，上下文窗口就是 Claude 的「桌面」。你给它看的文件、它跑的命令输出、你们的对话，全堆在这张桌上。桌子就这么大，堆满了就得收拾。

收拾的过程叫压缩（Compaction）。当上下文快满时，Claude Code 会自动总结之前的对话，清掉旧的工具输出，腾出空间。你也可以手动跑 /compact 触发。

默认模型 Opus 5 支持 100 万 token 的上下文窗口，这已经很大了，但复杂任务还是会塞满。怎么管理上下文是后面专门的章节。

CLAUDE.md：项目指令文件

CLAUDE.md 是一个 Markdown 文件，里面写着你给 Claude 的持久指令。每次会话开始，它都会被自动加载。

放什么进去？项目约定、编码规范、构建命令、「永远不要做 X」这类规则。比如：

# 项目约定
- 使用 pnpm，不要用 npm
- 提交前必须跑测试
- 代码风格遵循 ESLint 配置

CLAUDE.md 有分层机制：

项目级：./CLAUDE.md，跟着项目走，团队共享
用户级：~/.claude/CLAUDE.md，你个人的全局偏好
全局托管：由 IT 部门通过管理控制台下发

所有层级的文件都会被加载，不是互相覆盖。从最宽的范围到最具体的范围依次拼接。

Tip

经验法则：保持 CLAUDE.md 在 200 行以下。太长了就拆成 .claude/rules/ 里的模块化规则文件，或者做成 Skill 按需加载。

自动记忆（Auto Memory）

自动记忆（Auto Memory） 是 Claude 自己给自己写的笔记。根据你的纠正和偏好，它自动记录下来，存在 ~/.claude/projects/ 下。

跟 CLAUDE.md 的区别：CLAUDE.md 是你写的，Auto Memory 是 Claude 写的。两者互补。

比如你纠正了它三次「我们用的是 pnpm 不是 npm」，它可能就记到 Auto Memory 里了，下次不再犯。MEMORY.md 索引的前 200 行或 25KB 在每个会话开始时自动加载。

技能（Skill）

技能（Skill） 是一个 SKILL.md 文件，包含可复用的指令、知识或工作流。你可以用 /skill-name 直接调用，Claude 也会在相关时自动加载。

跟 CLAUDE.md 的区别：CLAUDE.md 每次都加载，Skill 是按需加载的。

适合做 Skill 的东西：

部署流程（/deploy）
代码审查清单（/review-checklist）
API 风格指南（Claude 需要时自动加载）
多步骤工作流

Claude Code 自带一批内置 Skills，比如 /batch（批量改代码）、/code-review（代码审查）、/debug（调试排查）。

子代理（Subagent）

子代理（Subagent） 是一个专门的小助手，在自己的上下文窗口里运行，干完活把摘要交回主对话。

为什么要用子代理？举两个场景：

上下文隔离：一个任务要读 50 个文件，但结果就几句话。如果主对话干，50 个文件的内容全挤进上下文窗口。让子代理干，主对话只收到摘要，上下文不爆。
并行工作：同时让三个子代理分别查安全、查性能、查测试，各自独立跑，互不干扰。

内置的子代理有 Explore（探索代码库）、Plan（规划任务）等。你也可以自定义。

Note

子代理跟 Agent Teams 不同。子代理在主会话内运行，只向主对话报告结果；Agent Teams 的每个成员都是独立的完整会话，你能直接跟任何一个对话。Agent Teams 目前是实验性功能。

MCP：连接外部服务

MCP（Model Context Protocol，模型上下文协议） 是一个开放标准，用来把 AI 工具连接到外部数据源和服务。

简单说，MCP 让 Claude Code 能连上 Slack、Jira、数据库、浏览器这些外部服务，获得新的工具能力。比如：

连数据库 MCP，Claude 能直接查数据
连 GitHub MCP，Claude 能管理 issue 和 PR
连浏览器 MCP，Claude 能操作网页

通过 /mcp 命令管理 MCP 服务器连接，或在 .mcp.json 文件里配置。

钩子（Hook）

钩子（Hook） 是在特定生命周期事件上自动执行的处理程序。它不是 Claude 决定要不要跑的，而是在固定时机必然触发。

比如：

每次文件编辑后自动跑 ESLint
会话开始时加载特定配置
工具运行前检查权限

Hook 的处理程序可以是 shell 命令、HTTP 请求、MCP 工具、LLM 提示或子代理。配置分三层：事件类型、匹配器、处理程序。

Warning

Hook 是确定性的—在固定时机必然触发，不经过模型决策。这跟 Skill 不同，Skill 是 Claude 觉得相关才加载的。

插件（Plugin）

插件（Plugin） 是打包层。它把 Skills、Hooks、子代理、MCP 服务器捆绑成一个可安装单元。

插件的好处是复用和分发。你在 A 项目调教好一套配置，打包成插件，B 项目一行命令就能装上。还能通过市场（Marketplace） 分发给团队或社区。

插件里的 Skill 带命名空间，比如 my-plugin:review，多个插件不会冲突。

沙箱（Sandbox）

沙箱（Sandbox） 是 Bash 工具的操作系统级隔离。命令在你预先定义的边界内运行，Claude 可以在里面自由操作，不需要每个命令都弹审批。

沙箱跟权限规则是两层东西：

权限规则：决定哪些工具调用需要问你
沙箱：给命令执行套一层文件系统和网络隔离

开了沙箱，Claude 跑命令时即使出了格，也被限制在沙箱边界内，碰不到外面的文件。

检查点（Checkpoint）

检查点（Checkpoint） 是每次你发送提示时自动创建的还原点。Claude Code 在每次编辑前对文件做快照。

搞砸了？按两次 Esc 或运行 /rewind，把代码和对话回滚到之前的点。也可以只回滚代码不回滚对话，或者从某条消息开始总结。

检查点是会话本地的，跟 git 分开，不追踪通过 Bash 工具做的修改。所以别把它当 git 用，它只是给你一个「撤销」的退路。

权限模式（Permission Mode）

权限模式（Permission Mode） 决定会话的基线审批行为。用 Shift+Tab 循环切换。

几种主要模式：

模式	行为
default / manual	每次操作都问你（最安全）
acceptEdits	自动接受文件编辑，命令仍问
plan	只读模式，只研究不改文件
auto	后台分类器审查，大部分操作自动放行
bypassPermissions	跳过所有权限检查（最危险）

Warning

bypassPermissions 模式跳过所有安全检查，只在完全信任的隔离环境里用。日常别开。

斜杠命令（Slash Command）

斜杠命令（Slash Command） 是在提示里输入 /name 触发的命令。内置的如 /clear（清空对话）、/model（切换模型）、/compact（压缩上下文）。

你可以把自己的命令定义成文件放在 .claude/commands/ 里，或者用 Skill 实现。两者效果一样，Skill 是新推荐的格式。

会话（Session）与轮次（Turn）

会话（Session） 是跟当前目录关联的一段对话，有自己独立的上下文窗口。claude -c 可以恢复最近的会话，/clear 开新会话，/resume 恢复历史会话。

轮次（Turn） 是一个完整的交互单元：从你发消息开始，到 Claude 回完结束，中间可能有多次工具调用。一个会话由很多轮次组成。

设置文件（settings.json）

settings.json 是 Claude Code 的配置文件。也有分层：

用户级：~/.claude/settings.json
项目级：.claude/settings.json
本地级：.claude/settings.local.json（不提交到 git）

优先级从高到低：托管策略 > 命令行参数 > 本地设置 > 项目设置 > 用户设置。数组会合并，标量会被高优先级覆盖。

概念关系图

这些概念怎么串起来？用一段话概括：

你启动一个会话，Claude Code 加载 CLAUDE.md、自动记忆和 settings.json 配置。你发消息，进入代理循环—Claude 用工具收集上下文、采取行动、验证结果。它可能调用子代理隔离上下文干活，用MCP 连外部服务，加载Skill 获取专业知识。Hook 在固定时机自动触发。沙箱和权限模式控制它能干什么。每次你发消息，自动存一个检查点。上下文快满了就压缩。你可以用斜杠命令快速操作。

不用全记住，心里有个大概就行。后面每章会展开讲。

不用全学会再开始

这些概念看着多，但你不需要全搞懂才能用 Claude Code。很多人就是装上、登录、开始聊，遇到问题再查。

这章的作用是：后面读到某个词，你知道它在讲什么。真正用起来，从下一章安装开始就行。