settings.json

strictKnownMarketplaces

型array記述場所管理者設定のみ

(管理設定のみ)ユーザーが追加できるプラグインマーケットプレイスの許可リスト。未定義は制限なし、空配列はロックダウンを意味する。ソース指定には完全一致を使用する。 See https://code.claude.com/docs/en/plugin-marketplaces#managed-marketplace-restrictions

既定値: 未設定であり、ユーザーは任意のマーケットプレイスを追加できる。空配列は公式の Anthropic マーケットプレイスを含むすべてのマーケットプレイスソースをブロックする完全なロックダウンである

記述例

{
  "strictKnownMarketplaces": [
    { "source": "github", "repo": "acme-corp/approved-plugins" },
    { "source": "github", "repo": "acme-corp/security-tools", "ref": "v2.0" },
    { "source": "url", "url": "https://plugins.example.com/marketplace.json" }
  ]
}

使い方・用途

  • 組織が管理設定でユーザーが追加できるプラグインマーケットプレイスを限定し、許可リストにないマーケットプレイスからの追加をネットワーク・ファイルシステム操作の前にブロックしたいときに使う
  • github owner の owner/* 形式のワイルドカードを使って、特定の GitHub org 配下のすべてのマーケットプレイスリポジトリをまとめて許可したいときに使う
  • strictPluginOnlyCustomization と組み合わせて、スキル・エージェント・hooks・MCP サーバーをプラグイン経由に限定しつつ、どのマーケットプレイスからプラグインを導入できるかまで含めてカスタマイズの供給元を統制したいときに使う
英語原文(公式ドキュメントより)

(Managed settings only) Allowlist of plugin marketplaces users can add. Undefined = no restrictions, empty array = lockdown. Uses exact matching for source specifications. See https://code.claude.com/docs/en/plugin-marketplaces#managed-marketplace-restrictions

関連する変更履歴

v2.1.277(1件)

Fixed
strictKnownMarketplaces または blockedMarketplaces の不正なエントリが 1 つあるだけで、企業向けマーケットプレイスポリシー全体が無効化されてしまう問題を修正した
英語原文を表示
Fixed one malformed strictKnownMarketplaces or blockedMarketplaces entry silently disabling the whole enterprise marketplace policy

v2.1.234(1件)

Fixed
strictKnownMarketplaces の許可リストが、git が実際に接続するホストと異なるホストを持つ SCP 形式の git マーケットプレイスソースを受け入れてしまう問題を修正した。
英語原文を表示
Fixed strictKnownMarketplaces allowlists accepting SCP-style git marketplace sources whose host differs from the one git would actually connect to

v2.1.232(1件)

Changed
設定: additionalMarketplaces と allowedMarketplaces が、extraKnownMarketplaces と strictKnownMarketplaces のより分かりやすい別名として受け付けられるようになりました。
英語原文を表示
Settings: additionalMarketplaces and allowedMarketplaces are now accepted as friendlier aliases for extraKnownMarketplaces and strictKnownMarketplaces

変更後

設定ファイルでマーケットプレイス関連のキー名を、より直感的に分かりやすい additionalMarketplaces や allowedMarketplaces と書けるようになる。特に組織のポリシー設定では、制限を許可リストとして allowedMarketplaces という名前で表現できるため、設定の意図が伝わりやすくなる。

v2.1.223(1件)

Added
GitHub 組織配下のすべてのマーケットプレイスリポジトリの許可またはブロックを一括で指定できるように、管理設定(strictKnownMarketplaces および blockedMarketplaces)にオーナーのワイルドカードエントリ("owner/*")を追加しました。
英語原文を表示
Added owner wildcard entries ("owner/*") to the strictKnownMarketplaces and blockedMarketplaces managed settings for allowing or blocking all marketplace repos under a GitHub org

変更後

組織内の開発環境におけるプラグインマーケットプレイスの利用制限を、リポジトリごとに個別登録することなく、組織単位でまとめて安全に管理できるようになります。

v2.1.117(1件)

Changed
管理設定の blockedMarketplaces と strictKnownMarketplaces が、プラグインのインストールや更新、自動アップデート時にも強制適用されるようになりました
英語原文を表示
Managed-settings blockedMarketplaces and strictKnownMarketplaces are now enforced on plugin install, update, refresh, and autoupdate

変更後

企業環境などにおいて、セキュリティポリシーに基づいた安全なプラグインのみが利用されることを保証します。

v2.1.71(1件)

Fixed
/plugin marketplace add owner/repo@ref において、@ 記号が正しく解析されない問題を修正しました。以前は # のみがリファレンス区切りとして機能しており、厳格なマーケットプレイス制限下で診断困難なエラーが発生していました。
英語原文を表示
Fixed /plugin marketplace add owner/repo@ref incorrectly parsing @ — previously only # worked as a ref separator, causing undiagnosable errors with strictKnownMarketplaces

変更後

特定のバージョンやブランチのプラグインを導入する際の手順が分かりやすくなり、導入時のトラブルが減少します。

関連ドキュメント

v2.1.69(1件)

Added
strictKnownMarketplaces に pathPattern を追加。ファイル・ディレクトリ形式のプラグインソースを正規表現で制限可能に
英語原文を表示
Added pathPattern to strictKnownMarketplaces for regex-matching file/directory marketplace sources alongside hostPattern restrictions

変更後

管理者側で、社内の標準ディレクトリ以外からのプラグインインストールを禁止するなど、より強力なセキュリティ制御が可能になります。

v2.1.64(1件)

Added
strictKnownMarketplaces 設定に pathPattern を追加しました。hostPattern と併用して、ファイルやディレクトリベースのプラグインソースを正規表現で制限できます。
英語原文を表示
Added pathPattern to strictKnownMarketplaces for regex-matching file/directory marketplace sources alongside hostPattern restrictions

変更後

企業利用におけるセキュリティガバナンスが強化され、信頼できない場所からの意図しないコード実行を未然に防ぐことができます。