メインコンテンツへスキップ
プラグインマーケットプレイスは、利用可能なプラグインのカタログであり、Claude Code拡張機能の発見、インストール、管理を簡単にします。このガイドでは、既存のマーケットプレイスを使用する方法と、チーム配布用に独自のマーケットプレイスを作成する方法を説明します。

​
概要

マーケットプレイスはJSONファイルであり、利用可能なプラグインをリストし、それらを見つける場所を説明します。マーケットプレイスは以下を提供します：
  • 一元化された発見: 複数のソースからのプラグインを1か所で参照
  • バージョン管理: プラグインバージョンを自動的に追跡および更新
  • チーム配布: 組織全体で必要なプラグインを共有
  • 柔軟なソース: gitリポジトリ、GitHubリポジトリ、ローカルパス、パッケージマネージャーのサポート

​
前提条件

  • Claude Codeがインストールされて実行中
  • JSONファイル形式の基本的な理解
  • マーケットプレイスの作成: Gitリポジトリまたはローカル開発環境

​
マーケットプレイスの追加と使用

/plugin marketplaceコマンドを使用してマーケットプレイスを追加し、異なるソースからプラグインにアクセスします：

​
GitHubマーケットプレイスの追加

.claude-plugin/marketplace.jsonを含むGitHubリポジトリを追加
/plugin marketplace add owner/repo

​
Gitリポジトリの追加

任意のgitリポジトリを追加
/plugin marketplace add https://gitlab.com/company/plugins.git

​
開発用のローカルマーケットプレイスの追加

.claude-plugin/marketplace.jsonを含むローカルディレクトリを追加
/plugin marketplace add ./my-marketplace
marketplace.jsonファイルへの直接パスを追加
/plugin marketplace add ./path/to/marketplace.json
URLを介してリモートmarketplace.jsonを追加
/plugin marketplace add https://url.of/marketplace.json

​
マーケットプレイスからプラグインをインストール

マーケットプレイスを追加したら、プラグインを直接インストールします：
既知のマーケットプレイスからインストール
/plugin install plugin-name@marketplace-name
利用可能なプラグインを対話的に参照
/plugin

​
マーケットプレイスのインストール確認

マーケットプレイスを追加した後：
  1. マーケットプレイスをリスト: /plugin marketplace listを実行して追加されたことを確認
  2. プラグインを参照: /pluginを使用してマーケットプレイスから利用可能なプラグインを表示
  3. インストールをテスト: プラグインをインストールしてマーケットプレイスが正しく機能することを確認

​
チームマーケットプレイスの設定

.claude/settings.jsonで必要なマーケットプレイスを指定して、チームプロジェクトの自動マーケットプレイスインストールを設定します： 
{
  "extraKnownMarketplaces": {
    "team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    },
    "project-specific": {
      "source": {
        "source": "git",
        "url": "https://git.company.com/project-plugins.git"
      }
    }
  }
}
チームメンバーがリポジトリフォルダを信頼すると、Claude CodeはこれらのマーケットプレイスとenabledPluginsフィールドで指定されたプラグインを自動的にインストールします。

​
独自のマーケットプレイスを作成

チームまたはコミュニティ向けのカスタムプラグインコレクションを構築および配布します。

​
マーケットプレイス作成の前提条件

  • Gitリポジトリ（GitHub、GitLab、またはその他のgitホスティング）
  • JSONファイル形式の理解
  • 配布する1つ以上のプラグイン

​
マーケットプレイスファイルの作成

リポジトリルートに.claude-plugin/marketplace.jsonを作成します： 
{
  "name": "company-tools",
  "owner": {
    "name": "DevTools Team",
    "email": "[email protected]"
  },
  "plugins": [
    {
      "name": "code-formatter",
      "source": "./plugins/formatter",
      "description": "Automatic code formatting on save",
      "version": "2.1.0",
      "author": {
        "name": "DevTools Team"
      }
    },
    {
      "name": "deployment-tools",
      "source": {
        "source": "github",
        "repo": "company/deploy-plugin"
      },
      "description": "Deployment automation tools"
    }
  ]
}

​
マーケットプレイススキーマ

​
必須フィールド

フィールド型説明
namestringマーケットプレイス識別子（ケバブケース、スペースなし）
ownerobjectマーケットプレイス保守者情報
pluginsarray利用可能なプラグインのリスト

​
オプションのメタデータ

フィールド型説明
metadata.descriptionstringマーケットプレイスの簡潔な説明
metadata.versionstringマーケットプレイスバージョン
metadata.pluginRootstring相対プラグインソースの基本パス

​
プラグインエントリ

プラグインエントリはプラグインマニフェストスキーマ（すべてのフィールドがオプション）に基づいており、マーケットプレイス固有のフィールド（source、category、tags、strict）が追加されます。nameは必須です。
必須フィールド：
フィールド型説明
namestringプラグイン識別子（ケバブケース、スペースなし）
sourcestring|objectプラグインを取得する場所

​
オプションのプラグインフィールド

標準メタデータフィールド：
フィールド型説明
descriptionstringプラグインの簡潔な説明
versionstringプラグインバージョン
authorobjectプラグイン作成者情報
homepagestringプラグインホームページまたはドキュメンテーションURL
repositorystringソースコードリポジトリURL
licensestringSPDXライセンス識別子（例：MIT、Apache-2.0）
keywordsarrayプラグイン発見とカテゴリ化用のタグ
categorystring整理用のプラグインカテゴリ
tagsarray検索性用のタグ
strictbooleanプラグインフォルダ内のplugin.jsonを要求（デフォルト：true） 1
コンポーネント設定フィールド：
フィールド型説明
commandsstring|arrayコマンドファイルまたはディレクトリへのカスタムパス
agentsstring|arrayエージェントファイルへのカスタムパス
hooksstring|objectカスタムフック設定またはフックファイルへのパス
mcpServersstring|objectMCPサーバー設定またはMCP設定へのパス
1 - strict: true（デフォルト）の場合、プラグインはplugin.jsonマニフェストファイルを含む必要があり、マーケットプレイスフィールドはこれらの値を補足します。strict: falseの場合、plugin.jsonはオプションです。存在しない場合、マーケットプレイスエントリは完全なプラグインマニフェストとして機能します。

​
プラグインソース

​
相対パス

同じリポジトリ内のプラグイン： 
{
  "name": "my-plugin",
  "source": "./plugins/my-plugin"
}

​
GitHubリポジトリ

{
  "name": "github-plugin",
  "source": {
    "source": "github",
    "repo": "owner/plugin-repo"
  }
}

​
Gitリポジトリ

{
  "name": "git-plugin",
  "source": {
    "source": "url",
    "url": "https://gitlab.com/team/plugin.git"
  }
}

​
高度なプラグインエントリ

プラグインエントリはデフォルトのコンポーネント位置をオーバーライドし、追加のメタデータを提供できます。${CLAUDE_PLUGIN_ROOT}は環境変数であり、プラグインのインストールディレクトリに解決されることに注意してください（詳細については環境変数を参照）： 
{
  "name": "enterprise-tools",
  "source": {
    "source": "github",
    "repo": "company/enterprise-plugin"
  },
  "description": "Enterprise workflow automation tools",
  "version": "2.1.0",
  "author": {
    "name": "Enterprise Team",
    "email": "[email protected]"
  },
  "homepage": "https://docs.company.com/plugins/enterprise-tools",
  "repository": "https://github.com/company/enterprise-plugin",
  "license": "MIT",
  "keywords": ["enterprise", "workflow", "automation"],
  "category": "productivity",
  "commands": [
    "./commands/core/",
    "./commands/enterprise/",
    "./commands/experimental/preview.md"
  ],
  "agents": [
    "./agents/security-reviewer.md",
    "./agents/compliance-checker.md"
  ],
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [{"type": "command", "command": "${CLAUDE_PLUGIN_ROOT}/scripts/validate.sh"}]
      }
    ]
  },
  "mcpServers": {
    "enterprise-db": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"]
    }
  },
  "strict": false
}
スキーマ関係: プラグインエントリはプラグインマニフェストスキーマを使用し、すべてのフィールドがオプションであり、マーケットプレイス固有のフィールド（source、strict、category、tags）が追加されます。これは、plugin.jsonファイルで有効なフィールドはマーケットプレイスエントリでも使用できることを意味します。strict: falseの場合、plugin.jsonが存在しなければ、マーケットプレイスエントリは完全なプラグインマニフェストとして機能します。strict: true（デフォルト）の場合、マーケットプレイスフィールドはプラグイン独自のマニフェストファイルを補足します。

​
マーケットプレイスのホストと配布

プラグイン配布ニーズに最適なホスティング戦略を選択します。

​
GitHubでホスト（推奨）

GitHubは最も簡単な配布方法を提供します：
  1. リポジトリを作成: マーケットプレイス用の新しいリポジトリを設定
  2. マーケットプレイスファイルを追加: プラグイン定義を含む.claude-plugin/marketplace.jsonを作成
  3. チームと共有: チームメンバーは/plugin marketplace add owner/repoで追加
利点: 組み込みバージョン管理、問題追跡、チームコラボレーション機能。

​
他のgitサービスでホスト

任意のgitホスティングサービスは、任意のgitリポジトリへのURLを使用してマーケットプレイス配布に機能します。 例えば、GitLabを使用する場合： 
/plugin marketplace add https://gitlab.com/company/plugins.git

​
開発用のローカルマーケットプレイスを使用

配布前にローカルでマーケットプレイスをテストします：
テスト用のローカルマーケットプレイスを追加
/plugin marketplace add ./my-local-marketplace
プラグインインストールをテスト
/plugin install test-plugin@my-local-marketplace

​
マーケットプレイス操作の管理

​
既知のマーケットプレイスをリスト

設定されたすべてのマーケットプレイスをリスト
/plugin marketplace list
設定されたすべてのマーケットプレイスをソースとステータスとともに表示します。

​
マーケットプレイスメタデータの更新

マーケットプレイスメタデータをリフレッシュ
/plugin marketplace update marketplace-name
マーケットプレイスソースからプラグインリストとメタデータをリフレッシュします。

​
マーケットプレイスを削除

マーケットプレイスを削除
/plugin marketplace remove marketplace-name
設定からマーケットプレイスを削除します。
マーケットプレイスを削除すると、そこからインストールしたプラグインがアンインストールされます。

​
マーケットプレイスのトラブルシューティング

​
一般的なマーケットプレイスの問題

​
マーケットプレイスが読み込まれない

症状: マーケットプレイスを追加できない、またはそこからプラグインが表示されない 解決策:
  • マーケットプレイスURLがアクセス可能であることを確認
  • .claude-plugin/marketplace.jsonが指定されたパスに存在することを確認
  • claude plugin validateを使用してJSON構文が有効であることを確認
  • プライベートリポジトリの場合、アクセス権限があることを確認

​
プラグインインストール失敗

症状: マーケットプレイスは表示されるがプラグインインストールが失敗 解決策:
  • プラグインソースURLがアクセス可能であることを確認
  • プラグインディレクトリに必要なファイルが含まれていることを確認
  • GitHubソースの場合、リポジトリがパブリックであるか、アクセス権限があることを確認
  • プラグインソースを手動でクローン/ダウンロードしてテスト

​
検証とテスト

共有する前にマーケットプレイスをテストします：
マーケットプレイスJSON構文を検証
claude plugin validate .
テスト用のマーケットプレイスを追加
/plugin marketplace add ./path/to/marketplace
テストプラグインをインストール
/plugin install test-plugin@marketplace-name
完全なプラグインテストワークフローについては、プラグインをローカルでテストを参照してください。技術的なトラブルシューティングについては、プラグインリファレンスを参照してください。

​
次のステップ

​
マーケットプレイスユーザー向け

  • コミュニティマーケットプレイスを発見: Claude CodeプラグインコレクションについてgitHubを検索
  • フィードバックを提供: マーケットプレイス保守者に問題を報告し、改善を提案
  • 有用なマーケットプレイスを共有: チームが価値のあるプラグインコレクションを発見するのを支援

​
マーケットプレイス作成者向け

  • プラグインコレクションを構築: 特定のユースケース周辺のテーマ別マーケットプレイスを作成
  • バージョン管理を確立: 明確なバージョン管理と更新ポリシーを実装
  • コミュニティエンゲージメント: フィードバックを収集し、アクティブなマーケットプレイスコミュニティを維持
  • ドキュメンテーション: マーケットプレイスコンテンツを説明する明確なREADMEファイルを提供

​
組織向け

  • プライベートマーケットプレイス: 独自ツール用の内部マーケットプレイスを設定
  • ガバナンスポリシー: プラグイン承認とセキュリティレビューのガイドラインを確立
  • トレーニングリソース: チームが有用なプラグインを効果的に発見および採用するのを支援

​
関連項目