使い方ガイド特集:エージェント開発入門

CLAUDE.md・スキル・サブエージェント・hooks・MCP・プラグイン:どれを使うか

読み込まれるタイミングとコンテキストの重さで選ぶ

Claude Code には、機能を足す仕組みがいくつもあります。公式ドキュメントの比較表をもとに、それぞれの役割、読み込まれるタイミング、文脈への負担の違いを整理し、「いつ、どれを足すか」の目安をまとめます。

8分で読めますエンジニア向け難しさ:初級AIexandria編集部

6つの仕組みの役割

公式ドキュメントでは、それぞれの役割が次のように説明されています。

仕組み 役割
CLAUDE.md 毎回のセッションで Claude が見る、永続的な文脈
スキル(Skills) 再利用できる知識と、呼び出せる手順
サブエージェント(Subagents) 独立した文脈で動き、要約を返す担当
hooks 決まったタイミングで、スクリプトなどを実行する
MCP 外部のサービスやツールにつなぐ
プラグイン(Plugins) スキル、hooks、サブエージェント、MCP サーバーを、一つの単位にまとめて配る

使いどころの目安

向いている場面 使うもの
プロジェクトの決まり、「常に〜する」という規則 CLAUDE.md
何度も使う手順、参照資料、繰り返す作業 スキル
文脈を分けたい、並列で進めたい、専門の担当がほしい サブエージェント
外部のデータや操作がほしい(データベース、Slack、ブラウザ) MCP
毎回、必ず実行したい(編集後のリント、危険な操作のブロック) hooks
複数のリポジトリで同じ設定を配りたい プラグイン

読み込まれるタイミングと、文脈への負担

「いつ読み込まれるか」は、会話の文脈をどれだけ使うかに直結します。

仕組み 読み込まれるとき 文脈への負担
CLAUDE.md セッションの開始時 毎回のリクエストで、全文が乗る
スキル 開始時に説明だけ、使うときに全文 小さい(説明文は毎回乗る)
MCP サーバー 開始時にツール名だけ 小さい(ツールを使うまで、詳細は読まれない)
サブエージェント 起動したとき 主会話とは分かれている
hooks 発火したとき ゼロ(出力を返さない限り)

公式のヒントは、「CLAUDE.md は 200 行未満にする。参照資料はスキルに移す。スキルは必要なときに読まれる」です。

迷いやすい組み合わせ

スキルとサブエージェント

スキル サブエージェント
中身 再利用できる指示・知識・手順 独立した文脈を持つ担当
利点 内容を、いろいろな場面で共有できる 作業が分かれ、要約だけが戻る
文脈への影響 主会話の文脈に加わる 別の文脈を使う

hooks とスキル

hooks スキル
実行されるもの スクリプト、HTTP リクエスト、MCP ツール、プロンプト、サブエージェント Claude が読んで従う指示
引き金 PostToolUse や SessionStart などのイベント 自分が /名前 と打つ、または Claude が説明を見て選ぶ
確実さ Claude の判断なしに発火する Claude が解釈するので、結果が変わりうる

公式ドキュメントは、「ガードレールは hooks に置く」と書いています。CLAUDE.md やスキルに「.env を編集しない」と書くのは依頼であって、保証ではないからです。

MCP とスキル

MCP は「つなぐ」仕組みで、ツールとデータへのアクセスを提供します。スキルは「教える」仕組みで、知識と手順を提供します。たとえば、MCP でデータベースにつなぎ、スキルでスキーマとクエリの作法を教える、という組み合わせがよくあります。

足すタイミング

公式の「少しずつ育てる」の表は、次のきっかけを挙げています。

きっかけ 足すもの
Claude が決まりやコマンドを2回間違えた CLAUDE.md に書く
毎回、同じ依頼文を打っている ユーザーが呼び出せるスキルにする
同じ手順書を、3回目に貼りつけた スキルにする
ブラウザのタブからデータを写している MCP サーバーでつなぐ
別の作業が、あとで使わない出力で会話を埋める サブエージェントに回す
毎回、頼まなくても起きてほしい hooks を書く
2つ目のリポジトリにも、同じ設定が必要 プラグインにまとめる

組み合わせの例

組み合わせ 動き 例
スキル + MCP MCP が接続を担い、スキルが使い方を教える MCP でデータベースにつなぎ、スキルにスキーマとクエリの作法を書く
スキル + サブエージェント スキルが、並列の作業を担当に配る /audit が、セキュリティ・性能・スタイルの担当を並行して走らせる
CLAUDE.md + スキル CLAUDE.md に常時の規則、スキルに参照資料 CLAUDE.md に「API の規約に従う」、スキルに規約の全文
hooks + MCP hooks が、MCP 経由で外部の処理を起こす 重要なファイルの変更後に、Slack へ通知する

公式の例では、「プロジェクトの規約は CLAUDE.md、デプロイの手順はスキル、データベースへの接続は MCP、編集のたびのリントは hooks」という分担が挙げられています。

迷ったら

まず CLAUDE.md に短く書き、同じことを繰り返し頼むようになったらスキルへ、出力が多い作業はサブエージェントへ、と動かしていくのが無理のない順序です。プラグインは最後でかまいません。

出典

この記事で扱った機能・ツール

この記事で扱った企業

特集「エージェント開発入門」のほかの記事

あわせて読みたい

中央のターミナルから伸びる光るケーブルが、周囲のサーバーやクラウドにつながるイラスト

Claude Code に MCP サーバーをつなぐ方法

MCP(Model Context Protocol)を使うと、Claude Code から外部のサービスや社内のツールを呼び出せるようになります。この記事では、公式ドキュメントに沿って、MCP サーバーの追加、チームでの共有、認証、管理のコマンドを説明します。

7分