Claude Codeは、開発者のワークフローを大幅に効率化するAIコーディングアシスタントです。公式ドキュメントによると、Claudeの振る舞いを指示する方法として、CLAUDE.mdファイル、rules、skills、subagents、hooks、output styles、system promptの7つの手法が提供されています。これらの手法は、コンテキストへのロードタイミング、コンパクション時の永続性、トークンコストが異なり、用途に応じて使い分けることが重要です。

📑目次
  1. CLAUDE.mdファイルの役割と使い方
  2. SkillsとHooksの違い・活用シーン
  3. SubagentsとRulesの効果的な設定方法
  4. 各方法の比較表(ロードタイミング・コスト・用途)
  5. 実践的な使い分けフレームワーク
  6. よくある質問(FAQ)
  7. まとめ

CLAUDE.mdファイルの役割と使い方

CLAUDE.mdファイルは、プロジェクトのルートに配置することでセッション開始時に自動的にロードされ、セッション全体を通じてコンテキストに残ります。コンパクション後もメモ化され、再読み込みされるため、ビルドコマンドやディレクトリ構造、チーム規約などの永続的な指示に適しています。

一方、サブディレクトリ版のCLAUDE.mdは、該当ディレクトリ内のファイルが読み込まれたタイミングでオンデマンドにロードされます。コンテキストコストが低いのが特徴ですが、コンパクション時に失われやすい点に注意が必要です。公式ブログでは、CLAUDE.mdを200行以内に抑え、所有者を明確にし、コードのようにレビューすることを推奨しています。

出典: Claude公式ブログ(2026年6月時点)


SkillsとHooksの違い・活用シーン

Skillsは特定のタスクやドメイン知識を定義するもので、セッション開始時に名前と説明のみがロードされ、実際に呼び出された際にフルボディがロードされます。コンテキストコストを抑えつつ専門性を高められるため、コードレビューやデプロイチェックリストなどの手順的なワークフローに有効です。

Hooksはイベントトリガーで動作をカスタマイズする手法で、コンパクションをバイパスして永続的に動作します。linterの実行やSlackへの通知、コマンドのブロックなど、ワークフローの自動化に適しています。公式例では、PreCompactイベントでのチャット履歴バックアップなどが紹介されています。


SubagentsとRulesの効果的な設定方法

Subagentsは独立したエージェントとして並行処理を可能にし、メインセッションとは別のコンテキストで動作します。大規模プロジェクトの分割作業や、ディープサーチ、ログ分析などに適しており、コンテキストコストが低いのが利点です。

Rulesは永続的な制約を課す手法で、セッション開始時にロードされ、コンパクション時に再注入されます。path-scoped rulesを使用することで、特定のディレクトリやファイルに限定した制約を設けられます。例として、APIハンドラでのZod検証強制などが挙げられます。


各方法の比較表(ロードタイミング・コスト・用途)

Method ロードタイミング コンパクション時の挙動 コンテキストコスト 主な用途例
CLAUDE.md (root) セッション開始 メモ化・キャッシュ 高 ビルドコマンド、チーム規約
CLAUDE.md (subdir) オンデマンド 再タッチまでロスト 低 特定サブディレクトリ作業
Skills 必要時 持続 中 専門タスク・ドメイン知識
Hooks イベントトリガー 持続 低 ワークフロー自動化
Subagents 並行処理 独立 中 大規模プロジェクト分割
Rules 常時 永続 低 コーディング規約強制
Output Styles 出力時 セッション内 低 フォーマット統一

出典: Claude公式ブログ(2026年6月時点)


実践的な使い分けフレームワーク

公式ドキュメントのフレームワークに従い、指示の永続性が必要か、コンテキストコストを抑えたいか、イベント駆動が必要かを判断して選択します。複数の方法を組み合わせることで、Claude Codeの柔軟性を最大化できます。例えば、チーム規約はroot CLAUDE.mdに、特定のワークフローはskillsに、自動化はhooksに振り分けるのが効果的です。


よくある質問(FAQ)

Q1. CLAUDE.mdとskillsの違いは何ですか?

A. CLAUDE.mdはセッション開始時に常にロードされるのに対し、skillsは呼び出された時のみフル内容がロードされます。コストと永続性のバランスが異なります。

Q2. Hooksはどのように設定しますか?

A. .claude/hooks/ディレクトリに設定ファイルを配置し、ライフサイクルイベントに紐づけます。コンパクションをバイパスする点が特徴です。

Q3. Subagentsを使うメリットは?

A. 独立したコンテキストで並行処理が可能になり、メインセッションのトークンコストを抑えられます。大規模タスクの分割に有効です。

Q4. コンパクション後も指示が残る方法はどれですか?

A. CLAUDE.md (root)、Rules、Hooks、Skillsの一部がコンパクション耐性を持ちます。詳細は公式比較表を参照してください。

Q5. トークンコストを最小限に抑えるにはどの方法を選ぶべきですか?

A. Subdirectory CLAUDE.md、Hooks、path-scoped Rulesが低コストです。常に必要な指示以外はオンデマンドロードを優先します。

Q6. チーム規約を強制するにはどの方法が最適ですか?

A. root CLAUDE.mdまたはpath-scoped Rulesが適しています。所有者を明確にし、定期レビューを行うことが推奨されます。

Q7. 複数の方法を同時に使うことは可能ですか?

A. はい。組み合わせることで柔軟性が向上します。例: CLAUDE.mdで全体像、skillsで手順、hooksで自動化を実現します。


関連記事:

まとめ

Claude Codeのカスタマイズ手法を理解し、適切に使い分けることで、開発生産性を大幅に向上させることができます。公式ドキュメントを基に、プロジェクトの規模やチーム構成に合わせて選択してください。詳細はClaude公式ブログをご覧ください。

関連する新しい記事:

krona23

著者

krona23

IT業界20年以上の実務経験を持ち、日本国内有数のPVを誇る大規模Webサービスで事業部長・CTOを複数社で歴任。Windows/iOS/Android/Webと技術の変遷を経験し、現在はAIネイティブへの変革に注力。DevGENTでは、AIコードエディタ・自動化ツール・LLMの実践的な使い方を日英西3言語で発信中。

DevGENT について →

コメントを残す

Trending

DevGENTをもっと見る

今すぐ購読し、続きを読んで、すべてのアーカイブにアクセスしましょう。

続きを読む