8 8
9Claude Code は、コードについて推論するモデルと、ファイル操作、検索、実行、ウェブアクセス用の[組み込みツール](/docs/ja/how-claude-code-works#tools)を組み合わせています。組み込みツールはほとんどのコーディングタスクをカバーしています。このガイドは拡張レイヤーについて説明します。つまり、Claude が何を知るかをカスタマイズし、外部サービスに接続し、ワークフローを自動化するために追加する機能です。9Claude Code は、コードについて推論するモデルと、ファイル操作、検索、実行、ウェブアクセス用の[組み込みツール](/docs/ja/how-claude-code-works#tools)を組み合わせています。組み込みツールはほとんどのコーディングタスクをカバーしています。このガイドは拡張レイヤーについて説明します。つまり、Claude が何を知るかをカスタマイズし、外部サービスに接続し、ワークフローを自動化するために追加する機能です。
10 10
11<Note>11> [!NOTE]
12 コア agentic ループがどのように機能するかについては、[How Claude Code works](/docs/ja/how-claude-code-works) を参照してください。12>
13</Note>13> コア agentic ループがどのように機能するかについては、[How Claude Code works](/docs/ja/how-claude-code-works) を参照してください。
14 14
15**Claude Code は初めてですか?** [CLAUDE.md](/docs/ja/memory) でプロジェクト規約を開始します。その後、[特定のトリガーが発生したときに](#build-your-setup-over-time)他の拡張機能を追加してください。15**Claude Code は初めてですか?** [CLAUDE.md](/docs/ja/memory) でプロジェクト規約を開始します。その後、[特定のトリガーが発生したときに](#build-your-setup-over-time)他の拡張機能を追加してください。
16 16
17<h2 id="overview">17## 概要
18 概要
19</h2>
20 18
21拡張機能は agentic ループのさまざまな部分に接続します。19拡張機能は agentic ループのさまざまな部分に接続します。
22 20
33 31
34[Skills](/docs/ja/skills) は最も柔軟な拡張機能です。スキルは知識、ワークフロー、または指示を含むマークダウンファイルです。`/deploy` のようなコマンドでスキルを呼び出すことができます。または Claude は関連する場合に自動的にスキルをロードできます。スキルは現在の会話で実行することも、subagents を介して独立したコンテキストで実行することもできます。32[Skills](/docs/ja/skills) は最も柔軟な拡張機能です。スキルは知識、ワークフロー、または指示を含むマークダウンファイルです。`/deploy` のようなコマンドでスキルを呼び出すことができます。または Claude は関連する場合に自動的にスキルをロードできます。スキルは現在の会話で実行することも、subagents を介して独立したコンテキストで実行することもできます。
35 33
36<h2 id="match-features-to-your-goal">34## 目標に合わせて機能を選択する
37 目標に合わせて機能を選択する
38</h2>
39 35
40機能は、Claude がすべてのセッションで見る常時オンのコンテキストから、ユーザーまたは Claude が呼び出せるオンデマンド機能、特定のイベントで実行されるバックグラウンド自動化まで、様々な範囲に及びます。以下の表は、利用可能な機能と、各機能が適切な場面を示しています。36機能は、Claude がすべてのセッションで見る常時オンのコンテキストから、ユーザーまたは Claude が呼び出せるオンデマンド機能、特定のイベントで実行されるバックグラウンド自動化まで、様々な範囲に及びます。以下の表は、利用可能な機能と、各機能が適切な場面を示しています。
41 37
54 50
55**[Plugins](/docs/ja/plugins/overview)** はパッケージングレイヤーです。プラグインはスキル、フック、subagent、MCP サーバーを単一のインストール可能なユニットにバンドルします。プラグインスキルは名前空間化されているため(`/my-plugin:review` など)、複数のプラグインが共存できます。複数のリポジトリ全体で同じセットアップを再利用したい場合、または **[marketplace](/docs/ja/plugins/overview)** を通じて他のユーザーに配布したい場合はプラグインを使用します。51**[Plugins](/docs/ja/plugins/overview)** はパッケージングレイヤーです。プラグインはスキル、フック、subagent、MCP サーバーを単一のインストール可能なユニットにバンドルします。プラグインスキルは名前空間化されているため(`/my-plugin:review` など)、複数のプラグインが共存できます。複数のリポジトリ全体で同じセットアップを再利用したい場合、または **[marketplace](/docs/ja/plugins/overview)** を通じて他のユーザーに配布したい場合はプラグインを使用します。
56 52
57<h3 id="build-your-setup-over-time">53### セットアップを時間をかけて構築する
58 セットアップを時間をかけて構築する
59</h3>
60 54
61すべてを事前に設定する必要はありません。各機能には認識可能なトリガーがあり、ほとんどのチームはおおよそこの順序で追加します。55すべてを事前に設定する必要はありません。各機能には認識可能なトリガーがあり、ほとんどのチームはおおよそこの順序で追加します。
62 56
74 68
75同じトリガーは、既に持っているものを更新するタイミングを示します。繰り返される間違いまたは繰り返されるレビューコメントは、チャットでの 1 回限りの修正ではなく、CLAUDE.md の編集です。手動で何度も調整するワークフローは、別の改訂が必要なスキルです。69同じトリガーは、既に持っているものを更新するタイミングを示します。繰り返される間違いまたは繰り返されるレビューコメントは、チャットでの 1 回限りの修正ではなく、CLAUDE.md の編集です。手動で何度も調整するワークフローは、別の改訂が必要なスキルです。
76 70
77<h3 id="compare-similar-features">71### 類似機能を比較する
78 類似機能を比較する
79</h3>
80 72
81一部の機能は似ているように見えることがあります。それらの間で選択するためのより深い説明については、ブログの [Steering Claude Code: when to use CLAUDE.md, skills, hooks, and subagents](https://claude.com/blog/steering-claude-code-skills-hooks-rules-subagents-and-more) を参照してください。それらを区別する方法は次のとおりです。73一部の機能は似ているように見えることがあります。それらの間で選択するためのより深い説明については、ブログの [Steering Claude Code: when to use CLAUDE.md, skills, hooks, and subagents](https://claude.com/blog/steering-claude-code-skills-hooks-rules-subagents-and-more) を参照してください。それらを区別する方法は次のとおりです。
82 74
83<Tabs>75**Skill vs Subagent**
84 <Tab title="Skill vs Subagent">
85 スキルと subagent は異なる問題を解決します。
86 76
87 * **Skills** は任意のコンテキストに読み込める再利用可能なコンテンツです77スキルと subagent は異なる問題を解決します。
88 * **Subagents** はメインの会話とは別に実行される分離されたワーカーです
89 78
90 | 側面 | Skill | Subagent |79* **Skills** は任意のコンテキストに読み込める再利用可能なコンテンツです
91 | - | - | - |80* **Subagents** はメインの会話とは別に実行される分離されたワーカーです
92 | **それは何か** | 再利用可能な指示、知識、またはワークフロー | 独自のコンテキストを持つ分離されたワーカー |
93 | **主な利点** | コンテキスト全体でコンテンツを共有する | コンテキスト分離。作業は別々に実行され、要約のみが返される |
94 | **[Context window](/docs/ja/context-window) への影響** | メインウィンドウに追加される | 独自の入力および出力トークンを持つ別のウィンドウを使用する |
95 | **最適な用途** | 参照資料、呼び出し可能なワークフロー | 多くのファイルを読み取るタスク、並列作業、専門的なワーカー |
96 81
97 **スキルは参照またはアクションです。** 参照スキルは Claude がセッション全体で使用する知識を提供します(API スタイルガイドなど)。アクション スキルは Claude に特定の操作を実行するよう指示します(デプロイメント ワークフローを実行する `/deploy` など)。82| 側面 | Skill | Subagent |
83| - | - | - |
84| **それは何か** | 再利用可能な指示、知識、またはワークフロー | 独自のコンテキストを持つ分離されたワーカー |
85| **主な利点** | コンテキスト全体でコンテンツを共有する | コンテキスト分離。作業は別々に実行され、要約のみが返される |
86| **[Context window](/docs/ja/context-window) への影響** | メインウィンドウに追加される | 独自の入力および出力トークンを持つ別のウィンドウを使用する |
87| **最適な用途** | 参照資料、呼び出し可能なワークフロー | 多くのファイルを読み取るタスク、並列作業、専門的なワーカー |
88
89**スキルは参照またはアクションです。** 参照スキルは Claude がセッション全体で使用する知識を提供します(API スタイルガイドなど)。アクション スキルは Claude に特定の操作を実行するよう指示します(デプロイメント ワークフローを実行する `/deploy` など)。
90
91**コンテキスト分離が必要な場合、または コンテキスト ウィンドウが満杯になっている場合は subagent を使用します。** subagent は数十のファイルを読み取ったり、広範な検索を実行したりする可能性がありますが、メインの会話は要約のみを受け取ります。subagent の作業はメインコンテキストを消費しないため、中間作業を表示したままにする必要がない場合にも便利です。カスタム subagent は独自の指示を持つことができ、スキルをプリロードできます。
92
93**それらは組み合わせることができます。** subagent は特定のスキルをプリロードできます(`skills:` フィールド)。スキルは `context: fork` を使用して分離されたコンテキストで実行できます。詳細は [Skills](/docs/ja/skills) を参照してください。
94
95**CLAUDE.md vs Skill**
96
97どちらも指示を保存しますが、読み込み方法と目的が異なります。
98
99| 側面 | CLAUDE.md | Skill |
100| - | - | - |
101| **読み込み** | すべてのセッション、自動的に | オンデマンド |
102| **ファイルを含めることができる** | はい、`@path` インポート付き | はい、`@path` インポート付き |
103| **ワークフローをトリガーできる** | いいえ | はい、`/<name>` 付き |
104| **最適な用途** | 「常に X を実行する」ルール | 参照資料、呼び出し可能なワークフロー |
105
106**Claude が常に知っておくべき場合は CLAUDE.md に入れます。** コーディング規約、ビルドコマンド、プロジェクト構造、「X を実行しないでください」ルール。
98 107
99 **コンテキスト分離が必要な場合、または コンテキスト ウィンドウが満杯になっている場合は subagent を使用します。** subagent は数十のファイルを読み取ったり、広範な検索を実行したりする可能性がありますが、メインの会話は要約のみを受け取ります。subagent の作業はメインコンテキストを消費しないため、中間作業を表示したままにする必要がない場合にも便利です。カスタム subagent は独自の指示を持つことができ、スキルをプリロードできます。108**Claude が時々必要とする参照資料(API ドキュメント、スタイルガイド)または `/<name>` でトリガーするワークフロー(デプロイ、レビュー、リリース)の場合は、スキルに入れます。**
100 109
101 **それらは組み合わせることができます。** subagent は特定のスキルをプリロードできます(`skills:` フィールド)。スキルは `context: fork` を使用して分離されたコンテキストで実行できます。詳細は [Skills](/docs/ja/skills) を参照してください。110**経験則:** CLAUDE.md を 200 行以下に保ちます。成長している場合は、参照コンテンツをスキルに移動するか、[`.claude/rules/`](/docs/ja/memory#organize-rules-with-claude/rules/) ファイルに分割します。
102 </Tab>
103 111
104 <Tab title="CLAUDE.md vs Skill">112**CLAUDE.md vs Output style**
105 どちらも指示を保存しますが、読み込み方法と目的が異なります。
106 113
107 | 側面 | CLAUDE.md | Skill |114どちらも Claude に常時指示を与えます。CLAUDE.md は Claude が知っておくべきことを含み、output style は Claude がどのように応答するかを設定します。
108 | - | - | - |
109 | **読み込み** | すべてのセッション、自動的に | オンデマンド |
110 | **ファイルを含めることができる** | はい、`@path` インポート付き | はい、`@path` インポート付き |
111 | **ワークフローをトリガーできる** | いいえ | はい、`/<name>` 付き |
112 | **最適な用途** | 「常に X を実行する」ルール | 参照資料、呼び出し可能なワークフロー |
113 115
114 **Claude が常に知っておくべき場合は CLAUDE.md に入れます。** コーディング規約、ビルドコマンド、プロジェクト構造、「X を実行しないでください」ルール。116| 側面 | CLAUDE.md | Output style |
117| - | - | - |
118| **保持する** | プロジェクトに関する事実とルール | ロール、トーン、応答形式 |
119| **切り替え** | 常に読み込まれる | 一度に 1 つアクティブ。[スタイルを切り替える](/docs/ja/output-styles#change-your-output-style) ことはいつでも可能 |
120| **最適な用途** | ビルドコマンド、規約、「X を実行しないでください」ルール | より短い応答、コードと一緒に説明、非エンジニアリングロール |
115 121
116 **Claude が時々必要とする参照資料(API ドキュメント、スタイルガイド)または `/<name>` でトリガーするワークフロー(デプロイ、レビュー、リリース)の場合は、スキルに入れます。**122**プロジェクトに対して真実である場合は CLAUDE.md に入れます。** どのスタイルを使用していても、コーディング規約、ビルドコマンド、プロジェクト構造。
117 123
118 **経験則:** CLAUDE.md を 200 行以下に保ちます。成長している場合は、参照コンテンツをスキルに移動するか、[`.claude/rules/`](/docs/ja/memory#organize-rules-with-claude/rules/) ファイルに分割します。124**応答自体に関するもので、再度オフにしたい場合は output style を使用します。** 長さ、形式、Claude がどの程度説明するか、またはライティングアシスタントなどの異なるロール。Claude Code には [組み込みスタイル](/docs/ja/output-styles#built-in-output-styles) が含まれており、独自のスタイルを作成できます。
119 </Tab>
120 125
121 <Tab title="CLAUDE.md vs Output style">126**それらは組み合わせます。** CLAUDE.md はどのスタイルを選択しても読み込まれたままです。Claude は両方を指示として従うため、どちらも強制されません。毎回実行する必要があるものについては、[hook](/docs/ja/hooks-guide) を使用します。
122 どちらも Claude に常時指示を与えます。CLAUDE.md は Claude が知っておくべきことを含み、output style は Claude がどのように応答するかを設定します。
123 127
124 | 側面 | CLAUDE.md | Output style |128**CLAUDE.md vs Rules vs Skills**
125 | - | - | - |
126 | **保持する** | プロジェクトに関する事実とルール | ロール、トーン、応答形式 |
127 | **切り替え** | 常に読み込まれる | 一度に 1 つアクティブ。[スタイルを切り替える](/docs/ja/output-styles#change-your-output-style) ことはいつでも可能 |
128 | **最適な用途** | ビルドコマンド、規約、「X を実行しないでください」ルール | より短い応答、コードと一緒に説明、非エンジニアリングロール |
129 129
130 **プロジェクトに対して真実である場合は CLAUDE.md に入れます。** どのスタイルを使用していても、コーディング規約、ビルドコマンド、プロジェクト構造。1303 つすべてが指示を保存しますが、読み込み方法が異なります。
131 131
132 **応答自体に関するもので、再度オフにしたい場合は output style を使用します。** 長さ、形式、Claude がどの程度説明するか、またはライティングアシスタントなどの異なるロール。Claude Code には [組み込みスタイル](/docs/ja/output-styles#built-in-output-styles) が含まれており、独自のスタイルを作成できます。132| 側面 | CLAUDE.md | `.claude/rules/` | Skill |
133| - | - | - | - |
134| **読み込み** | すべてのセッション | すべてのセッション、または一致するファイルが開かれたとき | オンデマンド、呼び出されたとき、または関連があるとき |
135| **スコープ** | プロジェクト全体 | ファイルパスにスコープできる | タスク固有 |
136| **最適な用途** | コア規約とビルドコマンド | 言語固有またはディレクトリ固有のガイドライン | 参照資料、繰り返しワークフロー |
133 137
134 **それらは組み合わせます。** CLAUDE.md はどのスタイルを選択しても読み込まれたままです。Claude は両方を指示として従うため、どちらも強制されません。毎回実行する必要があるものについては、[hook](/docs/ja/hooks-guide) を使用します。138**すべてのセッションが必要とする指示には CLAUDE.md を使用します。** ビルドコマンド、テスト規約、プロジェクトアーキテクチャ。
135 </Tab>
136 139
137 <Tab title="CLAUDE.md vs Rules vs Skills">140**CLAUDE.md を焦点を当てるためにルールを使用します。** [`paths` frontmatter](/docs/ja/memory#path-specific-rules) を持つルールは、Claude が一致するファイルで作業するときのみ読み込まれ、コンテキストを節約します。
138 3 つすべてが指示を保存しますが、読み込み方法が異なります。
139 141
140 | 側面 | CLAUDE.md | `.claude/rules/` | Skill |142**Claude が時々必要とするコンテンツ(API ドキュメントまたは `/<name>` でトリガーするデプロイメントチェックリスト)にはスキルを使用します。**
141 | - | - | - | - |
142 | **読み込み** | すべてのセッション | すべてのセッション、または一致するファイルが開かれたとき | オンデマンド、呼び出されたとき、または関連があるとき |
143 | **スコープ** | プロジェクト全体 | ファイルパスにスコープできる | タスク固有 |
144 | **最適な用途** | コア規約とビルドコマンド | 言語固有またはディレクトリ固有のガイドライン | 参照資料、繰り返しワークフロー |
145 143
146 **すべてのセッションが必要とする指示には CLAUDE.md を使用します。** ビルドコマンド、テスト規約、プロジェクトアーキテクチャ。144**Subagent vs Dynamic workflow**
147 145
148 **CLAUDE.md を焦点を当てるためにルールを使用します。** [`paths` frontmatter](/docs/ja/memory#path-specific-rules) を持つルールは、Claude が一致するファイルで作業するときのみ読み込まれ、コンテキストを節約します。146どちらもメインの会話の外で作業を実行します。subagent では、Claude はターンごとに次に実行するものを決定します。ワークフローでは、スクリプトが決定します。
149 147
150 **Claude が時々必要とするコンテンツ(API ドキュメントまたは `/<name>` でトリガーするデプロイメントチェックリスト)にはスキルを使用します。**148* **Subagents** は Claude が生成するワーカーで、各ワーカーが会話を生成したものに要約を返す
151 </Tab>149* **[Dynamic workflows](/docs/ja/workflows)** は Claude が作成するスクリプトで、バックグラウンドで多くの subagent を実行し、1 つの結果を返す
152 150
153 <Tab title="Subagent vs Dynamic workflow">151**クイックで焦点を当てたワーカーが必要な場合は subagent を使用します。** 質問を調査する、主張を検証する、ファイルをレビューする。subagent は作業を実行して要約を返すため、メインの会話はクリーンなままです。Claude が生成したときに名前を付けた Subagent は、相互に [メッセージを送信](/docs/ja/sub-agents#what-loads-at-startup) することもできます。
154 どちらもメインの会話の外で作業を実行します。subagent では、Claude はターンごとに次に実行するものを決定します。ワークフローでは、スクリプトが決定します。
155 152
156 * **Subagents** は Claude が生成するワーカーで、各ワーカーが会話を生成したものに要約を返す153**ジョブが [複数の subagent を超えて成長する](/docs/ja/workflows#when-to-use-a-workflow) 場合、または結果を見る前に複数の検証を希望する場合は、動的ワークフローを使用します。** コードベース全体の監査、大規模な移行、複数の角度から作成されたプランなど。開始するには、[プロンプトでワークフローを要求します](/docs/ja/workflows#ask-for-a-workflow-in-your-prompt)。
157 * **[Dynamic workflows](/docs/ja/workflows)** は Claude が作成するスクリプトで、バックグラウンドで多くの subagent を実行し、1 つの結果を返す
158 154
159 **クイックで焦点を当てたワーカーが必要な場合は subagent を使用します。** 質問を調査する、主張を検証する、ファイルをレビューする。subagent は作業を実行して要約を返すため、メインの会話はクリーンなままです。Claude が生成したときに名前を付けた Subagent は、相互に [メッセージを送信](/docs/ja/sub-agents#what-loads-at-startup) することもできます。155**セッションの 1 つから別のセッションに結果を渡すには、** 最初のセッションの Claude に送信するよう依頼します。Claude は [cross-session messaging](/docs/ja/cross-session-messaging) で配信します。[複数の Claude を並列で実行](/docs/ja/agents) は、セッションを手渡して後で確認するなど、複数の Claude を一度に実行する他の方法を比較します。
160 156
161 **ジョブが [複数の subagent を超えて成長する](/docs/ja/workflows#when-to-use-a-workflow) 場合、または結果を見る前に複数の検証を希望する場合は、動的ワークフローを使用します。** コードベース全体の監査、大規模な移行、複数の角度から作成されたプランなど。開始するには、[プロンプトでワークフローを要求します](/docs/ja/workflows#ask-for-a-workflow-in-your-prompt)。157**MCP vs Skill**
162 158
163 **セッションの 1 つから別のセッションに結果を渡すには、** 最初のセッションの Claude に送信するよう依頼します。Claude は [cross-session messaging](/docs/ja/cross-session-messaging) で配信します。[複数の Claude を並列で実行](/docs/ja/agents) は、セッションを手渡して後で確認するなど、複数の Claude を一度に実行する他の方法を比較します。159MCP は Claude を外部サービスに接続します。スキルは Claude が知っていることを拡張し、それらのサービスを効果的に使用する方法を含みます。
164 </Tab>
165 160
166 <Tab title="MCP vs Skill">161| 側面 | MCP | Skill |
167 MCP は Claude を外部サービスに接続します。スキルは Claude が知っていることを拡張し、それらのサービスを効果的に使用する方法を含みます。162| - | - | - |
163| **それは何か** | 外部サービスに接続するためのプロトコル | 知識、ワークフロー、参照資料 |
164| **提供する** | ツールとデータアクセス | 知識、ワークフロー、参照資料 |
165| **例** | Slack 統合、データベースクエリ、ブラウザ制御 | コードレビューチェックリスト、デプロイワークフロー、API スタイルガイド |
168 166
169 | 側面 | MCP | Skill |167これらは異なる問題を解決し、一緒に機能します。
170 | - | - | - |
171 | **それは何か** | 外部サービスに接続するためのプロトコル | 知識、ワークフロー、参照資料 |
172 | **提供する** | ツールとデータアクセス | 知識、ワークフロー、参照資料 |
173 | **例** | Slack 統合、データベースクエリ、ブラウザ制御 | コードレビューチェックリスト、デプロイワークフロー、API スタイルガイド |
174 168
175 これらは異なる問題を解決し、一緒に機能します。169**MCP** は Claude に外部システム用の目的に合わせたツールを提供し、接続と認証はサーバーによって処理されます。
176 170
177 **MCP** は Claude に外部システム用の目的に合わせたツールを提供し、接続と認証はサーバーによって処理されます。171**スキル** は Claude にそれらのツールを効果的に使用する方法についての知識を提供し、さらに `/<name>` でトリガーできるワークフローを提供します。スキルには、チームのデータベーススキーマとクエリパターン、または `/post-to-slack` ワークフロー(チームのメッセージフォーマットルール付き)が含まれる場合があります。
178 172
179 **スキル** は Claude にそれらのツールを効果的に使用する方法についての知識を提供し、さらに `/<name>` でトリガーできるワークフローを提供します。スキルには、チームのデータベーススキーマとクエリパターン、または `/post-to-slack` ワークフロー(チームのメッセージフォーマットルール付き)が含まれる場合があります。173**Hook vs Skill**
180 </Tab>
181 174
182 <Tab title="Hook vs Skill">175Claude Code はライフサイクルイベントでフックを実行します。コンテキストにスキルを読み込んで Claude が適用します。
183 Claude Code はライフサイクルイベントでフックを実行します。コンテキストにスキルを読み込んで Claude が適用します。
184 176
185 | 側面 | Hook | Skill |177| 側面 | Hook | Skill |
186 | - | - | - |178| - | - | - |
187 | **実行** | シェルコマンド、HTTP リクエスト、MCP ツール呼び出し、LLM プロンプト、または subagent | Claude が読み取って従う指示 |179| **実行** | シェルコマンド、HTTP リクエスト、MCP ツール呼び出し、LLM プロンプト、または subagent | Claude が読み取って従う指示 |
188 | **トリガー** | [ライフサイクルイベント](/docs/ja/hooks#hook-events)(`PostToolUse` または `SessionStart` など) | `/<name>` を入力するか、Claude が説明をタスクに一致させる |180| **トリガー** | [ライフサイクルイベント](/docs/ja/hooks#hook-events)(`PostToolUse` または `SessionStart` など) | `/<name>` を入力するか、Claude が説明をタスクに一致させる |
189 | **決定論** | Claude の判断なしにイベントで発火します | Claude が指示を解釈します。結果は異なる場合があります |181| **決定論** | Claude の判断なしにイベントで発火します | Claude が指示を解釈します。結果は異なる場合があります |
190 | **コンテキストコスト** | フックが出力を返さない限りゼロ | 説明は各セッションで読み込まれます。完全なコンテンツは使用時に読み込まれます |182| **コンテキストコスト** | フックが出力を返さない限りゼロ | 説明は各セッションで読み込まれます。完全なコンテンツは使用時に読み込まれます |
191 | **最適な用途** | 編集後のリント、安全でないコマンドのブロック、ログ、通知 | Claude が手順を適用する方法を決定する必要があるワークフロー、参照資料、複数ステップのタスク |183| **最適な用途** | 編集後のリント、安全でないコマンドのブロック、ログ、通知 | Claude が手順を適用する方法を決定する必要があるワークフロー、参照資料、複数ステップのタスク |
192 184
193 **アクションが毎回同じ方法で実行される必要があり、Claude が考える必要がない場合は、フックを使用します。** 例えば、保存時にフォーマットする、`rm -rf /` を拒否する、セッション終了時に Slack メッセージを投稿する。185**アクションが毎回同じ方法で実行される必要があり、Claude が考える必要がない場合は、フックを使用します。** 例えば、保存時にフォーマットする、`rm -rf /` を拒否する、セッション終了時に Slack メッセージを投稿する。
194 186
195 **Claude が手順を適用する方法を決定する必要がある場合、またはコンテンツが知識ではなくスクリプトの場合は、スキルを使用します。** 例えば、`/release` チェックリスト、API スタイルガイド、デバッグプレイブック。187**Claude が手順を適用する方法を決定する必要がある場合、またはコンテンツがスクリプトではなく知識の場合は、スキルを使用します。** 例えば、`/release` チェックリスト、API スタイルガイド、デバッグプレイブック。
196 188
197 **フックにガードレールを入れます。** CLAUDE.md またはスキルの「`.env` を編集しないでください」のような指示は要求であり、保証ではありません。編集をブロックする `PreToolUse` フックは強制です。ルールが毎回保持される必要がある場合は、プロンプト指示ではなくフックにします。189**フックにガードレールを入れます。** CLAUDE.md またはスキルの「`.env` を編集しないでください」のような指示は要求であり、保証ではありません。編集をブロックする `PreToolUse` フックは強制です。ルールが毎回保持される必要がある場合は、プロンプト指示ではなくフックにします。
198 190
199 **フック出力はコンテキストに着地します。** リンターを実行する `PostToolUse` フックは結果をテキストとして返し、Claude が読み取ります。`/fix-lint` スキルは Claude にそれらを解決する方法を指示します。191**フック出力はコンテキストに着地します。** リンターを実行する `PostToolUse` フックは結果をテキストとして返し、Claude が読み取ります。`/fix-lint` スキルは Claude にそれらを解決する方法を指示します。
200 </Tab>
201</Tabs>
202 192
203<h3 id="understand-how-features-layer">193### 機能がどのようにレイヤーするかを理解する
204 機能がどのようにレイヤーするかを理解する
205</h3>
206 194
207機能は複数のレベルで定義できます。ユーザー全体、プロジェクトごと、プラグイン経由、または管理ポリシーを通じて。CLAUDE.md ファイルをサブディレクトリにネストしたり、スキルをモノレポの特定のパッケージに配置したりすることもできます。同じ機能が複数のレベルに存在する場合、以下がレイヤーする方法です。195機能は複数のレベルで定義できます。ユーザー全体、プロジェクトごと、プラグイン経由、または管理ポリシーを通じて。CLAUDE.md ファイルをサブディレクトリにネストしたり、スキルをモノレポの特定のパッケージに配置したりすることもできます。同じ機能が複数のレベルに存在する場合、以下がレイヤーする方法です。
208 196
211* **MCP サーバー** は名前でオーバーライドします。ローカル > プロジェクト > ユーザー。[MCP スコープ](/docs/ja/mcp#scope-hierarchy-and-precedence) を参照してください。199* **MCP サーバー** は名前でオーバーライドします。ローカル > プロジェクト > ユーザー。[MCP スコープ](/docs/ja/mcp#scope-hierarchy-and-precedence) を参照してください。
212* **フック** はマージされます。登録されたすべてのフックは、ソースに関係なく、一致するイベントに対して発火します。[フック](/docs/ja/hooks) を参照してください。200* **フック** はマージされます。登録されたすべてのフックは、ソースに関係なく、一致するイベントに対して発火します。[フック](/docs/ja/hooks) を参照してください。
213 201
214<h3 id="combine-features">202### 機能を組み合わせる
215 機能を組み合わせる
216</h3>
217 203
218各拡張は異なる問題を解決します。CLAUDE.md は常時オンのコンテキストを処理し、スキルはオンデマンドの知識とワークフローを処理し、MCP は外部接続を処理し、subagent は分離を処理し、フックは自動化を処理します。実際のセットアップはワークフローに基づいてそれらを組み合わせます。204各拡張は異なる問題を解決します。CLAUDE.md は常時オンのコンテキストを処理し、スキルはオンデマンドの知識とワークフローを処理し、MCP は外部接続を処理し、subagent は分離を処理し、フックは自動化を処理します。実際のセットアップはワークフローに基づいてそれらを組み合わせます。
219 205
226| **CLAUDE.md + Skills** | CLAUDE.md は常時オンのルールを保持します。スキルはオンデマンドで読み込まれる参照資料を保持します | CLAUDE.md は「API 規約に従う」と言い、スキルは完全な API スタイルガイドを含みます |212| **CLAUDE.md + Skills** | CLAUDE.md は常時オンのルールを保持します。スキルはオンデマンドで読み込まれる参照資料を保持します | CLAUDE.md は「API 規約に従う」と言い、スキルは完全な API スタイルガイドを含みます |
227| **Hook + MCP** | フックは MCP を通じて外部アクションをトリガーします | 編集後フックは Claude が重要なファイルを変更するときに Slack 通知を送信します |213| **Hook + MCP** | フックは MCP を通じて外部アクションをトリガーします | 編集後フックは Claude が重要なファイルを変更するときに Slack 通知を送信します |
228 214
229<h2 id="understand-context-costs">215## コンテキストコストを理解する
230 コンテキストコストを理解する
231</h2>
232 216
233追加する各機能は Claude のコンテキストの一部を消費します。多すぎるとコンテキストウィンドウがいっぱいになる可能性がありますが、Claude の効果を低下させるノイズを追加することもできます。スキルが正しくトリガーされない場合や、Claude が規約を失う場合があります。これらのトレードオフを理解することで、効果的なセットアップを構築するのに役立ちます。実行中のセッションでこれらの機能がどのように組み合わされるかのインタラクティブビューについては、[コンテキストウィンドウを探索する](/docs/ja/context-window) を参照してください。217追加する各機能は Claude のコンテキストの一部を消費します。多すぎるとコンテキストウィンドウがいっぱいになる可能性がありますが、Claude の効果を低下させるノイズを追加することもできます。スキルが正しくトリガーされない場合や、Claude が規約を失う場合があります。これらのトレードオフを理解することで、効果的なセットアップを構築するのに役立ちます。実行中のセッションでこれらの機能がどのように組み合わされるかのインタラクティブビューについては、[コンテキストウィンドウを探索する](/docs/ja/context-window) を参照してください。
234 218
235<h3 id="context-cost-by-feature">219### 機能別のコンテキストコスト
236 機能別のコンテキストコスト
237</h3>
238 220
239各機能には異なるロード戦略とコンテキストコストがあります。221各機能には異なるロード戦略とコンテキストコストがあります。
240 222
250 232
251\*スキルのフロントマターで [`disable-model-invocation: true`](/docs/ja/skills#control-who-invokes-a-skill) を設定すると、その説明を Claude のコンテキストから除外できます。書いていないスキルの場合は、ファイルを編集せずに同じことを行うために設定で [`skillOverrides`](/docs/ja/skills#override-skill-visibility-from-settings) を設定します。233\*スキルのフロントマターで [`disable-model-invocation: true`](/docs/ja/skills#control-who-invokes-a-skill) を設定すると、その説明を Claude のコンテキストから除外できます。書いていないスキルの場合は、ファイルを編集せずに同じことを行うために設定で [`skillOverrides`](/docs/ja/skills#override-skill-visibility-from-settings) を設定します。
252 234
253<h3 id="understand-how-features-load">235### 機能がどのようにロードされるかを理解する
254 機能がどのようにロードされるかを理解する
255</h3>
256 236
257各機能はセッション内の異なるポイントでロードされます。以下のタブは、各機能がいつロードされるか、およびコンテキストに何が入るかを説明しています。237各機能はセッション内の異なるポイントでロードされます。以下のタブは、各機能がいつロードされるか、およびコンテキストに何が入るかを説明しています。
258 238
259<img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/context-loading.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=aab139e750494a237ae2e0c8f9139b0a" className="dark:hidden" alt="コンテキストロード:CLAUDE.md はセッション開始時にロードされ、すべてのリクエストに留まります。MCP ツール名は開始時にロードされ、完全なスキーマは使用時に遅延されます。スキルは開始時に説明をロードし、呼び出し時に完全なコンテンツをロードします。Subagents は独立したコンテキストを取得します。Hooks は外部で実行されます。" width="720" height="382" data-path="images/context-loading.svg" />239
240
241**CLAUDE.md**
242
243**時期:** セッション開始
244
245**ロード内容:** すべての CLAUDE.md ファイル(管理、ユーザー、プロジェクトレベル)の完全なコンテンツ。
246
247**継承:** Claude は作業ディレクトリからルートまで CLAUDE.md ファイルを読み取り、サブディレクトリにネストされたものを、それらのファイルにアクセスするときに検出します。詳細は [CLAUDE.md ファイルがどのようにロードされるか](/docs/ja/memory#how-claude-md-files-load) を参照してください。
248
249> [!TIP]
250>
251> CLAUDE.md を 200 行以下に保ちます。リファレンスマテリアルをスキルに移動します。スキルはオンデマンドでロードされます。[チェックインされた CLAUDE.md のトリム提案を取得する](/docs/ja/memory#my-claude-md-is-too-large) には、`/doctor` を実行します。
260 252
261<img src="https://mintcdn.com/claude-code/_xqph1dUOslCOwsj/images/context-loading-dark.svg?fit=max&auto=format&n=_xqph1dUOslCOwsj&q=85&s=b274089ef9612d9c760bca9838557626" className="hidden dark:block" alt="コンテキストロード:CLAUDE.md はセッション開始時にロードされ、すべてのリクエストに留まります。MCP ツール名は開始時にロードされ、完全なスキーマは使用時に遅延されます。スキルは開始時に説明をロードし、呼び出し時に完全なコンテンツをロードします。Subagents は独立したコンテキストを取得します。Hooks は外部で実行されます。" width="720" height="382" data-path="images/context-loading-dark.svg" />253**Skills**
262 254
263<Tabs>255スキルは Claude のツールキットの追加機能です。リファレンスマテリアル(API スタイルガイドなど)または `/<name>` でトリガーする呼び出し可能なワークフロー(`/deploy` など)です。Claude Code は `/code-review`、`/batch`、`/debug` などの[バンドルされたスキル](/docs/ja/commands) を備えており、すぐに機能します。独自のスキルを作成することもできます。
264 <Tab title="CLAUDE.md">
265 **時期:** セッション開始
266 256
267 **ロード内容:** すべての CLAUDE.md ファイル(管理、ユーザー、プロジェクトレベル)の完全なコンテンツ。257**時期:** スキルの設定によって異なります。デフォルトでは、説明はセッション開始時にロードされ、完全なコンテンツは使用時にロードされます。ユーザーのみのスキル(`disable-model-invocation: true`)の場合、呼び出すまで何もロードされません。
268 258
269 **継承:** Claude は作業ディレクトリからルートまで CLAUDE.md ファイルを読み取り、サブディレクトリにネストされたものを、それらのファイルにアクセスするときに検出します。詳細は [CLAUDE.md ファイルがどのようにロードされるか](/docs/ja/memory#how-claude-md-files-load) を参照してください。259**ロード内容:** モデル呼び出し可能なスキルの場合、Claude はすべてのリクエストで名前と説明を見ます。`/<name>` でスキルを呼び出すか、Claude が自動的にロードする場合、完全なコンテンツが会話にロードされます。
270 260
271 <Tip>CLAUDE.md を 200 行以下に保ちます。リファレンスマテリアルをスキルに移動します。スキルはオンデマンドでロードされます。[チェックインされた CLAUDE.md のトリム提案を取得する](/docs/ja/memory#my-claude-md-is-too-large) には、`/doctor` を実行します。</Tip>261**Claude がスキルを選択する方法:** Claude はタスクをスキル説明と照合して、関連するものを決定します。説明が曖昧または重複している場合、Claude は間違ったスキルをロードするか、役立つスキルを見落とす可能性があります。Claude に特定のスキルを使用するよう指示するには、`/<name>` で呼び出します。
272 </Tab>
273 262
274 <Tab title="Skills">263**コンテキストコスト:** 使用されるまで低い。ユーザーのみのスキルは呼び出されるまでゼロコストです。
275 スキルは Claude のツールキットの追加機能です。リファレンスマテリアル(API スタイルガイドなど)または `/<name>` でトリガーする呼び出し可能なワークフロー(`/deploy` など)です。Claude Code は `/code-review`、`/batch`、`/debug` などの[バンドルされたスキル](/docs/ja/commands) を備えており、すぐに機能します。独自のスキルを作成することもできます。
276 264
277 **時期:** スキルの設定によって異なります。デフォルトでは、説明はセッション開始時にロードされ、完全なコンテンツは使用時にロードされます。ユーザーのみのスキル(`disable-model-invocation: true`)の場合、呼び出すまで何もロードされません。265**Subagents 内:** スキルは subagents で異なる動作をします。オンデマンドロードの代わりに、subagent の `skills` フィールドにリストされているスキルは起動時にそのコンテキストに完全にプリロードされます。Subagents はスキルツールを通じて、リストされていないプロジェクト、ユーザー、プラグインスキルを発見して呼び出すことができます。
278 266
279 **ロード内容:** モデル呼び出し可能なスキルの場合、Claude はすべてのリクエストで名前と説明を見ます。`/<name>` でスキルを呼び出すか、Claude が自動的にロードする場合、完全なコンテンツが会話にロードされます。267> [!TIP]
268>
269> 副作用を持つスキルには `disable-model-invocation: true` を使用します。これによりコンテキストを節約でき、名前を指定したときにのみ実行されるようになります。
280 270
281 **Claude がスキルを選択する方法:** Claude はタスクをスキル説明と照合して、関連するものを決定します。説明が曖昧または重複している場合、Claude は間違ったスキルをロードするか、役立つスキルを見落とす可能性があります。Claude に特定のスキルを使用するよう指示するには、`/<name>` で呼び出します。271**MCP servers**
282 272
283 **コンテキストコスト:** 使用されるまで低い。ユーザーのみのスキルは呼び出されるまでゼロコストです。273**時期:** セッション開始。
284 274
285 **Subagents 内:** スキルは subagents で異なる動作をします。オンデマンドロードの代わりに、subagent の `skills` フィールドにリストされているスキルは起動時にそのコンテキストに完全にプリロードされます。Subagents はスキルツールを通じて、リストされていないプロジェクト、ユーザー、プラグインスキルを発見して呼び出すことができます。275**ロード内容:** 接続されたサーバーからのツール名とサーバー指示。完全な JSON スキーマは Claude が特定のツールを必要とするまで遅延されます。
286 276
287 <Tip>副作用を持つスキルには `disable-model-invocation: true` を使用します。これによりコンテキストを節約でき、名前を指定したときにのみ実行されるようになります。</Tip>277**コンテキストコスト:** [ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search) はデフォルトで有効になっているため、アイドル MCP ツールは最小限のコンテキストを消費します。
288 </Tab>
289 278
290 <Tab title="MCP servers">279> [!TIP]
291 **時期:** セッション開始。280>
281> `/mcp` を実行して各サーバーの接続ステータスを確認します。`/context all` を実行して、ロードされた各 MCP ツールが使用するトークン数を確認します。Claude Code は、リモートサーバーが切断された場合は[自動的に再接続](/docs/ja/mcp#automatic-reconnection) し、積極的に使用していないサーバーを切断できます。
292 282
293 **ロード内容:** 接続されたサーバーからのツール名とサーバー指示。完全な JSON スキーマは Claude が特定のツールを必要とするまで遅延されます。283**Code intelligence**
294 284
295 **コンテキストコスト:** [ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search) はデフォルトで有効になっているため、アイドル MCP ツールは最小限のコンテキストを消費します。285**時期:** ファイル編集後、および Claude がコードをナビゲートするときのオンデマンド。
296 286
297 <Tip>`/mcp` を実行して各サーバーの接続ステータスを確認します。`/context all` を実行して、ロードされた各 MCP ツールが使用するトークン数を確認します。Claude Code は、リモートサーバーが切断された場合は[自動的に再接続](/docs/ja/mcp#automatic-reconnection) し、積極的に使用していないサーバーを切断できます。</Tip>287**ロード内容:** 各ファイル編集後の型エラーと警告。Claude がシンボルを検索するときの定義、参照、型情報。
298 </Tab>
299 288
300 <Tab title="Code intelligence">289**コンテキストコスト:** 低い。シンボル検索は多くの場合、広範なファイル読み取りを置き換えるため、ネットコンテキスト使用量は減少する可能性があります。
301 **時期:** ファイル編集後、および Claude がコードをナビゲートするときのオンデマンド。
302 290
303 **ロード内容:** 各ファイル編集後の型エラーと警告。Claude がシンボルを検索するときの定義、参照、型情報。291> [!TIP]
292>
293> LSP ツールは、言語の[コード intelligence プラグイン](/docs/ja/plugins/code-intelligence) をインストールするまで非アクティブです。
304 294
305 **コンテキストコスト:** 低い。シンボル検索は多くの場合、広範なファイル読み取りを置き換えるため、ネットコンテキスト使用量は減少する可能性があります。295**Subagents**
306 296
307 <Tip>LSP ツールは、言語の[コード intelligence プラグイン](/docs/ja/plugins/code-intelligence) をインストールするまで非アクティブです。</Tip>297**時期:** オンデマンド、タスクのためにあなたまたは Claude がスポーンするとき。
308 </Tab>
309 298
310 <Tab title="Subagents">299**ロード内容:** 以下を含む新しい独立したコンテキスト:
311 **時期:** オンデマンド、タスクのためにあなたまたは Claude がスポーンするとき。
312 300
313 **ロード内容:** 以下を含む新しい独立したコンテキスト:301* エージェント独自のシステムプロンプト(Claude Code システムプロンプトではない)
302* エージェントの `skills:` フィールドにリストされているスキルの完全なコンテンツ
303* CLAUDE.md と git ステータス。組み込みの Explore および Plan エージェントは[どちらもなしで開始](/docs/ja/sub-agents#what-loads-at-startup) し、定義で [`omitClaudeMd`](/docs/ja/sub-agents#supported-frontmatter-fields) を設定したエージェントは、ユーザー、プロジェクト、ローカル CLAUDE.md ファイルなしで開始します。
304* リードエージェントがプロンプトで渡すコンテキスト
314 305
315 * エージェント独自のシステムプロンプト(Claude Code システムプロンプトではない)306[fork](/docs/ja/sub-agents#fork-the-current-conversation) の場合、Claude Code は親の会話(これまでのところ)、システムプロンプト、ツールをロードします。
316 * エージェントの `skills:` フィールドにリストされているスキルの完全なコンテンツ
317 * CLAUDE.md と git ステータス。組み込みの Explore および Plan エージェントは[どちらもなしで開始](/docs/ja/sub-agents#what-loads-at-startup) し、定義で [`omitClaudeMd`](/docs/ja/sub-agents#supported-frontmatter-fields) を設定したエージェントは、ユーザー、プロジェクト、ローカル CLAUDE.md ファイルなしで開始します。
318 * リードエージェントがプロンプトで渡すコンテキスト
319 307
320 [fork](/docs/ja/sub-agents#fork-the-current-conversation) の場合、Claude Code は親の会話(これまでのところ)、システムプロンプト、ツールをロードします。308**コンテキストコスト:** メインセッションから分離。
321 309
322 **コンテキストコスト:** メインセッションから分離。310> [!TIP]
311>
312> フルな会話コンテキストが必要ない作業に subagents を使用します。それらの分離はメインセッションの膨張を防ぎます。
323 313
324 <Tip>フルな会話コンテキストが必要ない作業に subagents を使用します。それらの分離はメインセッションの膨張を防ぎます。</Tip>314**Hooks**
325 </Tab>
326 315
327 <Tab title="Hooks">316**時期:** トリガー時。Claude Code はツール実行、セッション境界、プロンプト送信、権限リクエスト、コンパクション などの特定のライフサイクルイベントで hooks を実行します。完全なリストは [Hooks](/docs/ja/hooks) を参照してください。
328 **時期:** トリガー時。Claude Code はツール実行、セッション境界、プロンプト送信、権限リクエスト、コンパクション などの特定のライフサイクルイベントで hooks を実行します。完全なリストは [Hooks](/docs/ja/hooks) を参照してください。
329 317
330 **ロード内容:** デフォルトではなし。フックは外部で実行されます。318**ロード内容:** デフォルトではなし。フックは外部で実行されます。
331 319
332 **コンテキストコスト:** ゼロ(フックが会話にメッセージとして追加されるコンテキストを返さない限り)。320**コンテキストコスト:** ゼロ(フックが会話にメッセージとして追加されるコンテキストを返さない限り)。
333 321
334 <Tip>フックは Claude のコンテキストに影響する必要がない副作用(リント、ロギング)に最適です。</Tip>322> [!TIP]
335 </Tab>323>
336</Tabs>324> フックは Claude のコンテキストに影響する必要がない副作用(リント、ロギング)に最適です。
337 325
338<h2 id="learn-more">326## 詳細を学ぶ
339 詳細を学ぶ
340</h2>
341 327
342各機能には、セットアップ指示、例、設定オプションを含む独自のガイドがあります。328各機能には、セットアップ指示、例、設定オプションを含む独自のガイドがあります。
343 329
344<CardGroup cols={2}>330> **[CLAUDE.md](/docs/ja/memory)**
345 <Card title="CLAUDE.md" icon="file-lines" href="/docs/ja/memory">331>
346 プロジェクトコンテキスト、規約、指示を保存332> プロジェクトコンテキスト、規約、指示を保存
347 </Card>
348 333
349 <Card title="Skills" icon="brain" href="/docs/ja/skills">334> **[Skills](/docs/ja/skills)**
350 Claude にドメイン専門知識と再利用可能なワークフローを提供335>
351 </Card>336> Claude にドメイン専門知識と再利用可能なワークフローを提供
352 337
353 <Card title="Subagents" icon="users" href="/docs/ja/sub-agents">338> **[Subagents](/docs/ja/sub-agents)**
354 独立したコンテキストに作業をオフロード339>
355 </Card>340> 独立したコンテキストに作業をオフロード
356 341
357 <Card title="Dynamic workflows" icon="network" href="/docs/ja/workflows">342> **[Dynamic workflows](/docs/ja/workflows)**
358 1 つのスクリプトから多くのサブエージェントを実行343>
359 </Card>344> 1 つのスクリプトから多くのサブエージェントを実行
360 345
361 <Card title="Cross-session messaging" icon="terminal" href="/docs/ja/cross-session-messaging">346> **[Cross-session messaging](/docs/ja/cross-session-messaging)**
362 Claude が他のセッションにメッセージを送信できるようにする347>
363 </Card>348> Claude が他のセッションにメッセージを送信できるようにする
364 349
365 <Card title="MCP" icon="plug" href="/docs/ja/mcp">350> **[MCP](/docs/ja/mcp)**
366 Claude を外部サービスに接続351>
367 </Card>352> Claude を外部サービスに接続
368 353
369 <Card title="Hooks" icon="bolt" href="/docs/ja/hooks-guide">354> **[Hooks](/docs/ja/hooks-guide)**
370 フックでアクションを自動化355>
371 </Card>356> フックでアクションを自動化
372 357
373 <Card title="Plugins" icon="puzzle-piece" href="/docs/ja/plugins/overview">358> **[Plugins](/docs/ja/plugins/overview)**
374 機能セットをバンドルして共有359>
375 </Card>360> 機能セットをバンドルして共有
376 361
377 <Card title="Marketplaces" icon="store" href="/docs/ja/plugins/create-marketplace">362> **[Marketplaces](/docs/ja/plugins/create-marketplace)**
378 プラグインコレクションをホストして配布363>
379 </Card>364> プラグインコレクションをホストして配布
380</CardGroup>