Rekomendasikan plugin Anda dari CLI Anda

Jika Anda memelihara CLI atau SDK, alat Anda dapat meminta pengguna Claude Code untuk memasang plugin Anda. Ketika CLI Anda mendeteksi bahwa itu berjalan di dalam Claude Code, buat agar menuliskan tag <claude-code-hint /> satu baris ke stderr. Claude Code menghapus baris dari output alat Bash dan PowerShell sebelum model melihat output, kemudian menampilkan kepada pengguna prompt pemasangan satu kali. Halaman ini hanya berlaku jika plugin Anda terdaftar di claude-plugins-official atau marketplace lain dengan salah satu nama marketplace resmi Anthropic. Marketplace komunitas, claude-community, bukan salah satunya.

Untuk menerbitkan plugin, lihat Publish and distribute a plugin.

Keluarkan hint

Keluarkan tag hanya ketika CLAUDECODE atau CLAUDE_CODE_CHILD_SESSION diatur, sehingga tidak muncul ketika seseorang menjalankan CLI Anda secara langsung. Claude Code menetapkan CLAUDECODE=1 dalam perintah yang dijalankannya melalui alat Bash dan PowerShell dan dalam perintah hook. Pada v2.1.172 dan yang lebih baru, itu juga menetapkan CLAUDE_CODE_CHILD_SESSION=1 di sana. Variabel berbeda dalam proses mana yang membawanya:

CLAUDECODE: diatur oleh setiap versi Claude Code. Ekstensi IDE juga menetapkannya di terminal terintegrasi mereka, jadi gerbang pada CLAUDECODE saja juga mengeluarkan tag ketika seseorang menjalankan CLI Anda sendiri di salah satu terminal tersebut
CLAUDE_CODE_CHILD_SESSION: diatur hanya dalam subproses yang dimulai Claude Code sendiri. Gunakan ketika Anda dapat memerlukan v2.1.172 atau yang lebih baru

Referensi variabel lingkungan memiliki detailnya. Contoh berikut gerbang pada CLAUDECODE untuk jangkauan terluas dan mengeluarkan hint untuk plugin bernama example-cli di marketplace resmi:

if (process.env.CLAUDECODE) {
  process.stderr.write(
    '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />\n',
  )
}

import os, sys

if os.environ.get("CLAUDECODE"):
    print(
        '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />',
        file=sys.stderr,
    )

if os.Getenv("CLAUDECODE") != "" {
    fmt.Fprintln(os.Stderr,
        `<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />`)
}

if [ -n "$CLAUDECODE" ]; then
  printf '%s\n' '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />' >&2
fi

Ganti example-cli dengan nama plugin Anda di marketplace resmi. Anda dapat mengeluarkan hint pada setiap invokasi, karena Claude Code meminta untuk setiap plugin sekali. Untuk memeriksa emitter, jalankan CLAUDECODE=1 example-cli di terminal dan konfirmasi baris tag muncul di stderr, kemudian jalankan example-cli tanpa variabel dan konfirmasi tidak ada yang dicetak ekstra.

Format hint

Tag harus menempati barisnya sendiri; Claude Code mengabaikan tag yang tertanam di tengah baris. Tag mengambil tiga atribut, semuanya diperlukan:

Atribut	Deskripsi
`v`	Versi protokol. `1` adalah satu-satunya nilai yang didukung
`type`	Jenis hint. `plugin` adalah satu-satunya nilai yang didukung
`value`	Pengenal plugin dalam bentuk `name@marketplace`

Nilai dapat dikutip ganda atau tidak dikutip; nilai yang tidak dikutip tidak dapat berisi spasi. Claude Code menghapus baris dari output bahkan ketika v atau type tidak dikenali.

Periksa kapan prompt muncul

Prompt hanya muncul dalam sesi terminal interaktif. Dalam claude -p berjalan, dalam berjalan subagent, dan dalam output perintah hook, tag dilepas dan tidak ada prompt yang ditampilkan. Semua pemeriksaan ini juga harus lulus:

Resmi dan dapat dipasang: value menamai plugin yang Claude Code temukan di salinan lokal marketplace resmi, yang belum dipasang, dan yang tidak ada kebijakan yang memblokir
Analytics aktif: sesi di mana analytics Claude Code dimatikan tidak pernah meminta, misalnya satu dengan DISABLE_TELEMETRY, DO_NOT_TRACK, atau CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC diatur, atau satu di penyedia pihak ketiga seperti Amazon Bedrock, di mana automatic telemetry opt-out berlaku
Batas frekuensi: satu prompt per sesi, satu prompt selamanya per plugin terlepas dari jawaban pengguna, dan tidak ada setelah 100 plugin telah diminta di mesin itu
Tidak dimatikan: pengguna belum memilih No, and don’t show plugin installation hints again
Sesi lokal, dihadiri: workspace sesi bersifat lokal daripada di mesin cloud atau jarak jauh, dan sesi tidak berjalan tanpa pengawasan. Misalnya, sesi dimulai dengan --cloud, satu melayani Remote Control, atau anggota tim agent-team tidak pernah meminta

Pratinjau apa yang dilihat pengguna

Ketika pemeriksaan dalam Periksa kapan prompt muncul lulus, Claude Code menampilkan dialog Plugin recommendation seperti berikut:

─────────────────────────────────────────────────────────────
  Plugin recommendation

    The example-cli command suggests installing a plugin.

    Plugin: example-cli
    Marketplace: claude-plugins-official
    Description: Official integration for example-cli deployments

    Would you like to install it?
    ❯ 1. Yes, install
      2. No
      3. No, and don't show plugin installation hints again

─────────────────────────────────────────────────────────────

Dialog menamai kata pertama dari perintah shell yang Claude jalankan, sehingga pengguna dapat mendeteksi ketidaksesuaian. Setiap jawaban memiliki satu efek:

Yes, install: memasang plugin di user scope
No, and don’t show plugin installation hints again: mematikan prompt hint masa depan untuk pengguna itu
No answer for 30 seconds: dihitung sebagai No

Langkah berikutnya

Publish and distribute a plugin: rute ke setiap marketplace, termasuk marketplace resmi, yang hint memerlukan
Plugin commands reference: perintah shell yang memasang plugin yang sama di luar sesi

Plugin

Gunakan plugin

Buat plugin

Jalankan marketplace

Kelola plugin untuk organisasi Anda

Pemecahan Masalah

Referensi

Rekomendasikan plugin Anda dari CLI Anda

Keluarkan hint

Format hint

Periksa kapan prompt muncul

Pratinjau apa yang dilihat pengguna

Langkah berikutnya

​Keluarkan hint

​Format hint

​Periksa kapan prompt muncul

​Pratinjau apa yang dilihat pengguna

​Langkah berikutnya

Keluarkan hint

Format hint

Periksa kapan prompt muncul

Pratinjau apa yang dilihat pengguna

Langkah berikutnya