Claude Code を制御する 7つの管理メソッド — Skill, SubAgent, CLAUDE.md の本質的な違い

Skill、SubAgent、CLAUDE.md。AIコーディング助手を制御する仕組みの名前が増え続けています。どれも見た目が似ていて、書き方も似ていて、役割まで重なって見えるため、「結局どれを使えばいいのか」で立ち止まる開発者は少なくありません。本記事では、Anthropic公式が示す7つの制御方法を、たった3つの変数で整理し直します。混乱の正体は数の多さではなく、軸の不在にあるからです。

よくある誤解 — 「全部CLAUDE.mdに書けばいい」の落とし穴

最も多い誤解は、プロジェクトの規約、ビルド手順、禁止事項、すべてをCLAUDE.mdに書き込めばよい、というものです。一見シンプルで強力に見えます。しかしCLAUDE.mdはセッション開始時に丸ごとロードされ、最後までコンテキスト窓に居座り続ける仕組みです。肥大化したCLAUDE.mdは本来の作業領域を圧迫し、AIアシスタントの集中力を奪っていきます。

Anthropicは公式に、事実、手順、隔離タスクは、それぞれ別の仕組みに置くべきだと明言しています。1つのファイルに全てを詰める設計は、原理的に破綻するということです。

整理の鍵は「3つの変数」

公式記事が提示する判断軸は、わずか3つです。

• いつコンテキストにロードされるか — 常時か、オンデマンドか。
• コンテキスト圧縮後にどう振る舞うか — 残るのか、消えるのか。
• トークンをどれだけ消費するか — 高コストか、低コストか。

この3軸で見れば、7つの方法は一目で識別できます。名前を覚えるより、まずこの3変数を頭に入れることが先決です。

7つの制御方法を順に見ていく

1. CLAUDE.md — プロジェクトの永続的な記憶層

ビルドコマンド、ディレクトリ構成、モノレポ構造、チーム規約など、セッション中ずっと参照したい事実を書く場所です。サブディレクトリに置けば、その配下のファイルに触れた時だけ追加で読み込まれます。常時ロードが基本のため、肥大化は致命傷になります。

2. Rules — 横断的な制約や慣行を明文化する

たとえば「すべてのAPIハンドラはZodで入力を検証すること」のような決まり事を入れます。Rulesはパスのスコープを指定でき、関係するファイルを触る時だけ読み込まれます。CLAUDE.mdとの違いは、このパススコープの有無です。

3. Skills — 手続き的な作業を一塊にする

デプロイ手順、リリースチェックリスト、コードレビューの一連の流れなど、特定の場面で発動する手順をSKILL.mdに記述します。Skillsの肝は、名前と説明だけがセッション開始時に読み込まれ、本体は呼び出し時にのみロードされる点にあります。Anthropicは2026年にスラッシュコマンドとSkillsを統合し、同じ仕組みの2つの呼び出し方として整理しました。

4. Subagents — 隔離タスクを別の文脈窓で実行する

深い検索、ログ解析、依存関係の監査など、大量の中間結果を親会話に持ち込みたくない作業に使います。Subagentは仕事を終えると最終結論だけを親に返し、途中の探索ログは親の文脈に入りません。文脈の汚染を物理的に防ぐ仕組みです。

5. Hooks — 決定論的な自動化

ツール呼び出しの前後、コンパクションの直前など、特定のイベントで自動的にコードを実行します。リンターの自動実行、完了時の通知、危険なコマンドのブロックなどに使われます。Hooksは指示ではなく実行コードであるため、プロンプト注入の影響を受けず、最も確実な制御方法と位置付けられています。

6. Output styles — デフォルトのシステムプロンプトを置き換える

コードアシスタントから汎用アシスタントへ、といった大幅なロール変更に使います。最も高い権限を持つ一方、副作用も大きく、デフォルトに含まれる重要な指示が失われる可能性があります。安易な選択肢ではありません。

7. append system prompt — CLIから軽量に指示を追加

トーン、応答の長さ、フォーマットの好みなどを、セッション単位で軽く乗せたい時に使います。Output stylesが「大改造」なら、こちらは「微調整」です。

似た3つを徹底比較 — CLAUDE.md・Skills・Subagents

構造的に似ているからこそ、本質的な違いが見えにくいのがこの3つです。公式の指針は明快です。CLAUDE.mdは事実、Skillsは手順、Subagentsは隔離タスク。

• 事実とは、変わらない情報のこと。たとえば「このリポジトリはTypeScriptを使う」「ビルドは make test で動く」など。常に頭の中にあってほしいので、CLAUDE.mdに書き、セッション中ずっとロードします。
• 手順とは、特定の作業で発動する一連のステップ。普段は不要でも、デプロイする時にはすべて見たい。だからSkillsに置き、呼び出した時だけロードします。
• 隔離タスクとは、大量の中間情報を読まないと結論が出ないが、その中間情報は親会話に持ち込みたくない作業。100メガバイト級のログから不具合原因を特定するような仕事を、Subagentに任せれば、文脈は無傷のまま結論だけが返ってきます。

判定基準は一行で済みます。「それは事実か、手順か、隔離が必要なタスクか」。この問いだけで、3つの使い分けは原理的に決着します。

残り4つの使い分け

Rules、Hooks、Output styles、append system prompt の役割分担も、軸が分かれば迷いません。

• Rulesは制約の仕組み。プロジェクトの一部にだけ効かせたい規則は Rules、全体に効かせたい事実は CLAUDE.md。
• Hooksは指示ではなく実行コード。毎回必ずリンターを通したい、特定のコマンドは絶対に阻止したい、といった確実性が必要な時に選びます。
• Output stylesはアシスタント自体の役割を変える、大きな転換のための仕組み。
• append system promptは、その逆の軽量な調整。

マトリクスとして見ると、常時ロードで高コストな領域には CLAUDE.md ルートと Output styles が並びます。希少な状況でのみ選ぶべき重い武器です。一方、オンデマンドで低コストな領域には Skills、Subagents、Hooks が揃います。日常運用の中心は、こちら側にあります。

公式が警告する4つの誤用パターン

• 誤用1:「常にXするときは常にYする」という指示をCLAUDE.mdに書く。これはHooksでやるべき仕事です。プロンプトは無視され得ますが、Hooksは決定論的に走ります。
• 誤用2: 絶対に禁止したい事項をプロンプトに頼って書く。プロンプト由来の指示は飛ぶことがあります。本当に止めたいなら Managed settings で強制すべきです。
• 誤用3: 30行を超える手順をCLAUDE.mdに書く。それは事実ではなく手順であり、Skillsに移すべきです。
• 誤用4: Rulesにパススコープをつけず、関係ないファイル作業時にも常時ロードする。本来は局所的な制約のはずなのに、CLAUDE.mdと変わらなくなってしまいます。

Anthropicは2026年の公式記事で、CLAUDE.mdは200行以下に保つべきだと推奨しています。肥大化したCLAUDE.mdは、開発者がこの7つの方法を理解していないサインだ、と公式は遠回しに指摘しているわけです。

結論 — 3変数で識別し、適切な場所に置く

Claude Code を制御する7つの方法は、3つの変数で識別できます。出発点は単純な三段論法です。事実は CLAUDE.md、手順は Skills、隔離タスクは Subagents。

残りの4つには、それぞれ得意領域があります。横断的制約は Rules、決定論的自動化は Hooks、大幅なロール変更は Output styles、軽量な調整は append system prompt。似た見た目に惑わされず、「何の指示を、いつ、どれだけのコストで持たせたいか」を問えば、適切な方法は自然と見えてきます。正しく分けて配置することで、コンテキスト窓は本来の作業に開放され、AIアシスタントの集中力は維持されます。

次回はAnthropicが公開したオープン標準、MCPを扱います。Skill、Subagent と並ぶ、第三の拡張の柱です。

参考・出典

• Anthropic (2026)
• Anthropic Docs
• Anthropic Blog (2026)

この記事は動画「Claude Code を制御する 7つの管理メソッド — Skill, SubAgent, CLAUDE.md の本質的な違い」の内容を、文章で読めるように再構成したものです。