Skip to main content

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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. Ketika CLI Anda melihat variabel tersebut, itu menulis tag <claude-code-hint /> yang menutup sendiri ke stderr. 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 CLAUDECODE sehingga penanda tidak pernah muncul di terminal pengguna manusia. Kemudian tulis tag ke stderr pada barisnya sendiri. Contoh berikut 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 CLAUDECODE: hanya keluarkan ketika variabel lingkungan CLAUDECODE diatur. Ini mencegah penanda muncul kepada pengguna yang menjalankan CLI Anda secara langsung.

​
Dapatkan plugin Anda ke marketplace resmi

Protokol petunjuk hanya berlaku untuk plugin yang terdaftar di marketplace Anthropic resmi. Untuk mengirimkan plugin, gunakan salah satu formulir pengajuan dalam aplikasi: Jika Anda bekerja dengan kontak mitra Anthropic, hubungi mereka untuk mengoordinasikan daftar.

​
Lihat juga