{/* TRANSLATED — 已翻译为中文 */}

> ## 文档索引
> 获取完整文档索引：https://code.claude.com/docs/llms.txt
> 使用此文件发现所有可用页面，然后再进一步探索。

# 术语表

> Claude Code 术语定义。了解代理循环、压缩、CLAUDE.md、钩子、子代理、MCP 及其他核心概念的含义。

本术语表定义了 Claude Code 的术语。每个条目都链接到深入介绍该概念的页面。有关 token、temperature 和 RAG 等模型级概念，请参阅[平台术语表](https://platform.claude.com/docs/en/about-claude/glossary)。

## A

### 代理团队

由团队负责人协调的多个独立 Claude Code 会话，具有共享的任务列表和对等消息传递。与[子代理](#子代理)不同，子代理在单个会话中运行且仅向父级报告，而队友各自拥有自己的上下文窗口，您可以直接与其中任何一个交互。代理团队是实验性功能，必须通过设置 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` 来启用。

了解更多：[运行代理团队](/en/agent-teams)

### 代理编码

一种工作流程，AI 可以自主读取文件、运行命令和进行更改，而您可以观察、重定向或离开，与仅以文本形式响应并需要您自行应用的聊天助手不同。Claude Code 是代理式的，因为它拥有[工具](#工具)使其能够行动，而不仅仅是建议。

了解更多：[Claude Code 的工作原理](/en/how-claude-code-works)

### 代理框架

将语言模型转变为有能力的编码代理的工具、上下文管理和执行环境。Claude Code 是框架；Claude 是其中的模型。框架提供文件访问、shell 执行、权限控制、内存加载以及将操作链接在一起的循环。

了解更多：[Claude Code 的工作原理](/en/how-claude-code-works)

### 代理循环

Claude 为每个任务执行的循环：收集上下文、采取行动、验证结果，然后重复直到完成。每次工具使用都会返回信息，为下一步提供依据。您可以在任何时候中断循环以重定向。大多数扩展点，包括[钩子](#钩子)、[技能](#技能)和 [MCP](#mcp-model-context-protocol)，都插入到此循环的特定阶段。

了解更多：[Claude Code 的工作原理](/en/how-claude-code-works#the-agentic-loop)

### 自动记忆

Claude 根据您的纠正和偏好为自己编写的笔记，按 git 仓库存储在 `~/.claude/projects/` 下。同一仓库的所有工作树共享一个自动记忆目录。`MEMORY.md` 索引的前 200 行或 25 KB 在每次会话开始时加载。自动记忆是 Claude 编写的[CLAUDE.md](#claudemd) 的对应物，后者由您编写。

了解更多：[自动记忆](/en/memory#auto-memory)

### 自动模式

一种[权限模式](#权限模式)，其中单独的分类器模型在后台审查每个操作，而不是向您显示审批提示。分类器阻止范围升级、不受信任的基础设施和[提示注入](#提示注入)。它永远不会看到工具结果，因此注入的指令无法影响其决策。自动模式是研究预览功能，对所有 Anthropic API 用户可用。

了解更多：[使用自动模式消除提示](/en/permission-modes#eliminate-prompts-with-auto-mode)

## B

### 裸模式

一个启动标志 `--bare`，跳过钩子、技能、插件、MCP 服务器、自动记忆和 CLAUDE.md 的自动发现。只有您明确传递的标志才会生效。推荐用于 CI 和脚本调用，您需要在不同机器上获得一致的行为，无论本地配置如何。

了解更多：[使用裸模式更快启动](/en/headless#start-faster-with-bare-mode)

### 内置技能

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

了解更多：[内置技能](/en/skills#bundled-skills)

## C

### 通道

一个 [MCP 服务器](#mcp-model-context-protocol)，将事件推送到您正在运行的会话中，以便 Claude 可以对您离开终端时发生的事情做出反应。通道可以是双向的：Claude 读取入站事件并通过同一通道回复。Telegram、Discord 和 iMessage 包含在研究预览中。

了解更多：[通道](/en/channels)

### 检查点

在您发送的每个提示处创建的恢复点。Claude Code 在每次编辑前对文件进行快照，以便检查点可以还原它们。按两次 `Esc` 或运行 `/rewind` 将代码、对话或两者恢复到较早的点，或从所选消息开始总结对话的一部分。检查点对会话是本地的，与 git 分开，且不跟踪通过 Bash 工具所做的更改。

了解更多：[检查点](/en/checkpointing)

### `.claude` 目录

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

了解更多：[`.claude` 目录](/en/claude-directory)

### CLAUDE.md

您为 Claude 编写的持久指令的 markdown 文件，在每次会话开始时作为系统提示之后的用户消息加载。将项目约定、架构说明和"始终执行 X"的规则放在这里。CLAUDE.md 在[压缩](#压缩)后仍然存在，并在之后从磁盘重新读取。

您可以将 CLAUDE.md 放在项目范围的 `./CLAUDE.md` 或 `./.claude/CLAUDE.md`，用户范围的 `~/.claude/CLAUDE.md`，或作为组织的[托管策略](#托管设置)。更具体的位置优先。

了解更多：[CLAUDE.md 文件](/en/memory#claude-md-files)

### 命令

您通过在提示中输入 `/name` 调用的可重用指令。内置命令如 `/clear`、`/model` 和 `/compact` 控制会话。您可以将自己的命令定义为 `.claude/commands/` 中的文件，或从[插件](#插件)安装它们。[技能](#技能)是打包多步命令的推荐方式。

了解更多：[命令](/en/commands) · [技能](/en/skills)

### 压缩

当[上下文窗口](#上下文窗口)接近其限制时自动总结您的对话。较旧的工具输出首先被清除，然后对话被总结。项目根目录的 CLAUDE.md 和自动记忆在压缩后仍然存在并从磁盘重新加载；仅在对话中给出的指令可能会丢失。运行 `/compact` 手动触发，可选择指定重点，如 `/compact focus on the API changes`。

了解更多：[压缩后保留的内容](/en/context-window#what-survives-compaction) · [当上下文填满时](/en/how-claude-code-works#when-context-fills-up)

### 上下文窗口

会话的工作内存，保存对话历史、文件内容、命令输出、CLAUDE.md、自动记忆、已加载的技能和系统指令。随着您工作，上下文会填满，直到[压缩](#压缩)对其进行总结。运行 `/context` 查看什么在占用空间。有关底层模型概念，请参阅[平台术语表](https://platform.claude.com/docs/en/about-claude/glossary#context-window)。

了解更多：[探索上下文窗口](/en/context-window)

## D

### 分发

一个电话发起的任务路由器，当您从 Claude 移动应用发送编码任务时，在桌面应用中生成 Claude Code 会话。您的提示会自动路由到正确的工具。在 Pro 和 Max 计划上可用。

了解更多：[来自分发的会话](/en/desktop#sessions-from-dispatch)

## E

### 努力级别

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

了解更多：[调整努力级别](/en/model-config#adjust-effort-level)

### 扩展思考

模型在响应之前执行的可见的逐步推理。您可以通过 `MAX_THINKING_TOKENS` 限制思考 token 或调整[努力级别](#努力级别)。思考以灰色斜体文本显示在终端中。

了解更多：[使用扩展思考](/en/model-config#extended-thinking)

## H

### 钩子

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

钩子配置有三个级别：

* **钩子事件**：生命周期点
* **匹配器**：过滤哪些事件触发它
* **钩子处理器**：运行什么

了解更多：[钩子入门](/en/hooks-guide) · [钩子参考](/en/hooks)

## M

### 托管设置

由 IT 或 DevOps 在全组织范围内强制执行的设置文件，放置在 `~/.claude` 之外的操作系统级路径。用户无法覆盖或排除托管设置。用于安全策略、合规要求或整个团队的标准化工具。

了解更多：[服务器管理设置](/en/server-managed-settings)

### MCP（模型上下文协议）

将 AI 工具连接到外部数据源和服务的开放标准。MCP 服务器为 Claude 提供 Slack、Jira、数据库、浏览器和数百种其他集成的新工具。您通过 `/mcp` 或将它们添加到 `.mcp.json` 来连接服务器。有关协议本身，请参阅[平台术语表](https://platform.claude.com/docs/en/about-claude/glossary#mcp-model-context-protocol)。

了解更多：[模型上下文协议](/en/mcp)

### MCP 工具搜索

一种节省上下文的机制，延迟 MCP 工具模式直到需要时才加载。启动时仅加载工具名称；当 Claude 决定使用特定工具时，它按需获取完整的模式。这使空闲的 MCP 服务器不会消耗太多上下文。

了解更多：[使用 MCP 工具搜索扩展](/en/mcp#scale-with-mcp-tool-search)

## N

### 非交互模式

一种执行单个提示并退出而没有对话会话的模式，使用 `-p` 或 `--print` 调用。用于 CI、脚本和管道。[Agent SDK](/en/agent-sdk/overview) 是 Python 和 TypeScript 的等效物。以前称为无头模式。

了解更多：[以编程方式运行 Claude Code](/en/headless)

## O

### 输出样式

修改 Claude 系统提示以更改响应行为、语气或格式的配置。输出样式关闭默认系统提示中特定于软件工程的部分，而 [CLAUDE.md](#claudemd) 作为系统提示之后的用户消息传递。内置样式包括 Default、Proactive、Explanatory 和 Learning。

了解更多：[输出样式](/en/output-styles)

## P

### 权限模式

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

了解更多：[选择权限模式](/en/permission-modes)

### 权限规则

一个设置条目，根据工具名称和参数模式允许、询问或拒绝工具调用。规则按 deny→ask→allow 评估，第一个匹配的获胜。权限规则是在更广泛的[权限模式](#权限模式)之上分层的细粒度控制。

了解更多：[配置权限](/en/permissions)

### 计划模式

一种[权限模式](#权限模式)，Claude 在不编辑源文件的情况下研究和提出更改。它可以读取、搜索和运行探索命令，然后在触及任何内容之前提出计划供批准。使用 `/plan` 或按 `Shift+Tab` 进入计划模式。

了解更多：[使用计划模式在编辑前分析](/en/permission-modes#analyze-before-you-edit-with-plan-mode)

### 插件

技能、钩子、子代理和 MCP 服务器打包为单个可安装单元。插件技能使用 `plugin-name:skill-name` 命名空间，以便多个插件共存。通过[应用市场](/en/plugin-marketplaces)在团队间分发插件。

了解更多：[插件](/en/plugins)

### 项目信任

在 Claude Code 加载其配置之前接受目录的对话框。接受信息按项目目录保存，但主目录除外，在主目录中信任仅对当前会话有效，提示在每次启动时重新出现。信任控制应用市场插件的自动安装和项目定义钩子的执行。信任目录意味着其 `.claude/settings.json`、`.mcp.json` 和其他配置文件生效。

了解更多：[`.claude` 目录](/en/claude-directory)

### 提示注入

嵌入在文件、网页或工具结果中的恶意指令，试图将 Claude 重定向到您从未要求的操作。Claude Code 的防御包括权限系统、命令阻止列表和信任验证。[自动模式](#自动模式)添加了一个服务器端探测器，扫描工具结果中的可疑内容，以及一个永远不会看到工具结果的分类器，因此注入的文本无法影响其审批决策。

了解更多：[防范提示注入](/en/security#protect-against-prompt-injection)

## R

### 远程控制

通过 claude.ai 从手机或浏览器继续本地 Claude Code 会话的方式。您的代码保留在您的机器上；只有 UI 是远程的。与在云端沙箱中运行的网页版 Claude Code 不同。

了解更多：[远程控制](/en/remote-control)

### 规则

`.claude/rules/` 中的模块化指令文件，与 CLAUDE.md 一起加载。规则可以使用 YAML `paths:` frontmatter 设置路径范围，使其仅在 Claude 读取匹配文件时加载，保持上下文精简直到相关。

了解更多：[使用 `.claude/rules/` 组织规则](/en/memory#organize-rules-with-claude/rules/)

## S

### 沙箱

Bash 工具的操作系统级文件系统和网络隔离。命令在您预先定义的边界内运行，因此 Claude 可以在其中自由工作，无需每条命令的审批提示。沙箱是与[权限规则](#权限规则)分开的层。

了解更多：[沙箱](/en/sandboxing)

### 会话

绑定到当前目录的对话，拥有自己独立的[上下文窗口](#上下文窗口)。会话可以用 `claude -c` 恢复，用 `--fork-session` 分叉以在新会话 ID 下保留历史记录，或跨终端并行运行。运行 `/clear` 开始新会话；之前的会话保持存储，可通过 `/resume` 访问。每个会话的记录存储在 `~/.claude/projects/` 下。

了解更多：[使用会话工作](/en/how-claude-code-works#work-with-sessions)

### 设置层级

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

了解更多：[设置文件](/en/settings#settings-files)

### 技能

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

技能是自定义命令的推荐替代品。`.claude/commands/deploy.md` 的文件和 `.claude/skills/deploy/SKILL.md` 的文件都创建 `/deploy` 且工作方式相同；现有命令文件继续工作。

了解更多：[使用技能扩展 Claude](/en/skills)

### 子代理

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

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

了解更多：[创建自定义子代理](/en/sub-agents)

### 界面

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

了解更多：[平台和集成](/en/platforms)

## T

### 传送

一个命令 `/teleport`，将云端 Claude Code 会话拉入您的本地终端。Claude 获取分支、加载对话历史，并从网页会话的最后状态恢复。反向操作是 `--remote`，将本地任务发送到网页运行。

了解更多：[从网页到终端](/en/claude-code-on-the-web#from-web-to-terminal)

### 工具

Claude 可以采取的操作：读取文件、编辑代码、运行 shell 命令、搜索网页、生成子代理。工具使 Claude Code 具有代理性。没有它们，Claude 只能以文本形式响应。每次工具使用都返回一个结果，为 Claude 在[代理循环](#代理循环)中的下一个决策提供信息。

了解更多：[Claude 可用的工具](/en/tools-reference)

### 轮次

[会话](#会话)中 Claude 的一次完整响应。轮次从您发送消息开始，到 Claude 完成响应结束，中间可以有任意数量的[工具](#工具)调用。[停止钩子](#钩子)在每轮结束时触发。一个会话由许多轮次组成，[代理循环](#代理循环)描述了其中一个轮次内发生的事情。

了解更多：[Claude Code 的工作原理](/en/how-claude-code-works#the-agentic-loop)

## W

### 工作树隔离

一种隔离模式，在 `.claude/worktrees/` 下的单独 git 工作树中运行 Claude，使用 `-w` 标志或子代理配置中的 `isolation: worktree` 启用。更改保留在单独目录的单独分支上，因此并行代理不会覆盖彼此的文件。

了解更多：[使用 git 工作树运行并行会话](/en/worktrees)

---

## 已弃用和重命名的术语

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

| 旧术语 | 现称为 | 备注 |
| --- | --- | --- |
| Headless mode | [非交互模式](#非交互模式) | 相同的 `-p` 标志，相同的行为 |
| Custom commands | [技能](#技能) | `.claude/commands/` 文件仍然有效 |
| Slash commands | Commands | 产品文案中已去掉"Slash" |