Claude Code 术语表快速查阅所有核心概念的定义、关联配置和限制。从 agentic loop、CLAUDE.md 文件、MCP 服务器到权限模式、子代理和技能，每个术语都指向详细文档，帮助你理解并使用各项功能。

Claude Code 术语表（Glossary）

Claude Code 术语定义。了解 agentic loop、compaction、CLAUDE.md、hooks、subagents、MCP 及其他核心概念的含义。

本术语表定义 Claude Code 术语。每个条目均附带深入讲解的文档链接。关于 tokens、temperature、RAG 等模型级概念，请参阅平台术语表。

A

Agent teams（代理团队）

由团队负责人协调的多个独立 Claude Code 会话，共享任务清单并支持点对点消息。不同于子代理（仅在单个会话内运行且只向父级汇报），团队成员各自拥有独立的上下文窗口，你可以直接与任一成员交互。代理团队为实验性功能，需设置 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 启用。

了解更多：运行代理团队

Agentic coding（代理式编程）

一种工作流：AI 在你的监督、引导或离开时自主读取文件、运行命令并做出修改，与仅返回文本需要你手动应用的聊天式助手形成对比。Claude Code 是代理式的，因为它拥有工具使其能够行动，而不仅仅是提供建议。

了解更多：Claude Code 工作原理

Agentic harness（代理框架）

将语言模型转变为强大编码代理的工具、上下文管理和执行环境。Claude Code 是框架，Claude 是其内部的模型。框架提供文件访问、Shell 执行、权限控制、记忆加载以及将动作串联起来的循环。

了解更多：Claude Code 工作原理

Agentic loop（代理循环）

Claude 处理每个任务的循环：收集上下文、采取行动、验证结果，重复直到完成。每次工具使用返回信息以指导下一步。你可以在任何时刻中断循环并重新定向。大多数扩展点（包括钩子、技能和 MCP）都接入此循环的特定阶段。

了解更多：Claude Code 工作原理

Auto memory（自动记忆）

Claude 根据你的纠正和偏好自行编写的笔记，按 Git 仓库存储在 ~/.claude/projects/ 下。同一仓库的所有工作树共享一个自动记忆目录。每次会话开始时加载 MEMORY.md 索引的前 200 行或 25 KB。自动记忆是与你编写的 CLAUDE.md 相对应的 Claude 编写部分。

了解更多：自动记忆

Auto mode（自动模式）

一种权限模式，由独立的分类器模型在后台审查每个操作，而不是向你显示批准提示。分类器会拦截作用域升级、不可信的基础设施以及提示注入。它从不查看工具结果，因此注入的指令无法影响其决策。自动模式是面向所有 Anthropic API 用户的研究预览版。

了解更多：使用自动模式消除提示

B

Bare mode（裸模式）

启动标志 --bare，跳过钩子、技能、插件、MCP 服务器、自动记忆和 CLAUDE.md 的自动发现。只有你显式传递的标志才会生效。推荐用于 CI 和脚本调用，以确保在不同机器上获得相同行为，不受本地配置影响。

了解更多：使用裸模式更快启动

Bundled skills（内置技能）

Claude Code 附带的基于提示的剧本，例如 /batch、/code-review、/debug 和 /loop。与执行固定逻辑的内置命令不同，内置技能为 Claude 提供详细提示并让其编排工作，因此它们可以生成代理、读取文件并适应你的代码库。

了解更多：内置技能

C

Channel（频道）

一种 MCP 服务器，将事件推送到你正在运行的会话中，使 Claude 能够在你不位于终端时对事件做出反应。频道可以是双向的：Claude 读取入站事件并通过同一频道回复。Telegram、Discord 和 iMessage 包含在研究预览版中。

了解更多：频道

Checkpoint（检查点）

在每次你发送提示时创建的一个恢复点。Claude Code 在每次编辑前对文件进行快照，以便检查点可以恢复。按两次 Esc 或运行 /rewind 可恢复代码、对话或两者到较早点，或从所选消息中总结部分对话。检查点与会话本地绑定，独立于 Git，且不跟踪通过 Bash 工具所做的更改。

了解更多：检查点

.claude 目录

Claude Code 读取项目级配置的目录：设置、钩子、技能、子代理、规则和自动记忆。项目根目录下有 .claude/；用户级默认配置位于 ~/.claude/。

了解更多：.claude 目录

CLAUDE.md

你为 Claude 编写的一套持久指令的 Markdown 文件，在每次会话开始时作为系统提示后的用户消息加载。将项目约定、架构说明和“始终做 X”规则放在此处。CLAUDE.md 在压缩后依然存在，并且压缩后重新从磁盘读取。

你可以在项目作用域下放置 ./CLAUDE.md 或 ./.claude/CLAUDE.md，在用户作用域下放置 ~/.claude/CLAUDE.md，或作为托管策略用于组织。更具体的位置优先级更高。

了解更多：CLAUDE.md 文件

Command（命令）

通过输入 /name 在提示中调用的可复用指令。内置命令如 /clear、/model 和 /compact 用于控制会话。你可以在 .claude/commands/ 中定义自己的命令文件，或通过插件安装。技能是打包多步骤命令的推荐方式。

了解更多：命令 · 技能

Compaction（压缩）

当上下文窗口接近限制时，自动对你的对话进行总结。首先清除较旧的工具输出，然后总结对话。项目根目录下的 CLAUDE.md 和自动记忆在压缩后仍然存在并从磁盘重新加载；仅对话中提供的指令可能会丢失。运行 /compact 手动触发，可附带焦点参数，如 /compact focus on the API changes。

了解更多：压缩后保留的内容 · 上下文填满时的处理

Context window（上下文窗口）

会话的工作记忆，包含对话历史、文件内容、命令输出、CLAUDE.md、自动记忆、加载的技能和系统指令。随着工作，上下文逐渐填满，直到压缩进行总结。运行 /context 查看空间使用情况。关于底层模型概念，请参阅平台术语表。

了解更多：探索上下文窗口

D

Dispatch（派遣）

通过手机启动的任务路由器：当你从 Claude 移动应用发送编码任务时，在 Desktop 应用中生成一个 Claude Code 会话。你的提示会自动路由到合适的工具。适用于 Pro 和 Max 方案。

了解更多：从 Dispatch 开始会话

E

Effort level（努力级别）

控制 Claude 在每个回合中使用的自适应推理思考预算的设置。更高的努力意味着更多的思考令牌和更深入的推理；更低的努力则更快更便宜。Opus 4.7、Opus 4.6 和 Sonnet 4.6 支持努力级别。

了解更多：调整努力级别

Extended thinking（扩展思考）

模型在回复前执行的可见逐步推理。你可以使用 MAX_THINKING_TOKENS 限制思考令牌数量，或调整努力级别。在终端中，思考内容以灰色斜体文字显示。

了解更多：使用扩展思考

H

Hook（钩子）

用户定义的处理程序，在 Claude Code 生命周期的特定点自动执行，例如在工具运行前、文件编辑后或会话开始时。处理程序可以是 Shell 命令、HTTP 端点、MCP 工具、LLM 提示或子代理。钩子是确定性的：它们在固定的生命周期点触发，而不是由模型自行决定。

一个钩子配置包含三个层级：

• 钩子事件：生命周期点
• 匹配器：筛选触发的事件
• 钩子处理程序：实际执行的逻辑

了解更多：钩子入门 · 钩子参考

M

Managed settings（托管设置）

由 IT 或 DevOps 组织级强制执行的设置文件，放置在 ~/.claude 之外的 OS 级路径。用户无法覆盖或排除托管设置。用于安全策略、合规要求或跨一组机器标准化工具。

了解更多：服务器托管设置

MCP（模型上下文协议）

一种开放标准，用于将 AI 工具连接到外部数据源和服务。MCP 服务器为 Claude 提供新工具，用于 Slack、Jira、数据库、浏览器以及数百种其他集成。通过 /mcp 或将其添加到 .mcp.json 来连接服务器。关于协议本身，请参阅平台术语表。

了解更多：模型上下文协议

MCP Tool Search（MCP 工具搜索）

一种节省上下文的机制，将 MCP 工具模式推迟到需要时才加载。启动时仅加载工具名称；Claude 在决定使用某个特定工具时按需获取完整模式。这可以防止空闲的 MCP 服务器消耗大量上下文。

了解更多：使用 MCP Tool Search 进行扩展

N

Non-interactive mode（非交互模式）

执行单个提示后退出、无需对话会话的模式，通过 -p 或 --print 调用。用于 CI、脚本和管道。Agent SDK 是 Python 和 TypeScript 中的等效模式。旧称 headless 模式。

了解更多：以编程方式运行 Claude Code

O

Output style（输出样式）

修改 Claude 系统提示以改变响应行为、语气或格式的配置。输出样式会关闭默认系统提示中与软件工程相关的部分，而 CLAUDE.md 则作为用户消息在系统提示之后传递。内置样式包括 Default、Proactive、Explanatory 和 Learning。

了解更多：输出样式

P

Permission mode（权限模式）

会话的基线审批行为。在 CLI 中使用 Shift+Tab 切换，或在 VS Code、Desktop 和 claude.ai 中使用模式选择器。可用模式：default、acceptEdits、plan、auto、dontAsk、bypassPermissions。

了解更多：选择权限模式

Permission rule（权限规则）

基于工具名称和参数模式，允许、询问或拒绝工具调用的设置条目。规则按 deny→ask→allow 顺序评估，首个匹配胜出。权限规则是在更广义的权限模式之上叠加的细粒度控制。

了解更多：配置权限

Plan mode（计划模式）

一种权限模式，Claude 在不编辑源文件的情况下研究和提议更改。它可以读取、搜索和运行探索命令，然后提出计划以供批准再做任何事情。使用 /plan 或按 Shift+Tab 进入计划模式。

了解更多：使用计划模式在编辑前分析

Plugin（插件）

将技能、钩子、子代理和 MCP 服务器打包为单个可安装单元。插件技能以 plugin-name:skill-name 命名，以便多个插件共存。通过市场在团队间分发插件。

了解更多：插件

Project trust（项目信任）

在 Claude Code 加载其配置前接受目录的对话框。接受按项目目录保存，主目录除外（信任仅在当前会话有效，每次启动都会重新提示）。信任可关闭市场插件的自动安装和执行项目定义的钩子。信任一个目录意味着其 .claude/settings.json、.mcp.json 和其他配置文件生效。

了解更多：.claude 目录

Prompt injection（提示注入）

嵌入在文件、网页或工具结果中的恶意指令，试图将 Claude 引导到你从未要求的操作上。Claude Code 的防御措施包括权限系统、命令黑名单和信任验证。自动模式增加了一个服务器端探针，扫描工具结果中的可疑内容，以及一个从不查看工具结果的分类器，因此注入的文本无法影响其批准决策。

了解更多：防范提示注入

R

Remote Control（远程控制）

通过 claude.ai 从手机或浏览器继续本地 Claude Code 会话的方式。代码保留在你的机器上，仅 UI 远程。不同于在 Web 上运行的 Claude Code（在云端沙盒中运行）。

了解更多：远程控制

Rules（规则）

.claude/rules/ 中的模块化指令文件，随 CLAUDE.md 一同加载。规则可以使用 YAML paths: frontmatter 限定作用域路径，仅在 Claude 读取匹配文件时加载，从而在未用到时保持上下文精简。

了解更多：使用 .claude/rules/ 组织规则

S

Sandboxing（沙箱）

针对 Bash 工具的 OS 级文件系统和网络隔离。命令在你预先定义的边界内运行，因此 Claude 可以在此范围内自由工作，无需逐命令的批准提示。沙箱是与权限规则分开的独立层。

了解更多：沙箱

Session（会话）

与当前目录绑定的对话，拥有独立的上下文窗口。可调用 claude -c 恢复会话，使用 --fork-session 以保留历史记录并在新会话 ID 下继续，或跨终端并行运行。运行 /clear 开始新会话；之前的会话仍会存储，可通过 /resume 恢复。每个会话的转录存储在 ~/.claude/projects/ 下。

了解更多：使用会话工作

Settings layers（设置层级）

Claude Code 读取配置的层次结构，按优先级从高到低： 托管策略、命令行参数、.claude/settings.local.json 本地设置、.claude/settings.json 项目设置，然后是 ~/.claude/settings.json 用户设置。数组跨层级合并；标量值由较高层级覆盖较低层级。

了解更多：设置文件

Skill（技能）

一个 SKILL.md 文件，包含 Claude 添加到其工具包中的指令、知识或工作流。Claude 在相关时自动加载技能，或者你可以直接通过 /skill-name 调用。技能遵循 Agent Skills 开放标准；Claude Code 扩展了调用控制和对子代理的执行。

技能是自定义命令的推荐继任者。.claude/commands/deploy.md 文件和 .claude/skills/deploy/SKILL.md 文件都会创建 /deploy 并以相同方式工作；现有的命令文件继续有效。

了解更多：使用技能扩展 Claude

Subagent（子代理）

在独立的上下文窗口中运行的专业 AI 助手，具有自定义系统提示、特定工具访问权限和独立的权限。它处理委派的任务并将摘要返回给主对话。使用子代理将大型探索保持在主上下文之外，或运行并行研究。与代理团队不同，代理团队中的每个代理都是你可以直接对话的完整独立会话。

内置子代理包括 Explore、Plan 和通用类型。

了解更多：创建自定义子代理

Surface（接入表面）

你访问 Claude Code 的任何地方：CLI、VS Code、JetBrains、Desktop 或 claude.ai。所有表面共享相同的引擎，因此你的 CLAUDE.md、设置和技能在所有表面上以相同方式工作。Slack 和 Chrome 扩展是连接到表面而非表面本身的集成。

了解更多：平台和集成

T

Teleport（传送）

命令 /teleport，将云中的 Claude Code 会话拉取到本地终端。Claude 获取分支、加载对话历史并恢复到 Web 会话的最后状态。反向方向是 --remote，将本地任务发送到 Web 上运行。

了解更多：从 Web 到终端

Tool（工具）

Claude 可以执行的操作：读取文件、编辑代码、运行 Shell 命令、搜索网页、生成子代理。工具是 Claude Code 具备代理能力的关键。没有工具，Claude 只能返回文本。每次工具使用返回结果，指导 Claude 在代理循环中的下一步决策。

了解更多：Claude 可用的工具

Turn（回合）

Claude 在会话内的一次完整响应。一个回合从你发送消息开始，到 Claude 完成响应结束，其间可能包含任意数量的工具调用。停止钩子在每个回合结束时触发。一个会话由多个回合组成，代理循环描述了单个回合内部发生的事情。

了解更多：Claude Code 工作原理

W

Worktree isolation（工作树隔离）

一种隔离模式，在 .claude/worktrees/ 中创建单独的 Git 工作树运行 Claude，通过 -w 标志或在子代理配置中设置 isolation: worktree 启用。更改在单独的目录中保持在单独的分支上，因此并行代理不会互相覆盖文件。

了解更多：使用 Git 工作树运行并行会话

---

已弃用和重命名的术语

这些术语出现在较老的文档、博客文章和社区内容中。搜索本站时请使用当前名称。

旧术语	现在称为	备注
Headless mode	Non-interactive mode	相同的 -p 标志，相同行为
Custom commands	Skills	.claude/commands/ 文件仍然有效
Slash commands	Commands	产品文案中已移除“Slash”

常见问题

Claude Code 的 CLAUDE.md 文件是做什么的？

CLAUDE.md 是位于项目根目录或用户目录下的 Markdown 文件，用于定义持久指令、项目约定和规则。它在每次会话开始时作为用户消息加载，不会被压缩丢弃，可引导 Claude 的行为。

代理团队（Agent teams）和子代理（subagent）有什么区别？

代理团队是多个独立会话协作，共享任务列表，彼此可直接通信；每个成员有独立上下文窗口。子代理是在主会话内触发、运行在独立上下文窗口中的单个专业代理，完成后只向父级返回摘要，无法被直接对话。

自动模式（Auto mode）对会话操作有什么限制？

自动模式使用后台分类器自动审批工具调用，不显示批准提示。它能拦截作用域升级、不可信基础设施和提示注入，且分类器不查看工具结果，因此注入的恶意指令无法影响审批决策。该模式为研究预览，适用于所有 Anthropic API 用户。