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# Buat sebuah mod

6 

7> Biarkan Claude menulis mod Claude Code dari deskripsi, atau tulis sendiri yang menghitung panggilan alat dan menambahkan perintah. Pelajari loop reload dan validate.

8 

9Mod adalah [plugin](/docs/id/plugins/overview) Claude Code dengan file entry, disebut hooks module: file JavaScript atau TypeScript yang fungsi-fungsinya dipanggil Claude Code ketika peristiwa terjadi. Ada dua cara untuk membuatnya:

10 

11* **Minta Claude untuk menulisnya**: [jelaskan apa yang Anda inginkan](#ask-claude-for-a-mod) dalam sesi Claude Code

12* **Tulis sendiri**: [ikuti tutorial](#write-a-mod-yourself) untuk mempelajari cara kerja kode mod. Anda tidak memerlukan Node.js, bundler, atau build step, karena Claude Code memuat file `.js` dan `.ts` secara langsung.

13 

14Jika Anda belum memutuskan apakah mod adalah alat yang tepat, baca [perbandingan di overview](/docs/id/plugins/mods/overview#compare-mods-settings-hooks-skills-and-mcp-servers) terlebih dahulu.

15 

16<Note>

17 Mod memerlukan Claude Code v2.1.287 atau lebih baru. Di shell Anda, jalankan `claude --version` untuk memeriksa. Untuk melihat apakah mod dapat dimuat untuk Anda, lihat [Periksa apakah mod dapat dimuat](/docs/id/plugins/mods/troubleshoot#check-whether-mods-can-load).

18</Note>

19 

20<h2 id="ask-claude-for-a-mod">

21 Minta Claude untuk sebuah mod

22</h2>

23 

24Jelaskan mod yang Anda inginkan dalam sesi Claude Code interaktif, dan Claude menulisnya. Claude bekerja dari [skill](/docs/id/skills) bawaan bernama `plugin-authoring`, yang memberitahu di mana menulis mod, peristiwa dan metode apa yang dimiliki versi Anda, dan bagaimana mod dimuat. Claude dapat memuat skill ketika Anda meminta mod, atau Anda dapat memuatnya sendiri dengan menjalankan `/plugin-authoring` di prompt Claude Code.

25 

26Mod berjalan setelah Anda menyetujuinya, kecuali dalam [sesi di mana mod yang ditulis Claude tidak dapat dimuat](#sessions-that-skip-the-approval).

27 

28<Steps>

29 <Step title="Jelaskan mod">

30 Minta mod dengan kata-kata Anda sendiri, misalnya `buat mod yang menunjukkan cabang git saat ini di atas prompt`. Claude menulis mod dalam direktori miliknya sendiri di folder mods sesi, yaitu `~/.claude/dev-mods/` diikuti dengan ID sesi. Jalur lengkap mod terlihat seperti `~/.claude/dev-mods/3f2a9c1e-5b7d-4e8a-9c21-6d0f4b8a7e13/git-branch/`.

31 

32 <Note>

33 Dalam [mode izin](/docs/id/permission-modes#protected-paths) `default` dan `acceptEdits`, Claude Code menanyakan sebelum Claude membuat setiap file mod, karena `~/.claude` adalah jalur yang dilindungi. Setujui setiap file saat muncul.

34 </Note>

35 </Step>

36 

37 <Step title="Setujui mod">

38 Ketika Claude menyimpan file pertama, Claude Code menanyakan apakah akan mengaktifkan hot reloading untuk sesi. Hot reloading menjalankan mod yang ditulis Claude dalam sesi ini dan mengambil setiap perubahan kemudian.

39 

40 Pilih salah satu jawaban ini:

41 

42 * **Aktifkan untuk sesi ini**: mod di folder mods sesi dimuat ketika giliran berakhir, dan dimuat ulang di akhir setiap giliran yang mengubahnya. Jawaban Anda berlaku untuk sesi, termasuk setelah Anda melanjutkannya.

43 * **Tidak sekarang**: tidak ada yang dimuat untuk sekarang. File tetap di tempat Claude menulisnya, dan mod dimuat saat sesi itu dimulai berikutnya. Untuk mencegah mod dimuat selamanya, hapus direktorinya.

44 </Step>

45 

46 <Step title="Periksa bahwa mod dimuat">

47 Jalankan `/plugin` di prompt Claude Code dan tekan Tab sampai tab **Installed** dipilih. Ini mencantumkan mod, dan Anda dapat mematikannya di sana.

48 </Step>

49 

50 <Step title="Coba mod">

51 Gunakan apa yang Anda minta. Untuk prompt contoh, nama cabang saat ini muncul di atas kotak prompt. Jika mod tidak melakukan apa yang Anda inginkan, beri tahu Claude apa yang harus diubah. Mod dimuat ulang di akhir setiap giliran yang mengubah filenya, sehingga Anda dapat mencoba perubahan segera setelah Claude selesai.

52 </Step>

53</Steps>

54 

55<h3 id="use-the-mod-in-other-sessions">

56 Gunakan mod di sesi lain

57</h3>

58 

59Mod yang ditulis Claude hanya dimuat dalam sesi yang membuatnya, dan Claude Code menghapus folder mods sesi itu setelah lebih lama dari [`cleanupPeriodDays`](/docs/id/settings-reference#cleanupperioddays). Untuk menyimpan mod, salin direktorinya keluar dari folder mods ke tempat Anda sendiri, seperti `~/mods/git-branch`. Kemudian pilih cara memuatnya:

60 

61* **Dalam sesi yang Anda mulai**: di shell Anda, jalankan `claude --plugin-dir ~/mods/git-branch`

62* **Untuk orang lain**: [tambahkan ke marketplace](#share-your-mod) sehingga mereka dapat menginstalnya

63 

64<h3 id="sessions-that-skip-the-approval">

65 Sesi di mana mod yang ditulis Claude tidak dapat dimuat

66</h3>

67 

68Mod yang ditulis Claude hanya dimuat setelah Anda menyetujuinya, dalam workspace terpercaya di mana mod diizinkan untuk berjalan. Dalam sesi ini tidak dimuat:

69 

70* **Tidak ada yang ada untuk menyetujui**: sesi tidak dapat menampilkan prompt kepada Anda, seperti dalam run `claude -p` atau [mode `dontAsk`](/docs/id/permission-modes)

71* **Workspace tidak terpercaya**: Anda belum menerima prompt kepercayaan untuk direktori

72* **Mod dihentikan**: Anda memulai dengan `--safe-mode` atau `--bare`, Anda menetapkan `disableAllHooks`, atau [pengaturan terkelola](/docs/id/plugins/mods/admin#choose-how-much-to-allow) organisasi Anda memblokir

73 

74<h2 id="write-a-mod-yourself">

75 Tulis mod sendiri

76</h2>

77 

78Dalam tutorial ini Anda membangun mod bernama `first-mod` yang menghitung panggilan alat yang dibuat Claude, menampilkan hitungan di samping spinner saat Claude bekerja, dan menambahkan perintah `/tally` yang mencetaknya. Anda kemudian membaca deklarasi tipe yang ditulis Claude Code di samping mod Anda dan menjalankan `claude plugin validate`. Bersama-sama mereka menunjukkan kepada Anda peristiwa dan metode yang ditawarkan versi Anda dan apa yang dibaca Claude Code dari kode Anda.

79 

80Rekaman ini menunjukkan mod yang selesai. Spinner menghitung panggilan alat, `/tally` mencetak hitungan, dan edit ke kode berlaku saat sesi berjalan:

81 

82<Frame>

83 <video autoPlay muted loop playsInline controls className="w-full dark:hidden" src="https://mintcdn.com/claude-code/dgiVO_Od1X1faduV/images/mods-first-mod-light.mp4?fit=max&auto=format&n=dgiVO_Od1X1faduV&q=85&s=eb561134afa90375777408453ba51c77" aria-label="Dalam sesi Claude Code, prompt 'list the files here and read the README' diketik dan dikirim. Spinner membaca 'Thinking · tool calls: 1' dan hitungan naik saat Claude bekerja. Perintah /tally mencetak 'first-mod: Claude has made 3 tool calls since this mod loaded'. Sebuah baris mengatakan first-mod dimuat ulang dan mencantumkan empat hooks-nya. Pada prompt berikutnya spinner membaca 'Thinking · tools used: 1'." data-path="images/mods-first-mod-light.mp4" />

84 

85 <video autoPlay muted loop playsInline controls className="w-full hidden dark:block" src="https://mintcdn.com/claude-code/dgiVO_Od1X1faduV/images/mods-first-mod-dark.mp4?fit=max&auto=format&n=dgiVO_Od1X1faduV&q=85&s=09779dadc7ef66c2b1e2da0c2e31ac72" aria-label="Dalam sesi Claude Code, prompt 'list the files here and read the README' diketik dan dikirim. Spinner membaca 'Thinking · tool calls: 1' dan hitungan naik saat Claude bekerja. Perintah /tally mencetak 'first-mod: Claude has made 3 tool calls since this mod loaded'. Sebuah baris mengatakan first-mod dimuat ulang dan mencantumkan empat hooks-nya. Pada prompt berikutnya spinner membaca 'Thinking · tools used: 1'." data-path="images/mods-first-mod-dark.mp4" />

86</Frame>

87 

88Anda menulis tiga file:

89 

90```text theme={null}

91first-mod/

92├── .claude-plugin/

93│ └── plugin.json

94└── hooks/

95 ├── hooks.json

96 └── register.js

97```

98 

99* **`plugin.json`**: [manifest](/docs/id/plugins/manifest-reference) plugin

100* **`hooks.json`**: [menunjuk ke file kode Anda](/docs/id/plugins/mods/reference#files)

101* **`register.js`**: kode Anda, disebut hooks module

102 

103<Steps>

104 <Step title="Buat direktori plugin">

105 Buat dua direktori yang menyimpan file:

106 

107 <Tabs>

108 <Tab title="Bash atau Zsh">

109 ```bash theme={null}

110 mkdir -p first-mod/.claude-plugin first-mod/hooks

111 ```

112 </Tab>

113 

114 <Tab title="PowerShell">

115 ```powershell theme={null}

116 New-Item -ItemType Directory -Force first-mod\.claude-plugin, first-mod\hooks

117 ```

118 </Tab>

119 </Tabs>

120 </Step>

121 

122 <Step title="Tulis manifest">

123 Mod adalah plugin, dan mod memerlukan [manifest](/docs/id/plugins/manifest-reference). Manifest mod ini tidak memiliki field khusus. Simpan ini sebagai `first-mod/.claude-plugin/plugin.json`:

124 

125 ```json first-mod/.claude-plugin/plugin.json theme={null}

126 {

127 "name": "first-mod",

128 "version": "0.1.0",

129 "description": "Counts Claude's tool calls, shows the count beside the spinner, and adds a /tally command",

130 "author": { "name": "Your Name" }

131 }

132 ```

133 </Step>

134 

135 <Step title="Beri tahu Claude Code di mana kode Anda berada">

136 Ketika Claude Code memuat plugin, ia membaca `hooks/hooks.json` plugin. Kunci `modules` dalam file itu memberikan jalur ke kode Anda, dan memilikinya adalah apa yang membuat plugin menjadi mod. Cantumkan satu jalur, relatif terhadap `hooks.json`. Di sini menunjuk ke `register.js`, yang Anda tulis di langkah berikutnya.

137 

138 Simpan ini sebagai `first-mod/hooks/hooks.json`:

139 

140 ```json first-mod/hooks/hooks.json theme={null}

141 {

142 "description": "The first-mod hooks module",

143 "modules": ["./register.js"]

144 }

145 ```

146 </Step>

147 

148 <Step title="Tulis kode">

149 File ini adalah kode mod, disebut hooks module. Ketika mod dimuat, Claude Code memanggil fungsi `register` yang diekspor file dan meneruskan fungsi bernama [`on`](/docs/id/plugins/mods/reference#the-hook-function). Setiap panggilan ke `on` mendaftarkan event handler, disebut hook, untuk peristiwa yang dinamainya.

150 

151 Simpan ini sebagai `first-mod/hooks/register.js`:

152 

153 ```javascript first-mod/hooks/register.js theme={null}

154 // The count, shared by the hooks below

155 let calls = 0

156 

157 // Claude Code calls this once when the mod loads

158 export function register(on) {

159 // Runs when the session starts, before your first prompt

160 on('session.start', async ($, e, next) => {

161 // Add the /tally command

162 await $.command.register({

163 name: 'tally',

164 description: 'Show how many tool calls Claude has made',

165 })

166 // Let the session start as usual

167 return next(e)

168 })

169 

170 // Runs each time Claude is about to use a tool

171 on('tool.call', async ($, e, next) => {

172 calls += 1

173 // Ask Claude Code to draw the interface again, so the new count shows

174 $.ui.invalidate('ui.render')

175 // Let the tool run as usual

176 return next(e)

177 })

178 

179 // Runs when you type /tally, and only then, because of the matcher

180 on('command.run', { command: 'tally' }, async () => {

181 // The text to print in the transcript

182 return { text: 'Claude has made ' + calls + ' tool calls since this mod loaded' }

183 })

184 

185 // Runs each time Claude Code draws the spinner

186 on('ui.render', { component: 'Spinner' }, async ($, e, next) => {

187 // Keep Claude Code's spinner, with the count added after its word

188 return next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } })

189 })

190 }

191 ```

192 

193 File menyimpan hitungan dalam `calls` dan mendaftarkan empat hooks:

194 

195 * **[`session.start`](/docs/id/plugins/mods/reference#session)** berjalan ketika sesi dimulai, sebelum prompt pertama Anda, dan lagi setiap kali mod dimuat ulang. Ini menambahkan perintah `/tally` ke Claude Code.

196 * **[`tool.call`](/docs/id/plugins/mods/reference#tools)** berjalan setiap kali Claude akan menggunakan alat. Ini menambah satu ke `calls` dan meminta Claude Code untuk menggambar antarmuka lagi.

197 * **[`command.run`](/docs/id/plugins/mods/reference#commands-and-configuration)** berjalan ketika Anda mengetik `/tally`. Ini mengembalikan teks untuk dicetak.

198 * **[`ui.render`](/docs/id/plugins/mods/reference#interface)** berjalan setiap kali Claude Code menggambar spinner. Ini menambahkan hitungan setelah kata spinner.

199 

200 [Cara kerja mod contoh](#how-the-example-mod-works) menjelaskan tiga argumen yang diterima setiap hook dan apa yang dikembalikan masing-masing.

201 </Step>

202 

203 <Step title="Muat mod">

204 Mulai Claude Code dengan flag `--plugin-dir`, yang memuat direktori plugin untuk satu sesi tanpa menginstalnya:

205 

206 ```bash theme={null}

207 claude --plugin-dir ./first-mod

208 ```

209 </Step>

210 

211 <Step title="Coba mod">

212 Minta Claude untuk melakukan sesuatu yang memerlukan beberapa panggilan alat, seperti `list the files here and read the README`. Saat Claude bekerja, kata spinner diikuti oleh hitungan yang naik, seperti `Thinking · tool calls: 2…`. Ketika Claude selesai, ketik `/tally` dan tekan Enter. Transkrip menunjukkan `first-mod: Claude has made 2 tool calls since this mod loaded`, dengan hitungan Anda sendiri. Claude Code menempatkan nama plugin di depan teks perintah.

213 

214 Untuk memeriksa perintah tanpa sesi interaktif, jalankan dalam mode non-interaktif:

215 

216 ```bash theme={null}

217 claude -p "/tally" --plugin-dir ./first-mod

218 ```

219 

220 ```text theme={null}

221 first-mod: Claude has made 0 tool calls since this mod loaded

222 ```

223 

224 Jika `/tally` tidak ada dalam daftar perintah, modul tidak dimuat. Lihat [Cari tahu mengapa mod tidak melakukan apa pun](/docs/id/plugins/mods/troubleshoot#find-out-why-a-mod-does-nothing).

225 </Step>

226 

227 <Step title="Ubah kode saat sesi berjalan">

228 Biarkan sesi tetap terbuka. Dalam `register.js`, ubah `' · tool calls: '` menjadi `' · tools used: '` dalam hook `ui.render` dan simpan. Baris yang disorot adalah yang berubah:

229 

230 ```javascript first-mod/hooks/register.js {4} theme={null}

231 // Runs each time Claude Code draws the spinner

232 on('ui.render', { component: 'Spinner' }, async ($, e, next) => {

233 // Keep Claude Code's spinner, with the count added after its word

234 return next({ ...e, props: { ...e.props, suffix: ' · tools used: ' + calls + '…' } })

235 })

236 ```

237 

238 Sebuah baris dalam transkrip mengatakan `first-mod` dimuat ulang dan mencantumkan hooks-nya, dan spinner berikutnya menggunakan teks baru, seperti `Thinking · tools used: 1…`.

239 </Step>

240</Steps>

241 

242<h3 id="how-the-example-mod-works">

243 Cara kerja mod contoh

244</h3>

245 

246Setiap fungsi yang Anda teruskan ke `on` adalah hook, yang merupakan event handler. Claude Code meneruskan setiap hook dengan tiga argumen yang sama:

247 

248* **Mods API**, bernama `$`: setiap metode yang dapat dipanggil mod untuk menjangkau di luar dirinya, dalam [namespaces](/docs/id/plugins/mods/reference#mods-api-methods) seperti `$.ui` dan `$.command`

249* **Event**, bernama `e`: [input event](/docs/id/plugins/mods/reference#events) sebagai data biasa, seperti nama dan argumen panggilan alat

250* **Next handler**, bernama [`next`](/docs/id/plugins/mods/events#how-a-hook-handles-an-event): fungsi yang meneruskan event ke mod lain dan kemudian ke perilaku Claude Code sendiri, dan mengembalikan hasilnya

251 

252Hook dalam `first-mod` menangani peristiwa mereka dalam tiga cara hook dapat:

253 

254* **Observe**: hook `session.start` mendaftarkan perintah, dan hook `tool.call` menghitung panggilan dan meminta redraw. Keduanya mengembalikan `next(e)`, sehingga sesi dimulai dan alat berjalan seperti biasa.

255* **Answer**: hook `command.run` mengembalikan hasilnya sendiri dan tidak pernah memanggil `next`. Argumen kedua ke `on`, `{ command: 'tally' }`, adalah filter, disebut [matcher](/docs/id/plugins/mods/events#filter-which-events-a-hook-handles), sehingga hook hanya berjalan untuk `/tally`.

256* **Rewrite**: hook `ui.render` memanggil `next` dengan salinan `e` yang `suffix`-nya menyimpan hitungan, sehingga Claude Code menggambar spinner biasanya dengan teks Anda setelah kata

257 

258Claude Code mengawasi direktori yang dimuat dengan `--plugin-dir` dan hot-reload hooks module ketika file di dalamnya berubah. Setiap reload menjalankan `register` lagi, sehingga `calls` kembali ke `0` dan `/tally` mulai menghitung lagi. Untuk menyimpan nilai di seluruh reload, lihat [Simpan state](/docs/id/plugins/mods/interface#keep-state).

259 

260<h2 id="keep-working-on-a-mod">

261 Terus bekerja pada mod

262</h2>

263 

264Setelah mod dimuat, Anda dapat membuat Claude mengubahnya, memeriksa kode Anda terhadap definisi tipe untuk versi Anda, mencantumkan peristiwa dan panggilan yang ditemukan Claude Code di dalamnya, dan mengujinya.

265 

266<h3 id="change-a-mod-with-claude">

267 Ubah mod dengan Claude

268</h3>

269 

270Untuk mengubah mod yang sudah Anda miliki, mulai sesi dengan `--plugin-dir` menunjuk ke direktori mod, sehingga apa yang ditulis Claude dimuat dalam sesi yang sama:

271 

272```bash theme={null}

273claude --plugin-dir ./first-mod

274```

275 

276Kemudian minta perubahan, misalnya `add a /tally-reset command to this mod that sets the tally back to zero`. Claude mengedit hooks module, menjalankan `claude plugin validate`, dan memperbaiki apa yang dilaporkannya. Direktori yang Anda muat dengan `--plugin-dir` adalah [jalur yang dilindungi](/docs/id/permission-modes#protected-paths), sehingga dalam mode `default` dan `acceptEdits` Anda diminta untuk menyetujui setiap edit Claude ke mod. Tabel jalur yang dilindungi memberikan hasil untuk mode izin lainnya.

277 

278File yang disimpan Claude selama gilirannya dimuat ulang ketika giliran berakhir, sehingga Anda dapat mencoba `/tally-reset` segera setelah Claude selesai.

279 

280<h3 id="get-the-types-for-your-build">

281 Dapatkan definisi tipe untuk versi Anda

282</h3>

283 

284Setiap kali Claude Code memuat atau memuat ulang mod dari direktori yang Anda teruskan ke `--plugin-dir`, atau mod [yang ditulis Claude untuk Anda](#ask-claude-for-a-mod), ia menulis file deklarasi TypeScript, berakhir dengan `.d.ts`, ke dalam `.claude-plugin/types/` di dalam direktori mod. Mereka menjelaskan peristiwa yang tepat, metode mods API, dan elemen dalam versi Claude Code yang Anda jalankan, sehingga editor Anda dapat autocomplete dan type-check hooks Anda. Untuk menelusuri deklarasi secara online, baca [`mods/types/claude-code.d.ts`](https://github.com/anthropics/claude-code/blob/main/mods/types/claude-code.d.ts) di repositori Claude Code, yang baris pertamanya menamai versi yang menulisnya. Direktori menyimpan file-file ini:

285 

286| Path | Apa yang dideklarasikan |

287| :- | :- |

288| `claude-code/index.d.ts` | Setiap event dan input serta hasilnya, setiap namespace dan metode mods API, dan elemen yang dapat digambar setiap surface |

289| `claude-code-tools/index.d.ts` | Input dan hasil alat bawaan, sehingga memeriksa `e.tool === 'Bash'` mempersempit `e` |

290| `claude-code-mcp/index.d.ts` | Input alat MCP yang terhubung terakhir kali Anda menyimpan file dalam mod |

291| `index.d.ts` dalam direktori bernama untuk plugin | Apa yang ditambahkan plugin itu ke mods API. Ada satu direktori untuk setiap plugin yang dicantumkan `plugin.json` Anda di bawah `dependencies`. |

292| `tsconfig.json` | Opsi compiler yang sesuai untuk hooks module |

293 

294Jika mod Anda tidak memiliki `tsconfig.json` miliknya sendiri, Claude Code menambahkan satu di root mod yang memperluas yang dihasilkan, sehingga editor Anda dan `tsc -p ./first-mod` type-check mod tanpa setup lebih lanjut.

295 

296Peristiwa dan metode dapat berubah antar rilis, jadi percayai file-file ini daripada halaman apa pun, termasuk yang ini, ketika mereka tidak setuju.

297 

298`claude-code/index.d.ts` adalah referensi paling lengkap untuk build Anda, dengan komentar dan contoh untuk setiap metode mods API. Untuk mencari sesuatu, cari file untuk namanya, seperti `'tool.call'`.

299 

300<h3 id="check-what-claude-code-reads-from-your-mod">

301 Periksa apa yang dibaca Claude Code dari mod Anda

302</h3>

303 

304Untuk melihat mod Anda seperti yang dilihat Claude Code, tanpa menjalankan kode atau memulai sesi, gunakan `claude plugin validate`. Ini memeriksa manifest dan menjalankan analisis statis yang sama pada sumber hooks module yang dijalankan Claude Code saat memuat mod. Di shell Anda, jalankan pada direktori mod:

305 

306```bash theme={null}

307claude plugin validate ./first-mod

308```

309 

310Untuk `first-mod`, output mencakup baris-baris ini.

311 

312```text theme={null}

313 ❯ ./register.js hooks: session.start, tool.call, command.run{command=tally}, ui.render{component=Spinner}

314 ❯ ./register.js calls: $.command.register, $.ui.invalidate

315 

316✔ Validation passed

317```

318 

319Baris `hooks:` mencantumkan peristiwa yang dihubungkan modul Anda, masing-masing dengan filternya dalam kurung kurawal. Baris `calls:` mencantumkan setiap metode mods API yang dipanggilnya. Modul yang membaca atau menetapkan variabel lingkungan juga mendapat baris `env reads:` dan `env writes:`, dan yang menggunakan [`$.state`](/docs/id/plugins/mods/interface#keep-state) mendapat `state reads:` dan `state writes:`.

320 

321Jika event yang dimaksudkan untuk dihubungkan hilang dari baris pertama, Claude Code juga tidak akan memanggil hook itu. Penyebab biasanya adalah nama event yang salah eja, yang dilaporkan perintah sebagai kesalahan seperti `"tool.calls" is not an event`.

322 

323Ikuti aturan-aturan ini sehingga analisis statis dapat menemukan setiap hook dan panggilan:

324 

325* Eja setiap panggilan mods API secara lengkap: `$`, namespace, kemudian metode, seperti dalam `$.store.get('notes')`. Anda dapat meneruskan `$` ke fungsi yang dideklarasikan di tingkat atas file yang sama, dan untuk fungsi Anda bernama `loadNotes`, baris `calls:` kemudian membaca `$.store.get (via loadNotes)`. Meneruskan `$` ke metode, fungsi yang didefinisikan di dalam hook, atau fungsi yang Anda impor dari file lain Anda gagal validasi. Fungsi `read` dan `update` yang digunakan [`$.state`](/docs/id/plugins/mods/interface#keep-state) adalah impor yang dapat mengambilnya. Jangan menetapkan `$` atau salah satu namespace-nya ke variabel, destructure, atau indexnya dengan nama yang dihitung. `const ui = $.ui` gagal dengan `$.ui is used as a value`.

326* Tulis nama event dalam setiap panggilan `on` sebagai string literal, seperti `'tool.call'`. Variabel, atau loop atas daftar nama, gagal dengan `the event name passed to on() is not a string literal`.

327* Di dalam `register`, jangan deklarasikan variabel atau parameter kedua bernama `on`. Validasi gagal dengan `"on" is declared again (shadowed)`.

328* Impor hanya dari file di dalam direktori plugin, dengan jalur relatif. Satu-satunya impor bare yang diizinkan adalah `claude-code`, untuk tipe dan beberapa helper.

329* Gunakan deklarasi `import` di atas file, seperti dalam `import { name } from './file.js'`. `import()` dinamis gagal dengan `a dynamic import(); a hooks module imports its own files with an import declaration`.

330* Tulis setiap file sebagai ES module, dengan `import` dan bukan `require`. [Reference](/docs/id/plugins/mods/reference#files) mencantumkan ekstensi file yang dimuat Claude Code.

331 

332<h3 id="test-the-mod">

333 Uji mod

334</h3>

335 

336Anda dapat menulis tes otomatis untuk mod dan menjalankannya dari shell Anda dengan `claude plugin test`, tanpa sesi, sign-in, atau jaringan. Tes menaikkan peristiwa yang ditangani hooks Anda dan memeriksa apa yang dilakukan hooks.

337 

338Tes ini menaikkan dua panggilan alat, menjalankan `/tally`, dan memeriksa bahwa balasan menghitung keduanya. Simpan sebagai `first-mod/tests/first-mod.test.ts`:

339 

340```typescript first-mod/tests/first-mod.test.ts theme={null}

341import { expect, test } from 'claude-code/testing'

342 

343test('/tally reports the tool calls the mod has seen', async ($, on) => {

344 // Answer each tool call in Claude Code's place, so no tool runs

345 on('tool.call', () => ({ result: 'ok' }))

346 

347 // Raise two tool calls, which the mod's tool.call hook counts

348 await $.tool.call({ tool: 'Bash', command: 'ls' })

349 await $.tool.call({ tool: 'Read', file_path: 'README.md' })

350 

351 // Run /tally and check the text its hook returns

352 const answer = await $.command.run({ command: 'tally', args: '' })

353 expect(answer.text).toBe('Claude has made 2 tool calls since this mod loaded')

354})

355```

356 

357Di shell Anda, jalankan tes dari direktori `first-mod`:

358 

359```bash theme={null}

360claude plugin test

361```

362 

363Output menamai setiap tes dan apakah itu lulus, dengan waktu yang bervariasi dari run ke run:

364 

365```text theme={null}

366tests/first-mod.test.ts:

367(pass) /tally reports the tool calls the mod has seen [22.87ms]

368 

369 1 pass

370 0 fail

371Ran 1 test across 1 file. [0.19s]

372```

373 

374[Uji mod](/docs/id/plugins/mods/test) mencakup stubbing panggilan model atau store, dan menguji timer dan gambar.

375 

376<h2 id="share-your-mod">

377 Bagikan mod Anda

378</h2>

379 

380Mod adalah plugin, jadi Anda memversinya dalam manifest dan orang menginstal dan memperbarui dengan perintah `/plugin`. Untuk memberikannya kepada orang lain, [tambahkan ke marketplace](/docs/id/plugins/publish).

381 

382Sebelum Anda melakukannya, periksa `name` plugin: `claude plugin validate` gagal nama yang [terlihat seperti salah satu milik Anthropic sendiri](/docs/id/plugins/manifest-reference#name), seperti yang dimulai dengan `claude-`. Peristiwa dan metode dapat berubah antar rilis, jadi README Anda adalah tempat untuk mengatakan versi Claude Code mana yang Anda uji.

383 

384Terus berkembang terhadap direktori dengan `--plugin-dir`, bukan terhadap salinan yang diinstal. Claude Code cache plugin yang diinstal berdasarkan versi, sehingga edit Anda tidak mencapai salinan yang diinstal sampai Anda menaikkan versi dan menginstal lagi.

385 

386<h2 id="next-steps">

387 Langkah berikutnya

388</h2>

389 

390* [Gambar di antarmuka](/docs/id/plugins/mods/interface): buka pane, gambar di atas prompt, dan tambahkan tombol dan field teks

391* [Bereaksi terhadap peristiwa](/docs/id/plugins/mods/events): hook panggilan alat, prompt, dan giliran

392* [Gunakan mods API](/docs/id/plugins/mods/api): tambahkan perintah dan alat, panggil model, dan jalankan pekerjaan pada timer

393* [Uji mod](/docs/id/plugins/mods/test): stub apa yang akan dijawab Claude Code, dan uji timer dan gambar

394* [Troubleshoot mod](/docs/id/plugins/mods/troubleshoot): alasan mod tidak melakukan apa pun, dan debug log

395* [Baca sumber mod bawaan](/docs/id/plugins/mods/overview#read-the-source-of-built-in-mods): plugin lengkap, masing-masing dengan hooks module dan tesnya