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

2026-06-30 15:23 更新

📚 系列导航:上一篇 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 会话里)

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

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

第二步:确认连上了

claude mcp list

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

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

claude

进去后敲(点名 server,是为了让它走 MCP 查官方文档,而不是凭记忆答):

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

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

第四步:清理(可选)

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

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号