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> Minta pengguna Claude Code untuk memasang plugin marketplace resmi Anda dengan mengeluarkan tag claude-code-hint dari CLI atau SDK Anda.

8 

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

10 

11Halaman ini hanya berlaku jika plugin Anda terdaftar di `claude-plugins-official` atau marketplace lain dengan salah satu [nama marketplace resmi Anthropic](/docs/id/plugins/security#official-marketplace-names). Marketplace komunitas, `claude-community`, bukan salah satunya.

12 

13<Note>

14 Untuk menerbitkan plugin, lihat [Publish and distribute a plugin](/docs/id/plugins/publish).

15</Note>

16 

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

18 Keluarkan hint

19</h2>

20 

21Keluarkan tag hanya ketika `CLAUDECODE` atau `CLAUDE_CODE_CHILD_SESSION` diatur, sehingga tidak muncul ketika seseorang menjalankan CLI Anda secara langsung.

22 

23Claude 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:

24 

25* **`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

26* **`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

27 

28[Referensi variabel lingkungan](/docs/id/env-vars) memiliki detailnya.

29 

30Contoh berikut gerbang pada `CLAUDECODE` untuk jangkauan terluas dan mengeluarkan hint untuk plugin bernama `example-cli` di marketplace resmi:

31 

32<CodeGroup>

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

34 if (process.env.CLAUDECODE) {

35 process.stderr.write(

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

37 )

38 }

39 ```

40 

41 ```python Python theme={null}

42 import os, sys

43 

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

45 print(

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

47 file=sys.stderr,

48 )

49 ```

50 

51 ```go Go theme={null}

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

53 fmt.Fprintln(os.Stderr,

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

55 }

56 ```

57 

58 ```shell Shell theme={null}

59 if [ -n "$CLAUDECODE" ]; then

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

61 fi

62 ```

63</CodeGroup>

64 

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

66 

67Anda dapat mengeluarkan hint pada setiap invokasi, karena Claude Code meminta untuk setiap plugin sekali.

68 

69Untuk 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.

70 

71<h2 id="hint-format">

72 Format hint

73</h2>

74 

75Tag harus menempati barisnya sendiri; Claude Code mengabaikan tag yang tertanam di tengah baris.

76 

77Tag mengambil tiga atribut, semuanya diperlukan:

78 

79| Atribut | Deskripsi |

80| :------ | :----------------------------------------------------------- |

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

82| `type` | Jenis hint. `plugin` adalah satu-satunya nilai yang didukung |

83| `value` | Pengenal plugin dalam bentuk `name@marketplace` |

84 

85Nilai dapat dikutip ganda atau tidak dikutip; nilai yang tidak dikutip tidak dapat berisi spasi.

86 

87Claude Code menghapus baris dari output bahkan ketika `v` atau `type` tidak dikenali.

88 

89<h2 id="check-when-the-prompt-appears">

90 Periksa kapan prompt muncul

91</h2>

92 

93Prompt 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:

94 

95* **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

96* **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](/docs/id/data-usage#default-behaviors-by-api-provider) berlaku

97* **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

98* **Tidak dimatikan**: pengguna belum memilih **No, and don't show plugin installation hints again**

99* **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

100 

101<h2 id="preview-what-the-user-sees">

102 Pratinjau apa yang dilihat pengguna

103</h2>

104 

105Ketika pemeriksaan dalam [Periksa kapan prompt muncul](#check-when-the-prompt-appears) lulus, Claude Code menampilkan dialog **Plugin recommendation** seperti berikut:

106 

107```text theme={null}

108─────────────────────────────────────────────────────────────

109 Plugin recommendation

110 

111 The example-cli command suggests installing a plugin.

112 

113 Plugin: example-cli

114 Marketplace: claude-plugins-official

115 Description: Official integration for example-cli deployments

116 

117 Would you like to install it?

118 ❯ 1. Yes, install

119 2. No

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

121 

122─────────────────────────────────────────────────────────────

123```

124 

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

126 

127* **Yes, install**: memasang plugin di [user scope](/docs/id/plugins/install)

128* **No, and don't show plugin installation hints again**: mematikan prompt hint masa depan untuk pengguna itu

129* **No answer for 30 seconds**: dihitung sebagai **No**

130 

131<h2 id="next-steps">

132 Langkah berikutnya

133</h2>

134 

135* [Publish and distribute a plugin](/docs/id/plugins/publish): rute ke setiap marketplace, termasuk marketplace resmi, yang hint memerlukan

136* [Plugin commands reference](/docs/id/plugins/cli-reference#plugin-install): perintah shell yang memasang plugin yang sama di luar sesi