Rekomendasikan plugins untuk organisasi Anda

Claude Code dapat menyarankan pemasangan plugin dari marketplace organisasi Anda ketika sesi pengguna cocok dengan sinyal yang Anda tentukan untuk plugin tersebut. Sinyal mencakup direktori kerja, file yang telah dibaca Claude, dan perintah yang telah dijalankan Claude. Anda menentukannya dengan menambahkan blok relevance ke entri plugin di marketplace.json. Operator marketplace menulis entri relevance. Administrator kemudian mendaftarkan whitelist marketplace dalam pengaturan terkelola. Pengguna tidak melihat saran dari marketplace sampai marketplace tersebut didaftarkan whitelist.

Kasus-kasus ini tercakup di halaman lain:

Anda ingin memasang plugins: lihat Pasang dan kelola plugins
Anda ingin mematikan saran: lihat Pahami cara kerja relevansi plugin

Mulai dengan bagian untuk peran Anda:

Operator marketplace: baca cara kerja saran, kemudian tambahkan relevansi ke entri plugin dan validasi marketplace Anda
Administrator: aktifkan saran dalam pengaturan terkelola

Pahami cara kerja relevansi plugin

Setiap entri plugin di marketplace.json dapat menyertakan objek relevance. Objek tersebut menamai topik dan satu atau lebih sinyal. Sinyal adalah pola yang diuji Claude Code terhadap sesi saat ini, seperti direktori kerja atau file yang telah dibaca Claude. Pencocokan sinyal terjadi secara lokal di mesin pengguna dan tidak menambah lalu lintas jaringan. Claude Code tidak melaporkan sinyal mana yang cocok atau nilainya kepada Anthropic atau operator marketplace. Ketika sinyal cocok dan plugin belum terpasang, Claude Code menyarankan plugin di tempat-tempat ini:

Spinner tip: pesan dengan perintah /plugin install muncul di bawah spinner saat Claude merespons.
Notifikasi awal sesi: jika sinyal cwd cocok dengan direktori kerja, notifikasi satu baris muncul sebelum pengguna mengirim pesan pertama.
Tab Discover /plugin: plugin disematkan ke bagian atas daftar Discover.

Pratinjau apa yang dilihat pengguna menunjukkan teks pasti dari masing-masing dan seberapa sering mereka berulang. Claude Code tidak pernah memasang plugin secara otomatis. Pengguna selalu mengonfirmasi. Spinner tip dan notifikasi awal sesi keduanya berhenti muncul ketika pengguna atau proyek menetapkan spinnerTipsEnabled ke false, atau ketika spinnerTipsOverride dengan excludeDefault menggantikan tips bawaan. Pin tab Discover tidak terpengaruh oleh pengaturan mana pun.

Tambahkan relevansi ke entri plugin

Tambahkan objek relevance ke entri plugin di marketplace.json Anda. Contoh berikut mendeklarasikan bahwa plugin terraform-helpers relevan ketika Claude membaca file .tf atau menjalankan 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"]
        }
      }
    }
  ]
}

Selama tidak ada sinyal yang cocok, plugin mempertahankan posisi normalnya di daftar Discover dan tidak muncul sebagai spinner tip. Untuk memeriksa blok sebelum menerbitkan, validasi marketplace Anda.

Referensi bidang

Objek relevance dan objek signals bersarangnya menerima bidang dalam tabel berikut. Klien yang lebih lama masih memuat marketplace yang menggunakan bidang relevance yang tidak mereka kenali, karena bidang yang tidak dikenali di bawah relevance dan relevance.signals diabaikan saat waktu muat. Bidang yang dikenali yang nilainya melebihi batasnya dalam referensi bidang membatalkan seluruh entri plugin, dan pengguna tidak dapat memasang plugin tersebut dari marketplace sampai Anda memperbaikinya; claude plugin validate melaporkan batas yang sama.

`relevance`

Bidang	Tipe	Deskripsi
`topic`	string	Opsional. Frasa yang mengisi “Bekerja dengan topic?” dalam spinner tip. Default ke nama plugin dengan setiap segmen tanda hubung dikapitalisasi. Maksimal 64 karakter.
`signals`	object	Pencocokan yang menentukan kapan plugin relevan. Claude Code menyarankan plugin hanya jika setidaknya satu sinyal diatur. Lihat `relevance.signals`.

topic sering kali adalah nama produk, misalnya Terraform. Gunakan domain seperti design ketika nama plugin tidak terdengar alami sebagai topik.

`relevance.signals`

Objek signals menerima bidang berikut.

Bidang	Tipe	Deskripsi	Batas
`cwd`	array of strings	Pola glob yang dicocokkan terhadap direktori kerja sesi. Lihat pencocokan direktori kerja.	10 pola dari 256 karakter masing-masing
`cli`	array of strings	Nama perintah dari perintah shell yang telah dijalankan Claude sesi ini, misalnya `["terraform"]`. Pencocokan tepat. Lihat pencocokan nama perintah.	10 entri dari 64 karakter masing-masing
`hosts`	array of strings	Nama host yang terlihat dalam URL `http://` atau `https://` dalam perintah Bash sesi ini, misalnya `["registry.terraform.io"]`. Hanya nama host huruf kecil telanjang: tidak ada skema, port, atau jalur. Pencocokan tepat tidak peka huruf besar-kecil.	20 entri dari 128 karakter masing-masing
`filesRead`	array of strings	Pola glob yang dicocokkan terhadap jalur file yang telah dibaca Claude sesi ini, misalnya `["*/.tf"]`. Garis miring maju dinormalisasi dan tidak peka huruf besar-kecil.	10 pola dari 256 karakter masing-masing
`manifestDeps`	array of objects	Dependensi yang dideklarasikan dalam manifes paket yang telah dibaca Claude sesi ini. Setiap entri adalah `{ "file": "...", "pattern": "..." }`, di mana kedua nilai adalah ekspresi reguler. Lihat pencocokan dependensi manifes.	10 entri, setiap nilai paling banyak 256 karakter. File manifes yang lebih besar dari 512 KB dilewati

Sinyal filesRead dan manifestDeps juga cocok dengan file yang telah ditulis atau diedit Claude sesi ini dan terhadap file memori CLAUDE.md yang dimuat otomatis proyek.

Pencocokan direktori kerja

cwd adalah satu-satunya sinyal yang dapat cocok saat awal sesi, sebelum pengguna mengirim pesan pertama. Claude Code mencocokkan setiap pola cwd sebagai berikut:

Pola dicocokkan terhadap direktori kerja sebagai jalur absolut. Ketika sesi berada di dalam repositori git, pola juga dicocokkan terhadap jalur direktori kerja relatif terhadap akar repositori.
Pencocokan dinormalisasi garis miring maju dan tidak peka huruf besar-kecil.
Setiap pola cocok dengan direktori itu sendiri dan semuanya di bawahnya, jadi infra, infra/, dan infra/** berperilaku identik.

Pencocokan nama perintah

Claude Code mencatat satu nama perintah untuk setiap perintah shell yang dijalankan Claude: token pertama setelah penetapan variabel lingkungan awal apa pun dan sudo. Perintah gabungan hanya berkontribusi pada perintah terdepan mereka, jadi cd infra && terraform plan mencatat cd, bukan terraform.

Pencocokan dependensi manifes

Setiap entri manifestDeps memasangkan dua string sumber JavaScript RegExp:

file: dicocokkan tidak peka huruf besar-kecil terhadap jalur file manifes. Jalur biasanya absolut, jadi jangkarkan pola di akhir daripada di awal. Jalur tidak dinormalisasi pemisah untuk sinyal ini, jadi jalur Windows menggunakan garis miring terbalik.
pattern: dicocokkan peka huruf besar-kecil terhadap isi file tersebut.

Contoh berikut menggunakan manifestDeps untuk menyarankan plugin Anda setelah Claude membaca package.json yang bergantung pada paket npm SDK Anda, bernama your-sdk di sini.

{
  "name": "your-plugin",
  "source": "./plugins/your-plugin",
  "relevance": {
    "signals": {
      "manifestDeps": [
        {
          "file": "[/\\\\]package\\.json$",
          "pattern": "\"your-sdk\"\\s*:"
        }
      ]
    }
  }
}

Dalam contoh ini, pola file menggunakan [/\\\\] sehingga cocok dengan pemisah jalur garis miring maju dan garis miring terbalik, dan \\. sehingga titik adalah literal. Dalam JSON, setiap garis miring terbalik dalam ekspresi reguler ditulis dua kali.

Validasi marketplace Anda

Di shell Anda, jalankan claude plugin validate terhadap direktori marketplace Anda untuk memeriksa blok relevance sebelum menerbitkan:

claude plugin validate ./my-marketplace

Validator melaporkan kesalahan dan peringatan pada blok relevance, termasuk ini:

Melaporkan kunci yang tidak dikenali di bawah relevance dan relevance.signals sebagai peringatan
Menandai nilai relevance yang bukan objek
Menolak entri signals.hosts yang menyertakan skema, port, atau jalur

Setiap temuan dicetak dengan jalur bidang yang menjadi perhatiannya, dan output berakhir dengan Validation passed, Validation passed with warnings, atau Validation failed.

Aktifkan saran dalam pengaturan terkelola

Pengguna tidak melihat saran dari marketplace sampai administrator mendaftarkan whitelist dalam pengaturan terkelola, bahkan ketika marketplace.json mendeklarasikan relevance. Untuk mendaftarkan whitelist marketplace, edit pengaturan terkelola Anda sebagai berikut:

Tambahkan nama marketplace ke pluginSuggestionMarketplaces.
Untuk marketplace apa pun selain marketplace resmi Anthropic, juga deklarasikan sumber marketplace, baik sebagai entri nama tersebut di extraKnownMarketplaces atau sebagai entri di strictKnownMarketplaces.

Pada mesin di mana marketplace tidak terdaftar, atau terdaftar dengan nama yang didaftarkan whitelist dari sumber yang berbeda, tidak ada saran darinya yang muncul. Pemeriksaan sumber menghentikan sumber yang tidak terkait dari mendaftar dengan nama yang didaftarkan whitelist untuk mendapatkan pluginnya disarankan di seluruh organisasi Anda. managed-settings.json berikut mendaftarkan marketplace organisasi dari repositori GitHub dan mengaktifkan sarannya:

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

Nama marketplace resmi hanya dapat mendaftar dari sumber Anthropic resmi, jadi tidak memerlukan deklarasi sumber. Untuk marketplace resmi, daftarkan whitelist nama saja:

{
  "pluginSuggestionMarketplaces": ["claude-plugins-official"]
}

Pratinjau apa yang dilihat pengguna

Ketika sinyal relevance plugin cocok selama sesi, tip di bawah spinner berbunyi:

Working with Terraform? Install the terraform-helpers plugin:
/plugin install terraform-helpers@your-marketplace

Ketika sinyal cwd cocok saat awal sesi, notifikasi satu baris berbunyi:

plugin suggestion: terraform-helpers@your-marketplace · /plugin

Di tab Discover /plugin, plugin disematkan di atas hasil lainnya dengan anotasi yang menamai sinyal yang cocok, seperti suggested for this directory atau suggested for terraform commands. Claude Code membatasi seberapa sering plugin tertentu disarankan:

Saran muncul paling banyak sekali setiap tiga sesi di seluruh spinner tip dan notifikasi awal sesi digabungkan.
Notifikasi awal sesi berhenti muncul setelah spinner tip dan notifikasi telah menunjukkan plugin sebanyak dua kali secara gabungan.
Baik spinner tip maupun notifikasi awal sesi tidak berulang setelah plugin dipasang.
Tab Discover menyematkan plugin pertama kali pengguna membuka tab saat sinyal plugin cocok. Claude Code mencatat itu di ~/.claude.json, jadi setiap kali pengguna membuka /plugin di mesin itu, plugin muncul dalam urutan normal.

Lihat juga

Host marketplace: jalankan marketplace yang menghost plugins Anda
Referensi marketplace: setiap bidang yang diterima entri plugin
Rekomendasikan plugin Anda dari CLI Anda: minta pengguna dari CLI Anda sendiri daripada dari sinyal sesi Claude Code
Kelola plugins untuk organisasi Anda: extraKnownMarketplaces, strictKnownMarketplaces, dan sisa kunci kebijakan plugin

Plugin

Gunakan plugin

Buat plugin

Jalankan marketplace

Kelola plugin untuk organisasi Anda

Pemecahan Masalah

Referensi

Rekomendasikan plugins untuk organisasi Anda

Pahami cara kerja relevansi plugin

Tambahkan relevansi ke entri plugin

Referensi bidang

`relevance`

`relevance.signals`

Pencocokan direktori kerja

Pencocokan nama perintah

Pencocokan dependensi manifes

Validasi marketplace Anda

Aktifkan saran dalam pengaturan terkelola

Pratinjau apa yang dilihat pengguna

Lihat juga

​Pahami cara kerja relevansi plugin

​Tambahkan relevansi ke entri plugin

​Referensi bidang

​relevance

​relevance.signals

​Pencocokan direktori kerja

​Pencocokan nama perintah

​Pencocokan dependensi manifes

​Validasi marketplace Anda

​Aktifkan saran dalam pengaturan terkelola

​Pratinjau apa yang dilihat pengguna

​Lihat juga

Pahami cara kerja relevansi plugin

Tambahkan relevansi ke entri plugin

Referensi bidang

`relevance`

`relevance.signals`

Pencocokan direktori kerja

Pencocokan nama perintah

Pencocokan dependensi manifes

Validasi marketplace Anda

Aktifkan saran dalam pengaturan terkelola

Pratinjau apa yang dilihat pengguna

Lihat juga