> ## Documentation Index > Fetch the complete documentation index at: https://docs.openclaude.app/llms.txt > Use this file to discover all available pages before exploring further. # 扩展 Claude Code > 了解何时使用 CLAUDE.md、Skills、subagents、hooks、MCP 和 plugins。 Claude Code 结合了一个能够推理代码的模型和[内置工具](/claude-code/02-core-concepts/01-how-claude-code-works#tools)，用于文件操作、搜索、执行和网络访问。内置工具涵盖了大多数编码任务。本指南涵盖扩展层：您添加的功能，用于自定义 Claude 的知识、将其连接到外部服务并自动化工作流。 有关核心代理循环如何工作的信息，请参阅[Claude Code 如何工作](/claude-code/02-core-concepts/01-how-claude-code-works)。 **初次使用 Claude Code？** 从[CLAUDE.md](/claude-code/07-configuration/03-memory)开始了解项目约定。根据需要添加其他扩展。 ## 概述 扩展插入代理循环的不同部分： * **[CLAUDE.md](/claude-code/07-configuration/03-memory)** 添加 Claude 每个会话都能看到的持久上下文 * **[Skills](/claude-code/04-build-with-claude/01-skills)** 添加可重用的知识和可调用的工作流 * **[MCP](/claude-code/04-build-with-claude/05-mcp)** 将 Claude 连接到外部服务和工具 * **[Subagents](/claude-code/04-build-with-claude/02-sub-agents)** 在隔离的上下文中运行自己的循环，返回摘要 * **[Agent teams](/claude-code/05-deployment/04-agent-teams)** 协调多个独立会话，具有共享任务和点对点消息传递 * **[Hooks](/claude-code/04-build-with-claude/03-hooks)** 完全在循环外运行作为确定性脚本 * **[Plugins](/claude-code/04-build-with-claude/06-plugins)** 和 **[marketplaces](/claude-code/04-build-with-claude/09-plugin-marketplaces)** 打包和分发这些功能 [Skills](/claude-code/04-build-with-claude/01-skills) 是最灵活的扩展。Skill 是一个包含知识、工作流或说明的 markdown 文件。您可以使用斜杠命令（如 `/deploy`）调用 skills，或者 Claude 可以在相关时自动加载它们。Skills 可以在您当前的对话中运行，也可以通过 subagents 在隔离的上下文中运行。 ## 将功能与您的目标相匹配 功能范围从 Claude 每个会话都能看到的始终开启的上下文，到您或 Claude 可以调用的按需功能，再到在特定事件上运行的后台自动化。下表显示了可用的功能以及何时使用每个功能。 | 功能 | 作用 | 何时使用 | 示例 | | ------------------------------------------------------------ | ---------------------- | --------------------- | ----------------------------------------- | | **CLAUDE.md** | 每次对话加载的持久上下文 | 项目约定、"始终执行 X"规则 | "使用 pnpm，而不是 npm。在提交前运行测试。" | | **Skill** | Claude 可以使用的说明、知识和工作流 | 可重用内容、参考文档、可重复任务 | `/review` 运行您的代码审查清单；带有端点模式的 API 文档 skill | | **Subagent** | 返回摘要结果的隔离执行上下文 | 上下文隔离、并行任务、专门工作者 | 读取许多文件但仅返回关键发现的研究任务 | | **[Agent teams](/claude-code/05-deployment/04-agent-teams)** | 协调多个独立的 Claude Code 会话 | 并行研究、新功能开发、使用竞争假设进行调试 | 生成审查者同时检查安全性、性能和测试 | | **MCP** | 连接到外部服务 | 外部数据或操作 | 查询您的数据库、发布到 Slack、控制浏览器 | | **Hook** | 在事件上运行的确定性脚本 | 可预测的自动化，不涉及 LLM | 每次文件编辑后运行 ESLint | **[Plugins](/claude-code/04-build-with-claude/06-plugins)** 是打包层。Plugin 将 skills、hooks、subagents 和 MCP servers 捆绑到单个可安装单元中。Plugin skills 是命名空间的（如 `/my-plugin:review`），因此多个 plugins 可以共存。当您想在多个存储库中重用相同的设置或通过 **[marketplace](/claude-code/04-build-with-claude/09-plugin-marketplaces)** 分发给他人时，使用 plugins。 ### 比较相似的功能 某些功能可能看起来相似。以下是如何区分它们。 Skills 和 subagents 解决不同的问题： * **Skills** 是可重用的内容，您可以将其加载到任何上下文中 * **Subagents** 是与主对话分开运行的隔离工作者 | 方面 | Skill | Subagent | | -------- | ------------- | -------------------- | | **它是什么** | 可重用的说明、知识或工作流 | 具有自己上下文的隔离工作者 | | **主要优势** | 在上下文之间共享内容 | 上下文隔离。工作单独进行，仅返回摘要 | | **最适合** | 参考材料、可调用的工作流 | 读取许多文件的任务、并行工作、专门工作者 | **Skills 可以是参考或操作。** 参考 skills 提供 Claude 在整个会话中使用的知识（如您的 API 风格指南）。操作 skills 告诉 Claude 执行特定操作（如运行您的部署工作流的 `/deploy`）。 **当您需要上下文隔离或上下文窗口变满时，使用 subagent**。Subagent 可能读取数十个文件或运行广泛的搜索，但您的主对话仅接收摘要。由于 subagent 工作不消耗您的主上下文，当您不需要中间工作保持可见时，这也很有用。自定义 subagents 可以有自己的说明，并可以预加载 skills。 **它们可以结合。** Subagent 可以预加载特定的 skills（`skills:` 字段）。Skill 可以使用 `context: fork` 在隔离的上下文中运行。有关详细信息，请参阅 [Skills](/claude-code/04-build-with-claude/01-skills)。 两者都存储说明，但它们的加载方式和用途不同。 | 方面 | CLAUDE.md | Skill | | ----------- | --------------- | --------------- | | **加载** | 每个会话，自动 | 按需 | | **可以包含文件** | 是，使用 `@path` 导入 | 是，使用 `@path` 导入 | | **可以触发工作流** | 否 | 是，使用 `/` | | **最适合** | "始终执行 X"规则 | 参考材料、可调用的工作流 | **如果 Claude 应该始终知道它，请将其放在 CLAUDE.md 中**：编码约定、构建命令、项目结构、"永远不要执行 X"规则。 **如果它是参考材料 Claude 有时需要（API 文档、风格指南）或您使用 `/` 触发的工作流（部署、审查、发布），请将其放在 skill 中**。 **经验法则：** 保持 CLAUDE.md 在约 500 行以下。如果它在增长，将参考内容移到 skills。 两者都并行化工作，但它们在架构上是不同的： * **Subagents** 在您的会话内运行并将结果报告回您的主上下文 * **Agent teams** 是相互通信的独立 Claude Code 会话 | 方面 | Subagent | Agent team | | -------- | ----------------- | --------------------- | | **上下文** | 自己的上下文窗口；结果返回给调用者 | 自己的上下文窗口；完全独立 | | **通信** | 仅向主代理报告结果 | 队友直接相互发送消息 | | **协调** | 主代理管理所有工作 | 具有自我协调的共享任务列表 | | **最适合** | 仅结果重要的专注任务 | 需要讨论和协作的复杂工作 | | **令牌成本** | 较低：结果摘要返回到主上下文 | 较高：每个队友是单独的 Claude 实例 | **当您需要快速、专注的工作者时，使用 subagent**：研究问题、验证声明、审查文件。Subagent 完成工作并返回摘要。您的主对话保持清洁。 **当队友需要共享发现、相互质疑和独立协调时，使用 agent team**。Agent teams 最适合具有竞争假设的研究、并行代码审查以及每个队友拥有单独部分的新功能开发。 **过渡点：** 如果您运行并行 subagents 但遇到上下文限制，或者您的 subagents 需要相互通信，agent teams 是自然的下一步。 Agent teams 是实验性的，默认禁用。有关设置和当前限制，请参阅 [agent teams](/claude-code/05-deployment/04-agent-teams)。 MCP 将 Claude 连接到外部服务。Skills 扩展 Claude 的知识，包括如何有效地使用这些服务。 | 方面 | MCP | Skill | | -------- | -------------------- | --------------------- | | **它是什么** | 连接到外部服务的协议 | 知识、工作流和参考材料 | | **提供** | 工具和数据访问 | 知识、工作流和参考材料 | | **示例** | Slack 集成、数据库查询、浏览器控制 | 代码审查清单、部署工作流、API 风格指南 | 这些解决不同的问题，可以很好地协同工作： **MCP** 给予 Claude 与外部系统交互的能力。没有 MCP，Claude 无法查询您的数据库或发布到 Slack。 **Skills** 给予 Claude 关于如何有效使用这些工具的知识，以及您可以使用 `/` 触发的工作流。Skill 可能包括您团队的数据库架构和查询模式，或带有您团队消息格式规则的 `/post-to-slack` 工作流。 示例：MCP server 将 Claude 连接到您的数据库。Skill 教导 Claude 您的数据模型、常见查询模式以及用于不同任务的表。 ### 了解功能如何分层 功能可以在多个级别定义：用户范围、按项目、通过 plugins 或通过托管策略。您还可以在子目录中嵌套 CLAUDE.md 文件或在 monorepo 的特定包中放置 skills。当相同的功能存在于多个级别时，以下是它们的分层方式： * **CLAUDE.md 文件** 是累加的：所有级别同时向 Claude 的上下文贡献内容。来自您的工作目录及以上的文件在启动时加载；子目录在您在其中工作时加载。当说明冲突时，Claude 使用判断来协调它们，更具体的说明通常优先。有关详细信息，请参阅[Claude 如何查找记忆](/claude-code/07-configuration/03-memory#how-claude-looks-up-memories)。 * **Skills 和 subagents** 按名称覆盖：当相同的名称存在于多个级别时，一个定义根据优先级获胜（对于 skills 为托管 > 用户 > 项目；对于 subagents 为托管 > CLI 标志 > 项目 > 用户 > plugin）。Plugin skills 是[命名空间的](/claude-code/04-build-with-claude/06-plugins#add-skills-to-your-plugin)以避免冲突。有关详细信息，请参阅 [skill 发现](/claude-code/04-build-with-claude/01-skills#where-skills-live)和 [subagent 范围](/claude-code/04-build-with-claude/02-sub-agents#choose-the-subagent-scope)。 * **MCP servers** 按名称覆盖：本地 > 项目 > 用户。有关详细信息，请参阅 [MCP 范围](/claude-code/04-build-with-claude/05-mcp#scope-hierarchy-and-precedence)。 * **Hooks** 合并：所有注册的 hooks 为其匹配的事件触发，无论来源如何。有关详细信息，请参阅 [hooks](/claude-code/04-build-with-claude/03-hooks)。 ### 组合功能 每个扩展解决不同的问题：CLAUDE.md 处理始终开启的上下文，skills 处理按需知识和工作流，MCP 处理外部连接，subagents 处理隔离，hooks 处理自动化。真实的设置根据您的工作流组合它们。 例如，您可能使用 CLAUDE.md 处理项目约定、使用 skill 处理部署工作流、使用 MCP 连接到数据库，以及使用 hook 在每次编辑后运行 linting。每个功能处理它最擅长的事情。 | 模式 | 工作原理 | 示例 | | ---------------------- | -------------------------------------- | ----------------------------------------------- | | **Skill + MCP** | MCP 提供连接；skill 教导 Claude 如何很好地使用它 | MCP 连接到您的数据库，skill 记录您的架构和查询模式 | | **Skill + Subagent** | Skill 为并行工作生成 subagents | `/review` skill 启动在隔离上下文中工作的安全性、性能和风格 subagents | | **CLAUDE.md + Skills** | CLAUDE.md 保存始终开启的规则；skills 保存按需加载的参考材料 | CLAUDE.md 说"遵循我们的 API 约定"，skill 包含完整的 API 风格指南 | | **Hook + MCP** | Hook 通过 MCP 触发外部操作 | 编辑后 hook 在 Claude 修改关键文件时发送 Slack 通知 | ## 了解上下文成本 您添加的每个功能都会消耗 Claude 的一些上下文。太多可能会填满您的上下文窗口，但它也可能增加噪音，使 Claude 效率降低；skills 可能无法正确触发，或 Claude 可能会忘记您的约定。了解这些权衡有助于您构建有效的设置。 ### 按功能的上下文成本 每个功能都有不同的加载策略和上下文成本： | 功能 | 何时加载 | 加载内容 | 上下文成本 | | --------------- | ---------- | ----------------- | ----------------- | | **CLAUDE.md** | 会话开始 | 完整内容 | 每个请求 | | **Skills** | 会话开始 + 使用时 | 启动时的描述，使用时的完整内容 | 低（每个请求的描述）\* | | **MCP servers** | 会话开始 | 所有工具定义和架构 | 每个请求 | | **Subagents** | 生成时 | 具有指定 skills 的新上下文 | 与主会话隔离 | | **Hooks** | 触发时 | 无（外部运行） | 零，除非 hook 返回额外上下文 | \*默认情况下，skill 描述在会话开始时加载，以便 Claude 可以决定何时使用它们。在 skill 的 frontmatter 中设置 `disable-model-invocation: true` 以将其从 Claude 完全隐藏，直到您手动调用它。这将仅在您自己触发的 skills 的上下文成本降低到零。 ### 了解功能如何加载 每个功能在会话的不同点加载。下面的选项卡说明每个功能何时加载以及什么进入上下文。 上下文加载：CLAUDE.md 和 MCP 在会话开始时加载并保留在每个请求中。Skills 在启动时加载描述，在调用时加载完整内容。Subagents 获得隔离的上下文。Hooks 外部运行。 **何时：** 会话开始 **加载内容：** 所有 CLAUDE.md 文件的完整内容（托管、用户和项目级别）。 **继承：** Claude 从您的工作目录读取 CLAUDE.md 文件到根目录，并在访问这些文件时在子目录中发现嵌套的文件。有关详细信息，请参阅[Claude 如何查找记忆](/claude-code/07-configuration/03-memory#how-claude-looks-up-memories)。 保持 CLAUDE.md 在约 500 行以下。将参考材料移到按需加载的 skills。 Skills 是 Claude 工具包中的额外功能。它们可以是参考材料（如 API 风格指南）或您使用 `/` 触发的可调用工作流（如 `/deploy`）。有些是内置的；您也可以创建自己的。Claude 在适当时使用 skills，或者您可以直接调用一个。 **何时：** 取决于 skill 的配置。默认情况下，描述在会话开始时加载，完整内容在使用时加载。对于仅用户 skills（`disable-model-invocation: true`），在您调用它们之前不会加载任何内容。 **加载内容：** 对于模型可调用的 skills，Claude 在每个请求中看到名称和描述。当您使用 `/` 调用 skill 或 Claude 自动加载它时，完整内容加载到您的对话中。 **Claude 如何选择 skills：** Claude 将您的任务与 skill 描述相匹配，以决定哪些相关。如果描述模糊或重叠，Claude 可能加载错误的 skill 或错过会有帮助的。要告诉 Claude 使用特定的 skill，请使用 `/` 调用它。具有 `disable-model-invocation: true` 的 Skills 对 Claude 不可见，直到您调用它们。 **上下文成本：** 低，直到使用。仅用户 skills 在调用前成本为零。 **在 subagents 中：** Skills 在 subagents 中的工作方式不同。Skills 不是按需加载，而是传递给 subagent 的 skills 在启动时完全预加载到其上下文中。Subagents 不从主会话继承 skills；您必须明确指定它们。 对具有副作用的 skills 使用 `disable-model-invocation: true`。这节省上下文并确保仅您触发它们。 **何时：** 会话开始。 **加载内容：** 来自连接的服务器的所有工具定义和 JSON 架构。 **上下文成本：** [工具搜索](/claude-code/04-build-with-claude/05-mcp#scale-with-mcp-tool-search)（默认启用）将 MCP 工具加载到上下文的 10%，并推迟其余的直到需要。 **可靠性说明：** MCP 连接可能在会话中途无声地失败。如果服务器断开连接，其工具会无警告地消失。Claude 可能尝试使用不再存在的工具。如果您注意到 Claude 无法使用它之前可以访问的 MCP 工具，请使用 `/mcp` 检查连接。 运行 `/mcp` 查看每个服务器的令牌成本。断开您未主动使用的服务器。 **何时：** 按需，当您或 Claude 为任务生成一个时。 **加载内容：** 新的、隔离的上下文，包含： * 系统提示（与父级共享以提高缓存效率） * 代理的 `skills:` 字段中列出的 skills 的完整内容 * CLAUDE.md 和 git 状态（从父级继承） * 主代理在提示中传入的任何上下文 **上下文成本：** 与主会话隔离。Subagents 不继承您的对话历史或调用的 skills。 对不需要您完整对话上下文的工作使用 subagents。它们的隔离防止膨胀您的主会话。 **何时：** 触发时。Hooks 在特定生命周期事件（如工具执行、会话边界、提示提交、权限请求和压缩）时触发。有关完整列表，请参阅 [Hooks](/claude-code/04-build-with-claude/03-hooks)。 **加载内容：** 默认情况下无。Hooks 作为外部脚本运行。 **上下文成本：** 零，除非 hook 返回添加为消息到您的对话的输出。 Hooks 非常适合不需要影响 Claude 上下文的副作用（linting、logging）。 ## 了解更多 每个功能都有自己的指南，包含设置说明、示例和配置选项。 存储项目上下文、约定和说明 给予 Claude 领域专业知识和可重用工作流 将工作卸载到隔离的上下文 协调多个并行工作的会话 将 Claude 连接到外部服务 使用 hooks 自动化工作流 捆绑和共享功能集 托管和分发 plugin 集合