Claude Codeのプラグインを社内で自動提案する設定(relevance)

公開 更新 著者 永上裕之導入とルール
小さなロボットが、作業中の人の横で、合いそうな道具の箱をそっと差し出しているイメージ

この記事の要点

  • マーケットプレイスのプラグインに relevance を書くと、作業内容が合った時に Claude Code が導入を提案する
  • 判定は手元のパソコンの中だけで行われ、どの条件に合ったかは Anthropic にも運営者にも送られない
  • 管理者が管理設定で許可するまで、端末では提案が出ない。自動でインストールはされず、必ず本人が確認する

活用例:社内で作ったAIの道具(プラグイン)を、必要な人に必要な時に届ける

部署
情報システム・開発
使うもの
Claude Code のプラグインのマーケットプレイスと管理設定
AIに任せる
作業内容に合うプラグインの提案
人が決める
提案する条件・許可するマーケットプレイス・導入するか

社内向けに便利なプラグインを作っても、「あることを知られず、使われない」ことがよくあります。

Claude Code には、作業の内容がプラグインに合った時に、導入を提案する仕組みがあります。この記事では、公式ドキュメント「Recommend plugins for your org」(2026年11月17日確認)にもとづいて、仕組みと設定の流れをまとめます。プラグインの置き場の作り方は プラグインのマーケットプレイス の記事を先にご覧ください。

結論:マーケットプレイスに relevance を書き、管理者が許可する

役割は2つに分かれます。

役割やること
マーケットプレイスの運営者プラグインの定義(marketplace.json)に relevance を書く
管理者管理設定で、そのマーケットプレイスを許可する

許可されるまで、端末には提案が出ません。

どう提案されるか

relevance には、話題(topic)と、条件(signals)を書きます。作業の内容が条件に合い、そのプラグインが未導入のとき、次の3か所で提案が出ます。

自動でインストールされることはありません。 必ず本人が確認します。条件の判定は、手元のパソコンの中だけで行われ、通信は増えません。どの条件に合ったかは、Anthropic にも運営者にも報告されません。

条件(signals)の種類

名前見るもの上限の目安
cwd作業フォルダ(パターン)10個
cli実行したコマンド名(完全一致)10個
hostsコマンドの中の URL のホスト名20個
filesRead読んだファイルのパス(パターン)10個
manifestDeps読んだ設定ファイル(package.json など)の依存の名前10個

セッションの開始時に合うのは、cwd だけです。他は、作業が進んでから合います。

コマンド名の見方に注意

記録されるのは、各コマンドの最初の1語だけです。「フォルダに移動してから実行する」のように1行につなげると、先頭の移動のコマンドだけが記録されます。

書き方の例

Terraform の社内ルール用のプラグインを、.tf のファイルを読んだ時と、terraform を実行した時に提案する例です。

{
  "name": "your-marketplace",
  "owner": { "name": "Your Org" },
  "plugins": [
    {
      "name": "terraform-helpers",
      "source": "./plugins/terraform-helpers",
      "description": "Your organization's Terraform conventions and helpers",
      "relevance": {
        "topic": "Terraform",
        "signals": {
          "cli": ["terraform"],
          "filesRead": ["**/*.tf"]
        }
      }
    }
  ]
}

条件のどれにも合わないときは、一覧の通常の位置のままで、提案にも出ません。

公開前の検証

運営者は、公開の前に、次のコマンドで relevance の書き方を検査できます。

claude plugin validate ./my-marketplace

知らない項目は警告になります。ホスト名にスキーム・ポート・パスを含めると、エラーです。上限を超えた値があると、そのプラグインの定義全体が無効になり、導入できなくなるので、公開前に必ず確認します。

管理者の設定

管理設定に、マーケットプレイスの名前を pluginSuggestionMarketplaces へ追加します。公式以外のマーケットプレイスは、入手元の宣言(extraKnownMarketplaces か strictKnownMarketplaces)も必要です。同じ名前で別の入手元から登録されても提案が出ないので、名前を借りて社内に提案を出すことはできません。

{
  "extraKnownMarketplaces": {
    "your-marketplace": {
      "source": { "source": "github", "repo": "your-org/your-marketplace" }
    }
  },
  "pluginSuggestionMarketplaces": ["your-marketplace"]
}

提案の頻度

うるさくならないように、頻度の上限があります。

本人が提案を止めたいときは、spinnerTipsEnabled を false にします。回答中の表示とセッション開始の通知が止まります。Discover タブの固定は止まりません。

会社での進め方の例

  1. まず1つのプラグインに、cwd か filesRead の条件を1〜2個だけ書く
  2. claude plugin validate で検査する
  3. 管理者が、管理設定で許可する
  4. 数人の端末で、提案の出方を確かめる
  5. 出方が合っていれば、他のプラグインにも広げる

プラグインの提案を、自作のコマンドから出す方法もあります。自作CLIからプラグインの導入を案内する方法 もあわせてご覧ください。

まとめ

  1. relevance を書くのは運営者、許可するのは管理者
  2. 条件は5種類。開始時に合うのは cwd だけ
  3. 判定は手元だけで行われ、自動インストールはされない
  4. 上限を超えた値は、そのプラグインを無効にする。検査コマンドで確認する

出典:Recommend plugins for your org(公式ドキュメント)

永上裕之

ユニコスクール株式会社 代表取締役。AIエージェント専門のスクール&コミュニティを運営しています。

この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。

関連する記事