# 52 · 术语表（小白友好）：把这一路的「黑话」一次性翻译成人话

> 📚 **系列导航**：上一篇 [51 常见问题排查（FAQ / Troubleshooting）](51-troubleshooting.md) 把你最容易卡住的报错和怪现象挨个排雷。这一篇做一件更基础、也更该早做的事——**把全教程冒出来过的术语，一个一个翻成人话**。代理循环、上下文窗口、MCP、subagent、skill、hook、checkpoint、权限模式、headless、transport……五十多篇下来名词攒了一大堆，这一篇当你的随身速查卡，**哪个词糊了，回来一翻就清楚**。

都说「术语表要从头到尾通读一遍打基础」，说句实话，**这是最没用的读法**。

学任何一门新工具，把术语表当课文从 A 背到 Z 背下来，几乎都是白费——背完转头就忘，因为那些词当时一个都没在你手里「发生」过。术语这东西，**是你撞上它、被它绊一下，才会真正记住**。

所以这一篇我不打算让你「读」，而是让你「查」。**它是一张速查卡，不是一篇课文。** 你正常往后学、往后用，哪天看到「这个 transport 到底是个啥」「auto-compact 又是什么」卡住了，翻回这一页，找到那一条，一句话加一个类比看完，继续干活——这才是术语表的正确用法。

**类比：装修工地墙上贴的那张物料清单。** 工地上没人会站那儿把清单从头背到尾，但每根管子、每块板材到货时，师傅会瞄一眼清单——「哦，这个是承重梁，那个是水管接头」，对上号就接着干。这张表也一样：**不为通读，只为「撞上了能查到」**。下面我按「主题」把术语归成几族（同一族的概念互相关联，放一起比按字母排好记），每条都是「术语 → 一句话 → 类比」三件套。

**看完（或者说，以后用着用着翻回来）你能拿到：**

- 全教程出现过的核心术语，一条不落地用小白话加类比解释清楚
- 按「主题族」归类，同族概念放一块，顺带理清它们之间的关系
- 主要条目都标了「详见第 NN 篇」编号，想深挖直接跳过去
- 一份「最容易搞混的几对术语」对照，撞车时回来对一眼就分清
- 一个动手小练习：用官方自带的文档 server，在 Claude 里随时查任何术语的权威定义

---

## 01 代理循环家族：Claude「干活」这件事是怎么转起来的

这一族是**最该先搞懂的地基**。它回答一个根本问题：Claude Code 跟一个网页聊天 AI 到底差在哪、它凭什么能「自己动手」。其余所有术语，几乎都挂在这套循环上。

**类比：一条会自己转的流水线。** 普通聊天 AI 是「你问一句、它答一句」，像点餐窗口；Claude Code 是一条**自己会转的流水线**——拿到活儿后，自己取料、自己加工、自己质检，转完一圈再看要不要再转一圈。下面这几个词，就是这条流水线上的不同零件。

### Agentic loop（代理循环）

**一句话：** Claude 处理每个任务时反复转的那个圈——收集上下文 → 采取行动 → 验证结果 → 不够就再来一圈，直到完成。

**类比：厨师颠勺的节奏。** 不是把所有料一次性倒进锅就完事，而是「下料 → 翻炒 → 尝一口咸淡 → 不够再调」，一个节奏一个节奏地逼近那盘菜。每次「尝一口」（工具返回的结果）都告诉它下一步该往哪走。你随时能喊停、改方向。（详见第 03 篇）

### Agentic coding（代理式编程）

**一句话：** 一种工作方式——AI 能自主读文件、跑命令、改代码，你在旁边看着、随时纠偏或干脆走开，而不是它给你一段文字让你自己照着敲。

**类比：请了个能上手的师傅，而不是一本说明书。** 说明书只能告诉你「该怎么做」，师傅是直接帮你做了。Claude Code 属于能动手的那种，靠的就是它手里那些工具。（详见第 01 篇）

### Agentic harness（代理外壳）

**一句话：** 把一个语言模型「武装成」能干活的编程代理的那一整套外围——文件访问、shell 执行、权限控制、记忆加载、把动作串起来的循环。**Claude Code 是外壳，Claude 是里头的模型**。

**类比：车壳和发动机。** 同一台发动机（模型）装进不同的车壳，开起来体验天差地别。harness 就是 Claude Code 这层车壳，它决定了模型能摸到哪些东西、按什么规矩动手。（详见第 03 篇）

### Tool（工具）

**一句话：** Claude 能实际执行的动作——读文件、改代码、跑 shell 命令、搜网页、派 subagent；**没有工具，它就只能动嘴回文字**。

**类比：流水线工位上的那些设备。** 光有个聪明大脑没用，得有机械臂、传送带、检测仪它才能真把活干出来。工具就是 Claude 的「手」，每用一次都返回一个结果，喂给代理循环里它的下一步决策。（详见第 03 篇）

### Turn（回合）

**一句话：** 从你发一条消息开始，到 Claude 把这次响应彻底说完为止，算一个完整回合；中间它可能调用任意多次工具。

**类比：你点一次单、厨房出一道菜。** 你说一句需求是「点单」，Claude 中间切菜、翻炒、装盘（调一堆工具）你不用管，最后端上来这一整套算「一道菜出齐」。一次会话由很多个回合串成。（详见第 03 篇）

### Verification loop（验证循环）

**一句话：** 让 Claude 知道「活儿是真干完了，不只是看起来像」的机制——你给它一个能跑的检查（测试、构建、截图对比），它就反复改到检查通过为止。

**类比：交作业前自己先对一遍答案。** 没有标准答案时，「写完」全凭感觉；给它一份能自查的答案，它才会改到对为止，而不是写一遍就交。无人值守跑长任务时，这一条是命根子——**没有它，判断「干完没」的只有它自己**。（详见第 49 篇）

### Extended thinking（扩展思考）

**一句话：** 模型在正式回答前那段**看得见的逐步推理**，在终端里以灰色斜体显示；可以用 `MAX_THINKING_TOKENS` 或调 effort level 控制它想多少。

**类比：解题前先在草稿纸上演算。** 不是张口就答，而是先把推导过程写出来——你能看到它「怎么想的」，错了也好定位是哪一步歪了。（详见第 35 篇）

### Effort level（努力级别）

**一句话：** 一个设置，控制 Claude 每个回合花多少「思考预算」——级别越高想得越深、越慢越贵，越低越快越省。

**类比：考试时给一道题分配多少时间。** 选择题扫一眼就填（低 effort），压轴大题多花十分钟细想（高 effort）。简单活儿调低省钱，硬骨头调高求质量。（详见第 35 篇）

> 💡 一句话总结：这一族讲的是 Claude「会自己动手」这件事的运转机制——**核心是「想→做→看」的代理循环，工具是它的手，harness 是把模型武装起来的车壳，extended thinking 是它的演算草稿、effort level 是给思考分配的时间预算，验证循环是它的质检员**。

---

## 02 上下文家族：Claude 的「记性」和「桌面」有多大

学会第一族，你就会立刻撞上第二族——**Claude 不是记性无限的**。这一族所有词，都围绕「它一次能记住多少、记满了怎么办、换任务了怎么清」打转。卡过「它怎么把我前面说的忘了」的人，答案全在这儿。

**类比：一张就那么大的工作台。** 你趴在桌上画图，桌面就那么大；图纸、参考书、草稿越铺越多，迟早摊不下，得收拾。Claude 的「记性」就是这张桌子，下面这几个词讲的全是「桌子多大、满了咋办」。

### Context window（上下文窗口）

**一句话：** 一次会话的「工作内存」——装着对话历史、文件内容、命令输出、CLAUDE.md、加载的 skill、系统指令，**就这么大，装满为止**。

**类比：工作台的台面面积。** 台面越大，能同时摊开的资料越多；摊满了，新东西放上去就得先挪走旧的。跑 `/context` 能看到现在台面上都摆了些啥、谁占地方。（详见第 19 篇）

### Token

**一句话：** 模型处理文字的最小计量单位，大致是「半个到一个汉字、一个英文词的一部分」；上下文窗口的大小、计费，都按 token 算。

**类比：文字的「计价字数」。** 寄快递按重量算钱，模型按 token 算「量」——你喂进去多少、它吐出来多少，都折成 token 计进那张工作台的占用和账单里。（token 的底层细节属于模型层概念，本教程不展开，够用就行）

### Compaction（压缩）

**一句话：** 上下文快装满时，自动把对话「总结成精简版」腾地方——先清掉老的工具输出，再概括对话；跑 `/compact` 可手动触发。

**类比：把摊了一桌的草稿纸，整理成一页要点。** 草稿太多桌子放不下，你把关键结论抄到一张纸上，其余的收走——信息主干还在，占地小了。注意：项目根目录的 CLAUDE.md 和 auto memory 在压缩时会保留并从磁盘重读，**只在聊天里临时说过的话可能被压没**。（详见第 19 篇）

### Auto-compact（自动压缩）

**一句话：** 不用你喊，上下文接近上限时系统自动触发的那次压缩。

**类比：流水线上的自动卸料。** 料斗快满了，传送带自己启动把多余的卸走，不用你按按钮。它跟手动 `/compact` 干的是同一件事，区别只在「谁来按下启动键」。（详见第 19 篇）

### Session（会话）

**一句话：** 跟你当前目录绑定的一段对话，**有它自己独立的一块上下文窗口**；`/clear` 开新会话，旧的存着可 `/resume` 找回。

**类比：换个全新任务，干脆收拾干净台面再开工。** 上一个活儿的草稿留在台上只会碍事，清空台面（开新会话）从头铺，脑子清爽。每段会话的记录都存在 `~/.claude/projects/` 下，所以哪怕关了终端，回头还能 `claude -c` 接着上次聊。（详见第 19 篇）

### CLAUDE.md

**一句话：** 你写给 Claude 的**常驻说明书**，每个会话一开就自动加载，放「项目约定、构建命令、永远做 X」这类始终生效的规矩。

**类比：给新员工的入职手册。** 每天来的可能是个「失忆的新人」，但只要手册钉在那儿，他一上工先读一遍，就知道这儿的规矩。建议控制在 200 行内，太长就把参考资料挪进 skill。（详见第 18 篇）

### Auto memory（自动记忆）

**一句话：** Claude 根据你的纠正和偏好，**给自己**写的笔记，按 git 仓库存在 `~/.claude/projects/` 下，会话开始时加载索引的开头一截。

**类比：还是显示器旁那两张纸，但这张是它自己写的。** CLAUDE.md 是你钉上去的规矩，auto memory 是它自己记的小抄——「上次他纠正过我别用 npm」这种，它记下来下次不再犯。一个你写、一个它写，是一对。（详见第 25 篇）

### Rules（规则文件）

**一句话：** 放在 `.claude/rules/` 里、跟 CLAUDE.md 一起加载的模块化指令文件，可以用 `paths:` 限定「只在 Claude 读到匹配文件时才加载」，让上下文保持精简。

**类比：按工种分册的施工规范，用到哪本翻哪本。** CLAUDE.md 是总则人人先读；rules 是「电工规范」「水管规范」分册，碰到对应活儿才翻出来——不相关的不占桌面。（详见第 13 篇）

### Output style（输出样式）

**一句话：** 一项配置，**改写 Claude 的系统提示**来调整它回应的行为、语气和格式；内置有 Default、Proactive、Explanatory、Learning 几种。

**类比：同一个主持人，换一档节目的风格。** 还是这个人，但「新闻播报」和「脱口秀」的语气、节奏完全不同。output style 调的就是这个「节目档」，跟 CLAUDE.md（作为用户消息传进去的规矩）是两回事。（详见第 32 篇）

> 💡 一句话总结：这一族全在讲「记性与说话方式」——**上下文窗口是工作台台面，token 是计价单位，压缩是台面满了的整理动作，会话是一次独立的开工，CLAUDE.md / auto memory / rules 是钉在桌边的几类备忘，output style 是换一档说话风格**。

---

## 03 扩展点家族：给 Claude「加装备」的那几样

这一族是整套教程的重头——**怎么把 Claude 从「开箱能用」改造成「贴合你的活儿」**。第 30 篇专门讲过这几样怎么选，这里只做「一句话加类比」的速查。它们的共同点：都是**插在代理循环不同位置上的挂钩**。

**类比：同一个工人，给他配不同的装备包。** 光人到岗还不够——给他一本工作手册（CLAUDE.md）、几本专项菜谱（skill）、一个外接扩展坞（MCP）、几个外派帮手（subagent）、几个自动卡点（hook），他能干的活儿就完全不是一个量级。下面逐个认。

### Skill（技能）

**一句话：** 一个 `SKILL.md` 文件，装着一段知识、套路或流程；相关时 Claude 自动把它调进来用，你也能 `/<名字>` 主动唤它。

**类比：手机里的快捷指令。** 「回家模式」一点，关灯、开空调、放音乐一串动作自动跑完——你不用每次重说一遍流程。skill 就是 Claude 的快捷指令：把重复的套路存成一条，要用时一键调出。平时只占一行描述，**用到才把完整内容加载进上下文**（官方管这叫渐进式披露）。（详见第 26 篇）

### Subagent（子代理）

**一句话：** 一个有**独立上下文窗口**的专项助手，带自己的系统提示和工具权限，你派活给它，它干完只把结论摘要递回主对话。

**类比：把一个活儿外包给跑腿小弟。** 你让他去翻三十份档案找一个数，他在外面翻得天昏地暗你这边一点不沾，回来只跟你说一句「找到了，是这个」。**精髓是上下文隔离**——中间过程不污染你的主桌面。内置的有 Explore、Plan 和通用三种。（详见第 23 篇）

### Hook（钩子）

**一句话：** 在 Claude Code 生命周期的某个固定时刻（工具运行前、文件改完后、会话一开始……）**自动执行**的一段动作，可以是 shell 命令、脚本、通知等。

**类比：流水线上的自动卡点。** 传送带每过一个工位，卡点「咔哒」一下自动盖个章——不靠人盯、不靠 AI 自觉，**事件一到必然触发**。这点是它跟 CLAUDE.md 的根本区别：写进 CLAUDE.md 是「请求」，hook 是「保证」。（详见第 33 篇）

### Command / slash command（命令 / 斜杠命令）

**一句话：** 你在提示里打 `/名字` 就能调用的可复用指令；内置的（`/clear`、`/model`、`/compact`）控制会话，自定义的本质就是「带 `/<名字>` 触发的 skill」。

**类比：遥控器上的固定按键。** `/clear` 像「复位键」，`/deploy` 像你自己贴上去的「一键发版键」——按下去就跑那套固定流程。如今官方推荐用 skill 来打包多步命令。（详见第 36 篇）

### Plugin（插件）

**一句话：** 把 skill、hook、subagent、MCP server **打包成一个可安装单元**，装一次，一整套扩展点全到位。

**类比：出门前装好的一只行李箱。** 你不会把衬衫、剃须刀、充电器一件件抱在怀里，统统码进箱子拎走。plugin 就是这只箱子——换个项目要用同一套装备，装上这个 plugin 就齐了。里头的 skill 还带命名空间（像 `/my-plugin:review`），多个 plugin 各装各的也不撞名。（详见第 24 篇）

### Plugin marketplace（插件市场）

**一句话：** 分发和获取 plugin 的来源，你可以添加一个或多个市场，从里面挑 plugin 安装。

**类比：给手机装一个应用商店。** 应用商店里摆着一堆 App（plugin），你挑需要的装。**注意来路**——从陌生网站下个 `.exe` 双击运行的风险，装来历不明的 plugin 一样有。（详见第 38 篇）

> 💡 一句话总结：这一族是「加装备」——**skill 是快捷指令、subagent 是外派帮手、hook 是自动卡点、command 是遥控器按键、plugin 是装备行李箱、marketplace 是应用商店**；它们都插在代理循环的不同位置上。

---

## 04 MCP 家族：把 Claude 接到「外部世界」的那套接口

扩展点里 **MCP 单拎出来说**，因为它自带一窝小术语（transport、server、scope……），新手抄命令最容易在这儿翻车。第 22 篇整篇都在讲它，这里把它的「家族成员」一条条认清。

**类比：一个带一堆接口的扩展坞。** 笔记本机身就剩一两个口，HDMI、网线、U 盘全插不上；接个扩展坞，一根线上去全通了。MCP 之于 Claude 就是这个扩展坞——接一次，一堆外部服务的工具全摆到它面前。

### MCP（Model Context Protocol，模型上下文协议）

**一句话：** 一套**开源标准**，规定「AI 工具怎么连外部数据和服务」；MCP server 给 Claude 接上 Slack、Jira、数据库、浏览器等几百种集成。

**类比：USB 这个统一接口标准。** 早年每个设备一种插头，乱成一团；USB 一统天下后，什么设备都能插同一个口。MCP 就是 AI 接外部工具的这个「USB 标准」——一次对接，处处能用。（详见第 22 篇）

### MCP server（MCP 服务器）

**一句话：** 按 MCP 标准实现的一个具体「接头」，带着一组工具（比如 GitHub server 带「读 PR」「开 issue」），接上后这些工具就出现在 Claude 面前。

**类比：插在扩展坞上的一个具体设备。** 扩展坞是标准（MCP），插上去的打印机、硬盘是具体设备（server）——每个 server 给你接通一种外部能力。（详见第 22 篇）

### Transport（传输方式）

**一句话：** Claude Code 和 MCP server 之间「怎么通信」的方式；日常就两种——`stdio`（本地进程）和 `http`（远程托管），外加一个已弃用的 `sse`。

**类比：扩展坞上的设备，有的就在桌上，有的在墙那头。** `stdio` 是 Claude 在你本机后台拉起的一个小程序（就在手边），`http` 是连到某个网址上的远程服务（在墙那头）。**抄命令翻车多半翻在这儿**：stdio 不写 transport，http 要写 `--transport http`。（详见第 22 篇）

### Scope（作用域）

**一句话：** 一个 MCP server 在「哪些项目里能用、要不要跟团队共享」——`local`（仅当前项目、私有）、`project`（写进 `.mcp.json`、随 git 共享）、`user`（你所有项目）。

**类比：办公室里一台打印机怎么共享。** 只连你这台电脑（`local`）、接进部门资产表全组能用（`project`）、还是你自己拎着跑各会议室（`user`）——三种摆法，对应三种作用域。（详见第 22 篇）

### MCP Tool Search（MCP 工具搜索）

**一句话：** 一种省上下文的机制——启动时只加载工具的名字，Claude 真要用某个工具时才按需拉取它的完整说明。

**类比：先看菜单标题，点了才翻详细做法。** 菜单上几百道菜，你不会一上来把每道的详细配料都读一遍——先扫标题，决定点哪道，再翻它的细则。这样一堆闲着的 MCP server 就不会白占工作台。（详见第 22 篇）

> 💡 一句话总结：MCP 是「接外部世界」的 USB 标准——**server 是具体接头，transport 是连线方式（本地 stdio / 远程 http），scope 是这个接头哪些项目能用**；接第三方 server 前先掂量信任。

---

## 05 安全与权限家族：Claude 动手前「问不问你」

Claude 能动手了、还能接外部了，**「它会不会乱来」就成了绕不开的问题**。这一族讲的全是「它动手前的把关机制」——从「问一句再做」到「硬拦死某些操作」。第 20、21 篇讲透了，这里速查。

**类比：开车上路的几层防护。** 安全带、气囊、限速牌——一层管你自己别乱来，一层管真出事时兜底，一层划死「这条线不许越」。Claude 的安全机制也是分层的，下面这几个词分别是哪一层。

### Permission mode（权限模式）

**一句话：** 一次会话里 Claude 动手的「基线态度」——官方共六档，包括每步都问你（`default`）、自动接受改动（`acceptEdits`）、只研究不动手（`plan`）、别问直接干（`bypassPermissions`）、自动审查（`auto`）、静默通过（`dontAsk`）；完整说明见第 35 篇。

**类比：实习生动手前问不问你，是你给他定的自主权等级。** 同一个实习生，你可以让他「每件事都先问」，也可以放权「这类小事自己看着办」。模式就是你给他设的这个等级，在 CLI 里按 `Shift+Tab` 循环切换。（详见第 35 篇）

### Plan mode（计划模式）

**一句话：** 一种权限模式——Claude 只读、只搜、只研究，**不碰你的源文件**，先把改动方案列出来给你批，你点头了才动手。

**类比：装修先出图纸，砸墙前先给你看。** 不许它上来就抡锤子，得先画好「这面墙拆、那根管改」的图纸，你确认再施工。大改动前用它最稳。（详见第 35 篇）

### Auto mode（自动模式）

**一句话：** 一种权限模式——后台有个独立的分类器模型逐个审查操作，挡掉越权、可疑基础设施和提示注入，而不是每步都弹窗问你；目前是研究预览。

**类比：门口有个不看货、只查证件的保安。** 它专门盯「这个操作越不越界」，而且**永远看不到工具返回的内容**，所以藏在工具结果里的恶意指令影响不了它的判断。（详见第 35 篇）

### Permission rule（权限规则）

**一句话：** 按「工具名加参数模式」来 allow / ask / deny 的细粒度设置条目，按 deny→ask→allow 顺序匹配，先中者胜。

**类比：门禁系统里一条条具体的放行 / 拦截规则。** 「这张卡能进 3 楼、不能进机房」——规则比「权限模式」这个大基线更细，是叠在它上面的精确控制。（详见第 20 篇）

### Sandboxing（沙箱）

**一句话：** 给 Bash 工具套一层操作系统级的文件和网络隔离——Claude 在你划定的边界内自由跑，不用每条命令都弹窗批准。

**类比：专用试车场里飙车，墙是物理的。** 场子里随便开多快都行，因为四周的墙是真的拦得住，出不去。沙箱就是这堵墙，跟权限规则是分开的另一层防护。（详见第 21 篇）

### Prompt injection（提示注入）

**一句话：** 藏在文件、网页或工具结果里的**恶意指令**，试图把 Claude 带去做你从没要求的事。

**类比：接到一个照着话术念的诈骗电话。** 对方语气正常、内容却是「你现在按我说的转账」——提示注入就是塞进数据里的这种「话术」，Claude 读进去就可能被带偏。抓外部内容的 MCP server 风险尤其高。（详见第 21 篇）

### Checkpoint（检查点）

**一句话：** 在你每次发提示时自动建的「还原点」，Claude 改文件前先快照；按两次 `Esc`（输入框需为空）或 `/rewind` 打开回溯菜单，可选恢复代码、对话或两者到早先某个提示点。**它是会话本地的，跟 git 分开**。

**类比：打游戏的存档读档。** 走错一步，读个档退回上个存档点重来，不用从头玩。注意它**不跟踪通过 Bash 工具做的改动**——那些得靠 git 或别的方式兜。（详见第 37 篇）

> 💡 一句话总结：这一族是「动手前的把关」分层——**权限模式是大基线（问不问你）、权限规则是细则、沙箱是物理隔离的墙、auto mode 是查证件的保安、checkpoint 是存档读档**；提示注入是要防的那种「话术攻击」。

---

## 06 入口与运行模式家族：你从哪儿用它、它怎么个跑法

最后一族最杂，但都归一类问题：**你在哪儿、用什么姿势跟 Claude Code 打交道**。终端、VS Code、网页、还是塞进脚本里自动跑——形态不同，但底下是同一个引擎。

**类比：同一个工人，有好几种到岗方式。** 他可以来你办公室坐班（终端 / 编辑器）、远程在线办公（网页）、也可以你发个工单他自动接活儿（脚本调用）。人和本事是同一个，**只是「在哪儿、怎么个到岗法」不一样**。

### Surface（交互入口）

**一句话：** 你访问 Claude Code 的任何地方——CLI、VS Code、JetBrains、桌面端、claude.ai；**所有入口共用同一个引擎**，你的 CLAUDE.md、设置、skill 在哪儿都一样使。

**类比：同一品牌不同车型，共用一套车机系统。** 轿车、SUV 外形不同，但车机界面、操作逻辑一模一样，上手零成本。换入口用 Claude Code 也是这感觉。（详见第 08 篇）

### Non-interactive mode（非交互模式 / 旧称 headless）

**一句话：** 用 `-p`（或 `--print`）跑——**执行单条提示、出结果就退出**，不进对话会话；专门给 CI、脚本、流水线用。旧文档里叫 headless mode，是同一个东西。

**类比：发一张工单，他干完交活就走，不跟你唠。** 不是坐下来你来我往聊，而是「这件事，做完给结果」。它的 Python / TypeScript 等价物是 Agent SDK。（详见第 45 篇）

### Agent SDK（代理 SDK）

**一句话：** 把 Claude Code 的能力**搬进你自己程序**的开发包（Python / TypeScript），让你在代码里像调函数一样驱动它。

**类比：把整台咖啡机的机芯拆出来，装进你自己的产品里。** 不再是用现成的咖啡机，而是拿到机芯自己造一台。非交互模式是命令行版，Agent SDK 是「写进代码」版。（详见第 45 篇）

### Claude Code on the web（网页版）

**一句话：** 在浏览器里跑的 Claude Code，任务在**云端沙箱**里执行（跟「Remote Control」不同——后者代码还在你本机，只是 UI 远程）。

**类比：租了台一次性云电脑，用完即焚。** 活儿在云上那台临时机器里干，不占你本地环境。（详见第 11 篇）

### Bare mode（精简模式）

**一句话：** 启动加 `--bare`，**跳过 hook、skill、plugin、MCP server、auto memory、CLAUDE.md 的自动发现**——只有你显式传的参数生效；给 CI 和脚本求「换台机器行为也一致」用。

**类比：出差只带一个登机箱，家里那堆都不带。** 把所有「本地个性化配置」清空，光带任务本身上路，到哪台机器跑出来都一个样。（详见第 34 篇）

### Worktree isolation（工作树隔离）

**一句话：** 一种隔离方式，用 `-w` 或在 subagent 配置里写 `isolation: worktree`，让 Claude 在 `.claude/worktrees/` 下一个**单独的 git worktree、单独分支**里干活，**改动不会跟别的并行代理打架**。

**类比：同一套图纸，给每个施工队各开一个独立工地。** 几队人同时干，各在各的场地，谁也不会把别人砌好的墙推倒。并行跑多个会话时全靠它隔开。（详见第 41 篇）

### Remote Control（远程控制）/ Teleport（传送）

**一句话：** Remote Control 是从手机或浏览器**接管你本机正在跑的会话**（代码还在你机器上，只有界面远程）；Teleport（`/teleport`）反过来，把云端会话**拉进你本地终端**接着干。

**类比：给办公室那台电脑装个远程遥控器。** Remote Control 像你出门用手机遥控家里的电脑（活儿在家里跑）；teleport 像把云上没干完的活儿「传送」回你面前这台机器接着干。（详见第 11 篇）

> 💡 一句话总结：这一族讲「从哪儿用、怎么跑」——**surface 是入口（共用一个引擎）、非交互模式（旧称 headless）是发工单式跑法、Agent SDK 是写进代码、网页版在云沙箱跑、bare mode 是纯净启动、worktree 隔离让并行不打架、Remote Control / teleport 在本机与云端之间来回接管**。

---

## 07 最容易搞混的几对，撞车时回来对一眼

术语多了，**总有那么几对长得像、一用就纠结**。把新手撞车最多的几对单独拎出来对照，你卡哪对回来扫一眼就分清。这张表也是对前面六族的一次横向收口。

| 容易混的一对 | 关键区别 | 一句话切开 |
|------------|---------|-----------|
| **Skill vs Subagent** | 内容进谁的上下文 | skill 加载进你主桌面用；subagent 用它自己的桌面，只把结论递回来（详见第 30 篇） |
| **CLAUDE.md vs Skill** | 什么时候加载 | CLAUDE.md 每会话自动加载；skill 用到才加载（详见第 30 篇） |
| **Hook vs 权限规则** | 管的面 | hook 是「事件触发跑一段动作」；权限规则是「这个工具准不准」的黑白判断（详见第 30 篇） |
| **Subagent vs Agent team** | 你能不能直接跟它聊 | subagent 在单会话里跑、只向主对话汇报；agent team 是多个完整会话，你能直接跟任一个对话（详见第 29 篇） |
| **Session vs Turn** | 粒度 | 一次会话是一整段对话（独立上下文）；一个回合是其中「你说一句→它答完」这一来一回（详见第 03 篇） |
| **Compaction vs `/clear`** | 留不留旧内容 | 压缩是把旧对话「总结成精简版」留着；`/clear` 是直接清台面开新会话（详见第 19 篇） |
| **Permission mode vs 权限规则** | 粗细 | 权限模式是整场的大基线（问不问你）；权限规则是叠在上面的细则（这条命令准不准）（详见第 20 篇） |
| **stdio vs http（transport）** | server 跑在哪 | stdio 是本机后台拉起的进程；http 是连到某网址的远程服务（详见第 22 篇） |
| **CLAUDE.md vs auto memory** | 谁写的 | CLAUDE.md 你写的常驻规矩；auto memory 是 Claude 自己记的小抄（详见第 25 篇） |

这张表里的每一对，新手刚学时**至少有四五对是真容易混的**。最典型的是 skill 和 subagent——刚上手那会儿，很容易把一个「读整个目录找死代码」的活儿硬写成 skill，结果中间翻文件的过程把主对话灌得满满当当，跑两回才反应过来：**只要结论的脏活，该派 subagent，不该塞 skill**。

> 💡 一句话总结：撞车的几对，记区别的「那一个关键维度」就够了——**skill/subagent 看上下文进谁的、CLAUDE.md/skill 看何时加载、mode/规则看粗细、stdio/http 看 server 跑在哪**。

---

## 08 动手：让 Claude 自己当「活字典」，随时查权威定义

光有这张表还不够——**术语会更新，这一篇是静态的，官方文档是活的**。最稳的查法，是让 Claude 自己去查官方那份术语表。第 22 篇接过的那个「官方文档 server」正好派上用场：它免登录、免配置，接上就能问。这一节带你把它当成随身「活字典」用。

> 这个 server 是远程托管的 HTTP 服务，加它需要联网；国内访问 `code.claude.com` 如果不通，先开「魔法上网」再试。

**第一步：接上官方文档 server**（在终端，不是在 `claude` 会话里）

```bash
claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp
```

**预期**：打印一行类似 `Added HTTP MCP server claude-code-docs ...` 的确认。**看到 `Added` = 配置写进去了**。

**第二步：确认连上了**

```bash
claude mcp list
```

**预期**：列表里出现 `claude-code-docs`，旁边标着 `✓ Connected`。**看到绿勾 = 真连上**；若是 `✗ Failed to connect`，多半网络没通，开魔法上网再试。

**第三步：进会话，点名让它查某个术语的官方定义**

```bash
claude
```

进去后敲（点名 server，是为了让它走 MCP 查官方文档，而不是凭记忆答）：

```text
用 claude-code-docs server 查一下官方术语表里 compaction 和 context window 的定义，各用一句话告诉我
```

**预期**：Claude **第一次调这个 server 会停下来问你要不要批准**（就是第 05 节权限那族里、工具首次调用要批准这一闸——归权限系统管，跟 checkpoint 是两回事）——批准它。然后它返回这两个术语的官方说明，**而且输出里那个工具调用旁边会标着 `claude-code-docs`**。看到这个标记 = 答案是真从官方文档查来的，不是模型记忆里的。

**第四步：清理**（可选）

```bash
claude mcp remove claude-code-docs
```

**预期**：打印移除确认，再跑 `claude mcp list`，它已不在列表里。

这套跑通，你就有了一个**永不过时的术语查法**：这一篇当速查卡，拿不准或怀疑过时了，就让 Claude 现查官方那份。核对每一条定义都**靠这个**——比凭记忆写一句然后心里打鼓踏实多了。

> 💡 一句话总结：这一篇是静态速查卡，**官方文档 server 是活字典**；接上它（`add` → `list` 看绿勾 → 会话里点名查 → 批准），任何术语都能现查最权威的定义，永不过时。

---

## 09 小结

这一篇不是让你背，是给你一张**随身速查卡**——全教程的术语按六族归好，撞上哪个翻回来一查就清。

把六族串起来回顾：

| 术语族 | 一句话定位 | 镇族术语 |
|-------|-----------|---------|
| **代理循环** | Claude「会自己动手」的运转机制 | agentic loop、tool、harness、turn、extended thinking、effort level、verification loop |
| **上下文** | 它的记性边界与说话方式 | context window、token、compaction、session、CLAUDE.md、auto memory、rules、output style |
| **扩展点** | 给它加装备 | skill、subagent、hook、command、plugin、marketplace |
| **MCP** | 接外部世界的 USB 标准 | MCP、server、transport、scope、tool search |
| **安全权限** | 动手前的把关分层 | permission mode、plan mode、auto mode、权限规则、sandbox、prompt injection、checkpoint |
| **入口与运行** | 你从哪儿用、它怎么跑 | surface、non-interactive（headless）、Agent SDK、网页版、bare mode、worktree 隔离、Remote Control |

**你现在应该能：** 看到这一路冒出来的任何一个术语，不再发懵——知道它属于哪一族、一句话是啥、配个什么类比好记；遇到 skill vs subagent、stdio vs http 这种容易撞车的对子，回第 07 节对一眼就分清；还学会了用官方文档 server 把 Claude 当「活字典」，任何术语都能现查最权威的定义。**这张速查卡放在手边，前面五十篇里那些一闪而过没记牢的名词，都有了回头查的去处。**

整个正式教程到这儿基本齐活了——从「这是什么」到装好、用熟、加装备、配置优化、再到这张术语收口，**该认的字你都认全了**。

---

下一篇 **53「制作视频（Remotion）〔选读〕」**——这是整套教程的彩蛋篇，跳出「写代码」的框，带你看 Claude Code 还能玩点啥花的：用 Remotion（一个「用 React 代码写视频」的框架）让 Claude 帮你把一段动画视频用代码生成出来。**选读，不影响主线**；但想看看「AI 编程」能延伸到多远的，这一篇值得瞄一眼。想想看：既然视频能用代码写，那让 Claude 来写这段代码，是不是又是一个「描述需求、它出活」的活儿？
