术语表
Claude Code 常见术语速查:智能体循环、压缩、CLAUDE.md、hook、子智能体、MCP、权限模式、检查点、worktree 隔离等,以及已更名的旧术语。
按字母顺序整理 Claude Code 的核心术语,每条在对应的专题页里有详细说明。模型层面的概念(token、temperature、RAG 等)请看 Anthropic 平台术语表。
A
- AGENTS.md:写给 AI 编码智能体的项目说明 markdown 文件。仓库里有它而没有 CLAUDE.md 时,Claude 会把它当作项目指令;可在
/config的 Project instructions 设置里改成两个都读或只读CLAUDE.md。 - 智能体团队(Agent teams):由团队负责人协调的多个独立 Claude Code 会话,有共享任务列表和点对点消息。与只向父会话汇报的子智能体不同,队友各有自己的上下文窗口,你可以直接与任一队友交互。该功能为实验性。
- 智能体式编码(Agentic coding):AI 能自主读文件、运行命令、做改动,你在旁观察、调整或离开的工作方式,区别于只回复文本、要你自己应用的聊天助手。
- 智能体框架(Agentic harness):把语言模型变成能干的编码智能体的工具、上下文管理和执行环境。Claude Code 是框架,Claude 是里面的模型;框架提供文件访问、shell 执行、权限把关、记忆加载和把动作串起来的循环。
- 智能体循环(Agentic loop):Claude 处理每个任务的循环:收集上下文、采取行动、验证结果,重复直到完成。每次工具调用的返回都会影响下一步,你可以随时打断。hooks、skills、MCP 等大多数扩展点都接入这个循环的特定阶段。
- Artifact:Claude Code 从会话里发布到 claude.ai 私有 URL 的实时交互网页,方便直观查看或分享;会话重新发布时原地更新。
- 自动记忆(Auto memory):Claude 根据你的纠正和偏好为自己写的笔记,按 git 仓库存放在
~/.claude/projects/下,同一仓库的所有 worktree 共享一个目录。每个会话开始时加载MEMORY.md索引的前 200 行或 25 KB。它是 CLAUDE.md 的 Claude 自写对应物。 - 自动模式(Auto mode):由独立分类器模型代你审查操作的权限模式,大多数操作无需询问;匹配你显式 ask 规则的操作仍会询问。
B
- Bare 模式:用
--bare启动时不加载 hooks、skills、自定义命令、子智能体、已安装插件、MCP 服务器、自动记忆和 CLAUDE.md(--add-dir传入目录里的 skills 除外)。推荐用于 CI 和需要每台机器结果一致的脚本调用。 - 内置 skills(Bundled skills):Claude Code 自带的提示型作业手册,如
/batch、/code-review、/debug、/loop。与执行固定逻辑的内置命令不同,它们给 Claude 一个详细提示并让它编排工作,所以可以派生智能体、读文件并适应你的代码库。
C
- Channel:把事件推入你正在运行的会话的 MCP 服务器,让 Claude 对你离开终端期间发生的事做出反应;可以是双向的。研究预览里包含 Telegram、Discord 和 iMessage。
- 检查点(Checkpoint):你每次发送开启一个回合的提示时创建的恢复点;Claude Code 在每次编辑前给文件做快照。按两次
Esc或运行/rewind可以把代码、对话或两者恢复到更早的点,或从选定消息起总结部分对话。 .claude目录:Claude Code 读取项目范围配置(设置、hooks、skills、子智能体、规则)的目录;项目根有.claude/,用户级默认值在~/.claude/。- CLAUDE.md:你为 Claude 写的持久指令 markdown 文件,每个会话开始时作为系统提示之后的用户消息加载。项目约定、架构说明、「总是做 X」的规则放这里。项目根的 CLAUDE.md 在压缩后会从磁盘重新读取。可放在项目范围的
./CLAUDE.md或./.claude/CLAUDE.md、用户范围的~/.claude/CLAUDE.md,或作为组织的托管策略;所有发现的文件会拼接进上下文而不是互相覆盖,从最宽范围到最具体排序。 - 云端会话(Cloud session):运行在云基础设施上、关掉笔记本后仍继续运行的会话:默认由 Anthropic 托管,或使用组织自己运营的自托管环境。
- 命令(Command):在提示符输入
/name调用的可复用指令。内置命令如/clear、/model、/compact控制会话;你也可以在.claude/commands/里定义或从插件安装。多步骤命令推荐用 skills 打包。另有两种无关用法:claude mcp add这样的 CLI 子命令,以及 stdio MCP 服务器条目里的command字段。 - 压缩(Compaction):上下文窗口接近上限时对对话的自动总结,先清除较旧的工具输出,再总结对话。项目根 CLAUDE.md 和自动记忆在压缩后从磁盘重新加载;只在对话里给出的指令可能丢失。可运行
/compact手动触发。 - Connector:添加到你的 claude.ai 账号而不是在 Claude Code 里配置的 MCP 服务器;用该账号登录 Claude Code 后,它们出现在
/mcp里。 - 上下文窗口(Context window):会话的工作记忆,装着对话历史、文件内容、命令输出、CLAUDE.md、自动记忆、已加载的 skills 和系统指令。运行
/context查看什么占了空间。
D–F
- Dispatch:从 Claude 手机 App 发送编码任务时,在桌面 App 里派生 Claude Code 会话的手机发起任务路由,适用于 Pro 和 Max 套餐。
- 力度级别(Effort level):控制自适应推理的设置,让模型决定每一步是否思考以及思考多少。力度越高思考 token 越多、推理越深;越低越快越省。
- 扩展思考(Extended thinking):模型在回复前进行的可见逐步推理,可用力度级别调节,在固定思考预算的模型上可用
MAX_THINKING_TOKENS限制;终端里以灰色斜体显示。 - Frontmatter:Markdown 文件最顶部、两行
---之间的 YAML 设置块。skills、子智能体、输出风格和规则都从它读取配置,闭合---之后的内容当作指令。
H–M
- Hook:在 Claude Code 生命周期特定点(如工具运行前、文件编辑后、会话开始)自动执行的用户定义处理器,可以是 shell 命令、HTTP 端点、MCP 工具、LLM 提示或子智能体。hooks 是确定性的:在固定点触发,而不取决于模型是否「想起」。配置有三层:hook 事件、matcher(过滤哪些事件触发)、hook 处理器。
- 托管设置(Managed settings):由 IT 或 DevOps 在组织范围内强制的设置,从 Anthropic 服务器经管理控制台下发,或部署到设备上
~/.claude之外的 OS 级路径;用户和项目设置无法覆盖。 - MCP(Model Context Protocol):连接 AI 工具与外部数据源和服务的开放标准。MCP 服务器给 Claude 提供 Slack、Jira、数据库、浏览器等集成工具,通过
/mcp或写进.mcp.json连接。 - MCP 服务器:通过 MCP 给 Claude 提供工具、提示或资源的程序,用
claude mcp add、.mcp.json、插件或 claude.ai connector 添加。 - MCP Tool Search:节省上下文的机制,延迟加载 MCP 工具的 schema:启动时只加载工具名和服务器说明,Claude 决定使用某个工具时才按需获取完整 schema。
N–P
- 非交互模式(Non-interactive mode):用
-p或--print执行单个提示后退出,用于 CI、脚本和管道。除非传--no-session-persistence,这次运行仍会保存为可恢复的会话。Agent SDK 是它的 Python / TypeScript 对应物。旧称 headless 模式。 - 输出风格(Output style):改变 Claude Code 给 Claude 的指令,以设置回复行为、语气或格式。与在默认指令旁边补充项目上下文的 CLAUDE.md 不同,自定义输出风格可以替换默认的软件工程指令。
- 权限模式(Permission mode):会话的基线批准行为,在 CLI 用
Shift+Tab循环切换。可用:default(在 CLI、VS Code、JetBrains 和桌面 App 里显示为 Manual,manual也被接受为别名)、acceptEdits、plan、auto、dontAsk、bypassPermissions。 - 权限规则(Permission rule):按工具名和参数模式允许、询问或拒绝某次工具调用的设置条目,按 deny → ask → allow 评估,首个匹配生效;是叠加在权限模式之上的细粒度控制。
- 计划模式(Plan mode):Claude 调研并提出改动而不编辑源文件的权限模式;它可以读、搜索、运行探索类命令,然后在动手之前提交计划等你批准。用
/plan或Shift+Tab进入。 - 插件(Plugin):把 skills、hooks、子智能体和 MCP 服务器打包成单个可安装单元;插件 skills 以
plugin-name:skill-name命名空间,多个插件可以共存;通过插件市场在团队间分发。 - 项目信任(Project trust):在 Claude Code 加载某目录的配置前确认该目录的对话框,按项目目录保存(主目录例外,只对当前会话有效)。在你信任之前,Claude Code 会扣住仓库提供的部分内容。
- 提示词注入(Prompt injection):嵌入文件、网页或工具结果里的恶意指令,试图把 Claude 引向你从未要求的操作。Claude Code 的防御包括权限系统、命令注入检测和信任验证。
R–S
- Remote Control:通过 claude.ai 从手机或浏览器继续本地 Claude Code 会话的方式;代码执行和文件留在你的机器上,只有界面是远程的。与跑在云端沙箱里的云端会话不同。
- 规则(Rules):
.claude/rules/里与 CLAUDE.md 一起加载的模块化指令文件;可以用 YAMLpaths:frontmatter 限定路径,只有 Claude 读取匹配文件时才加载,保持上下文精简。 - 沙箱(Sandboxing):对 Bash 工具的操作系统级文件系统和网络隔离。命令在你预先定义的边界内运行,Claude 可以在其中自由工作而无需逐条命令批准;与权限规则是独立的一层。
- 会话(Session):与当前目录绑定、有自己独立上下文窗口的对话。可以用
claude -c恢复、用--fork-session分叉(保留历史,新会话 ID),或在多个终端里并行。/clear开始新会话,旧会话仍保存可恢复。 - 设置层级(Settings layers):Claude Code 读取配置的层次,优先级从高到低:托管策略、命令行参数、本地设置(
.claude/settings.local.json)、项目设置(.claude/settings.json)、用户设置(~/.claude/settings.json)。数组跨层合并,更高层的标量覆盖更低层。 - Skill:包含指令、知识或工作流的
SKILL.md文件,Claude 加入自己的工具箱:相关时自动加载,或用/skill-name直接调用。skills 遵循 Agent Skills 开放标准,Claude Code 在其上扩展了调用控制和子智能体执行。它是自定义命令的推荐继任者:.claude/commands/deploy.md和.claude/skills/deploy/SKILL.md都会创建/deploy,效果相同。 - 子智能体(Subagent):在自己的上下文窗口里运行、有自定义系统提示、特定工具访问和独立权限的专用 AI 助手,处理委派的任务并把摘要返回主对话。用于把大规模探索挡在主上下文之外或并行调研。内置子智能体有 Explore、Plan 和 general-purpose。
- 入口(Surface):访问 Claude Code 的任何地方:CLI、VS Code、JetBrains、桌面 App 或 claude.ai,共享同一引擎。本机会话读取你本地的 CLAUDE.md、设置和 skills;云端会话从仓库的全新克隆启动,不读取你机器上的
~/.claude/。 - 系统提示(System prompt):Claude Code 在每次请求中放在对话之前的指令,涵盖 Claude 如何使用工具、安全行为和回复格式。可用
--append-system-prompt追加或--system-prompt替换。你的 CLAUDE.md 和输出风格指令不属于系统提示,Claude Code 把它们作为系统提醒放进对话里。 - 系统提醒(System reminder):Claude Code 作为框架添加到对话里给 Claude 提供上下文的消息,不是你发的,例如会话开始时、hook 返回文本时或磁盘上的文件变化时插入。CLAUDE.md、输出风格指令、hook 返回的
additionalContext、可用 skills 列表、文件已变更的说明、提交和 PR 署名行都以此方式送达。在记录的 API 请求里,它被<system-reminder>标签包在用户消息里。
T–W
- Teleport:
/teleport命令把云端 Claude Code 会话拉到你的本地终端:Claude 获取分支、加载对话历史、从云端会话的最后状态继续。反方向是--cloud,把本地任务发到云端运行。 - 工具(Tool):Claude 可以执行的动作:读文件、编辑代码、运行 shell 命令、搜索网络、派生子智能体。工具使 Claude Code 有智能体性;没有工具,Claude 只能回复文本。
- 转录(Transcript):会话的存储记录。对话是你和 Claude 交换的内容;转录是保存为文件的对话,默认位于
~/.claude/projects/<project>/<session-id>.jsonl,恢复时 Claude Code 读回这个文件。 - 回合(Turn):Claude 在会话中的一次完整回复:从你发送消息开始,到 Claude 回复完成为止,中间可以有任意多次工具调用。Stop hooks 在每个回合结束时触发。
- 验证循环(Verification loop):会话如何知道工作真的完成而不只是看上去合理:你给 Claude 一个它能运行的检查(测试套件、构建、截图对比),Claude 反复迭代直到检查通过,而不是尝试一次就停。它是
/goal、无人值守运行和动态工作流的前提。 - Worktree 隔离:让 Claude 在
.claude/worktrees/下独立的 git worktree 里运行的隔离模式,用-w标志或子智能体配置里的isolation: worktree启用;改动留在单独目录里的独立分支,并行智能体不会互相覆盖文件。
已弃用和改名的术语
旧文档、博客和社区内容里还会出现这些词,搜索时请用现名:
| 旧术语 | 现称 | 说明 |
|---|---|---|
| Headless 模式 | 非交互模式 | 同一个 -p 标志,行为相同 |
| Web 会话;用「Claude Code on the web」指任何云端会话 | 云端会话 | 「Claude Code on the web」现在只指 claude.ai/code 的浏览器入口 |
| 自定义命令 | Skills | .claude/commands/ 里的文件仍然有效 |
| Slash commands | Commands | 产品文案里去掉了「slash」 |