Langsung ke konten utama
Jika Anda memelihara CLI atau SDK dan memiliki plugin di marketplace resmi Anthropic, alat Anda dapat meminta pengguna Claude Code untuk memasang plugin tersebut. CLI Anda menulis penanda satu baris ke stderr ketika mendeteksi bahwa itu berjalan di dalam Claude Code. Claude Code membaca penanda, menghapusnya dari output, dan menampilkan prompt pemasangan satu kali kepada pengguna. Claude Code menghapus baris petunjuk dari output perintah sebelum mengirimkannya ke model, sehingga penanda tidak pernah muncul dalam percakapan dan tidak dihitung terhadap penggunaan token. Protokol tidak memerlukan perintah tambahan dan tidak mengubah apa yang CLI Anda cetak untuk pengguna di luar Claude Code. Halaman ini adalah untuk pengelola CLI dan SDK. Jika Anda mencari untuk memasang plugin, lihat Temukan dan pasang plugin.

​
Cara kerjanya

Claude Code menetapkan variabel lingkungan CLAUDECODE ke 1 untuk setiap perintah yang dijalankan melalui alat Bash dan PowerShell, dan untuk perintah hook. Dari v2.1.172 juga menetapkan CLAUDE_CODE_CHILD_SESSION ke 1 dalam subproses yang sama. Ketika CLI Anda melihat salah satu variabel ini, itu menulis tag <claude-code-hint /> yang menutup sendiri ke stderr. Dalam perintah hook, tag petunjuk dilepas dan diabaikan. Hanya output alat Bash dan PowerShell yang memicu prompt pemasangan. Ketika Claude Code menerima output perintah, itu:
  1. Memindai baris petunjuk dan menghapusnya sebelum output mencapai model
  2. Memeriksa bahwa petunjuk menargetkan plugin di marketplace Anthropic resmi
  3. Memeriksa bahwa plugin belum dipasang dan belum diminta sebelumnya
  4. Menampilkan prompt pemasangan kepada pengguna yang menyebutkan perintah yang mengeluarkan petunjuk
Claude Code tidak pernah memasang plugin secara otomatis. Pengguna selalu mengonfirmasi.

​
Keluarkan petunjuk

Gerbang emisi pada variabel lingkungan sehingga penanda tidak mungkin muncul ketika manusia menjalankan CLI Anda secara langsung, kemudian tulis tag ke stderr pada barisnya sendiri. Pilih variabel mana yang akan diperiksa:
  • CLAUDECODE: diatur pada setiap versi Claude Code, sehingga mencapai sebagian besar sesi. Ini juga diatur dalam sesi tmux dan subprocess server MCP stdio yang Claude Code mulai. Ekstensi IDE juga mengaturnya di terminal terintegrasi mereka, di mana manusia dapat menjalankan CLI Anda secara langsung.
  • CLAUDE_CODE_CHILD_SESSION: diatur hanya dalam subprocess yang Claude Code sendiri spawn, seperti pemanggilan alat, perintah hook, dan perintah status line, sehingga tag biasanya tidak mencapai terminal manusia. Proses yang berumur panjang yang dimulai di dalam sesi, seperti server tmux, menangkap variabel, sehingga shell yang diluncurkan kemudian dari proses itu masih menampilkan tag mentah. Memerlukan Claude Code v2.1.172 atau lebih baru, sehingga sesi pada versi yang lebih lama melewatkan petunjuk.
Contoh berikut gerbang pada CLAUDECODE untuk jangkauan maksimal dan mengeluarkan petunjuk 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',
  )
}
Ganti example-cli dengan nama plugin Anda di marketplace resmi.

​
Pilih tempat untuk mengeluarkan

Anda mengontrol jalur kode mana yang mengeluarkan petunjuk. Claude Code menghilangkan duplikat berdasarkan plugin, jadi mengeluarkan pada setiap invokasi tidak memiliki kelemahan. Titik sentuh yang bekerja dengan baik meliputi:
PenempatanMengapa itu bekerja
Output --helpClaude sering menjalankan help saat menjelajahi CLI yang tidak dikenal
Kesalahan subperintah yang tidak dikenalMencapai momen ketika Claude bingung tentang antarmuka Anda
Keberhasilan login atau autentikasiPengguna sudah dalam pola pikir pengaturan
Pesan sambutan first-runMomen onboarding yang alami

​
Apa yang dilihat pengguna

Ketika petunjuk melewati semua pemeriksaan, Claude Code menampilkan prompt seperti berikut: 
─────────────────────────────────────────────────────────────
  Plugin recommendation

    The example-cli command suggests installing a plugin.

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

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

─────────────────────────────────────────────────────────────
Prompt menyebutkan perintah yang menghasilkan petunjuk sehingga pengguna dapat mendeteksi ketidaksesuaian antara alat dan plugin yang direkomendasikannya. Jika pengguna tidak merespons dalam 30 detik, prompt ditutup sebagai No. Frekuensi prompt dibatasi:
  • Sekali per plugin: setelah prompt ditampilkan, Claude Code mencatat plugin dan tidak pernah memintanya lagi, terlepas dari jawaban pengguna.
  • Sekali per sesi: di semua CLI di mesin, paling banyak satu prompt petunjuk muncul per sesi Claude Code.
Memilih Yes memasang plugin ke cakupan pengguna. Memilih No, and don’t show plugin installation hints again menonaktifkan semua prompt petunjuk di masa depan untuk pengguna.

​
Format petunjuk

Petunjuk adalah tag yang menutup sendiri dengan tiga atribut yang diperlukan. 
<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />
AtributDiperlukanDeskripsi
vYaVersi protokol. 1 adalah satu-satunya nilai yang didukung
typeYaJenis petunjuk. plugin adalah satu-satunya nilai yang didukung
valueYaPengenal plugin dalam bentuk name@marketplace
Nilai atribut dapat dikutip dengan tanda kutip ganda atau dibiarkan tanpa tanda kutip. Nilai tanpa tanda kutip tidak dapat berisi spasi. Urutan escape tidak didukung.

​
Persyaratan

Claude Code memberlakukan dua kondisi sebelum bertindak atas petunjuk. Petunjuk yang gagal salah satu pemeriksaan dijatuhkan:
  • Baris sendiri: tag harus menempati barisnya sendiri. Tag yang tertanam di tengah baris, misalnya di dalam pernyataan log, diabaikan. Spasi di awal dan akhir baris diizinkan.
  • Marketplace resmi: value harus mereferensikan plugin di marketplace yang dikendalikan Anthropic seperti claude-plugins-official. Petunjuk yang menunjuk ke marketplace lain secara diam-diam dijatuhkan.
Baris petunjuk selalu dihapus dari output sebelum mencapai model, bahkan ketika versi atau jenis tidak dikenali, sehingga penanda tidak pernah dihitung terhadap penggunaan token. Panduan yang tersisa direkomendasikan tetapi tidak diberlakukan. Claude Code tidak dapat mengamati apakah CLI Anda mengikutinya:
  • Tulis ke stderr: stderr menjaga tag keluar dari pipa shell seperti example-cli deploy | jq. Claude Code memindai kedua aliran, jadi stdout juga berfungsi.
  • Gerbang pada variabel lingkungan: hanya keluarkan ketika CLAUDECODE atau CLAUDE_CODE_CHILD_SESSION diatur. Lihat Emit the hint untuk mengetahui bagaimana kedua variabel berbeda.

​
Dapatkan plugin Anda ke marketplace resmi

Protokol petunjuk hanya berlaku untuk plugin yang terdaftar di marketplace Anthropic resmi, claude-plugins-official. Anthropic mengkurasi marketplace tersebut atas kebijakannya sendiri, dan formulir pengajuan dalam aplikasi menambahkan plugin ke marketplace komunitas sebagai gantinya, yang protokol petunjuk tidak periksa. Jika Anda bekerja dengan kontak mitra Anthropic, hubungi mereka untuk mengoordinasikan daftar marketplace resmi.

​
Lihat juga