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か所で提案が出ます。
- 回答中の表示:回答を待つ間、導入コマンドつきの一言が出る
- セッション開始の通知:作業フォルダの条件に合ったとき、最初のメッセージの前に1行出る
- /plugin の Discover タブ:一覧の一番上に固定される
自動でインストールされることはありません。 必ず本人が確認します。条件の判定は、手元のパソコンの中だけで行われ、通信は増えません。どの条件に合ったかは、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"]
}
提案の頻度
うるさくならないように、頻度の上限があります。
- 回答中の表示とセッション開始の通知を合わせて、同じプラグインは3セッションに1回まで
- セッション開始の通知は、合計2回表示されたら止まる
- 導入済みになったら、どちらも出なくなる
- Discover タブの固定は、条件に合っている間に最初に開いたときだけ
本人が提案を止めたいときは、spinnerTipsEnabled を false にします。回答中の表示とセッション開始の通知が止まります。Discover タブの固定は止まりません。
会社での進め方の例
- まず1つのプラグインに、cwd か filesRead の条件を1〜2個だけ書く
claude plugin validateで検査する- 管理者が、管理設定で許可する
- 数人の端末で、提案の出方を確かめる
- 出方が合っていれば、他のプラグインにも広げる
プラグインの提案を、自作のコマンドから出す方法もあります。自作CLIからプラグインの導入を案内する方法 もあわせてご覧ください。
まとめ
- relevance を書くのは運営者、許可するのは管理者
- 条件は5種類。開始時に合うのは cwd だけ
- 判定は手元だけで行われ、自動インストールはされない
- 上限を超えた値は、そのプラグインを無効にする。検査コマンドで確認する
出典:Recommend plugins for your org(公式ドキュメント)
この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。


