discover-plugins.md +0 −651 deleted
File Deleted View Diff
1> ## Documentation Index
2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
3> Use this file to discover all available pages before exploring further.
4
5# マーケットプレイスから事前構築されたプラグインを発見してインストールする
6
7> マーケットプレイスからプラグインを検索してインストールし、Claude Code を新しいスキル、エージェント、機能で拡張します。
8
9プラグインは Claude Code をスキル、エージェント、フック、MCP サーバーで拡張します。プラグインマーケットプレイスは、これらの拡張機能を自分で構築することなく発見してインストールするのに役立つカタログです。
10
11claude.ai でプラグインを有効にすることもできます。自分自身のため、または組織を通じて有効にできます。Claude Code はそれらをマーケットプレイスのインストールなしにセッションに同期します。[claude.ai から同期されたプラグイン](/docs/ja/plugins-reference#synced-plugins)で説明されているとおりです。
12
13独自のマーケットプレイスを作成して配布したいですか？[プラグインマーケットプレイスを作成して配布する](/docs/ja/plugin-marketplaces)を参照してください。
14
15<h2 id="how-marketplaces-work">
16 マーケットプレイスの仕組み
17</h2>
18
19マーケットプレイスは、他の誰かが作成して共有したプラグインのカタログです。マーケットプレイスを使用するのは 2 段階のプロセスです：
20
21<Steps>
22 <Step title="マーケットプレイスを追加する">
23 これにより、カタログが Claude Code に登録され、利用可能なものを参照できるようになります。プラグインはまだインストールされていません。
24 </Step>
25
26 <Step title="個別のプラグインをインストールする">
27 カタログを参照して、必要なプラグインをインストールします。
28 </Step>
29</Steps>
30
31<h2 id="official-anthropic-marketplace">
32 公式 Anthropic マーケットプレイス
33</h2>
34
35Claude Code は初めて対話的に起動すると、公式 Anthropic マーケットプレイス（`claude-plugins-official`）を自動的に追加します。ネットワークがダウンロードをブロックしている場合や、[マーケットプレイスポリシー](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions)が以前の試行をブロックした場合など、Claude Code がそれを追加できない場合は、`/plugin marketplace add anthropics/claude-plugins-official` を使用して自分で追加してください。
36
37利用可能なものを参照するには、`/plugin` を実行して **Discover** タブに移動するか、[claude.com/plugins](https://claude.com/plugins)でカタログを表示してください。
38
39公式マーケットプレイスからプラグインをインストールするには、`/plugin install <name>@claude-plugins-official` を使用します。たとえば、GitHub 統合をインストールするには：
40
41```shell theme={null}
42/plugin install github@claude-plugins-official
43```
44
45`/plugin` はターミナル CLI で対話的なパネルを開きます。Claude が `/plugin` がこの環境では利用できないと返答する場合は、別の方法でプラグインをインストールしてください：
46
47* **Claude デスクトップアプリ**：[プラグインブラウザー](/docs/ja/desktop#install-plugins)を使用してください。
48* **VS Code 拡張機能**：[**Manage plugins** ダイアログ](/docs/ja/vs-code#manage-plugins)からインストールしてください。
49* **クラウドセッション**：claude.ai アカウントのプラグインを有効にして、Claude Code が[同期されたプラグイン](/docs/ja/plugins-reference#synced-plugins)として読み込むようにしてください。
50
51インストールが失敗した場合は、Claude Code が報告するメッセージと照合してください：
52
53* `Marketplace "claude-plugins-official" not found`：`/plugin marketplace add anthropics/claude-plugins-official` でマーケットプレイスを追加してから、インストールを再試行してください。
54* プラグインが[マーケットプレイスで見つかりません](#install-plugins)：プラグイン名を確認してください。
55
56<Note>
57 公式マーケットプレイスは Anthropic によって管理されており、掲載は Anthropic の裁量です。アプリ内送信フォームはプラグインを[コミュニティマーケットプレイス](#community-marketplace)に追加します。公式マーケットプレイスには追加されません。プラグインを独立して配布するには、[独自のマーケットプレイスを作成](/docs/ja/plugin-marketplaces)してユーザーと共有してください。
58</Note>
59
60公式マーケットプレイスには、プラグインのいくつかのカテゴリが含まれています：
61
62<h3 id="code-intelligence">
63 コード インテリジェンス
64</h3>
65
66[コード インテリジェンス](#code-intelligence)プラグインは Claude Code の組み込み LSP ツールを有効にし、Claude が定義にジャンプしたり、参照を見つけたり、編集直後に型エラーを確認したりできるようにします。これらのプラグインは [Language Server Protocol](https://microsoft.github.io/language-server-protocol/) 接続を構成します。これは VS Code のコード インテリジェンスを強化する同じテクノロジーです。[クラウドセッション](/docs/ja/claude-code-on-the-web)では、Claude Code はプラグイン言語サーバーを起動しないため、Claude はそこで LSP ツールを取得しません。
67
68これらのプラグインを使用する前に、以下の表から言語サーバーバイナリをインストールしてください。プラグインはそれをインストールしません。言語サーバーが既にインストールされている場合、プロジェクトを開くと Claude は対応するプラグインをインストールするよう促す場合があります。
69
70| 言語 | プラグイン | 必要なバイナリ |
71| :--------- | :------------------ | :--------------------------- |
72| C/C++ | `clangd-lsp` | `clangd` |
73| C# | `csharp-lsp` | `csharp-ls` |
74| Go | `gopls-lsp` | `gopls` |
75| Java | `jdtls-lsp` | `jdtls` |
76| Kotlin | `kotlin-lsp` | `kotlin-language-server` |
77| Lua | `lua-lsp` | `lua-language-server` |
78| PHP | `php-lsp` | `intelephense` |
79| Python | `pyright-lsp` | `pyright-langserver` |
80| Rust | `rust-analyzer-lsp` | `rust-analyzer` |
81| Swift | `swift-lsp` | `sourcekit-lsp` |
82| TypeScript | `typescript-lsp` | `typescript-language-server` |
83
84[他の言語用に独自の LSP プラグインを作成](/docs/ja/plugins-reference#lsp-servers)することもできます。
85
86<Note>
87 プラグインをインストール後に `/plugin` Errors タブに `Executable not found in $PATH` が表示される場合は、上記の表から必要なバイナリをインストールしてください。
88</Note>
89
90<h4 id="what-claude-gains-from-code-intelligence-plugins">
91 コード インテリジェンス プラグインから Claude が得られるもの
92</h4>
93
94コード インテリジェンス プラグインがインストールされ、その言語サーバーバイナリが利用可能になると、Claude は 2 つの機能を得られます：
95
96* **自動診断**：Claude が行うすべてのファイル編集後、言語サーバーはエラーと警告を報告し、Claude はコンパイラやリンターを実行することなく、型エラー、不足しているインポート、構文の問題を確認します。Claude がエラーを導入した場合、それに気付いて同じターンで修正します。
97* **コード ナビゲーション**: Claude は言語サーバーを使用して定義にジャンプしたり、参照を見つけたり、ホバーで型情報を取得したり、シンボルをリストしたり、実装を見つけたり、呼び出し階層をトレースしたりできます。これらの操作により、Claude は grep ベースの検索よりも正確なナビゲーションが可能になりますが、言語と環境によって可用性が異なる場合があります。
98
99診断を自分で読むには、Claude Code が **Found 3 new diagnostic issues in 2 files** などのインジケーターを表示するときに **Ctrl+O** を押してください。
100
101問題が発生した場合は、[コード インテリジェンスのトラブルシューティング](#code-intelligence-issues)を参照してください。
102
103<h3 id="external-integrations">
104 外部統合
105</h3>
106
107これらのプラグインは事前構成された [MCP サーバー](/docs/ja/mcp)をバンドルしているため、手動セットアップなしで Claude を外部サービスに接続できます：
108
109* **ソース管理**: `github`、`gitlab`
110* **プロジェクト管理**: `atlassian`（Jira/Confluence）、`asana`、`linear`、`notion`
111* **デザイン**: `figma`
112* **インフラストラクチャ**: `vercel`、`firebase`、`supabase`
113* **コミュニケーション**: `slack`
114* **監視**: `sentry`
115
116<h3 id="automatic-security-review">
117 自動セキュリティレビュー
118</h3>
119
120`security-guidance` プラグインは Claude が行う各変更を一般的な脆弱性についてレビューし、Claude に見つかったものを修正するよう指示します。[Claude がコードを書く際にセキュリティの問題をキャッチする](/docs/ja/security-guidance)を参照して、何をチェックするか、プロジェクト固有のルールを追加する方法を確認してください。
121
122<h3 id="development-workflows">
123 開発ワークフロー
124</h3>
125
126一般的な開発タスク用のスキルとエージェントを追加するプラグイン：
127
128* **commit-commands**: コミット、プッシュ、PR 作成を含む Git コミット ワークフロー
129* **pr-review-toolkit**: プルリクエストをレビューするための特化したエージェント
130* **agent-sdk-dev**: Claude Agent SDK で構築するためのツール
131* **plugin-dev**: 独自のプラグインを作成するためのツールキット
132
133<h3 id="output-styles">
134 出力スタイル
135</h3>
136
137Claude の応答方法をカスタマイズします：
138
139* **explanatory-output-style**: 実装の選択に関する教育的な洞察
140* **learning-output-style**: スキル構築のためのインタラクティブな学習モード
141
142<h2 id="community-marketplace">
143 コミュニティ マーケットプレイス
144</h2>
145
146[`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community)のコミュニティ マーケットプレイスは、Anthropic の自動検証とセキュリティ スクリーニングに合格したサードパーティ プラグインをホストしています。各プラグインはカタログ内の特定のコミット SHA に固定されています。公式マーケットプレイスとは異なり、手動で追加します：
147
148```shell theme={null}
149/plugin marketplace add anthropics/claude-plugins-community
150```
151
152その後、`claude-community` マーケットプレイス名を使用してプラグインをインストールします：
153
154```shell theme={null}
155/plugin install <plugin-name>@claude-community
156```
157
158独自のプラグインをコミュニティ マーケットプレイスに送信するには、プラグイン作成ガイドの[プラグインをコミュニティ マーケットプレイスに送信する](/docs/ja/plugins#submit-your-plugin-to-the-community-marketplace)を参照してください。
159
160<h2 id="try-it-add-the-demo-marketplace">
161 試してみる: デモマーケットプレイスを追加する
162</h2>
163
164Anthropic は、プラグインシステムで何が可能かを示す例プラグインを含む [デモプラグインマーケットプレイス](https://github.com/anthropics/claude-code/tree/main/plugins)（`claude-code-plugins`）も管理しています。公式マーケットプレイスとは異なり、このマーケットプレイスは手動で追加する必要があります。
165
166<Steps>
167 <Step title="マーケットプレイスを追加する">
168 Claude Code 内から、`anthropics/claude-code` マーケットプレイスの `plugin marketplace add` コマンドを実行します：
169
170 ```shell theme={null}
171 /plugin marketplace add anthropics/claude-code
172 ```
173
174 これにより、マーケットプレイスカタログがダウンロードされ、そのプラグインが利用可能になります。
175 </Step>
176
177 <Step title="利用可能なプラグインを参照する">
178 `/plugin` を実行してプラグインマネージャーを開きます。これにより、**Tab**（または後方に移動するには **Shift+Tab**）を使用して循環できるタブ付きインターフェースが開きます：
179
180 * **Discover**: すべてのマーケットプレイスから利用可能なプラグインを参照
181 * **Installed**: インストール済みプラグインを表示および管理
182 * **Marketplaces**: 追加したマーケットプレイスを追加、削除、または更新
183 * **Errors**: プラグイン読み込みエラーを表示
184 * **Stats**: [各スキルのコンテキストコストと使用頻度を確認](/docs/ja/skills#find-unused-skills)します。`/skill-doctor` が利用可能なセッションで確認できます
185
186 **Discover** タブに移動して、追加したばかりのマーケットプレイスからプラグインを確認してください。管理者が [`pluginSuggestionMarketplaces`](/docs/ja/settings-reference#pluginsuggestionmarketplaces) マネージド設定を通じてマーケットプレイスをホワイトリストに登録している場合、現在の作業ディレクトリに関連するとマークされたプラグインは、**suggested for this directory** ラベル付きで上部に固定されます。
187 </Step>
188
189 <Step title="プラグインをインストールする">
190 プラグインを選択してその詳細を表示します。詳細ペインには、プラグインに含まれるもの、およびそのコストが表示されます：
191
192 * **Context cost** の推定値。毎ターン [コンテキストウィンドウ](/docs/ja/features-overview#understand-context-costs) にプラグインが追加するトークン数を確認できます
193 * プラグインの **Last updated** 日付
194 * プラグインのコマンド、エージェント、スキル、フック、MCP および LSP サーバーをリストアップする **Will install** セクション。インストール前に正確に何が追加されるかを確認できます
195
196 すべてのプラグインがこれらのフィールドの背後にあるデータを提供するわけではありません。ローカルまたはカスタムマーケットプレイスのプラグインの場合、**Context cost** および **Last updated** 行が表示されない場合があり、**Will install** セクションは代わりに **Components will be discovered at installation** を表示する場合があります。
197
198 インストールスコープを選択します：
199
200 * **User scope**: すべてのプロジェクト全体で自分用にインストール
201 * **Project scope**: このリポジトリのすべてのコラボレーター用にインストール
202 * **Local scope**: このリポジトリ内で自分用にのみインストール
203
204 たとえば、**commit-commands**（git ワークフロースキルを追加するプラグイン）を選択して、ユーザースコープにインストールします。
205
206 コマンドラインから直接インストールすることもできます：
207
208 ```shell theme={null}
209 /plugin install commit-commands@claude-code-plugins
210 ```
211
212 スコープの詳細については、[設定ファイル](/docs/ja/settings#where-settings-live)を参照してください。
213 </Step>
214
215 <Step title="新しいプラグインを使用する">
216 インストール概要が `Run /reload-plugins to activate.` と報告されている場合、Claude Code はそのリロードを自動的に実行します。リロードが会話を再読み込みすることを警告する場合は、`/reload-plugins --force` を実行してプラグインをアクティベートしてください。
217
218 プラグインスキルはプラグイン名でネームスペース化されているため、**commit-commands** は `/commit-commands:commit` のようなスキルを提供します。
219
220 ファイルに変更を加えて、以下を実行して試してみてください：
221
222 ```shell theme={null}
223 /commit-commands:commit
224 ```
225
226 これにより、変更がステージされ、コミットメッセージが生成され、コミットが作成されます。
227
228 各プラグインは異なる方法で機能します。**Discover** タブのプラグインの詳細を確認して、提供されるコマンドとスキルを確認するか、使用方法のガイダンスについてそのホームページにアクセスしてください。
229 </Step>
230</Steps>
231
232<h2 id="add-marketplaces">
233 マーケットプレイスを追加する
234</h2>
235
236`/plugin marketplace add` コマンドを使用して、異なるソースからマーケットプレイスを追加します。
237
238<Tip>
239 **ショートカット**: `/plugin marketplace` の代わりに `/plugin market` を使用でき、`remove` の代わりに `rm` を使用できます。
240</Tip>
241
242* **GitHub リポジトリ**: `owner/repo` 形式（例：`anthropics/claude-code`）
243* **Git URL**: 任意の git リポジトリ URL（GitLab、Bitbucket、自己ホスト）
244* **ローカル パス**: ディレクトリまたは `marketplace.json` ファイルへの直接パス
245* **リモート URL**: ホストされた `marketplace.json` ファイルへの直接 URL
246* **claude.ai**: claude.ai でホストされているマーケットプレイス（組織のプラグイン ライブラリなど）。これらは [**Marketplaces** タブまたはシェルから名前で追加](#add-from-claude-ai)します。ソースではなく名前で追加します。
247
248<h3 id="add-from-github">
249 GitHub から追加する
250</h3>
251
252`.claude-plugin/marketplace.json` ファイルを含む GitHub リポジトリを `owner/repo` 形式を使用して追加します。ここで `owner` は GitHub ユーザー名または組織で、`repo` はリポジトリ名です。
253
254たとえば、`anthropics/claude-code` は `anthropics` が所有する `claude-code` リポジトリを指します：
255
256```shell theme={null}
257/plugin marketplace add anthropics/claude-code
258```
259
260<h3 id="add-from-other-git-hosts">
261 他の Git ホストから追加する
262</h3>
263
264git マーケットプレイス リポジトリを完全な URL を提供することで追加します。`https://` URL の場合、`.git` サフィックスを含めるかどうかはホストによって異なります：
265
266* **`github.com` と `gitlab.com`**: Claude Code はリポジトリ URL を `.git` サフィックスの有無にかかわらず認識し、クローンします。サフィックスなしで `gitlab.com` URL を追加するには、Claude Code v2.1.232 以降が必要です。v2.1.232 より前では、Claude Code はこれをホストされた `marketplace.json` ファイルへの直接リンクとして扱いました。
267* **Azure DevOps**: サフィックスを省略します。Claude Code はパスに `/_git/` を含む任意の URL をクローンします。`/_git/` パスに `.git` を追加すると、クローンが失敗します。
268* **自己管理 GitLab サーバーを含む他のすべてのホスト**: `.git` サフィックスを含めて、Claude Code がリポジトリをクローンするようにしてください。URL をホストされた `marketplace.json` ファイルへの直接リンクとして扱うのではなく。AWS CodeCommit のようにクローン URL にサフィックスを含まないホストの場合は、代わりに [`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) に git エントリとしてマーケットプレイスを追加してください。Claude Code は git エントリを URL が `.git` で終わるかどうかにかかわらずクローンします。
269
270Claude Code は `https://gitlab.com/group/subgroup/project` のようなネストされたサブグループを持つ `gitlab.com` URL もクローンします。
271
272`https://` プレフィックスを含めてください。Claude Code v2.1.196 以降は、`gitlab.com/company/plugins.git` のようにプレフィックスなしで入力されたホストを無効な GitHub `owner/repo` ショートハンドとして拒否し、エラーメッセージでプレフィックスを追加するよう指示します。以前のバージョンでは、これを GitHub リポジトリパスとして誤読し、クローン時に失敗します。
273
274HTTPS を使用する場合：
275
276```shell theme={null}
277/plugin marketplace add https://gitlab.com/company/plugins.git
278```
279
280SSH を使用する場合：
281
282```shell theme={null}
283/plugin marketplace add git@gitlab.com:company/plugins.git
284```
285
286Claude Code は SSH アドレスを `.git` で終わるかどうかにかかわらずクローンします。
287
288特定のブランチまたはタグを追加するには、`#` の後に ref を追加します：
289
290```shell theme={null}
291/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0
292```
293
294<h3 id="add-from-local-paths">
295 ローカル パスから追加する
296</h3>
297
298`.claude-plugin/marketplace.json` ファイルを含むローカル ディレクトリを追加します：
299
300```shell theme={null}
301/plugin marketplace add ./my-marketplace
302```
303
304`marketplace.json` ファイルへの直接パスを追加することもできます：
305
306```shell theme={null}
307/plugin marketplace add ./path/to/marketplace.json
308```
309
310<h3 id="add-from-remote-urls">
311 リモート URL から追加する
312</h3>
313
314URL 経由でリモート `marketplace.json` ファイルを追加します：
315
316```shell theme={null}
317/plugin marketplace add https://example.com/marketplace.json
318```
319
320<Note>
321 URL ベースのマーケットプレイスは、Git ベースのマーケットプレイスと比べていくつかの制限があります。URL ベースのマーケットプレイスからのプラグインのインストールが失敗する場合は、[トラブルシューティング](/docs/ja/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces)を参照してください。
322</Note>
323
324<h3 id="add-from-claude-ai">
325 claude.ai から追加する
326</h3>
327
328[プラグインが claude.ai アカウントから同期されるターミナル セッション](/docs/ja/plugins-reference#synced-plugins)では、claude.ai はマーケットプレイスをリストアップすることもできます。組織のプラグイン ライブラリや独自の claude.ai アップロードなど。`claude plugin marketplace list` は `From claude.ai:` セクションでそれらを出力し、`/plugin` **Marketplaces** タブにもリストされます。そこから 1 つを選択して追加します。claude.ai からマーケットプレイスを追加するには、Claude Code v2.1.273 以降が必要です。
329
330シェルから追加するには、`claude plugin marketplace add` を `--claudeai` フラグとリストに表示されている名前で実行します：
331
332```bash theme={null}
333claude plugin marketplace add --claudeai claudeai-organization-library
334```
335
336Claude Code はマーケットプレイスをローカル名で登録します。これは claude.ai がリストアップしている名前から派生した `claudeai-` で始まる名前です。「Organization library」としてリストされているマーケットプレイスは `claudeai-organization-library` として登録されます。その名前でプラグインをインストールします。たとえば `claude plugin install <plugin>@claudeai-organization-library` を使用します。
337
338サインアウトするか別のアカウントでサインインすると、マーケットプレイスは設定されたままですがプラグインが表示されず、既にそこからインストールしたプラグインは引き続き読み込まれます。
339
340`From claude.ai:` セクションは、claude.ai を通じて共有されている git ベースのマーケットプレイスもリストアップできます。これらは通常の `marketplace add` コマンドで追加します。リストが出力するソースを使用します。
341
342<h2 id="install-plugins">
343 プラグインをインストールする
344</h2>
345
346マーケットプレイスを追加したら、プラグインを名前でインストールできます。まだ追加していないマーケットプレイスの場合は、代わりに[1 つのコマンドでマーケットプレイスを追加してインストール](#add-a-marketplace-and-install-in-one-command)できます。
347
348名前でインストールするには：
349
350```shell theme={null}
351/plugin install plugin-name@marketplace-name
352```
353
354このコマンドはそのプラグインの詳細を開き、[インストール スコープ](/docs/ja/settings#where-settings-live)を選択できます。`/plugin` を実行して **Discover** タブに移動し、プラグインで **Enter** を押すと、同じ選択肢が表示されます：
355
356* **User scope**: すべてのプロジェクト全体で自分用にインストール
357* **Project scope**: このリポジトリのすべてのコラボレーター用にインストール（`.claude/settings.json` に追加）
358* **Local scope**: このリポジトリ内で自分用にのみインストール（コラボレーターと共有されない）
359
360インタラクティブなステップなしでインストールするには、[`claude plugin install`](/docs/ja/plugins-reference#plugin-install) シェル コマンドを使用します。このコマンドはユーザー スコープにインストールします。`--scope` を渡さない限り、ユーザー スコープにインストールされます。[`command` ソース](/docs/ja/plugin-marketplaces#how-users-accept-the-command)を持つプラグインの場合、`--yes` を渡して、それが表示するコマンドを受け入れます。
361
362**managed** スコープのプラグインも表示される場合があります。これらは管理者が[管理設定](/docs/ja/managed-settings)経由でインストールしたもので、変更することはできません。
363
364Claude Code はローカル マーケットプレイス カタログのコピーでプラグインを検索します。プラグインの名前の付け方によって、Claude Code がそのコピーを最初に更新するかどうかが決まります：
365
366* **マーケットプレイス名を含む場合**: セッションで `plugin-name@marketplace-name` をインストールするか、`claude plugin install` で実行すると、Claude Code はルックアップの前にそのマーケットプレイスを更新します。Claude Code は、マーケットプレイスの[自動更新](#configure-auto-updates)をオフにしたか、`DISABLE_AUTOUPDATER` を設定した場合でも、更新を実行します。v2.1.232 より前では、Claude Code はルックアップの前にマーケットプレイスを更新しませんでした。Claude Code は以下の場合、この更新をスキップします：
367 * マーケットプレイスが[GitHub、別の Git ホスト、リモート URL から追加](#add-marketplaces)されていない、または[Claude.ai から追加](#add-from-claude-ai)されていない。
368 * [シード ディレクトリ](/docs/ja/plugin-marketplaces#pre-populate-plugins-for-containers)がマーケットプレイスを提供している。
369 * Claude Code が過去 30 秒以内にマーケットプレイスを更新した。
370 * [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ja/env-vars)を設定した。
371 * [管理設定](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions)がマーケットプレイスをブロックしている。この場合、Claude Code はインストールも拒否します。
372* **プラグイン名のみ**: セッションで `/plugin install plugin-name` を実行すると、Claude Code は[バックグラウンドでも更新](#configure-auto-updates)するマーケットプレイスのみを更新し、ルックアップが失敗した後のみです。`claude plugin install plugin-name` を実行すると、Claude Code は更新なしでキャッシュされたカタログを読み取ります。最後の更新後に公開されたプラグインをインストールするには、セッションで `/plugin marketplace update <marketplace-name>` を実行するか、シェルで [`claude plugin marketplace update <marketplace-name>`](/docs/ja/plugin-marketplaces#plugin-marketplace-update)を実行してから、インストールを再試行します。
373
374名前付きインストール前の更新が失敗した場合（例えば、オフラインの場合）、Claude Code はキャッシュされたカタログでプラグインを検索します。`claude plugin install` は成功メッセージで `marketplace not refreshed` を報告し、`/plugin install` はプラグインの詳細の上または見つからないメッセージでエラーを表示します。
375
376`/plugin` インターフェイスからインストールすると、インストール サマリーは、プラグインが現在のセッションでアクティブかどうかを示します：
377
378* `Plugin is now active.`: Claude Code はインストールの一部としてプラグインをアクティブにしました。
379* `Run /reload-plugins to activate.`: プラグインはまだアクティブではありません。これは、アクティブ化すると[プロンプト キャッシュが無効になる](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin)か、アクティブ化の試行が失敗したためです。Claude Code はその後、`/reload-plugins` を実行します。そのリロードがプロンプト キャッシュについて警告する場合、[プラグインをとにかくアクティブにする](#apply-plugin-changes-without-restarting)には `/reload-plugins --force` を実行してください。
380* プラグインの読み込みに失敗した場合、サマリーは失敗を報告し、`/plugin` **Errors** タブに詳細が表示されます。
381
382v2.1.221 より前では、`/reload-plugins` を実行するか再起動するまで、現在のセッションでインストールが有効になりませんでした。
383
384`claude plugin install` シェル コマンドはセッションで実行されないため、Claude Code は次回 Claude Code を起動するか、既に開いているセッションで `/reload-plugins` を実行するときに、インストールしたプラグインを読み込みます。
385
386<Warning>
387 プラグインをインストールする前に、それを信頼していることを確認してください。Anthropic はプラグインに含まれる MCP サーバー、ファイル、またはその他のソフトウェアを制御せず、意図したとおりに機能することを確認できません。詳細については、各プラグインのホームページを確認してください。
388</Warning>
389
390<h3 id="add-a-marketplace-and-install-in-one-command">
391 1 つのコマンドでマーケットプレイスを追加してインストールする
392</h3>
393
394まだ追加していないマーケットプレイスからプラグインをインストールするには、`--marketplace` でマーケットプレイス ソースを指定します。Claude Code v2.1.275 以降が必要です。
395
396```shell theme={null}
397/plugin install quality-review-plugin --marketplace your-org/plugins
398```
399
400ソースは[`/plugin marketplace add`](#add-marketplaces)と同じ形式を取ります。例えば、GitHub の `owner/repo`、git URL、またはローカル パスなど。ただし、スペースを含むことはできません。プラグイン名は `@marketplace` サフィックスなしで指定します。
401
402Claude Code はソースが解決されたことを表示し、マーケットプレイスを追加する前に確認を求めます。キャンセルするとインストールがキャンセルされ、何も追加されません。マーケットプレイスが追加されると、プラグインの詳細が開き、[インストール スコープ](/docs/ja/settings#where-settings-live)を選択できます。ソースが既に追加したマーケットプレイスと一致する場合、Claude Code は確認をスキップし、そのマーケットプレイスでプラグインの詳細を開きます。
403
404<h2 id="manage-installed-plugins">
405 インストール済みプラグインを管理する
406</h2>
407
408`/plugin` を実行して **Installed** タブに移動し、プラグインを表示、有効化、無効化、またはアンインストールします。リストはスコープでグループ化され、問題が最初に表示されるようにソートされます。読み込みエラーまたは未解決の依存関係を持つプラグインが上部に表示され、その後にお気に入りが続き、無効化されたプラグインは下部の折りたたまれたヘッダーの後ろに折りたたまれます。
409
410リストから以下を実行できます：
411
412* `f` を押して、選択したプラグインをお気に入りに追加またはお気に入りから削除
413* 入力してプラグイン名または説明でフィルタリング
414* Enter を押してプラグインの詳細ビューを開き、有効化、無効化、またはアンインストール
415
416Claude Code はまた、[claude.ai アカウントから同期されたプラグイン](/docs/ja/plugins-reference#synced-plugins) を **Installed** タブに一覧表示します。ソースは `synced` です。組織がそれを必須としてマークしていない限り、そこで有効化または無効化できます。削除するには、claude.ai でオフにします。同期されたプラグインは Claude Code v2.1.273 以降のターミナルセッションに表示されます。
417
418プロジェクトの `.claude/settings.json` が有効化しているプラグインをアンインストールすると、Claude Code はどのスコープを意図しているかを尋ねます。自分だけのために無効化する場合は、`.claude/settings.local.json` にオーバーライドを書き込み、プラグインはプロジェクトにインストールされたままになります。または、すべてのユーザーのためにアンインストールする場合は、共有の `.claude/settings.json` から削除されます。
419
420詳細ビューには、プラグインが提供するコンポーネントが表示されます。コマンド、skills、agents、hooks、MCP サーバー、LSP サーバーです。同じインベントリは、コマンドラインから `claude plugin details` で利用できます。
421
422Claude Code はまた、マーケットプレイスから自分でインストールしたが、少なくとも 2 週間以上、かつ少なくとも 10 セッション以上にわたって使用していないプラグインも一覧表示します。これらは **Installed** タブの **Not used recently** ヘッダーの下に表示されます。詳細ビューには、各プラグインの **Last used** 行が表示されます。これらを使用して、もう使用していないが、それでもスタートアップとコンテキストコストを追加しているプラグインを見つけ、無効化またはアンインストールできます。
423
4242 種類のプラグインは、未使用として一覧表示されることはありません：
425
426* 組織が管理するプラグイン、または `--plugin-dir` で読み込むプラグイン
427* テーマ、出力スタイル、モニター、またはワークフローを提供するプラグイン。これらは追跡する呼び出しなしで価値を提供するため
428
429**Not used recently** ヘッダーと **Last used** 行は、組織が [`strictKnownMarketplaces`](/docs/ja/settings-reference#strictknownmarketplaces) でマーケットプレイスを制限している場合、両方とも非表示になります。
430
431プラグインの [言語サーバー](/docs/ja/plugins#add-lsp-servers-to-your-plugin) は、診断を提供するか、コード ナビゲーション リクエストに応答するときに使用済みとしてカウントされます。そのため、LSP プラグインのサーバーがセッションでアクティブな場合、未使用として一覧表示されません。v2.1.203 より前では、言語サーバー アクティビティを使用としてカウントできなかったため、LSP サーバーを提供するプラグインはグループ全体から除外されていました。これはテーマと出力スタイル プラグインと同じ方法です。
432
433言語サーバー アクティビティをカウントするバージョンの最初のセッションは、まだ使用を記録していない各 LSP プラグインの使用記録もリセットするため、Claude Code は、サーバー アクティビティが追跡される前に記録されたデータに基づいて、以前にインストールしたプラグインを未使用と判断しません。
434
435依存関係を宣言するプラグインをインストールすると、インストール出力には、それと共に自動インストールされた依存関係が一覧表示されます。
436
437直接コマンドでプラグインを管理することもできます：
438
439* `/plugin disable`、`/plugin enable`、または `/plugin uninstall` を実行すると、Claude Code はプラグインパネルを開いて変更を適用し、パネルを開いたままにします。別のコマンドを入力する前に **Esc** を押してパネルを閉じます。[プラグインの変更をリスタートなしで適用する](#apply-plugin-changes-without-restarting) では、変更がセッションでいつ有効になるかについて説明しています。
440* スクリプティングの場合は、代わりに `claude plugin` シェルコマンドを使用します。これらはパネルを開きません。
441
442メニューを開かずにインストール済みプラグインを一覧表示します：
443
444```shell theme={null}
445/plugin list
446```
447
448`--enabled` または `--disabled` を渡して、その状態のプラグインのみを表示します。
449
450プラグインをアンインストールせずに無効化します：
451
452```shell theme={null}
453/plugin disable plugin-name@marketplace-name
454```
455
456無効化されたプラグインを再度有効化します：
457
458```shell theme={null}
459/plugin enable plugin-name@marketplace-name
460```
461
462これらの識別子では、`plugin-name` は [マーケットプレイスエントリ](/docs/ja/plugin-marketplaces#plugin-entries) の `name` であり、プラグイン自体の `plugin.json` の `name` と異なる場合があります。
463
464Claude Code v2.1.195 以降では、`/plugin` インターフェイスの **Enable** と **Disable** は、2 つの名前が異なるプラグインに対して機能し、`/plugin enable` と `/plugin disable` はどちらの名前でも受け入れます。以前のバージョンでそのようなプラグインを無効化すると、Claude Code は `already disabled` を報告し、有効なままにします。
465
466プラグインを完全に削除します：
467
468```shell theme={null}
469/plugin uninstall plugin-name@marketplace-name
470```
471
472`--scope` オプションを使用すると、CLI コマンドで特定のスコープをターゲットにできます：
473
474```shell theme={null}
475claude plugin install formatter@your-org --scope project
476claude plugin uninstall formatter@your-org --scope project
477```
478
479<h3 id="apply-plugin-changes-without-restarting">
480 プラグインの変更をリスタートなしで適用する
481</h3>
482
483`/plugin` メニューを閉じると、Claude Code はインストール、有効化、無効化、アンインストールなど、メニューで行った変更を適用するために `/reload-plugins` を実行します。リロードが [プロンプトキャッシュを無効にする](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin) 場合、警告を表示し、変更を保留のままにします。代わりに `/reload-plugins --force` を実行して適用します。Claude がまだ応答中の場合、リロードは応答が終了した後に実行されます。
484
485メニューの外で発生するプラグイン変更については、`/reload-plugins` を自分で実行します。これらの変更には以下が含まれます：
486
487* 別のターミナルで実行した `claude plugin` コマンド
488* 開発中に [`--plugin-dir`](/docs/ja/plugins#test-your-plugins-locally) で読み込んだプラグインへの編集
489* 再度読み込むよう求める通知を表示するプラグイン [自動更新](#configure-auto-updates)
490* [claude.ai アカウントからの同期](/docs/ja/plugins-reference#synced-plugins) がプラグインを追加、更新、または削除し、再度読み込むよう求める通知を表示した
491* Claude Code が保留していた [`--plugin-dir` フォルダ](/docs/ja/plugins#test-your-plugins-locally) の変更。これは、適用するとプロンプトキャッシュが無効になるため
492
493v2.1.268 より前では、メニューで有効化、無効化、またはアンインストールしたプラグイン、およびインストール中にアクティブ化されなかったインストールは、`/reload-plugins` を実行するまで保留のままでした。
494
495`/reload-plugins` はまた、デスクトップアプリ、Agent SDK、および [`-p` を使用した非対話型モード](/docs/ja/headless) など、対話型ターミナルのないセッションでも実行されます。Claude Code v2.1.260 以降が必要です。これらのセッションでは 2 つの制限が適用されます：
496
497* コマンドは、`-p` プロンプトやデスクトップアプリのプロンプトボックスなど、セッションに直接入力した場合にのみ実行されます。代わりに [Remote Control](/docs/ja/remote-control) やリレーされたチャットメッセージなどのリモート接続を介して送信する場合、コマンドは何もリロードせずに拒否されます。
498* リロードはプラグイン MCP サーバーを接続または切断しません。これらの変更は次のセッションで有効になります。
499
500Claude Code はすべてのアクティブなプラグインをリロードし、プラグイン、skills、agents、hooks、プラグイン MCP サーバー、プラグイン LSP サーバーのカウントを表示します。対話型ターミナルのないセッションではプラグイン MCP サーバーのカウントを省略します。skills のカウントでは、Claude Code はプラグインが提供するすべての skill を含みます。`commands/` エントリと `SKILL.md` skills の両方です。v2.1.246 より前では、Claude Code は `commands/` エントリのみをカウントしていたため、プラグインの `SKILL.md` skills をリロードしても、概要で `0 skills` を報告する可能性がありました。
501
502リロードには次のリクエストでトークンコストがあります。新しくロードされたコンポーネントは会話に追加されたコンテンツで自身を発表し、既存の履歴はプロンプトキャッシュから読み込まれたままです。MCP サーバーを提供するプラグインは、そのツールが [tool search](/docs/ja/mcp#scale-with-mcp-tool-search) によって遅延されていない場合、より多くのコストがかかります。変更はキャッシュを無効にし、次のリクエストは会話全体を再度読み込みます。詳細については、[プラグインの有効化または無効化](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin) を参照してください。
503
504<h2 id="manage-marketplaces">
505 マーケットプレイスを管理する
506</h2>
507
508インタラクティブな `/plugin` インターフェースまたは CLI コマンドを使用してマーケットプレイスを管理できます。
509
510<h3 id="use-the-interactive-interface">
511 インタラクティブ インターフェースを使用する
512</h3>
513
514`/plugin` を実行して **Marketplaces** タブに移動して、以下を実行します：
515
516* 追加したすべてのマーケットプレイスをそのソースとステータスで表示
517* 新しいマーケットプレイスを追加
518* マーケットプレイス リストを更新して最新のプラグインを取得
519* 不要になったマーケットプレイスを削除
520
521<h3 id="use-cli-commands">
522 CLI コマンドを使用する
523</h3>
524
525直接コマンドでマーケットプレイスを管理することもできます。
526
527構成されたすべてのマーケットプレイスをリストします：
528
529```shell theme={null}
530/plugin marketplace list
531```
532
533マーケットプレイスからプラグイン リストを更新します：
534
535```shell theme={null}
536/plugin marketplace update marketplace-name
537```
538
539マーケットプレイスを削除します：
540
541```shell theme={null}
542/plugin marketplace remove marketplace-name
543```
544
545<Warning>
546 マーケットプレイスを削除すると、そこからインストールしたプラグインがアンインストールされます。
547</Warning>
548
549<h3 id="configure-auto-updates">
550 自動更新を構成する
551</h3>
552
553Claude Code はスタートアップ時にマーケットプレイスとそのインストール済みプラグインをバックグラウンドで自動的に更新できます。マーケットプレイスで自動更新が有効になっている場合、Claude Code はマーケットプレイス データを更新し、インストール済みプラグインをディスク上の最新バージョンに更新します。
554
555Claude Code はセッション開始後、最大 10 分のランダムな遅延でマーケットプレイスとプラグインの更新をチェックするため、実行中のセッションは起動時に読み込んだバージョンを使用し続けます。プラグインが更新された場合、`/reload-plugins` を実行するよう促すメッセージが表示されるか、次回の起動時に新しいバージョンが読み込まれます。
556
557自動更新は、マーケットプレイス エントリが `headersHelper` を宣言するプラグインも除外します。Claude Code は [そのパス上のコマンドを実行したり、アーカイブをダウンロードしたりしません](/docs/ja/plugin-marketplaces#installs-and-updates-that-refuse-the-command-instead-of-asking)。そのセクションでは、Claude Code がプラグインを `/plugin` Errors タブにリストする時期について説明しており、独自のビューから更新できます。
558
559Claude Code は [`command` ソース](/docs/ja/plugin-marketplaces#command-sources)を持つプラグインを、マーケットプレイス自動更新設定および `DISABLE_AUTOUPDATER` とは異なるペースで更新します。代わりに、[セッションごとに 1 回コマンドを再実行](/docs/ja/plugin-marketplaces#when-claude-code-re-runs-the-command)し、その [ハッシュ](/docs/ja/plugins-reference#version-management)が変更された場合、出力を新しいプラグイン バージョンとしてインストールします。
560
561UI を通じて個別のマーケットプレイスの自動更新を切り替えます：
562
5631. `/plugin` を実行してプラグイン マネージャーを開く
5642. **Marketplaces** を選択
5653. リストからマーケットプレイスを選択
5664. **Enable auto-update** または **Disable auto-update** を選択
567
568`claude-plugins-official`、その他のほとんどの公式 Anthropic マーケットプレイス、および [claude.ai から追加されたマーケットプレイス](#add-from-claude-ai)はデフォルトで自動更新が有効になっています。その他のサードパーティ マーケットプレイスおよびローカル開発マーケットプレイスはデフォルトで自動更新が無効になっています。
569
570管理者は、マネージド設定で各 [`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) エントリに `"autoUpdate": true` を設定して、各ユーザーが切り替える必要なく、組織マーケットプレイスの自動更新を有効にすることもできます。
571
572Claude Code とマーケットプレイスから取得されたプラグインの自動更新を無効にするには、`DISABLE_AUTOUPDATER` 環境変数を設定します。[`command` ソース](/docs/ja/plugin-marketplaces#command-sources)を持つプラグインは独自のセッションごと 1 回の再解決に従います。詳細については、[自動更新](/docs/ja/setup#auto-updates)を参照してください。
573
574Claude Code の自動更新を無効化しながらプラグイン自動更新を有効化したままにするには、`DISABLE_AUTOUPDATER` と共に `FORCE_AUTOUPDATE_PLUGINS=1` を設定します：
575
576```bash theme={null}
577export DISABLE_AUTOUPDATER=1
578export FORCE_AUTOUPDATE_PLUGINS=1
579```
580
581<h2 id="configure-team-marketplaces">
582 チーム マーケットプレイスを構成する
583</h2>
584
585チーム管理者は、`.claude/settings.json` にマーケットプレイス構成を追加することで、プロジェクトの自動マーケットプレイス インストールを設定できます。チーム メンバーが[リポジトリ フォルダを信頼](/docs/ja/permissions#what-runs-before-you-trust-a-folder)すると、Claude Code はこれらのマーケットプレイスをさらなるプロンプトなしで追加します。
586
587Claude Code v2.1.195 以降、マーケットプレイスを追加しても、プラグインを読み込むすべてのパスで外部ソースから提供されるプラグインはインストールされません。プロジェクトの `.claude/settings.json` のみで有効にされ、GitHub リポジトリや npm パッケージなどの外部ソースから提供されるプラグインは、チーム メンバーがインストールするまで読み込まれません。それまでの間、Claude Code はプラグインがインストールされていないと報告し、実行する `claude plugin install` コマンドを表示します。
588
589プロジェクトの `.claude/settings.json` に `extraKnownMarketplaces` を追加します：
590
591```json theme={null}
592{
593 "extraKnownMarketplaces": {
594 "my-team-tools": {
595 "source": {
596 "source": "github",
597 "repo": "your-org/claude-plugins"
598 }
599 }
600 }
601}
602```
603
604`extraKnownMarketplaces` と `enabledPlugins` を含む完全な構成オプションについては、[プラグイン設定](/docs/ja/settings-reference#plugin-settings)を参照してください。
605
606<h2 id="security">
607 セキュリティ
608</h2>
609
610プラグインとマーケットプレイスは、ユーザー権限でマシン上で任意のコードを実行できる、非常に信頼されたコンポーネントです。信頼できるソースからのみプラグインをインストールし、マーケットプレイスを追加してください。組織は、[管理マーケットプレイス制限](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions)を使用してユーザーが追加できるマーケットプレイスを制限できます。
611
612<h2 id="troubleshooting">
613 トラブルシューティング
614</h2>
615
616<h3 id="/plugin-command-not-recognized">
617 /plugin コマンドが認識されない
618</h3>
619
620「unknown command」が表示されるか、`/plugin` コマンドが表示されない場合：
621
6221. **バージョンを確認する**: `claude --version` を実行して、インストールされているものを確認します。
6232. **Claude Code を更新する**:
624 * **Homebrew**: `brew upgrade claude-code`、または `brew upgrade claude-code@latest` をインストールした場合は `brew upgrade claude-code@latest`
625 * **npm**: `npm install -g @anthropic-ai/claude-code@latest`
626 * **ネイティブ インストーラー**: [セットアップ](/docs/ja/setup)からインストール コマンドを再実行します。
6273. **Claude Code を再起動する**: 更新後、ターミナルを再起動して `claude` を再度実行します。
628
629<h3 id="common-issues">
630 一般的な問題
631</h3>
632
633プラグイン スキルが表示されない場合は、`rm -rf ~/.claude/plugins/cache` でキャッシュをクリアし、Claude Code を再起動して、プラグインを再度インストールしてください。
634
635詳細なトラブルシューティングとソリューションについては、マーケットプレイス ガイドの [トラブルシューティング](/docs/ja/plugin-marketplaces#troubleshooting)を参照してください。デバッグ ツールについては、[デバッグと開発ツール](/docs/ja/plugins-reference#debugging-and-development-tools)を参照してください。
636
637<h3 id="code-intelligence-issues">
638 コード インテリジェンスの問題
639</h3>
640
641* **言語サーバーが起動しない**: バイナリがインストールされており、`$PATH` で利用可能であることを確認してください。詳細については、`/plugin` Errors タブを確認してください。
642* **メモリ使用量が多い**: `rust-analyzer` や `pyright` などの言語サーバーは、大規模なプロジェクトで大量のメモリを消費する可能性があります。メモリの問題が発生した場合は、`/plugin disable <plugin-name>` でプラグインを無効化し、代わりに Claude の組み込み検索ツールを使用してください。
643* **モノレポでの誤検知診断**: ワークスペースが正しく構成されていない場合、言語サーバーは内部パッケージの未解決インポート エラーを報告する可能性があります。これらはコードを編集する Claude の能力に影響しません。
644
645<h2 id="next-steps">
646 次のステップ
647</h2>
648
649* **独自のプラグインを構築する**: スキル、エージェント、フックを作成するには、[プラグイン](/docs/ja/plugins)を参照してください。
650* **マーケットプレイスを作成する**: チームまたはコミュニティにプラグインを配布するには、[プラグイン マーケットプレイスを作成](/docs/ja/plugin-marketplaces)を参照してください。
651* **技術リファレンス**: 完全な仕様については、[プラグイン リファレンス](/docs/ja/plugins-reference)を参照してください。