Claude Code 扩展组件架构

Wiki route

[!info] TL;DR 出处:2026-04-16 收到的 5 张架构图(微信公众号「童童的 AI 创业圈」)。以下是图片内容的完整文本化。

Claude Code 的 Agentic Loop(Plan → Act → Observe → Reflect)通过 6种扩展组件获得能力。

组件	角色	适用场景	示例
CLAUDE.md	保持持久化上下文,每次会话自动加载	Project Specs(项目规范、全局规则)	使用 pnpm;提交前测试
Skills	可复用的功能模块(知识、指令、工作流),按需加载	Reference Docs / Standard Tasks	”/deploy 执行部署”
Subagent	独立的子 Agent。在独立上下文中运行,返回结果摘要	Context Isolation / Parallel Tasks	解析文件并返回结论
Agent Teams	多个 Agent 协同,共享任务列表并相互通信	Parallel Research / Complex Dev	启动多个 reviewer
MCP	连接外部系统与工具,访问外部数据/操作	External Data / Actions	DB 查询;Slack 发送
Hook	循环外的自动化脚本。在特定事件触发	Deterministic Automation	变更后运行 ESLint

通常组合使用:MCP 提供连接,Skills 定义用法。

组件可打包为 Plugin 进行分发。

Plugin(插件)
  ├── Skills
  ├── Hooks
  ├── Subagents
  └── MCP Servers
         ↓
    Marketplace(将扩展功能打包分发)

Skills 使用命名空间(例:/my-plugin:review)避免冲突。

组件以 4 层叠加(additive):

用户级
  ↓
项目级
  ↓
插件级
  ↓
管理策略级

所有层级的 CLAUDE.md 文件都会被加载,并合并进对话的上下文。冲突解决:更具体的规则优先。

每个扩展组件都会消耗模型的上下文窗口。

组件	加载时机	加载内容	上下文成本
CLAUDE.md	会话开始时	全部内容	每次请求(高)
Skills	会话开始时 + 调用时	说明 + 全部内容	较低
MCP Servers	会话开始时	工具定义	每次请求(高)
Subagents	创建时	独立上下文	与主会话隔离
Hooks	触发时	默认无	零

需要在功能与成本之间取得平衡。Tips:设置 disable-model-invocation: true,Skill 便仅在手动调用时加载,成本为零。

以下为初期阶段的联想,属今后探讨对象。

以 MCP Server 形式提供支付能力:任意 Agent 经由 MCP 协议调用 Agent 支付基础设施调查报告(check_balance, authorize_payment, get_price, dispute)。底层依赖 ERC-4337 概览 · Account Abstraction 的应用层实现
Marketplace 的收费化:成为 Skill 市场有偿化后,可用作计费/支付的后端(支付货币的选择参见 USD 稳定币互换市场)
分层的预算管理:用户级 → 项目级 → Agent 级 → 任务级 → 单次调用,映射到组件层级
金融成本追踪:与上下文成本追踪类似,追踪每次 Skill 调用的金融成本(花了多少,是否值)

这些方向尚未确认,仅作记录。

文本化整理 · 2026-04-16