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

• マーケットプレイスファイル: トップレベルフィールド および プラグインエントリ
• エントリの 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 としてカウントされます。マーケットプレイスの追加は is another spelling of "<reserved>", a reserved marketplace name で失敗し、そのような名前で既に登録されているマーケットプレイスは読み込みを停止します。このチェックには 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 以降が必要です。
• すべての JavaScript オブジェクトが持つメンバー名: constructor、hasOwnProperty、isPrototypeOf、propertyIsEnumerable、toLocaleString、toString、および valueOf。claude plugin marketplace add は、これらのいずれかを使用するマーケットプレイスを Claude Code reserves this name and cannot register a marketplace under it で拒否します。このチェックには Claude Code v2.1.296 以降が必要です。
• claudeai- で始まる名前: claude.ai でホストされているマーケットプレイス用に予約されています。claude plugin marketplace add は Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai で他のマーケットプレイスを拒否します。
• 登録済みの GitHub マーケットプレイスのダウンロードフォルダ <owner>-<repo>: Claude Code は、acme/x-tools などの github ソースから追加されたマーケットプレイスを、そのマーケットプレイス自体の name に関係なく、acme-x-tools という名前のフォルダを通じてダウンロードします。そのマーケットプレイスが acme-x-tools 以外の名前で登録されている間、claude plugin marketplace add は acme-x-tools という名前の別のマーケットプレイスをダウンロードした後にそれを拒否し、Can't use the marketplace name "acme-x-tools" を報告します。このチェックには Claude Code v2.1.290 以降が必要です。

​

トップレベルフィールド

​

プラグインエントリ

​

エントリが 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: 相対パスは完全に拒否されます。

​

マーケットプレイスリポジトリ内の Git サブモジュール

• プラグインがサブモジュール内にある: サブモジュールがプラグインのディレクトリ、またはその上位のディレクトリである
• サブモジュールがプラグイン内にある: サブモジュールがプラグインのディレクトリ配下のいずれかの場所にある
• シンボリックリンクがサブモジュール内を指している: リポジトリにコミットされたリンクのターゲットがサブモジュール内にある

• コンポーネントディレクトリ: ルートにあるプラグインコンポーネントを保持するディレクトリ（skills/、hooks/、bin/ など）
• プラグインの設定内のパス: プラグインのマーケットプレイスエントリ、その plugin.json、または .mcp.json や hooks/hooks.json などの設定ファイル内のパス
• シンボリックリンク: リポジトリにコミットされたリンク
• プラグインのファイル内のテキスト: 設定ファイルまたはコンポーネントディレクトリ配下のファイルに記述された、vendor/tool のようなサブモジュールのパス

• ルートにある SKILL.md: この場合、リポジトリ全体が 1 つのスキルのディレクトリになります
• Claude Code が読み取れないファイル: マーケットプレイスファイル、プラグインの設定ファイルのいずれか、または .gitmodules

​

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 のようなレジストリパッケージ名、@your-org/formatter@2.0.0 のようにバージョンを付加した名前、またはパッケージの tarball ファイルへの https リンク
• version: バージョン、semver 範囲、または dist-tag。package がバージョンを付加していないパッケージ名の場合に使用されます。省略すると latest を取得します
• registry: デフォルトレジストリにないパッケージのレジストリ URL

• git アドレス、フォルダまたは file: パス、あるいは npm: エイリアス: git リポジトリには github、url、または git-subdir ソースを、マーケットプレイス内のフォルダには相対パスを、エイリアスにはパッケージ自体の名前を使用してください
• github.com、gist.github.com、gitlab.com、bitbucket.org、または git.sr.ht 上の tarball リンク: リンクが GitHub リリースのダウンロードであっても拒否されます。ただし、gitlab.com/api/v4/ 配下の GitLab npm レジストリリンクは除きます
• http 経由の tarball リンク: インストールするユーザー自身のデフォルト npm レジストリを指していない限り拒否されます

{
  "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: ソースではありません。{"source": "skills-dir"} エントリなしで strictKnownMarketplaces を設定すると、スキルディレクトリプラグイン は読み込まれなくなります。strictPluginOnlyCustomization でいずれかのカスタマイズタイプをロックした場合は、エントリの有無にかかわらず読み込まれなくなります。
• 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 の無効な入力

• .. を含む npm package
• プラグインソース の 1 つではない source タイプ
• github に repo がないなど、必須フィールドが欠落しているか、型が間違っている既知のタイプ

​

検証が検出しない失敗

​

次のステップ

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