Claude Code プラグインのドキュメントをお探しなら、短く答えると次のとおりです。プラグインは Claude Code 拡張機能のパッケージ化レイヤーです。プラグインは、スキル、エージェント、フック、MCP サーバー、LSP サーバー、モニターを 1 つのインストール可能なユニットにまとめることができます。一方、MCP はその下にあるツール接続レイヤーであり続けます。「MCP プラグイン」や「ドキュメントプラグイン」を検索した場合、ドキュメントが意図している区別は通常これです。プラグインはセットアップを配布し、MCP はツールを接続し、リファレンスドキュメントは各要素の技術的な形状を説明します。
Claude Code の拡張機能は多岐にわたるため、用語はすぐに曖昧になりがちです。「プラグイン」は、実際に使われている機能がスキル、フック、MCP サーバーであっても、すべての略称として使われることがよくあります。この混乱は、インストール手順、セキュリティモデル、メンテナンスの負担がそれぞれ異なるため、重要な問題です。
セットアップに入る前に、クローズドモデル限定のワークフローよりもバックエンドの柔軟性を求めるチーム向けに、実用的な注意点を 1 つ挙げます。Claude Code の拡張レイヤーは、その背後で実行するモデルとは別物です。つまり、同じプラグイン、スキル、MCP セットアップを維持したまま、推論を Novita AI のオープンウェイトコーディングモデル(qwen/qwen3-coder-480b-a35b-instruct など)にルーティングできます。これは、エージェンティックなツールを手放さずにコストを抑えたい場合に、実際のリポジトリワークでの有力な選択肢です。
現在のドキュメントが強調していること
現在の Claude Code ドキュメントでは、次の 4 つを明確に区別しています。
- プラグイン:再利用可能な拡張機能をパッケージ化します。
- MCP:Claude Code を外部ツールやデータソースに接続します。
- スキルとサブエージェント:再利用可能な動作を保持します。
- フック:ライフサイクルイベントでアクションを自動化します。
つまり、「Claude Code プラグインのドキュメント」という検索の多くは、実際にはプラグインのリファレンス、検出/インストールのフロー、またはツール接続の仕組みを説明する MCP ドキュメントを求めていることになります。現在のドキュメントでは、マーケットプレイスベースのインストールと配布のフローも公開されているため、すべてのコンポーネントを手作業で設定する代わりに、ビルド済みプラグインをインストールできます。
Claude Code プラグインの実体
Anthropic の現在のドキュメントでは、プラグインは Claude Code 拡張機能の配布および再利用レイヤーと定義されています。実際には、プラグインはマニフェストと、以下のようなオプションの拡張コンポーネントを含む自己完結型ディレクトリです。
- スキル
- エージェント
- フック
- MCP 設定
- LSP 設定
- ヘルパーバイナリ
- デフォルト設定
そのため、本当に欲しいものが再利用可能なスキルやワンコマンドの MCP スキャフォールドであっても、公式プラグインのドキュメントは重要です。プラグインは多くの場合、インストールする対象ですが、気にかけている動作はパッケージ化されたコンポーネントの中にあります。
最も重要な結果は名前付けです。プラグインのスキルは名前空間化されているため、プラグインからのコマンドは次のようになります。
/my-plugin:hello
この名前空間は見た目だけの問題ではありません。類似した名前のコマンドを持つプラグイン間の衝突を防ぎます。
プラグイン vs MCP vs スキル vs フック
ここで多くの開発者がドキュメントに時間を費やしています。
次の早見表を使いましょう。
| 機能 | 役割 | 最適なユースケース |
|---|---|---|
| プラグイン | 拡張機能をパッケージ化して配布する | プロジェクトやチームメンバー間で同じセットアップを再利用する |
| MCP | Claude Code を外部ツールやサービスに接続する | GitHub、Notion、データベース、ブラウザ操作、内部 API |
| スキル | Claude に再利用可能な知識やワークフローを与える | レビューチェックリスト、デプロイフロー、ハウススタイル、反復的なプロンプト |
| フック | ライフサイクルイベントで自動的に実行する | 編集後の lint、危険なコマンドのブロック、通知のトリガー |
「Claude Code プラグイン」に関する質問の多くは、実際には MCP に関する質問です。目標が「Claude Code を Jira に接続する」や「Claude にデータベースを照会させる」であれば、主に探しているのはプラグイン機能ではありません。探しているのは MCP サーバーであり、直接インストールするか、プラグイン内にパッケージ化することができます。実際には、MCP プラグイン の検索の多くは、正しいサーバーと、正しいパッケージ化またはインストールパスを探していることになります。
これは、Anthropic ドキュメントの機能概要が役立つ理由でもあります。プラグインを MCP やスキルから明確に区別しているからです。プラグインはラッパーです。MCP は外部接続です。スキルは再利用可能な指示です。フックは自動化レイヤーです。
Novita スタックの観点から見ると、これは推論と実行を分離する最も明確な場所でもあります。MCP ツールを中心にカスタムの Claude Code 関連ワークフローを構築する場合、Novita の LLM API がツール使用の推論レイヤーを処理し、Novita Agent Sandbox がコード、シェルコマンド、ツールの副作用のための分離された実行レイヤーを処理します。この分離は、プラグインと MCP のドキュメントが実際に説明している「モデルが決定する」と「ランタイムが実行する」の境界に自然に対応します。
プラグインを使うべきタイミング
次のいずれかに当てはまる場合は、プラグインを使用します。
- 複数のリポジトリで同じ Claude Code カスタマイズを使用したい。
- チームメイトが
.claude/ファイルを手動でコピーする代わりに、1 つのものをインストールできるようにしたい。 - スキル、フック、MCP 設定にバージョン管理された共有可能なパッケージングを使用したい。
- マーケットプレイスを通じて拡張機能を配布する予定がある。
1 つのリポジトリだけで試している場合は、最初にプラグインに手を出さないでください。Anthropic のドキュメントでは、迅速な反復のためにスタンドアロンの .claude/ 設定から始めることを推奨しています。これは、プロジェクト固有のワークフローにとって摩擦の少ないパスです。
言い換えると:
- スタンドアロン設定はローカルでの実験に適しています。
- プラグインは移植性と配布に適しています。
既存のプラグインをインストールする最速の方法
プラグイン名とマーケットプレイスがすでにわかっている場合、現在のドキュメントでは Claude Code 内のスラッシュコマンドフローを案内しています。
たとえば、Anthropic の MCP ドキュメントでは、公式の mcp-server-dev プラグインに次のインストールパスを使用しています。
/plugin install mcp-server-dev@claude-plugins-official
Claude Code がマーケットプレイスが見つからないと報告した場合は、最初に追加します。
/plugin marketplace add anthropics/claude-plugins-official
その後、インストールコマンドを再実行します。
インストール後、Claude がプラグインのリロードを促すかどうかを確認します。促された場合は、次を実行します。
/reload-plugins
このリロード手順は、見た目以上に重要です。ファイルは存在するのにコマンドが現在のセッションで有効になっていないために、プラグインが「機能しなかった」と開発者が考えるよくある理由です。
独自の Claude Code プラグインを作成する方法
独自プラグインを構築したい場合、現在のプラグインドキュメントには簡単なクイックスタートが記載されています。
- プラグインディレクトリを作成します。
.claude-plugin/plugin.jsonを追加します。skills/、agents/、hooks/またはその他のサポートされている拡張ディレクトリを追加します。- 開発中は
--plugin-dirを指定して Claude Code を起動します。
最小の有用な例は、1 つのスキルを同梱するプラグインです。Anthropic のドキュメントには、マニフェストと skills/<name>/SKILL.md フォルダーが示されています。マニフェストがプラグインのアイデンティティを定義し、スキルは名前空間付きコマンドになります。
開発中の標準的なテストフローは次のとおりです。
claude --plugin-dir ./my-first-plugin
次に、Claude Code 内からスキルを呼び出します。
/my-first-plugin:hello
見落としがちな詳細:.claude-plugin/ 内に置くのは plugin.json だけです。skills/、agents/、hooks/ ディレクトリはプラグインのルートに置き、.claude-plugin/ の下にネストしないでください。
プラグインガイドで MCP が頻繁に言及される理由
プラグインは MCP 設定を同梱できるからです。
これは、チームのすべてのエンジニアが Claude Code からアクセスする必要がある内部サービスがある場合に役立ちます。全員に同じ MCP サーバーを手動設定するよう指示する代わりに、その設定を Claude Code ワークフローの残りと一緒にパッケージ化できます。
これによって MCP が時代遅れになるわけではありません。サーバーの配布方法が変わるだけです。
次のように考えてください。
- MCP が答えるのは、「Claude はこの外部システムとどのように通信するのか?」です。
- プラグインが答えるのは、「そのセットアップをどうすればきれいに配布できるのか?」です。
内部開発者プラットフォームを設計している場合、この区別により重複したセットアップ作業が大幅に削減されます。
MCP を先に使うべきタイミング
主な要件が外部アクセスである場合は、プラグインではなく MCP から始めます。
- 課題トラッカー
- モニタリングツール
- Slack
- Notion
- データベース
- ブラウザ自動化
- 内部 HTTP サービス
Anthropic の現在の MCP ドキュメントには、4 つの一般的な接続モードが示されています。
- リモート HTTP サーバー
- リモート SSE サーバー
- ローカル stdio サーバー
- リモート WebSocket サーバー
ほとんどのクラウドサービスでは、HTTP が推奨されるトランスポートです。SSE もまだドキュメント化されていますが、Anthropic は HTTP が利用できる場合は SSE を非推奨としています。
自分だけで 1 つのサービスに接続する必要がある場合は、claude mcp add が通常最も簡単な開始点です。そのセットアップが再利用可能であることが判明したら、後でプラグインにラップします。
MCP は Claude Code にツールへ到達する方法を提供しますが、それらのツールの 1 つがコードの実行、ファイルへのアクセス、コマンドの実行を必要とする場合に、安全な実行ランタイムを置き換えるものではありません。そのようなセットアップでは、Novita の LLM API がツールをいつどのように呼び出すかを決定する推論バックエンドとなり、Novita Agent Sandbox はワークフローのコード実行側のためのより安全な実行環境となります。プラグインや MCP サーバーがリモートコード実行、ブラウザ自動化、シェルベースのヘルパーを公開している場合、この分離はアーキテクチャ上の衛生管理にとどまりません。「Claude がこのツールを呼び出せる」と「このツールがエンジニアのラップトップや共有ホストではなく、分離されたランタイムで実行される」の違いです。
実用的な判断ルール
実際に必要なドキュメントページがまだわからない場合は、次のルールを使用します。
- 「Claude Code に毎回同じ方法で何かをさせたい。」
CLAUDE.mdまたはスキルから始めます。 - 「Claude Code に別のシステムと通信させたい。」MCP から始めます。
- 「このセットアップを再利用または共有しやすくしたい。」プラグインとしてパッケージ化します。
- 「イベントで何かを自動実行させたい。」フックを使用します。
これは、機能名を暗記するよりも有用です。解決しようとしている問題に直接対応するからです。
実際のワークフローにおける位置づけ
プラグインや MCP のセットアップがより大きなエージェントスタックの一部にすぎない場合は、コーディングエージェントとは、エージェントランタイム vs コードインタープリター、MCP サーバーサンドボックス:ファイルシステム、シークレット、ネットワークコントロールを備えた分離 MCP サーバー と組み合わせてください。これにより、計画からツールアクセス、分離された実行までの完全なチェーンが得られます。
実際のチームに適したプラグインワークフロー
ほとんどのチームにとって、最もわかりやすい進め方は次のとおりです。
.claude/または直接のclaude mcp addコマンドでワークフローをプロトタイプします。- 実際の作業で有用であることが証明された部分だけを残します。
- それらの部分を、明確なマニフェストと名前空間付きスキルを持つプラグインにパッケージ化します。
- マーケットプレイスまたは内部配布パスを通じて共有します。
これにより、最も一般的な失敗モードを回避できます。それは、そのワークフローを維持する価値があるか誰も知らないうちに、すべてのアイデアをプラグインにしてしまうことです。
チームが Claude Code を代替モデルバックエンドと組み合わせている場合、これも Novita AI が運用面で役立つ段階です。プラグインと MCP レイヤーは同じままで、モデルルーティングは、すべてのステップでプレミアムなクローズドモデルを必要としないコーディング中心のセッションのために、Novita の LLM API に移行できます。この分離は、拡張スタック自体を再設計するよりも単純なことがよくあります。
Claude Code プラグインセットアップでよくある間違い
最も時間を浪費する間違いは次のとおりです。
すべての拡張機能をプラグインとして扱う
正解が単純なスキルや直接の MCP サーバー設定であることもあります。時期尚早にパッケージ化するとメンテナンスが増えます。
ファイルを間違ったディレクトリに置く
plugin.json は .claude-plugin/ に置きます。スキルとフックはそこに置きません。
名前空間を忘れる
プラグインスキルは、グローバルコマンドとしてではなく、プラグインのプレフィックスを付けて呼び出されます。
インストール後のリロードをスキップする
Claude が /reload-plugins の実行を促したら、インストールが失敗したと判断する前に実行します。
本当のニーズが MCP なのにプラグインを使う
中核の問題がツール接続である場合は、最初に MCP に焦点を当て、後でパッケージ化します。
まとめ
「プラグイン」だけを拡張機能の概念として扱うのをやめると、Claude Code プラグインのドキュメントはより理解しやすくなります。プラグインは配布レイヤーです。スキルは再利用可能な指示を保持します。フックはライフサイクルイベントを自動化します。MCP は Claude Code を外部システムに接続します。
この枠組みにより、ドキュメントの残りの部分をはるかにナビゲートしやすくなります。目標が迅速なセットアップであれば、問題を解決する最小の作業単位から始めてください。セットアップを再利用する価値がある場合にのみ、パッケージ化を追加します。
FAQ
Claude Code プラグインは MCP サーバーと同じものですか?
いいえ。MCP サーバーは外部ツールやサービスへの接続レイヤーです。プラグインは、スキル、フック、エージェント、その他の Claude Code 拡張機能とともに MCP 設定を含めることができるパッケージ化レイヤーです。
Claude Code プラグインをインストールするにはどうすればよいですか?
Claude Code 内から、プラグイン名とマーケットプレイス名を指定して /plugin install コマンドを使用します。マーケットプレイスがない場合は、/plugin marketplace add ... で追加し、Claude から促されたらプラグインをリロードします。
プラグインを使うべきですか、それとも .claude/ ファイルだけを使うべきですか?
プロジェクト固有の迅速な反復には .claude/ ファイルを使用します。セットアップをプロジェクト間で再利用したり、チームメイトと共有したり、マーケットプレイスで配布する必要がある場合は、プラグインを使用します。
プラグインの代わりに MCP を使うべきなのはいつですか?
主な目標が GitHub、Jira、Notion、Slack、内部 API などのシステムへの外部アクセスである場合は、最初に MCP を使用します。MCP プラグイン ガイドとプラグインドキュメントページを比較している場合は、MCP ガイドをツール接続のリファレンスとして、プラグインドキュメントページをパッケージングのリファレンスとして扱ってください。そのセットアップをよりきれいに再利用および配布する必要がある場合にのみ、後でプラグインとしてパッケージ化します。
Claude Code プラグインは Anthropic 以外のモデルバックエンドでも動作しますか?
はい。拡張レイヤーとモデルバックエンドは別の関心事です。実際には、サポートされているコーディングワークフローでは、Novita AI などの互換性のあるプロバイダーを介して推論をルーティングしながら、同じ Claude Code プラグインと MCP セットアップを維持できることを意味します。
おすすめ記事
- Claude Code プラグイン:MCP ツールが外部機能で Claude Code を拡張する方法
- Claude Code ルール:CLAUDE.md の書き方とエージェンティックなコーディングコンテキストの管理
- Novita Sandbox と mcp-use ライブラリでリモートコード実行 MCP サーバーを構築する
出典確認日:2026 年 8 月 31 日:Claude Code 機能概要、Claude Code プラグインドキュメント、Claude Code MCP ドキュメント、Novita AI モデルライブラリ。
