文档索引

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

术语表

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

本术语表定义了 Claude Code 的术语。每个条目都链接到深入介绍该概念的页面。有关 token、temperature 和 RAG 等模型级概念，请参阅平台术语表。

A

代理团队

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

了解更多：运行代理团队

代理编码

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

了解更多：Claude Code 的工作原理

代理框架

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

了解更多：Claude Code 的工作原理

代理循环

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

了解更多：Claude Code 的工作原理

自动记忆

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

了解更多：自动记忆

自动模式

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

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

B

裸模式

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

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

内置技能

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

了解更多：内置技能

C

通道

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

了解更多：通道

检查点

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

了解更多：检查点

.claude 目录

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

了解更多：.claude 目录

CLAUDE.md

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

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

了解更多：CLAUDE.md 文件

命令

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

了解更多：命令 · 技能

压缩

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

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

上下文窗口

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

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

D

分发

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

了解更多：来自分发的会话

E

努力级别

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

了解更多：调整努力级别

扩展思考

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

了解更多：使用扩展思考

H

钩子

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

钩子配置有三个级别：

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

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

M

托管设置

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

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

MCP（模型上下文协议）

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

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

MCP 工具搜索

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

了解更多：使用 MCP 工具搜索扩展

N

非交互模式

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

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

O

输出样式

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

了解更多：输出样式

P

权限模式

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

了解更多：选择权限模式

权限规则

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

了解更多：配置权限

计划模式

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

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

插件

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

了解更多：插件

项目信任

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

了解更多：.claude 目录

提示注入

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

了解更多：防范提示注入

R

远程控制

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

了解更多：远程控制

规则

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

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

S

沙箱

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

了解更多：沙箱

会话

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

了解更多：使用会话工作

设置层级

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

了解更多：设置文件

技能

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

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

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

子代理

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

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

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

界面

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

了解更多：平台和集成

T

传送

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

了解更多：从网页到终端

工具

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

了解更多：Claude 可用的工具

轮次

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

了解更多：Claude Code 的工作原理

W

工作树隔离

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

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

已弃用和重命名的术语

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