1> ## Documentation Index

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

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

4 

5# Rekomendasikan plugin Anda dari CLI Anda

6 

7> Keluarkan penanda satu baris dari CLI Anda sehingga Claude Code meminta pengguna untuk memasang plugin resmi Anda.

8 

9Jika 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.

10 

11Claude 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.

12 

13Halaman ini adalah untuk pengelola CLI dan SDK. Jika Anda mencari untuk memasang plugin, lihat [Temukan dan pasang plugin](/id/discover-plugins).

14 

15<h2 id="how-it-works">

16 Cara kerjanya

17</h2>

18 

19Claude Code menetapkan variabel lingkungan [`CLAUDECODE`](/id/env-vars) ke `1` untuk setiap perintah yang dijalankan melalui alat Bash dan PowerShell, dan untuk perintah [hook](/id/hooks). Ketika CLI Anda melihat variabel tersebut, 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.

20 

21Ketika Claude Code menerima output perintah, itu:

22 

231. Memindai baris petunjuk dan menghapusnya sebelum output mencapai model

242. Memeriksa bahwa petunjuk menargetkan plugin di marketplace Anthropic resmi

253. Memeriksa bahwa plugin belum dipasang dan belum diminta sebelumnya

264. Menampilkan prompt pemasangan kepada pengguna yang menyebutkan perintah yang mengeluarkan petunjuk

27 

28Claude Code tidak pernah memasang plugin secara otomatis. Pengguna selalu mengonfirmasi.

29 

30<h2 id="emit-the-hint">

31 Keluarkan petunjuk

32</h2>

33 

34Gerbang emisi pada variabel lingkungan `CLAUDECODE` sehingga penanda tidak pernah muncul di terminal pengguna manusia. Kemudian tulis tag ke stderr pada barisnya sendiri.

35 

36Contoh berikut mengeluarkan petunjuk untuk plugin bernama `example-cli` di marketplace resmi:

37 

38<CodeGroup>

39 ```javascript Node.js theme={null}

40 if (process.env.CLAUDECODE) {

41 process.stderr.write(

42 '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />\n',

43 )

44 }

45 ```

46 

47 ```python Python theme={null}

48 import os, sys

49 

50 if os.environ.get("CLAUDECODE"):

51 print(

52 '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />',

53 file=sys.stderr,

54 )

55 ```

56 

57 ```go Go theme={null}

58 if os.Getenv("CLAUDECODE") != "" {

59 fmt.Fprintln(os.Stderr,

60 `<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />`)

61 }

62 ```

63 

64 ```shell Shell theme={null}

65 [ -n "$CLAUDECODE" ] &&

66 printf '%s\n' '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />' >&2

67 ```

68</CodeGroup>

69 

70Ganti `example-cli` dengan nama plugin Anda di marketplace resmi.

71 

72<h2 id="choose-where-to-emit">

73 Pilih tempat untuk mengeluarkan

74</h2>

75 

76Anda 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:

77 

78| Penempatan | Mengapa itu bekerja |

79| :--------------------------------------- | :--------------------------------------------------------------------- |

80| Output `--help` | Claude sering menjalankan help saat menjelajahi CLI yang tidak dikenal |

81| Kesalahan subperintah yang tidak dikenal | Mencapai momen ketika Claude bingung tentang antarmuka Anda |

82| Keberhasilan login atau autentikasi | Pengguna sudah dalam pola pikir pengaturan |

83| Pesan sambutan first-run | Momen onboarding yang alami |

84 

85<h2 id="what-the-user-sees">

86 Apa yang dilihat pengguna

87</h2>

88 

89Ketika petunjuk melewati semua pemeriksaan, Claude Code menampilkan prompt seperti berikut:

90 

91```text theme={null}

92─────────────────────────────────────────────────────────────

93 Plugin Recommendation

94 

95 The example-cli command suggests installing a plugin.

96 

97 Plugin: example-cli

98 Marketplace: claude-plugins-official

99 Official integration for example-cli deployments

100 

101 Would you like to install it?

102 ❯ 1. Yes, install example-cli

103 2. No

104 3. No, and don't show plugin installation hints again

105 

106─────────────────────────────────────────────────────────────

107```

108 

109Prompt 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**.

110 

111Frekuensi prompt dibatasi:

112 

113* **Sekali per plugin**: setelah prompt ditampilkan, Claude Code mencatat plugin dan tidak pernah memintanya lagi, terlepas dari jawaban pengguna.

114* **Sekali per sesi**: di semua CLI di mesin, paling banyak satu prompt petunjuk muncul per sesi Claude Code.

115 

116Memilih **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.

117 

118<h2 id="hint-format">

119 Format petunjuk

120</h2>

121 

122Petunjuk adalah tag yang menutup sendiri dengan tiga atribut yang diperlukan.

123 

124```text theme={null}

125<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />

126```

127 

128| Atribut | Diperlukan | Deskripsi |

129| :------ | :--------- | :--------------------------------------------------------------- |

130| `v` | Ya | Versi protokol. `1` adalah satu-satunya nilai yang didukung |

131| `type` | Ya | Jenis petunjuk. `plugin` adalah satu-satunya nilai yang didukung |

132| `value` | Ya | Pengenal plugin dalam bentuk `name@marketplace` |

133 

134Nilai atribut dapat dikutip dengan tanda kutip ganda atau dibiarkan tanpa tanda kutip. Nilai tanpa tanda kutip tidak dapat berisi spasi. Urutan escape tidak didukung.

135 

136<h2 id="requirements">

137 Persyaratan

138</h2>

139 

140Claude Code memberlakukan dua kondisi sebelum bertindak atas petunjuk. Petunjuk yang gagal salah satu pemeriksaan dijatuhkan:

141 

142* **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.

143* **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.

144 

145Baris petunjuk selalu dihapus dari output sebelum mencapai model, bahkan ketika versi atau jenis tidak dikenali, sehingga penanda tidak pernah dihitung terhadap penggunaan token.

146 

147Panduan yang tersisa direkomendasikan tetapi tidak diberlakukan. Claude Code tidak dapat mengamati apakah CLI Anda mengikutinya:

148 

149* **Tulis ke stderr**: stderr menjaga tag keluar dari pipa shell seperti `example-cli deploy | jq`. Claude Code memindai kedua aliran, jadi stdout juga berfungsi.

150* **Gerbang pada `CLAUDECODE`**: hanya keluarkan ketika variabel lingkungan `CLAUDECODE` diatur. Ini mencegah penanda muncul kepada pengguna yang menjalankan CLI Anda secara langsung.

151 

152<h2 id="get-your-plugin-into-the-official-marketplace">

153 Dapatkan plugin Anda ke marketplace resmi

154</h2>

155 

156Protokol 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](/id/plugins#submit-your-plugin-to-the-community-marketplace) sebagai gantinya, yang protokol petunjuk tidak periksa. Jika Anda bekerja dengan kontak mitra Anthropic, hubungi mereka untuk mengoordinasikan daftar marketplace resmi.

157 

158<h2 id="see-also">

159 Lihat juga

160</h2>

161 

162* [Buat plugin](/id/plugins): bangun plugin yang direkomendasikan CLI Anda

163* [Buat dan distribusikan marketplace plugin](/id/plugin-marketplaces): host plugin di luar marketplace resmi

164* [Variabel lingkungan](/id/env-vars): referensi lengkap untuk `CLAUDECODE` dan variabel terkait