Claude Code の操作：CLAUDE.md ファイル、スキル、フック、ルール、サブエージェントなど

## Rules [Rules](https://code.claude.com/docs/en/memory#organize-rules-with-claude/rules/) は、Claude に特定の制約や規約を与える .claude/rules/ ディレクトリ内の Markdown ファイルです。 スコープ指定のないルールは CLAUDE.md と同様に動作し、セッション開始時に常に読み込まれ、コンパクション時にも再注入されます。これにより、現在のタスクに関連しない場合でも文脈が読み込まれてトークンが無駄になる可能性があります。 パススコープ付きのルールを使用すると、paths フィールドを追加して関連する際にのみルール指示を読み込むことができます。 例えば、src/api/** にスコープされたルールは、ドキュメント専用のセッション中は文脈に含まれません。Claude がその src/api/ ディレクトリ内のファイルを読み取る場合にのみ読み込まれます。 具体的な記述例は以下の通りです： --- paths: - "src/api/**" - "**/*.handler.ts" --- すべての API ハンドラーは、処理前に Zod を使用して入力を検証する必要があります。**ヒント**: 「マイグレーションは追加のみ」といったファイル固有の制約は、パス：フロントマターに配置された**ルール**として記述するのが最も適しています。コードベースの複数の（ただしすべてではない）箇所にまたがる横断的な関心事やファイルに関する指示の場合は、ネストされた CLAUDE.md ファイルよりも、パススコープ付きのルールを使用してください。 ## Skills [Skills](https://code.claude.com/docs/en/skills) は .claude/skills/ に配置され、Claude が動的に読み込む指示、スクリプト、リソースのフォルダです。各スキルには、名前、説明、本文を含む SKILL.md ファイルが存在します。 セッション開始時に読み込まれるのは名前と説明のみであり、フルボディは Claude がスラッシュコマンド（/code-review）を介してスキルを呼び出すか、タスクの自動マッチングによって呼び出した際に読み込まれます。 ![image](https://cdn.prod.website-files.com/68a44d4040f98a4adf2207b6/6a340f852d1f938ab867559f_2199ed03.png) スキルはシステムプロンプトを介してトリガーされます。例えば、/code-review は組み込みのスキルであり、現在の差分（diff）を検証し、ファイルを編集せずにその結果を報告します。このスキルはプレイブックを定義しており、Claude はこれを呼び出すたびに同じ構造化されたアプローチに従います。 コンパクション（圧縮）時に、Claude Code はすべての呼び出されたスキルにわたる合計予算の範囲内で、呼び出されたスキルを再注入します。セッション中に多くのスキルを呼び出した場合、最も古いものが最初に除外されます。 **ヒント:** デプロイワークフロー、リリースチェックリスト、レビュープロセスなど、手順的な指示は CLAUDE.md ではなく、スキルの内部に記述すべきです。 Claude Code には標準でスキルが搭載されていますが、独自のカスタムスキルを作成することも可能です。当社の [Claude 向けスキルの構築に関する完全ガイド](https://claude.com/blog/complete-guide-to-building-skills-for-claude) でその方法を確認できます。 ## サブエージェント [サブエージェント](https://code.claude.com/docs/en/sub-agents) は、特定のサイドタスク用の孤立したアシスタントを定義する .claude/agents/ ディレクトリ内のマークダウンファイルです。各ファイルは YAML フロントマター（名前、説明、およびモデルやツールアクセスに関するオプションフィールド）で始まり、その後に続く本文がサブエージェントのシステムプロンプトとなります。 サブエージェントはスキルと同様に、名前、説明、ツールリストがセッション開始時に読み込まれますが、エージェント本体内のより大きなコンテキストは自動的に呼び出されません。Claude は Agent ツールを介してサブエージェントを呼び出し、プロンプト文字列を渡します。 ![image](https://cdn.prod.website-files.com/68a44d4040f98a4adf2207b6/6a340f852d1f938ab86755a2_914c1942.png) Claude Code のコンテキストウィンドウには、セッションに関する Claude が知っているすべての情報が保持されます。[インタラクティブなタイムライン](https://code.claude.com/docs/en/context-window) では、何がいつ読み込まれるかが解説されています。サブエージェント本体内のより大きな指示用コンテキストが自動的に呼び出されないだけでなく、親会話に全く入力されることもありません。 その後、サブエージェントは独自の新しいコンテキストウィンドウで実行され、メインセッションに戻ってくるのはサブエージェントの最終メッセージ（多くの下位タスクの結果を集約したもの）とメタデータのみです。 このパターンはスケーラブルです：サブエージェントは最大 5 レベルまでネスト可能であり、[動的ワークフロー](https://claude.com/blog/a-harness-for-every-task-dynamic-workflows-in-claude-code) が各サブエージェントアーキテクチャの詳細を指定することなく、数十から数百のバックグラウンドエージェントをオーケストレートします。オーケストレーション計画と中間結果は Claude のコンテキストウィンドウではなくスクリプト変数に保存されるため、指示の忠実性を失うことなくスケールが可能になります。 **ヒント:** この分離性が、スキルではなくサブエージェントを利用する主な理由の一つです。深い検索やログ分析のパス、依存関係監査などの中継結果がメインの会話に混入し、後で参照されなくなるようなサイドタスクを行う場合はサブエージェントを使用してください。一方、各ステップを確認して制御したい手順をメインスレッド内で実行させたい場合はスキルを使用します。 ## フック [フック](https://code.claude.com/docs/en/hooks-guide)は、ユーザーが定義したコマンド、HTTP エンドポイント、または LLM プロンプトであり、ファイル編集、ツール呼び出し、セッション開始といった [Claude のライフサイクル内の特定イベント](https://code.claude.com/docs/en/hooks#hook-lifecycle) で発火することで、Claude の動作に対してより決定論的な制御を提供します。 ![image](https://cdn.prod.website-files.com/68a44d4040f98a4adf2207b6/6a340f852d1f938ab867559c_e782277c.png) フックが発火する可能性のある Claude Code セッション内のイベントマップ。フックは settings.json、管理ポリシー設定、またはスキル/エージェントのフロントマターに登録します。 フックにはいくつかの種類があります：コマンド、HTTP、mcp_tool、プロンプト、およびエージェントです。すべてのフックは決定論的にトリガーされますが、最初の 3 つ（コマンド、HTTP、mcp_tool）は決定論的に実行されるのに対し、後者の 2 つ（プロンプトとエージェント）は出力を決定するためにルールセットではなく Claude の判断を使用します。 フックは、設定や指示がメインのコンテキストウィンドウの外側に存在するため、コンテキストコストが低くなります。ハーンは、フックの種類に応じて、ハンドラー（コマンド、HTTP、MCP ツール）を実行するか、別々のウィンドウ（プロンプト、エージェント）を使用してモデル呼び出しを行います。 一部のフックでは、出力がメインのコンテキストウィンドウに保存される場合があります。例えば、ブロッキングフックの標準エラーはコンテキスト内に保存され、Claude がその呼び出しが拒否された理由を理解できるようにします。 ただし、設定で明示的に返さない限り、ほとんどのフックの出力がメインウィンドウに保存されることはありません。PreCompact イベントを使用して、コンパクション前にチャット履歴を別のファイルにバックアップした場合、Claude はどのファイルにチャット履歴が保存されたかを認識できません。 このため、これらのフックタイプは CLAUDE.md、ルール、スキルとは根本的に異なります。詳細については、当社の投稿「[フックの設定方法](https://claude.com/blog/how-to-configure-hooks)」をご覧ください。 **ヒント:** 決定論的に行うべきこと（編集後のリンター実行、完了時の Slack への投稿、実行前の特定コマンドのブロックなど）にはフックを使用してください。PreToolUse フックは任意のツール呼び出しを検査し、コード 2 を返して拒否することができます。 これらは Claude に読み込まれてコンテキストに含まれる指示ではなく、ハーンが実行するコードであるため、コンテキストコストが低くなります。 ## 出力スタイル [出力スタイル](https://code.claude.com/docs/en/output-styles) は、.claude/output-styles/ ディレクトリ内のファイルであり、システムプロンプトに指示を注入するものです。これらは圧縮されず、セッション開始時に毎回読み込まれ、セッション内の最初の要求以降はキャッシュされるため、中程度のコンテキストコストがかかります。 システムプロンプト上に位置するため、出力スタイルはこれまで紹介した手法の中で最も高い指示従順性を持ち、慎重に使用する必要があります。 **出力スタイルの変更は、デフォルトの出力スタイルを置き換えます**（ただし、スタイルのフロントマターで `keep-coding-instructions: true` を設定している場合は除きます）。 Claude Code においてこれは、Claude がソフトウェアエンジニアリングタスクの支援を行っていることを示す指示や、セキュリティへの懸念への対応方法、作業完了前にテストを実行するなどの検証習慣など、他の重要なデフォルト指示をすべて削除することになります。デフォルトでは、カスタム出力スタイルはこれらすべての指示をドロップし、Claude Code はソフトウェアエンジニアアシスタントというよりも一般的なアシスタントとして振る舞うようになります。 **ヒント**: カスタム出力スタイルを作成する前に、組み込みのスタイルを確認してください。**Proactive**（積極的）、**Explanatory**（説明的）、および **Learning**（学習）は、スタイルファイルの維持を必要とせず、自律性、ティーチングモード、共同コーディングという最も一般的なニーズをカバーしています。 ## システムプロンプトの追加 出力スタイルを変更する代替手段として、append-system-prompt（システムプロンプト追加）フラグがあります。出力スタイルファイルを変更すると Claude の動作に予期せぬ大きな影響を与える可能性がある一方、この追加フラグは元のシステムプロンプトに対して単に加算されるのみです。Claude の役割自体を変更するのではなく、デフォルトの役割に対して指示を追加するだけです。 また、これは呼び出し時に渡され、セッション間でファイルとして永続化されるものではなく、その呼び出し時のみに適用されます。 他の方法で指示を渡す場合に比べて、システムプロンプトを追加するとコンテキストコストが高くなる可能性があります。入力トークン数が増加しますが、セッション内の最初の要求以降はプロンプトキャッシングによりこのコストが軽減されます。また、Claude により詳細または長いスタイルを使用するよう指示すると、出力トークン数も増加します。 **ヒント:** システムプロンプトの追加は、特定のコーディング規約、出力フォーマット、またはドメイン固有の知識を追加する場合に最も適しています。この方法で提供される指示が多くなるほど、遵守度合いが低下するという限界効果があることを念頭に置いてください。特に、指示同士が矛盾する場合はその傾向が強まります。 ## Claude Code カスタマイズのためのクイックヒント もしあなたが以下のいずれかの状況にあると感じるなら、指示を別の場所に配置することを検討してください： **「X のたびに Y を行う」を CLAUDE.md に記載する。** 編集のたびに prettier を実行する、完了時に Slack に投稿するなど、確実に発生させるべき動作がある場合は、settings.json でフックを使用してください。モデルがフォーマッターを実行することを選択するのは、フォーマッターが自動的に実行されることとは異なります。 **「決してこれを行わない」を CLAUDE.md に記載しない。** 絶対に起こしてはならない事柄がある場合、指示はそのための適切なツールではありません。Claude は通常その指示に従いますが、圧力下にあるとき、セッションが長い場合や状況が曖昧な場合、あるいはタスクの一部としてアクセスされたファイル内のプロンプトインジェクションによって、モデルがプロンプトされたルールに従わない可能性があります。真のガードレールは決定論的である必要があり、その強制手段は [hooks](https://code.claude.com/docs/en/hooks) と [permissions](https://code.claude.com/docs/en/permissions) です。PreToolUse フックでは呼び出しを検査し、コード 2 で終了してブロックすることができます。[Managed settings](https://code.claude.com/docs/en/settings#managed-settings)** **はさらに先を行きます：これらは管理者によってデプロイされ、ユーザーのローカル設定で上書きできず、組織全体にわたる決定論的なガードレールを強制するための唯一の方法です。 **CLAUDE.md に 30 行の手順を記載しない。** 手順はスキル（skills）に属します。CLAUDE.md は、Claude が常に保持すべき事実（ビルドコマンド、モノリポジトリのレイアウト、チームの慣習など）のためのものです。デプロイメントの実行手順やセキュリティレビューのチェックリストは .claude/skills/ に置くべきです。これらは呼び出されたときにのみ本文が読み込まれます。 **パスを指定しない API 固有のルール。**もしルールが `src/api/**` のみに適用される場合、パスでスコープを限定することで、無関係な作業中にコンテキストから除外できます。スコープを指定しないルールは、機械的には CLAUDE.md ファイルに内容を記述したものと同一です：常に読み込まれ、常にトークンを消費します。 **個人用設定をプロジェクトレベルの CLAUDE.md ファイルに書き込むこと。**ファイルベースの方法には、どのリポジトリにいるかに関わらず、すべての Claude Code セッションで読み込まれるユーザーレベルの対応策が存在します。個人用設定にはローカルファイルを使用してください（常に意味のあるコミットメッセージを使用すること）。チーム全体向けだが特定のコードベースに固有の設定は、プロジェクトレベルのファイルに記述してください。 ## はじめに 環境の構成から並列セッションでのスケーリングまで、Claude Code を最大限に活用するためのより多くのヒントやパターンは、[Claude Code のベストプラクティス](https://code.claude.com/docs/en/best-practices#write-an-effective-claude-md)ドキュメントで見つけることができます。 これらのいくつかを動作させたら、スキル、サブエージェント、フック、出力スタイルなどを [プラグイン](https://code.claude.com/docs/en/plugins) としてバンドルし、チームメンバーやプロジェクト間で一貫したセットアップを共有できるようにすることもできます。

Claude Code の操作：CLAUDE.md ファイル、スキル、フック、ルール、サブエージェントなど

背景や根拠まで確認しますか？

調べる

選ぶ

サイト

背景や根拠まで確認しますか？

ニュースの次に確認する

調べる

選ぶ

サイト