プラグインとマーケットプレイス

Claude Code プラグインは、散らばっていた拡張機能を 1 つのパッケージに束ねてチームやコミュニティへ配布する単位であり、マーケットプレイスはそのパッケージを発見しインストールするカタログです。ハーネスの観点から見れば、前の 3 つのドキュメントで学んだスキル・フック・MCP という素材を「1 つのインストール可能なハーネスの断片」として包む配布層です。

背景リファレンス

このページは、MoAI-ADK が動作する基盤である Claude Code そのもの を解説する背景資料です。MoAI-ADK 自体の機能は、サイドバーの上位セクションで扱います。

情報

ひとことで言うと: プラグインはコマンド・エージェント・スキル・hook・MCP を 1 つのフォルダに収めてバージョン管理しながら配布する「拡張の束」で、マーケットプレイスはその束を選んで手に入れるアプリストアです。

プラグイン (plugin) は、Claude Code の複数の拡張要素を 1 つのディレクトリに束ね、共有・再利用・バージョン管理 できるようにしたパッケージです。.claude/ ディレクトリに直接置く単独設定と異なり、プラグインはマニフェストファイルでアイデンティティを持ち、マーケットプレイスを通じて他のプロジェクトやチームへ配布されます。

単独設定とプラグインの違いは明確です。

プラグインの核心は .claude-plugin/plugin.json の マニフェスト です。このファイルがプラグインの名前・説明・バージョンを定義し、name フィールドはそのままスキルの名前空間プレフィックスになります。マニフェストは任意で、なくてもプラグインは動作しますが、バージョン管理とマーケットプレイスでの配布はマニフェストがあるほうがはるかに容易です。

{
  "name": "my-first-plugin",
  "description": "A greeting plugin to learn the basics",
  "version": "1.0.0",
  "author": { "name": "Your Name" }
}

version は任意の値です。明示するとこの値を上げたときだけユーザーに更新が届き、省略して git で配布するとコミット SHA がバージョンの役割を果たし、毎コミットが新バージョンとして扱われます。

開発中は claude --plugin-dir ./my-plugin でインストールなしにローカルプラグインを直接ロードしてテストし、変更後は /reload-plugins で再起動なしに反映します。

プラグインのルート (.claude-plugin/plugin.json ではなくプラグインディレクトリ自体) に要素ごとのディレクトリを置きます。重要な注意: .claude-plugin/ の中には plugin.json のみ が入り、スキル・コマンド・エージェント・hook などすべての構成要素はプラグインのルートに置きます。

このようにプラグイン 1 つがスキル・hook・MCP を同時に収められるため、「この作業に必要なすべての拡張」を 1 回のインストールで届けられます。たとえば commit-commands プラグインは commit・push・PR 作成のスキルを束ねて提供し、pr-review-toolkit は PR レビュー専用のエージェント群を一緒に配布します。

マーケットプレイス (marketplace) は、誰かが作ったプラグインの一覧を収めたカタログです。使い方は 2 段階です。まずカタログを 追加 して閲覧できるようにし、次に目的のプラグインを 個別にインストール します。アプリストアを登録することと、個別のアプリをダウンロードすることを分けて考えればよいでしょう。

/plugin marketplace add でさまざまな出どころを登録できます。

# GitHub リポジトリ (owner/repo 形式)
/plugin marketplace add anthropics/claude-plugins-official

# 別の Git ホスト (.git 接尾辞が必須)
/plugin marketplace add https://gitlab.com/company/plugins.git

# 特定のブランチ・タグに固定
/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0

# ローカルパス / リモートの marketplace.json
/plugin marketplace add ./my-marketplace
/plugin marketplace add https://example.com/marketplace.json

公式の Anthropic マーケットプレイス (claude-plugins-official) は Claude Code の起動時に自動で利用可能です。コミュニティのマーケットプレイスは手動で追加します。

# 公式マーケットプレイスからインストール
/plugin install hello@claude-plugins-official

# コミュニティマーケットプレイスを追加してからインストール
/plugin marketplace add anthropics/claude-plugins-community
/plugin install <plugin-name>@claude-plugins-community

/plugin を実行すると Discover / Installed / Marketplaces / Errors の 4 タブを持つプラグインマネージャーが開きます。Discover タブの詳細パネルでは、インストール前にコンテキストコスト (Context cost) の推定値、最終更新日、そしてインストールされるコマンド・エージェント・スキル・hook・MCP・LSP の一覧を事前に確認できます。

インストール範囲 (scope) は 3 つです。

インストール・有効化・無効化・削除は CLI でも可能です。

/plugin install plugin-name@marketplace-name   # インストール (デフォルトは user 範囲)
/plugin disable plugin-name@marketplace-name    # 無効化 (削除はしない)
/plugin enable  plugin-name@marketplace-name    # 再有効化
/plugin uninstall plugin-name@marketplace-name  # 完全に削除
/reload-plugins                                 # 再起動なしで変更を反映

チーム単位では、.claude/settings.json の extraKnownMarketplaces キーにマーケットプレイスを宣言しておけば、協業者がリポジトリのフォルダを信頼した際に Claude Code がそのマーケットプレイスとプラグインのインストールを案内します。

コードインテリジェンス (code intelligence) プラグインは、LSP (Language Server Protocol) を通じて Claude Code 組み込みのコードインテリジェンスツールを有効化します。VS Code のコードナビゲーションを支えるまさにあの技術です。言語別のプラグインをインストールし、対応する 言語サーバーのバイナリ がシステムにあって初めて動作します。

プラグインが有効になると、Claude は 2 つの能力を得ます。

• 自動診断 (diagnostics): Claude がファイルを編集するたびに言語サーバーが変更を分析し、型エラー・不足している import・構文エラーを自動で報告します。コンパイラやリンターを別途回さなくても、同じターンでエラーに気づきすぐに直します。「diagnostics found」の表示が出たときに Ctrl+O を押すとインラインで確認できます。
• コードナビゲーション (navigation): 定義へ移動、参照検索、ホバーの型情報、シンボル一覧、実装検索、呼び出し階層の追跡が可能です。grep ベースの検索よりはるかに正確な探索を提供します。

Executable not found in $PATH エラーが /plugin の Errors タブに見えたら、上の表の言語サーバーバイナリをインストールすれば解決します。rust-analyzer・pyright などは大規模コードベース (large codebase) でメモリを多く使うことがあるため、負担なら該当プラグインを無効化して Claude 組み込みの検索に頼っても構いません。

プラグインとマーケットプレイスは 非常に高い信頼を要する構成要素 です。ユーザー権限で任意のコードを実行できるからです。信頼できる出どころからのみインストールしてください。

• Anthropic はプラグインに含まれる MCP サーバー・ファイル・ソフトウェアを統制せず、意図どおりに動作するかを検証しません。サードパーティのプラグインはインストール前にホームページと Discover タブの「Will install」一覧を自ら確認してください。
• コミュニティマーケットプレイスのプラグインは、Anthropic の自動検証・安全スクリーニングを通過した後、特定のコミット SHA に固定されて配布されます。それでも最終的な信頼の判断はインストールする側の責任です。
• 組織は管理設定 (managed settings) で、ユーザーが追加できるマーケットプレイスを制限できます。

flowchart TD
    A[マーケットプレイス追加
/plugin marketplace add] --> B[プラグイン探索
/plugin Discover タブ]
    B --> C{出どころを
信頼できるか?}
    C -- いいえ --> D[インストール保留
ホームページ・Will install を確認]
    C -- はい --> E[インストール範囲を選択
User / Project / Local]
    E --> F[インストール
/plugin install]
    F --> G[変更を反映
/reload-plugins]
    G --> H[名前空間スキルを使用
/plugin-name:skill]

MoAI-ADK 自体はプラグインではなく、moai init が .claude/ ディレクトリにハーネス資産 (スキル・エージェント・hook・設定) を直接配布する方式を使います。それでも、このページの 2 点は MoAI-ADK ユーザーにも直接関わります。第一に、Discover タブの コンテキストコスト (Context cost) 推定値は、トークノミクスの感覚をそのまま反映した指標です — 拡張を 1 つインストールするたびに常時コンテキストがどれだけ増えるかを見て判断してください。第二に、コードインテリジェンス (LSP) プラグインは MoAI-ADK の言語別品質ゲートが活用する診断シグナルと同系統なので、使用言語の LSP プラグインをインストールしておけば、編集直後の型エラーを同じターンで捕まえるループがはるかに緻密になります。

• スキル
• フック (Hooks)
• MCP サーバー

• Create plugins (code.claude.com)
• Discover and install plugins (code.claude.com)
• What Claude gains from code intelligence plugins

ヒント

インストールしたいプラグインが見つからないときは、マーケットプレイスが古くなっている可能性があります。/plugin marketplace update <marketplace-name> で一覧を更新してから、もう一度インストールを試してください。