Skip to content
claude ~ claude-code/52-glossary— 28 min read

52 · 术语表(小白友好):把这一路的「黑话」一次性翻译成人话

📚 系列导航:上一篇 51 常见问题排查(FAQ / Troubleshooting) 把你最容易卡住的报错和怪现象挨个排雷。这一篇做一件更基础、也更该早做的事——把全教程冒出来过的术语,一个一个翻成人话。代理循环、上下文窗口、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 是活字典;接上它(addlist 看绿勾 → 会话里点名查 → 批准),任何术语都能现查最权威的定义,永不过时。


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 来写这段代码,是不是又是一个「描述需求、它出活」的活儿?