Claude Codeは、開発者のワークフローを大幅に効率化するAIコーディングアシスタントです。公式ドキュメントによると、Claudeの振る舞いを指示する方法として、CLAUDE.mdファイル、rules、skills、subagents、hooks、output styles、system promptの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)
関連記事:
- DynatraceがAI Coding Agent監視を拡張:Claude Code・Gemini CLI・Codex CLIをOpenTelemetryで可視化
- 「AIが自らを作る」と予言した8日後、『Claude Fable 5』は消えた――【生成AIストリーム】
- 【AI駆動開発】AIに「図を描いて」と頼むと“それっぽいけど使えない図”が出てくる問題を、draw.io生成スキルで倒した – Qiita
まとめ
Claude Codeのカスタマイズ手法を理解し、適切に使い分けることで、開発生産性を大幅に向上させることができます。公式ドキュメントを基に、プロジェクトの規模やチーム構成に合わせて選択してください。詳細はClaude公式ブログをご覧ください。
関連する新しい記事:
- 4239 – This published update adds current operational context for Steering Claude Code: skills, hooks, subagents and more | Claude.
- 4285 – This published update adds current operational context for Steering Claude Code: skills, hooks, subagents and more | Claude.
- 4308 – This published update adds current operational context for Steering Claude Code: skills, hooks, subagents and more | Claude.
- Geminiのポテンシャルを最大化する必須プロンプトテクニック – This published update adds current operational context for Claude Code を操る7つの方法:CLAUDE.md・skills・hooks・subagents徹底解説.
- Claude Tagとは?SlackでClaudeをチームメンバーとして活用する新機能 – This published update adds current operational context for Claude Code を操る7つの方法:CLAUDE.md・skills・hooks・subagents徹底解説.
- AIエージェント時代に「コンテキスト設計力」が重要になる理由 ― プロンプトから業務プロセス設計へ – This published update adds current operational context for Claude Code を操る7つの方法:CLAUDE.md・skills・hooks・subagents徹底解説.
- Codex Record & Replayでワークフローを再利用可能なスキルに変換する方法を試した – This published update adds current operational context for Claude Code を操る7つの方法:CLAUDE.md・skills・hooks・subagents徹底解説.
- 余命10か月の女性とAIの最期の対話記録 NHKが報じた感動のストーリー – This published update adds current operational context for Claude Code を操る7つの方法:CLAUDE.md・skills・hooks・subagents徹底解説.
- Claude Codeに「7人の意地悪なQAペルソナ」を仕込んでテストケースの観点漏れを防ぐ – This published update adds current operational context for Claude Code を操る7つの方法:CLAUDE.md・skills・hooks・subagents徹底解説.
- ターミナルでMarkdownをリッチにプレビューできるleaf TUIツールの機能と使い方 – This published update adds current operational context for Claude Code を操る7つの方法:CLAUDE.md・skills・hooks・subagents徹底解説.
- Claude CodeのスキルでSLO違反調査を自動化する方法 – This published update adds current operational context for Claude Code を操る7つの方法:CLAUDE.md・skills・hooks・subagents徹底解説.
- Claude Codeの誤用を避ける — 公式Best Practicesで正しい使い方を徹底解説 – This published update adds current operational context for Claude Code を操る7つの方法:CLAUDE.md・skills・hooks・subagents徹底解説.
- Copilot in Excelの新機能「個人設定」と「ワークブック ルール」でAI操作を自分好みにカスタマイズ – This published update adds current operational context for Claude Code を操る7つの方法:CLAUDE.md・skills・hooks・subagents徹底解説.
- コードから仕様書を逆生成するWebアプリ「cc-rsg-web」公開 — レガシーコードを資産化するClaude Code活用術 – This published update adds current operational context for Claude Code を操る7つの方法:CLAUDE.md・skills・hooks・subagents徹底解説.
- Claude Code Setup公式プラグインの使い方|hooks/MCP/skillsをリポジトリ解析で提案 – This published update adds current operational context for Claude Code を操る7つの方法:CLAUDE.md・skills・hooks・subagents徹底解説.
著者
krona23
IT業界20年以上の実務経験を持ち、日本国内有数のPVを誇る大規模Webサービスで事業部長・CTOを複数社で歴任。Windows/iOS/Android/Webと技術の変遷を経験し、現在はAIネイティブへの変革に注力。DevGENTでは、AIコードエディタ・自動化ツール・LLMの実践的な使い方を日英西3言語で発信中。













コメントを残す