Claude Code 拡張コンポーネントアーキテクチャ

ウィキ上の位置づけ

[!info] 要約出典:2026-04-16 に受領した 5 枚のアーキテクチャ図(WeChat 公式アカウント「童童的 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 ファイルがロードされ、対話のコンテキストにマージされる。衝突解決:より具体的なルールが優先される。

組み合わせ	動作	例
Skills + MCP	MCP が接続を提供し、Skills が使い方を定義	Skills が DB スキーマを記述
Skills + Subagent	Skills が複数の Subagent を起動	/audit でセキュリティとパフォーマンスを同時チェック
CLAUDE.md + Skills	グローバルルール + オンデマンド知識	CLAUDE.md が API 規範を定義
Hook + MCP	Hook が外部システムを呼び出し	クリティカルなファイル変更後に Slack 通知

各拡張コンポーネントはモデルのコンテキストウィンドウを消費する。

コンポーネント	ロードタイミング	ロード内容	コンテキストコスト
CLAUDE.md	セッション開始時	全内容	毎回リクエスト(高)
Skills	セッション開始時 + 呼び出し時	説明 + 全内容	比較的低
MCP Servers	セッション開始時	ツール定義	毎回リクエスト(高)
Subagents	作成時	独立コンテキスト	メインセッションと隔離
Hooks	トリガ時	デフォルトなし	ゼロ

機能とコストのバランスを取る必要がある。Tips:disable-model-invocation: true を設定すれば、Skill は手動呼び出し時のみロードされ、コストはゼロになる。

以下は初期段階の連想であり、今後の検討対象である。

決済機能を MCP Server として提供:任意の Agent が MCP プロトコル経由で決済機能を呼び出す(check_balance, authorize_payment, get_price, dispute)。下層は ERC-4337 プログラマブルウォレットに依存する
Marketplace の有料化:Skill マーケット有料化になった後、課金・決済のバックエンドとして利用可能(決済通貨の選択は USD ステーブルコイン相互交換層を参照)
階層化された予算管理:ユーザーレベル → プロジェクトレベル → Agent レベル → タスクレベル → 単一呼び出し、コンポーネント階層にマッピング
金融コスト追跡:コンテキストコスト追跡と同様に、Skill 呼び出しごとの金融コスト(いくら使ったか、価値に見合うか)を追跡

これらの方向性は未確認であり、記録のみ。

テキスト化整理 · 2026-04-16