SpyBara
Go Premium

features-overview.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

This page contains 81 additions and 85 deletions.

2026
Wed 9 22:58 Fri 18 23:58 Tue 22 23:59 Fri 25 23:58

Claude Code を拡張する

CLAUDE.md、Skills、subagents、hooks、MCP、plugins をいつ使用するかを理解します。

Claude Code は、コードについて推論するモデルと、ファイル操作、検索、実行、ウェブアクセス用の組み込みツールを組み合わせています。組み込みツールはほとんどのコーディングタスクをカバーしています。このガイドは拡張レイヤーについて説明します。つまり、Claude が何を知るかをカスタマイズし、外部サービスに接続し、ワークフローを自動化するために追加する機能です。

Claude Code は初めてですか？ CLAUDE.md でプロジェクト規約を開始します。その後、特定のトリガーが発生したときに他の拡張機能を追加してください。

概要

拡張機能は agentic ループのさまざまな部分に接続します。

  • CLAUDE.md は、Claude がすべてのセッションで見る永続的なコンテキストを追加します
  • Skills は再利用可能な知識と呼び出し可能なワークフローを追加します
  • Code intelligence は Claude を言語サーバーに接続し、シンボルレベルのナビゲーションとライブ型エラーを実現します
  • MCP は Claude を外部サービスとツールに接続します
  • Subagents は独立したコンテキストで独自のループを実行し、サマリーを返します
  • Dynamic workflows は Claude が書いたスクリプトから多くの subagents を実行し、1 つの結果を返します
  • Cross-session messaging により、Claude はあなたのセッションの 1 つから別のセッションにメッセージを渡すことができます
  • Hooks はライフサイクルイベントで発火し、スクリプト、HTTP リクエスト、MCP ツール呼び出し、プロンプト、または subagent を実行できます
  • Plugins と marketplaces はこれらの機能をパッケージ化して配布します

Skills は最も柔軟な拡張機能です。スキルは知識、ワークフロー、または指示を含むマークダウンファイルです。/deploy のようなコマンドでスキルを呼び出すことができます。または Claude は関連する場合に自動的にスキルをロードできます。スキルは現在の会話で実行することも、subagents を介して独立したコンテキストで実行することもできます。

機能をあなたの目標に合わせる

機能は、Claude がすべてのセッションで見る常時オンのコンテキストから、あなたまたは Claude が呼び出すことができるオンデマンド機能、特定のイベントで実行されるバックグラウンド自動化まで、さまざまです。以下の表は、利用可能な機能と各機能が適切な場合を示しています。

機能 機能 使用する場合 例
CLAUDE.md すべての会話で読み込まれる永続的なコンテキスト プロジェクト規約、「常に X を実行する」ルール 「pnpm を使用し、npm は使用しない。コミット前にテストを実行する。」
Skill Claude が使用できる指示、知識、ワークフロー 再利用可能なコンテンツ、リファレンスドキュメント、繰り返しタスク /deploy はデプロイメントチェックリストを実行します。エンドポイントパターンを持つ API ドキュメントスキル
Subagent サマリー結果を返す独立した実行コンテキスト コンテキスト分離、並列タスク、専門的なワーカー 多くのファイルを読み取るが、主要な結果のみを返す研究タスク
Dynamic workflow 複数の subagents をバックグラウンドで実行するスクリプト Claude が記述 複数の subagents を超えて成長する作業、または検証したい結果 コードベース全体を監査し、2 番目のエージェントセットが各結果を検証
Cross-session messaging Claude がセッションの 1 つから別のセッションにメッセージを配信 実行するセッションがタスク途中で互いの結果を必要とする 1 つのセッションが別のセッションに警告し、変更が別のセッションが構築しているものを破壊する
Code intelligence 言語サーバーナビゲーションと診断 型付き言語、grep が遅いまたは不正確な大規模コードベース ファイル全体を読む代わりにシンボルの定義にジャンプ
MCP 外部サービスに接続 外部データまたはアクション データベースをクエリ、Slack に投稿、ブラウザを制御
Hook イベントで実行されるスクリプト、HTTP リクエスト、MCP ツール呼び出し、プロンプト、または subagent すべてのマッチングイベントで実行する必要がある自動化 すべてのファイル編集後に ESLint を実行
Artifact セッション出力をプライベートでインタラクティブな Web ページとして公開 ターミナルテキストではなく視覚的に見たり共有したい出力 Claude が調査するにつれて更新されるインシデントタイムライン

Plugins はパッケージングレイヤーです。プラグインはスキル、フック、subagents、MCP サーバーを単一のインストール可能なユニットにバンドルします。プラグインスキルは名前空間化されています（/my-plugin:review のように）ため、複数のプラグインが共存できます。同じセットアップを複数のリポジトリで再利用したい場合、または marketplace を通じて他のユーザーに配布したい場合はプラグインを使用します。

セットアップを時間をかけて構築する

すべてを事前に設定する必要はありません。各機能には認識可能なトリガーがあり、ほとんどのチームはおおよそこの順序で追加します。

トリガー 追加
Claude が規約またはコマンドを 2 回間違える CLAUDE.md に追加
同じプロンプトをタスクを開始するために何度も入力している ユーザーが呼び出し可能な skill として保存
同じプレイブックまたは複数ステップの手順をチャットに 3 回目に貼り付けている skill としてキャプチャ
Claude が見ることができないブラウザタブからデータをコピーし続けている そのシステムを MCP server として接続
Claude が多くのファイルを読み取ってシンボルが定義または使用されている場所を見つける 言語用の code intelligence plugin をインストール
サイドタスクが会話に再度参照しない出力で満杯になっている subagent を通じてルーティング
何かが毎回聞かずに起こることを望んでいる hook を記述
2 番目のリポジトリが同じセットアップを必要としている plugin としてパッケージ化

同じトリガーは、既に持っているものを更新する時期を示します。繰り返される間違いまたは繰り返されるレビューコメントは、チャットでの 1 回限りの修正ではなく、CLAUDE.md の編集です。手動で何度も調整するワークフローは、別の改訂が必要なスキルです。

類似機能を比較する

一部の機能は似ているように見えることがあります。より詳しい説明については、Steering Claude Code: when to use CLAUDE.md, skills, hooks, and subagents をブログで参照してください。ここでは、それらを区別する方法を説明します。

スキルと subagents は異なる問題を解決します。

  • Skills は任意のコンテキストにロードできる再利用可能なコンテンツです
  • Subagents はメイン会話とは別に実行される独立したワーカーです
側面 Skill Subagent
それは何か 再利用可能な指示、知識、またはワークフロー 独自のコンテキストを持つ独立したワーカー
主な利点 コンテキスト全体でコンテンツを共有 コンテキスト分離。作業は別々に行われ、サマリーのみが返される
Context window への影響 メインウィンドウに追加 独自の入力トークンと出力トークンを持つ別のウィンドウを使用
最適な用途 リファレンスマテリアル、呼び出し可能なワークフロー 多くのファイルを読み取るタスク、並列作業、専門的なワーカー

スキルはリファレンスまたはアクションです。 リファレンススキルは Claude がセッション全体で使用する知識を提供します（API スタイルガイドなど）。アクションスキルは Claude に特定の操作を実行するよう指示します（デプロイメントワークフローを実行する /deploy など）。

コンテキスト分離が必要な場合、またはコンテキストウィンドウがいっぱいになっている場合は subagent を使用します。 subagent は数十のファイルを読み取るか、広範な検索を実行する可能性がありますが、メイン会話はサマリーのみを受け取ります。subagent の作業はメインコンテキストを消費しないため、中間作業を表示したままにする必要がない場合にも便利です。カスタム subagents は独自の指示を持つことができ、スキルをプリロードできます。

それらは組み合わせることができます。 subagent は特定のスキルをプリロードできます（skills: フィールド）。スキルは context: fork を使用して独立したコンテキストで実行できます。詳細は Skills を参照してください。

機能がどのようにレイヤーするかを理解する

機能は複数のレベルで定義できます。ユーザー全体、プロジェクトごと、プラグイン経由、または管理ポリシーを通じて。また、CLAUDE.md ファイルをサブディレクトリにネストしたり、スキルをモノレポの特定のパッケージに配置したりすることもできます。同じ機能が複数のレベルに存在する場合、ここでそれらがどのようにレイヤーするかを示します。

  • CLAUDE.md ファイル は加算的です。すべてのレベルがコンテンツを同時に Claude のコンテキストに提供します。作業ディレクトリ以上のファイルは起動時にロードされます。サブディレクトリは作業時にロードされます。指示が競合する場合、Claude は判断を使用してそれらを調整し、より具体的な指示が通常優先されます。CLAUDE.md ファイルがどのようにロードされるか を参照してください。
  • スキルと subagents は名前でオーバーライドします。同じ名前が複数のレベルに存在する場合、優先度に基づいて 1 つの定義が勝ちます（スキルの場合は管理 > ユーザー > プロジェクト。subagents の場合は管理 > CLI フラグ > プロジェクト > ユーザー > プラグイン）。プラグインスキルは競合を避けるために 名前空間化 されています。スキル検出 と subagent スコープ を参照してください。
  • MCP サーバー は名前でオーバーライドします。ローカル > プロジェクト > ユーザー。MCP スコープ を参照してください。
  • Hooks はマージされます。すべての登録されたフックは、ソースに関係なく、マッチングイベントに対して発火します。Hooks を参照してください。

機能を組み合わせる

各拡張機能は異なる問題を解決します。CLAUDE.md は常時オンのコンテキストを処理し、スキルはオンデマンド知識とワークフローを処理し、MCP は外部接続を処理し、subagents は分離を処理し、フックは自動化を処理します。実際のセットアップはワークフローに基づいてそれらを組み合わせます。

たとえば、CLAUDE.md をプロジェクト規約に使用し、スキルをデプロイメントワークフローに使用し、MCP をデータベースに接続し、フックをすべての編集後にリントを実行するために使用する場合があります。各機能は最適な機能を処理します。

パターン 機能 例
Skill + MCP MCP は接続を提供します。スキルは Claude にそれを効果的に使用する方法を教えます MCP はデータベースに接続し、スキルはスキーマとクエリパターンを文書化します
Skill + Subagent スキルは並列作業のために subagents をスポーンします /audit スキルはセキュリティ、パフォーマンス、スタイル subagents を開始し、独立したコンテキストで作業します
CLAUDE.md + Skills CLAUDE.md は常時オンのルールを保持します。スキルはオンデマンドでロードされるリファレンスマテリアルを保持します CLAUDE.md は「API 規約に従う」と言い、スキルは完全な API スタイルガイドを含みます
Hook + MCP フックは MCP を通じて外部アクションをトリガーします 編集後フックは Claude が重要なファイルを変更するときに Slack 通知を送信します

コンテキストコストを理解する

追加する各機能は Claude のコンテキストの一部を消費します。多すぎるとコンテキストウィンドウがいっぱいになる可能性がありますが、Claude の効果を低下させるノイズを追加することもできます。スキルが正しくトリガーされない場合や、Claude が規約を失う場合があります。これらのトレードオフを理解することで、効果的なセットアップを構築するのに役立ちます。実行中のセッションでこれらの機能がどのように組み合わされるかのインタラクティブビューについては、コンテキストウィンドウを探索する を参照してください。

機能別のコンテキストコスト

各機能には異なるロード戦略とコンテキストコストがあります。

機能 ロード時期 ロード内容 コンテキストコスト
CLAUDE.md セッション開始 完全なコンテンツ すべてのリクエスト
Skills セッション開始 + 使用時 開始時の説明、使用時の完全なコンテンツ 低い（毎リクエスト説明）*
MCP サーバー セッション開始 ツール名。完全なスキーマはオンデマンド 低い（ツール使用まで）
Code intelligence ファイル編集後およびオンデマンド 編集後の診断。シンボル検索時の定義、参照、型情報 低い。ファイル読み取りを削減
Subagents スポーン時 指定されたスキルを持つ新しいコンテキスト、または fork の親会話 メインセッションから分離
Hooks トリガー時 なし（外部で実行） ゼロ（フックが追加コンテキストを返さない限り）

*デフォルトでは、スキル説明はセッション開始時にロードされるため、Claude はそれらを使用する時期を決定できます。スキルの frontmatter で disable-model-invocation: true を設定して、手動で呼び出すまで Claude から完全に非表示にします。書いていないスキルの場合は、ファイルを編集せずに同じことを行うために settings で skillOverrides を設定します。

機能がどのようにロードされるかを理解する

各機能はセッション内の異なるポイントでロードされます。以下のタブは、各機能がいつロードされるか、およびコンテキストに何が入るかを説明しています。

コンテキストロード：CLAUDE.md はセッション開始時にロードされ、すべてのリクエストに留まります。MCP ツール名は開始時にロードされ、完全なスキーマは使用時に遅延されます。スキルは開始時に説明をロードし、呼び出し時に完全なコンテンツをロードします。Subagents は独立したコンテキストを取得します。Hooks は外部で実行されます。 コンテキストロード：CLAUDE.md はセッション開始時にロードされ、すべてのリクエストに留まります。MCP ツール名は開始時にロードされ、完全なスキーマは使用時に遅延されます。スキルは開始時に説明をロードし、呼び出し時に完全なコンテンツをロードします。Subagents は独立したコンテキストを取得します。Hooks は外部で実行されます。

時期： セッション開始

ロード内容： すべての CLAUDE.md ファイル（管理、ユーザー、プロジェクトレベル）の完全なコンテンツ。

継承： Claude は作業ディレクトリからルートまで CLAUDE.md ファイルを読み取り、サブディレクトリにネストされたものを、それらのファイルにアクセスするときに検出します。詳細は CLAUDE.md ファイルがどのようにロードされるか を参照してください。

詳細を学ぶ

各機能には、セットアップ指示、例、設定オプションを含む独自のガイドがあります。

file-lines CLAUDE.md

プロジェクトコンテキスト、規約、指示を保存
brain Skills

Claude にドメイン専門知識と再利用可能なワークフローを提供
users Subagents

独立したコンテキストに作業をオフロード
network Dynamic workflows

1 つのスクリプトから多くのサブエージェントを実行
terminal Cross-session messaging

Claude が他のセッションにメッセージを送信できるようにする
plug MCP

Claude を外部サービスに接続
bolt Hooks

フックでアクションを自動化
puzzle-piece Plugins

機能セットをバンドルして共有
store Marketplaces

プラグインコレクションをホストして配布