マーケットプレイスを作成する

​

マーケットプレイスを作成する

mkdir -p my-marketplace/.claude-plugin my-marketplace/plugins
cp -r my-first-plugin my-marketplace/plugins/

claude plugin validate ./my-marketplace/plugins/my-first-plugin

{
  "name": "my-marketplace",
  "description": "Plugins for my team",
  "owner": {
    "name": "Your Name"
  },
  "plugins": [
    {
      "name": "my-first-plugin",
      "source": "./plugins/my-first-plugin",
      "description": "A greeting plugin to learn the basics"
    }
  ]
}

claude plugin validate ./my-marketplace

claude plugin marketplace add ./my-marketplace

claude plugin install my-first-plugin@my-marketplace

claude plugin list

claude plugin details my-first-plugin

​

プラグインエントリを追加する

• name：インストール時に @ の前に入力する識別子。スペースを含むことはできません。
• source：Claude Code がプラグインを取得する場所。チュートリアルのようにマーケットプレイスディレクトリ内のプラグインの相対パス文字列、またはその外のプラグインのソースオブジェクトを記述します。プラグインソースを選択するを参照してください。
• description：ユーザーが /plugin でマーケットプレイスを参照するときにプラグインの横に表示される行。

​

プラグインエントリのルール

​

マーケットプレイスルートから相対パスを記述する

• .. を含むパス：claude plugin validate はエントリを無効として報告します。メッセージは Path contains "..": ./../plugins/my-first-plugin で始まります。
• 存在しないディレクトリへのパス：claude plugin validate は成功します。claude plugin install は Source path does not exist: <path> で失敗し、<path> は Claude Code が確認した絶対位置です。

​

エントリ名とマニフェスト名を同じに保つ

• エントリ名：インストール ID、<entry-name>@<marketplace>。これはインストール時に入力する内容、claude plugin list が表示する内容、および Claude Code が設定ファイルの enabledPlugins の下に記述するキーです。
• マニフェスト名：プラグインのスキルのプレフィックス、および claude plugin details が受け取る名前。

​

プラグインソースを選択する

• url：任意のホスト上の git リポジトリ（URL による）
• archive：HTTPS 経由でダウンロードされた zip ファイル
• npm：npm パッケージ
• command：プラグインがインストールされているマシンでコマンドを実行して生成されたディレクトリ

​

検証とテスト

​

検証が報告する問題

• JSON 構文エラー（json: Invalid JSON syntax: <reason> として）
• owner: Invalid input などの必須フィールドの欠落
• スペース、非 ASCII 文字、または claude-official などの公式 Anthropic マーケットプレイスを模倣する形式を持つマーケットプレイス名
• .. を含む相対 source
• トップレベルまたはプラグインエントリの未知のフィールド（警告として）
• 各相対パスプラグインの plugin.json の問題（plugins[N] plugin.json → <field>: <message> として）

​

マーケットプレイスを追加またはインストールするときに表示される問題

• マーケットプレイスを追加するとき：claude-plugins-official などの正確な公式マーケットプレイス名は検証に合格します。これらの名前の 1 つを持つマーケットプレイスを追加すると、Claude Code は The name '<name>' is reserved for official Anthropic marketplaces で始まるメッセージで拒否します。
• プラグインをインストールするとき：
  • Claude Code は、プラグインをインストールするときに github、git-subdir、または他のリモートソースを最初に取得するため、間違った repo または path はその時点で表示されます。
  • ディレクトリが存在しない相対 source も、Source path does not exist: <path> でインストール時に失敗します。

​

プラグインの編集をテストする

​

マーケットプレイスを削除して最初からやり直す

​

マーケットプレイスをホストする

​

次のステップ

• マーケットプレイスをホストして維持する：ホストを選択し、ユーザーを最新に保ち、プラグインを安全に名前変更または削除します
• マーケットプレイスリファレンス：marketplace.json フィールドとソースタイプ
• 組織のプラグインを管理する：すべてのマシンでマーケットプレイスとそのプラグインを必須にします
• 関連性によってプラグインを提案する：セッションが一致するときにマーケットプレイスからプラグインを提案するように Claude Code に指示します