組織向けの Claude Code プラグインを管理する

​

プラグインの事前インストールと要求

​

配信メカニズムを選択する

• サーバーマネージド設定: 組織設定 > Claude Code > マネージド設定 でプラグインキーを JSON として設定します。Claude 組織の オーナーロール が必要です。クラウドセッションはプラグインをインストールする前にこれらの設定を取得します。
• MDM ポリシー: macOS では、トップレベルキーが設定キーである plist を配信します。Windows では、JSON ドキュメント全体をレジストリ値の文字列として保存します。plist ドメインとレジストリキーは 各メカニズムがポリシーを保存する場所 にあります。
• マネージド設定ファイル: プラットフォームのシステムパスに managed-settings.json を配置します。その横の managed-settings.d/ ドロップイン ディレクトリにファイルを追加することもできます。プラットフォームごとのファイルパスは 各メカニズムがポリシーを保存する場所 にあり、ドロップイン マージルールは ファイルベースのポリシーをチーム間で分割する にあります。

​

マシンに適用されるマネージドソース

​

マーケットプレイスとそのプラグインを要求する

{
  "extraKnownMarketplaces": {
    "your-marketplace": {
      "source": { "source": "github", "repo": "your-org/your-marketplace" },
      "autoUpdate": true
    }
  },
  "enabledPlugins": {
    "code-formatter@your-marketplace": true,
    "deploy-helper@your-marketplace": true
  }
}

• autoUpdate: true はマーケットプレイスとそのプラグインをバックグラウンドで更新し続け、false はそれをオフにします。更新ポリシーを設定 を参照してください。
• source: github は複数のソースタイプの 1 つです。git ソースは GitLab または内部ホスト用の url を取り、url ソースはホストされた marketplace.json のアドレスを取ります。すべてのソース形状は マーケットプレイスリファレンス にあります。

• マーケットプレイス: マネージドマーケットプレイスエントリは、同じ名前の低優先度エントリを置き換え、2 つのエントリのフィールドはマージされません。
• --plugin-dir コピー: --plugin-dir は 1 つのセッション用にローカルディレクトリからプラグインを読み込みます。そのコピーの名前がマネージド enabledPlugins が指定するプラグインと一致する場合の動作については、名前の競合 を参照してください。

​

リポジトリごとにプラグインを要求する

• インタラクティブセッション: Claude Code は、貢献者がそのフォルダの ワークスペース信頼ダイアログ を受け入れた後にのみマーケットプレイスを登録します。
• 非インタラクティブ -p 実行: エントリは、ユーザーが既にインタラクティブに信頼を受け入れたフォルダ、または ~/.claude.json で hasTrustDialogAccepted フラグを設定したフォルダでのみ適用されます。

​

各サーフェスがプラグインキーを適用する場合

​

ロールアウトを確認する

• 1 つのマシン上: Claude Code を開始して /plugin を実行します。マーケットプレイスとプラグインがリストされます。
• CI 内: claude -p を --output-format stream-json --verbose で実行します。init イベントは plugins の下に読み込まれたプラグインをリストします。

​

コンテナと CI をシードする

CLAUDE_CODE_PLUGIN_CACHE_DIR=/opt/claude-seed claude plugin marketplace add your-org/your-marketplace
CLAUDE_CODE_PLUGIN_CACHE_DIR=/opt/claude-seed claude plugin install code-formatter@your-marketplace

• 読み取り専用: Claude Code はシードに書き込まず、シードマーケットプレイスに対して autoUpdate をオフに強制します。
• シードエントリが優先: 各スタートアップで、シードで宣言されたマーケットプレイスは同じ名前のユーザーエントリを上書きします。ユーザーはマーケットプレイスを削除することではなく、claude plugin disable でシードプラグインをオプトアウトします。
• 更新と削除が失敗: claude plugin marketplace update <name> と remove は、シードマーケットプレイスで --scope なしで失敗し、シードディレクトリを指定するメッセージが表示されます。
• ポリシーはまだ適用: 許可リストとブロックリスト はシードマーケットプレイスの記録されたソースもチェックします。ビルドしたソースを許可します。

​

ユーザーがインストールできるものを制限する

• ダウンロード前: リストは、ユーザーがマーケットプレイスを追加し、すべてのインストール、更新、更新、および自動更新時に適用されます。
• セッション開始時: リストは既にインストールされているプラグインに再度適用されるため、マーケットプレイスソースがもはや一致しないインストール済みプラグインは読み込まれません。/plugin は Marketplace "<name>" is not in the allowed marketplace list または Marketplace "<name>" is blocked by enterprise policy でリストします。

• claude.ai 管理コンソール: Claude Code は サーバーマネージド設定を読み取る セッションで両方のリストを適用します。claude.ai は、組織内の誰かが claude.ai から新しいマーケットプレイスを git リポジトリから追加するか、Claude Desktop アプリの Code タブ外から カスタマイズ から追加する場合もチェックします。これは、メンバーが独自のアカウント用に追加するマーケットプレイスと、組織設定 > プラグイン の下で組織全体に追加されるマーケットプレイスをカバーします。claude.ai は、許可リストが認めないリポジトリまたはブロックリストが指定するリポジトリを拒否します。リストを設定する前にどちらかの場所で追加されたマーケットプレイスを再チェックしません。また、アップロードされたプラグインもチェックしません。
• マネージド設定ファイル、OS レベルのポリシー、または他のマネージドソース: Claude Code は、そのソースを読み取る場所で両方のリストを適用します。claude.ai はそれを読み取りません。

​

コントロールマトリックス

• enabledPlugins: 任意のスコープで設定でき、マネージド設定がそれをロックします。
• syncClaudeAiPlugins: 各ユーザーは独自のユーザーまたはローカル設定でも設定できます。設定リファレンス でそのスコープを参照してください。
• CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL: これは、フリート全体の更新をオフにする の下に示されているマネージド env ブロックを通じて配信する環境変数です。

​

マーケットプレイスキーのエイリアス

• バージョン: エイリアスは Claude Code v2.1.232 以降が必要であり、古いクライアントはそれらを無視します。混合フリートが読み取るファイルでは、正規名を保持してください。
• 両方の綴りが設定: ファイルが両方の綴りを設定する場合、正規キーの値が適用されます。

​

strictKnownMarketplaces を使用した許可リスト

• github: { "source": "github", "repo": "your-org/approved-plugins" }、オプションの ref と path を使用。
• github オーナーワイルドカード: { "source": "github", "repo": "your-org/*" } はそのオーナーの下のすべてのリポジトリと一致します。* はリポジトリ名全体を表す必要があります。Claude Code は */plugins や your-org/tools-* などのエントリを無効として無視するため、何も一致しません。Claude Code v2.1.223 以降が必要です。
• git: { "source": "git", "url": "https://gitlab.example.com/tools/plugins.git" }、オプションの ref と path を使用。
• url: { "source": "url", "url": "https://plugins.example.com/marketplace.json" }、オプションの headers を使用。
• file と directory: { "source": "file", "path": "/opt/marketplace/marketplace.json" } または { "source": "directory", "path": "/opt/marketplace/plugins" }、絶対パスを使用。
• hostPattern: { "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }、github、git、および url ソースのホストと照合。パターンはホスト名のどこかで一致するため、示されているように ^ と $ でアンカーしてホスト全体と一致させます。github ソースは常に github.com としてカウントされます。開発者が独自のマーケットプレイスを作成する GitHub Enterprise Server または GitLab ホストに hostPattern エントリを使用します。GHES ページ に実装例があります。
• pathPattern: { "source": "pathPattern", "pathPattern": "^/opt/approved/" }、file と directory ソースの path と照合。パターンはパスのどこかで一致するため、ディレクトリプレフィックスをピンするために ^ で開始します。".*" はすべてのローカルパスを許可します。
• skills-dir: { "source": "skills-dir" } は、許可リストが設定されている間 スキルディレクトリプラグイン を読み込み続け、マーケットプレイスと一致しません。

​

エントリがどのように一致するか

• ref のないエントリは ref: "main" を持つソースをカバーしません。
• your-org/your-marketplace のエントリは、同じリポジトリをクローンする git URL をカバーしません。
• 末尾のスラッシュ、.git サフィックス、または https:// の代わりの ssh:// は異なる値です。マーケットプレイスを複数の URL でクローンできる場合は、hostPattern エントリを優先します。

​

スキルディレクトリプラグインを読み込み続ける

​

claude.ai でホストされているマーケットプレイス

​

すべてのソースをロックアウトする

​

blockedMarketplaces を使用したブロックリスト

• Git URL は正規化されるため、1 つの github.com リポジトリの git@ と https:// フォーム、.git サフィックス、および末尾のスラッシュはすべて同じエントリと一致します。
• github エントリは同等の git URL もブロックし、その逆も同様です。
• owner/* エントリの場合、オーナー比較は大文字と小文字を区別しません。
• ref または path のないエントリは、一致するリポジトリのすべての ref とパスをブロックします。

{
  "blockedMarketplaces": [
    { "source": "github", "repo": "untrusted-org/*" }
  ]
}

​

公式マーケットプレイスと独自のマーケットプレイスを許可する

{
  "strictKnownMarketplaces": [
    { "source": "github", "repo": "anthropics/claude-plugins-official" },
    { "source": "github", "repo": "your-org/*" },
    { "source": "skills-dir" }
  ],
  "extraKnownMarketplaces": {
    "claude-plugins-official": {
      "source": { "source": "github", "repo": "anthropics/claude-plugins-official" }
    },
    "your-marketplace": {
      "source": { "source": "github", "repo": "your-org/your-marketplace" }
    }
  },
  "enabledPlugins": {
    "code-formatter@your-marketplace": true,
    "deploy-helper@your-marketplace": true
  },
  "disableSideloadFlags": true
}

• 許可リストは何も登録しません: extraKnownMarketplaces エントリは登録し、それ自体が許可リストを通す必要があります。Claude Code は、ソースが許可リストと一致しないマネージドマーケットプレイスを登録することを拒否します。
• 公式マーケットプレイスはインタラクティブターミナルセッションでのみ自分自身を登録します: そこでも、許可リストが許可する場合にのみ登録します。-p 実行またはクラウドセッションに接続されたターミナルは決して登録しません。
• ブロックされた試みは記憶されます: マシンが公式マーケットプレイスをブロックしたポリシーの下で実行された場合、Claude Code はブロックされた試みを記録し、ポリシーが変更された後に再試行しません。[] ロックダウンはそのようなポリシーの 1 つです。そのマシンは、このポリシーのような extraKnownMarketplaces エントリ、そのプラグインの 1 つの enabledPlugins エントリ、または手動の /plugin marketplace add を通じてのみ再度登録します。

​

更新ポリシーを設定する

​

マーケットプレイスごとに自動更新をオンまたはオフにする

• マネージドエントリがフィールドを設定する場合、Claude Code はユーザーの /plugin トグルを Auto-update for '<name>' is set by で始まるエラーで拒否します。
• マネージドエントリがフィールドを設定しない場合、ユーザーのトグルは保持されます。

​

フリート全体の更新をオフにする

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

​

ユーザーグループにリリースチャネルを割り当てる

• マネージド設定ファイルまたは MDM プロファイルなどの独立した エンドポイントマネージド設定 を各グループのデバイスに展開します。組織全体のソースも持つデバイスにグループごとのファイルまたはプロファイルが適用されるかどうかを確認するには、Claude Code がマネージドソースを組み合わせる方法 を参照してください。
• グループごとに 1 つの Claude アプリゲートウェイポリシー を定義します。ゲートウェイは一致ルールがユーザーに適合する最初のポリシーを適用するため、各ユーザーがグループのポリシーに到達するようにポリシーを順序付けます。そのポリシーの extraKnownMarketplaces マップは他のポリシーのマップとマージされないため、グループが必要とするすべてのマーケットプレイスをリストします。チャネルマーケットプレイスのみではなく。

{
  "extraKnownMarketplaces": {
    "stable-tools": {
      "source": { "source": "github", "repo": "your-org/stable-tools" }
    }
  }
}

​

プラグインを推奨する

​

監査とレビュー

​

OpenTelemetry イベント

​

Analytics API

​

マネージド設定が適用できないものを計画する

• ユーザーごとまたはグループごとのターゲティング: すべてのプラグインキーは、設定を受け取るすべてのユーザーに適用されます。サーバーマネージド設定は組織ごとに 1 つの設定を配信します。グループごとのポリシーについては、ユーザーグループにリリースチャネルを割り当てる の下のように独立したエンドポイントマネージド設定またはゲートウェイポリシーを使用してください。
• 許可されたマーケットプレイス内のエントリを制限: 許可リストはマーケットプレイスソースと一致します。許可されたマーケットプレイスから 1 つのプラグインをブロックするには、マネージド enabledPlugins で false に設定します。
• /plugin を非表示にする: キーはコマンドを無効にしません。最も近い同等物は、マーケットプレイスのみを指定する許可リスト、提供するプラグイン用のマネージド enabledPlugins エントリ、および disableSideloadFlags を組み合わせます。
• 許可リストを通じて --plugin-dir をゲートする: 許可リストは --plugin-dir をカバーしません。disableSideloadFlags はカバーします。
• これらのキーを通じて claude.ai プラグイントグルを適用する: 組織設定 > プラグインとスキル はこのページのキーを設定しません。メンバーと組織がそこでオンにするものは CLI に 同期されたプラグイン として到達し、独自のコントロールを持ちます。

​

ポリシーをトラブルシューティングする

• マネージドファイルが解析されませんでした: managed-settings.json が有効な JSON でない場合、Claude Code は起動を拒否し、ファイルを指定するエラー を出力します。解析されるが無効なエントリを 1 つ持つファイルは、ポリシーの残りを保持します。マネージド設定の無効なエントリ を参照してください。
• マネージドソースが読み込まれませんでした: /status を実行し、Setting sources 行で Enterprise managed settings を探します。欠落している場合、ソースは読み込まれませんでした。
• ユーザーが blocked by enterprise policy を報告: メッセージはマーケットプレイスまたはそのソースを指定します。許可リストの場合、許可されたソースもリストします。ユーザー向けエントリは プラグインをトラブルシューティング にあります。
• ユーザーが ~/.claude/settings.json で無効にしたプラグインがまだ読み込まれます: 別の設定ソースが再度有効にしました。例えば、それを強制的に有効にするマネージド enabledPlugins エントリ。/plugin と claude plugin list は Disabled in ~/.claude/settings.json but still loads をその設定ソースで表示します。

​

次のステップ

• マーケットプレイスリファレンス: extraKnownMarketplaces、strictKnownMarketplaces、および blockedMarketplaces が受け入れる source 値
• マーケットプレイスをホストして維持する: ポリシーが指す マーケットプレイスを実行する
• プラグインセキュリティと信頼: プラグインがマシンで実行できるもの、およびインストール前に 1 つをレビューする方法
• サーバーマネージド設定: claude.ai 管理コンソールからこれらのキーを配信する
• プラグインをトラブルシューティング: ポリシーがユーザーをブロックするときにユーザーが見るメッセージ