マーケットプレイスリファレンス

• マーケットプレイスファイル: トップレベルフィールド および プラグインエントリ
• エントリの source: プラグインソース
• 設定の source オブジェクト: マーケットプレイスソース
• claude plugin validate <path> からの出力: 検証メッセージ。各メッセージをそれが名前を付けるフィールドにマップします

​

マーケットプレイスファイル

​

予約名

• 公式マーケットプレイス名: claude-code-marketplace、claude-code-plugins、claude-plugins-official、anthropic-marketplace、anthropic-plugins、agent-skills、anthropic-agent-skills、life-sciences、knowledge-work-plugins、claude-for-legal、claude-for-financial-services、financial-services-plugins、first-party-plugins、および claude-tag-plugins。マーケットプレイスが github.com/anthropics/ の下の github または git マーケットプレイスソース から来ない限り予約されています。
• コミュニティマーケットプレイス名: claude-community、claude-plugins-community、および healthcare。公式名と同じルールの下で予約されています。
• プラグインディレクトリ名: anthropic-plugin-directory および claude-plugin-directory。公式名と同じルールの下で予約されています。
• 公式マーケットプレイスになりすまし名: official-claude-plugins または claude-plugins-v2 などの名前、および非 ASCII 文字を含む任意の名前。エラーは Marketplace name impersonates an official Anthropic/Claude marketplace です。名前内の制御文字または双方向フォーマット文字も Marketplace name cannot contain control or bidirectional-formatting characters を報告します。
• 予約名の別のスペル: 予約名と末尾のドット、またはハイフンの代わりにハイフン以外の記号によってのみ異なる名前。claude.code.plugins は claude-code-plugins としてカウントされます。claude plugin validate はそのような名前を受け入れます。マーケットプレイスの追加は is another spelling of "<reserved>", a reserved marketplace name で失敗し、1 つの下で登録されたマーケットプレイスは読み込みを停止します。このチェックには Claude Code v2.1.280 以降が必要です。
• Claude Code がマーケットプレイスから来ないプラグインに使用する名前: --plugin-dir で読み込まれたプラグインの inline、組み込みプラグインの builtin、.claude/skills/ から自動読み込みされたプラグインの skills-dir、および claude.ai アカウントから同期されたプラグインの synced。claude-plugin-test も予約されています。skills-dir は strictKnownMarketplaces および blockedMarketplaces で {"source": "skills-dir"} としても表示されます。ポリシーリストでのみ有効なソース値 で説明されています。
• npm、pip、uv、cargo、github、および gh: 任意の大文字小文字で予約されています。このチェックには Claude Code v2.1.275 以降が必要です。
• claudeai- で始まる名前: claude.ai でホストされているマーケットプレイス用に予約されています。claude plugin marketplace add は Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai で他のマーケットプレイスを拒否します。

​

トップレベルフィールド

​

プラグインエントリ

​

エントリが plugin.json とどのように組み合わされるか

• plugin.json なし: エントリは strict に関係なくマニフェストです。mcpServers、lspServers、userConfig、および channels を含むすべてのマニフェストフィールドがエントリに適用されます。
• plugin.json 存在: plugin.json はマニフェストです。厳密モード は、エントリの 6 つのコンポーネントフィールド commands、agents、skills、hooks、outputStyles、および themes が組み合わされるか、競合として拒否されるかを決定します。エントリ mcpServers、lspServers、userConfig、および channels は適用されません。plugin.json で宣言してください。

​

エントリ内のフック

​

表示フィールド

• エントリで設定したフィールドの場合、ユーザーはエントリの値を見ます。plugin.json が異なる値を設定している場合でも。
• エントリが設定しないフィールドの場合、ユーザーは plugin.json 値を見ます。

​

厳密モード

​

プラグインソース

• ref: ブランチまたはタグ。リポジトリのデフォルトブランチにデフォルト設定されます。
• sha: 40 文字の小文字のコミット SHA。ref と sha の両方を設定すると、Claude Code は sha をチェックアウトします。GitHub、GitLab、Bitbucket を含むほとんどの git ホストでは、ref で指定されたブランチまたはタグが上流で削除されていても、コミットがリポジトリから到達可能である限り、インストールは成功します。AWS CodeCommit などの一部のサーバーは SHA によるコミット取得をサポートしていません。これらのサーバーでは、ref が存在し、ピン留めされたコミットがそこから到達可能である必要があります。

​

相対パスプラグインソース

{ "name": "formatter", "source": "./plugins/formatter" }

• github、git、file、directory: Claude Code はマーケットプレイスのファイルを持っています。
• url: Claude Code は marketplace.json のみを取得するため、相対パスは解決できません。各プラグインに github や git-subdir などのオブジェクトソースを指定してください。
• settings: 相対パスは完全に拒否されます。

​

pluginRoot の下の裸の名前

• それ自体がマーケットプレイス内の相対パスである必要があります。
• 既に ./ で始まるソースには影響を与えません。
• team-a/formatter のように / を含むソースは裸の名前ではなく、metadata.pluginRoot が設定されていても ./ プレフィックスが必要です。

​

github プラグインソース

{
  "name": "formatter",
  "source": {
    "source": "github",
    "repo": "your-org/formatter",
    "ref": "v2.0.0",
    "sha": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"
  }
}

​

url プラグインソース

{
  "name": "formatter",
  "source": {
    "source": "url",
    "url": "https://gitlab.example.com/your-group/formatter.git",
    "ref": "main"
  }
}

​

git-subdir プラグインソース

{
  "name": "formatter",
  "source": {
    "source": "git-subdir",
    "url": "https://github.com/your-org/monorepo.git",
    "path": "tools/formatter"
  }
}

​

npm プラグインソース

• package: パッケージ名、または @your-org/formatter のようなスコープ付き名前
• version: バージョンまたは範囲
• registry: デフォルトレジストリにないパッケージのレジストリ URL

{
  "name": "formatter",
  "source": {
    "source": "npm",
    "package": "@your-org/formatter",
    "version": "^2.0.0",
    "registry": "https://npm.example.com"
  }
}

​

archive プラグインソース

{
  "name": "formatter",
  "source": {
    "source": "archive",
    "url": "https://artifacts.example.com/formatter-2.0.0.zip",
    "sha256": "6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1"
  }
}

​

command プラグインソース

• command: プラグインディレクトリの絶対パスを 1 行として出力し、終了コード 0 で終了するシェルコマンド。Claude Code はユーザーに実行前にレビュー用の文字列全体を表示します。印字可能な ASCII で記述し、最大 500 文字で、4 文字以上の連続スペースはありません。
• timeout: 1 から 600 までの秒数。デフォルトは 60 です。
• mode: copy（デフォルト）または link。コピーモードとリンクモードを参照してください。

{
  "name": "formatter",
  "source": {
    "source": "command",
    "command": "my-tool claude-plugin-path",
    "timeout": 120
  }
}

​

コマンドが実行する必要があること

• シェルと作業ディレクトリ: Claude Code はコマンドを sh を通じて実行するか、Windows では cmd.exe を通じて実行し、ユーザーのホームディレクトリから実行します。絶対パスまたは PATH 上のコマンドを指定してください。
• 出力: stdout に正確に 1 行、プラグインディレクトリの絶対パスを出力し、timeout 秒以内に終了コード 0 で終了します。
• ディレクトリの内容: コマンドが終了するまでに、ディレクトリはプラグイン全体を保持します。パスは実行ごとに異なる場合があります。

​

インストールまたは更新に失敗する出力

• プラグインコンテンツなし: 出力されたディレクトリの最上部にプラグインコンテンツがありません。例えば .claude-plugin/ ディレクトリや skills/、commands/、agents/、hooks/ ディレクトリなどです。
• セッション自体のディレクトリ: 出力されたディレクトリは Claude Code が開始されたディレクトリ、またはその親の 1 つです。
• ネットワークパス: Windows では、出力されたパスは UNC パスです。
• コピーするには大きすぎます: コピーモードでは、ディレクトリが 256 MiB より大きいか、20,000 を超えるエントリを持っています。

​

コピーモードとリンクモード

• copy: Claude Code はディレクトリをプラグインキャッシュにコピーし、コピーされたファイルのハッシュからプラグインバージョンを導出します。ツールはコマンド終了後にディレクトリを削除または上書きできます。同じファイルを生成する再実行は最新と見なされます。
• link: Claude Code はプラグインのキャッシュエントリを出力されたディレクトリの各最上位エントリへのリンクで満たし、ファイルを所定の位置で読み込みます。何もコピーされず、ファイルの内容はハッシュされず、サイズ制限は適用されません。コピーするには大きすぎるディレクトリ（レンダリングされた SDK エクスポートなど）に使用します。

• ディレクトリを所定の位置に保つ: Claude Code はすべての起動時にリンクを通じてプラグインを読み込むため、出力されたディレクトリはプラグインがインストールされている限り、その場所に留まる必要があります。
• 新しいコンテンツを通知するために異なるパスを出力: バージョンはファイル内の内容ではなく、出力されたディレクトリの実際のパスとその最上位エントリから取得されます。
• ディレクトリ内に最上位シンボリックリンクを保つ: 最上位エントリが出力されたディレクトリの外を指すシンボリックリンクの場合、インストールは失敗します。
• node_modules を含める: Claude Code はリンクモードプラグインのNode.js パッケージ依存関係インストールをスキップするため、プラグインが必要とするパッケージを既に含むディレクトリを出力してください。
• ディレクトリ内で開始されたセッション: 出力されたディレクトリまたはその下の任意の場所で開始されたセッションはプラグインを読み込みません。
• Windows ではない: Claude Code は Windows でリンクモードプラグインのインストールを拒否します。そこで "mode": "copy" を宣言してください。

​

マーケットプレイスソース

• claude plugin marketplace add: Claude Code は渡した文字列からソースを構築します。
• extraKnownMarketplaces: source オブジェクトとして自分でソースを記述します。
• strictKnownMarketplaces および blockedMarketplaces: 管理者はこれら 2 つのポリシーリストでソースを記述します。strictKnownMarketplaces は許可リストで、blockedMarketplaces は拒否リストです。

​

タイプ別フィールド

​

ポリシーリストでのみ有効なソース値

• hostPattern および pathPattern: Claude Code がソースをフェッチする前にテストする正規表現。
• skills-dir: ソースではありません。strictKnownMarketplaces をすべて設定する場合、スキルディレクトリプラグイン は {"source": "skills-dir"} をそのリストに追加するまで読み込みを停止します。
• owner/*: github repo 値として、正確にその GitHub 所有者の下のすべてのリポジトリに一致します。Claude Code v2.1.223 以降が必要です。

​

設定のソースオブジェクト

{
  "extraKnownMarketplaces": {
    "your-marketplace": {
      "source": {
        "source": "git",
        "url": "https://git.example.com/your-org/your-marketplace.git",
        "ref": "main"
      }
    }
  }
}

{
  "strictKnownMarketplaces": [
    { "source": "github", "repo": "your-org/*" },
    { "source": "hostPattern", "hostPattern": "^git\\.example\\.com$" }
  ]
}

​

検証メッセージ

​

source の無効な入力

• ./ で始まらない相対パス。ただし "." または metadata.pluginRoot の下のベアネーム を除く
• .. を含む npm package
• プラグインソース の 1 つではない source タイプ
• github なしの repo など、必須フィールドが欠落しているか間違った型の既知のタイプ

​

検証が検出しない失敗

​

次のステップ

• マーケットプレイスの作成: これらのフィールドからマーケットプレイスを構築し、ローカルからインストール
• マーケットプレイスのホストと保守: ファイルを配置する場所とユーザーが変更を受け取る方法
• プラグインマニフェストリファレンス: エントリがオーバーライドできる plugin.json フィールド
• 組織のプラグインを管理する: これらのソース値を使用する許可リストと拒否リストのレシピ