> ## 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. # Ikhtisar Mods > Tambahkan pane, perintah, dan aturan pemanggilan alat ke Claude Code dengan mod. Lihat apa yang dapat dilakukan mod, cara membuat atau memasang mod, dan tempat mod berjalan. Mod adalah [plugin](/docs/id/plugins/overview) yang mengubah tampilan dan perilaku Claude Code. Mod terdiri dari penanganan peristiwa JavaScript atau TypeScript: Claude Code memanggil satu ketika peristiwa terjadi, seperti pemanggilan alat, prompt yang dikirimkan, atau bagian dari antarmuka yang digambar, dan penanganan dapat memantau peristiwa, mengubahnya, atau mengambil alih. Gunakan mod untuk menambahkan fitur Anda sendiri ke Claude Code, seperti pane yang membuat bagan seberapa penuh konteks Anda setelah setiap permintaan. Untuk file dalam mod dan contoh lengkap, lihat [Cara kerja mod](#how-a-mod-works). [hooks](/docs/id/hooks) yang sudah ada di Claude Code juga berjalan pada peristiwa, sebagai perintah shell, permintaan HTTP, atau prompt yang Anda konfigurasi dalam file pengaturan. Penanganan mod adalah fungsi yang berjalan di dalam Claude Code sebagai gantinya. Claude Code memanggil kedua jenis hooks: di halaman ini, "hook" berarti penanganan mod, dan jenis file pengaturan adalah "settings hook".

Apa yang dapat dilakukan mod

Settings hooks, skills, status lines, dan server MCP bekerja dari luar Claude Code: masing-masing menjalankan skrip, atau memberikan Claude teks atau alat. Mod berjalan di dalam Claude Code, jadi dapat melakukan hal-hal yang tidak dapat dilakukan oleh yang lain: * **Gambar antarmuka yang dapat Anda gunakan**: pane di samping transkrip atau band di atas prompt, dengan tab, tombol, dan bidang teks. Lihat [Gambar di antarmuka](/docs/id/plugins/mods/interface). * **Gambar ulang antarmuka Claude Code sendiri**: ganti atau ubah gaya bagian yang digambar Claude Code sendiri, seperti baris pemanggilan alat, spinner, atau dialog yang Claude tanyakan. Lihat [Ubah apa yang sudah digambar Claude Code](/docs/id/plugins/mods/interface#change-what-claude-code-already-draws). * **Masuki pemanggilan alat atau permintaan**: misalnya, tahan pemanggilan alat saat Anda mengajukan pertanyaan kepada pengguna, jawab tanpa menjalankan alat, atau kirim satu permintaan ke model yang berbeda. Lihat [Lindungi atau ubah pemanggilan alat](/docs/id/plugins/mods/events#guard-or-change-a-tool-call) dan [Ikuti giliran](/docs/id/plugins/mods/events#follow-a-turn). * **Jalankan kode Anda sendiri pada perintah**: `/command` yang menjalankan fungsi Anda sekaligus, tanpa giliran Claude, bahkan saat Claude sedang bekerja. Lihat [Tambahkan perintah atau alat](/docs/id/plugins/mods/api#add-a-command-or-a-tool). * **Bagikan data antar hooks**: hooks mod berbagi variabel dalam file-nya, jadi apa yang dicatat satu hook, hook lain dapat menampilkannya. Misalnya, satu hook dapat menghitung pemanggilan alat sementara hook lain menampilkan hitungan di samping spinner, atau satu dapat membaca penggunaan token setiap permintaan sementara hook lain membuat bagan di pane. Lihat [Bereaksi terhadap acara](/docs/id/plugins/mods/events). Mods bekerja di CLI Claude Code dan di tab Code aplikasi Desktop Claude. Lihat [Tempat mod berjalan](#where-mods-run) untuk memahami cara mereka berperilaku di tempat lain, seperti di ekstensi VS Code, `claude -p`, dan sesi cloud. Jika settings hook, skill, atau server MCP sudah melakukan apa yang Anda butuhkan, [bandingkan mereka](#compare-mods-settings-hooks-skills-and-mcp-servers) sebelum Anda menulis mod. Untuk mengelola mods untuk organisasi, lihat [Kelola mods untuk organisasi Anda](/docs/id/plugins/mods/admin).

Dapatkan mod

Anda dapat memulai dengan mod dengan salah satu dari tiga cara: * **Gunakan yang sudah Anda miliki**: beberapa fitur Claude Code sendiri adalah mods, seperti `/diff`. Lihat [Mods bawaan Claude Code](#mods-built-into-claude-code). * **Buat satu**: jelaskan apa yang Anda inginkan dalam sesi Claude Code, dan Claude menulis mod. Lihat [Minta Claude untuk mod](/docs/id/plugins/mods/create#ask-claude-for-a-mod). Untuk mempelajari cara kerja kode mod, [tulis satu sendiri](/docs/id/plugins/mods/create#write-a-mod-yourself). * **Pasang satu**: lihat [Pasang atau perbarui mod](#install-or-update-a-mod)

Pasang atau perbarui mod

Mod adalah kode yang berjalan dengan izin Anda. Dapat membaca dan menulis file Anda, memulai proses, dan membuat permintaan jaringan. Pasang mods hanya dari penulis dan marketplace yang Anda percayai. Lihat [Putuskan apakah akan mempercayai mod](#decide-whether-to-trust-a-mod). Mod dipasang sebagai plugin, dari marketplace. Berikan nama plugin, `@`, dan nama marketplace. Contoh-contoh ini memasang plugin bernama `token-chart` dari marketplace bernama `your-org`: * Dalam sesi Claude Code, jalankan `/plugin install token-chart@your-org`. * Di shell Anda, jalankan `claude plugin install token-chart@your-org`. [Pasang plugins](/docs/id/plugins/install) mencakup marketplaces, scopes, ekstensi VS Code dan aplikasi Desktop, dan [menjaga plugins tetap terbaru](/docs/id/plugins/install#keep-plugins-updated), semuanya berlaku untuk plugin yang berisi mod tanpa perubahan. Jika Anda memasang atau memperbarui mod dari shell Anda saat sesi terbuka, jalankan `/reload-plugins` dalam sesi itu untuk memuatnya. Jika tidak, mod akan dimuat saat Anda memulai Claude Code berikutnya.

Putuskan apakah akan mempercayai mod

Mod adalah kode yang berjalan dengan izin Anda, di dalam Claude Code. Pasang mods hanya dari penulis dan [marketplaces yang Anda percayai](/docs/id/plugins/security).

Apa yang dapat dijangkau mod

Mod berjalan dengan izin Anda, jadi sebelum Anda memasang satu, ketahui apa yang dapat diaksesnya. Setelah dimuat, mod dapat: * **Bertindak di mesin Anda sebagai Anda**: membaca dan menulis file di mana pun akun pengguna Anda dapat, memulai program, dan membuat permintaan jaringan * **Baca rahasia Anda**: variabel lingkungan dan file pengaturan, termasuk kunci API yang Anda simpan di salah satu * **Lihat sesi Anda**: setiap prompt yang Anda kirim dan setiap pemanggilan alat yang dibuat Claude * **Ubah sesi Anda**: tulis ulang prompt atau pemanggilan alat, kirimkan prompt seolah-olah Anda telah mengetiknya, atau kirim pesan ke sesi lain Anda * **Bertindak tanpa meminta Anda**: setujui pemanggilan alat sebelum Anda diminta * **Habiskan penggunaan Anda**: panggil model pada paket atau kunci API Anda Mod yang menyetujui pemanggilan alat dapat menyetujui yang akan diminta oleh aturan `ask`, atau yang diblokir oleh hooks `PreToolUse` Anda sendiri. [Perluas izin dengan hooks](/docs/id/permissions#extend-permissions-with-hooks) mencantumkan apa yang dapat disetujui mod seperti itu, termasuk kapan dapat menyetujui panggilan yang ditolak aturan `deny`. Mod dapat mengubah gaya banyak antarmuka Claude Code, tetapi bukan prompt izin. Tidak dapat mengubah apa yang ditampilkan prompt kepada Anda.

Daftar apa yang dilakukan mod sebelum Anda memasangnya

Sebelum Anda memasang mod, Anda dapat membuat daftar acara mana yang dikaitkan dan apa yang dimintanya kepada Claude Code untuk dilakukan, seperti membaca file atau membuat permintaan jaringan, tanpa menjalankannya. Dapatkan file plugin terlebih dahulu, misalnya dengan mengkloning repositorinya. Kemudian, di shell Anda, jalankan `claude plugin validate` di direktori plugin: ```bash theme={null} claude plugin validate ./some-mod ``` Baris `hooks:` dan `calls:` dalam output mencantumkan acara yang ditangani mod dan apa yang dimintanya kepada Claude Code untuk dilakukan. [Tinjau apa yang dapat dilakukan mod](/docs/id/plugins/mods/admin#review-what-a-mod-can-do) menunjukkan output dan panggilan mana yang harus dicari.

Nyalakan atau matikan mods

Mods memerlukan Claude Code v2.1.287 atau lebih baru, dan mods aktif secara default. Di shell Anda, jalankan `claude --version` untuk memeriksa, dan perbarui Claude Code jika milik Anda lebih lama. Untuk mematikan mods, pilih berapa banyak yang akan dihentikan, dan berapa lama. Untuk menghidupkan kembali, batalkan perubahan yang sama: * **Satu mod**: nonaktifkan atau copot pemasangan pluginnya dari [tab **Installed** di `/plugin`](/docs/id/plugins/install#manage-installed-plugins) * **Setiap mod yang dipasang, untuk satu sesi**: mulai Claude Code dengan [`--safe-mode`](/docs/id/cli-reference#cli-flags), yang juga menghilangkan kustomisasi lain Anda * **Setiap mod yang Anda pasang, di setiap sesi**: atur [`"disableAllHooks": true`](/docs/id/settings-reference#disableallhooks) di `~/.claude/settings.json`. Settings hooks dan status line kustom Anda juga berhenti. Apa yang dikelola organisasi Anda terus berjalan. Jika Anda menggunakan Claude Code melalui organisasi, administrator juga dapat membatasi mods mana yang dimuat. Administrator dimulai di [Hentikan mods yang dipasang pengguna dari dimuat](/docs/id/plugins/mods/admin#stop-user-installed-mods-from-loading). Untuk mengetahui apakah mods dapat dimuat untuk Anda, lihat [Periksa apakah mods dapat dimuat](/docs/id/plugins/mods/troubleshoot#check-whether-mods-can-load). Jika Anda menetapkan `CLAUDE_CODE_ENABLE_FUNCTION_HOOKS` selama akses awal, hapus. Claude Code v2.1.287 dan lebih baru mengabaikannya, jadi menetapkannya ke `0` tidak membuat mods tetap mati.

Lihat mods mana yang dimuat sesi

Untuk melihat mods mana yang dimuat sesi terminal, jalankan `/plugin` di prompt Claude Code. Baris redup di bawah tab memberikan hitungan dan nama, seperti `1 mod active · first-mod`. Jika mod yang Anda pasang tidak dinamai di sana, lihat [Cari tahu mengapa mod tidak melakukan apa pun](/docs/id/plugins/mods/troubleshoot#find-out-why-a-mod-does-nothing).

Cara kerja mod

Mod adalah [plugin](/docs/id/plugins/overview) yang kodenya mendaftarkan penanganan acara, disebut hooks. Claude Code menjalankan hook ketika acaranya terjadi, seperti ketika Claude memanggil alat atau ketika spinner digambar. Mod kecil memiliki tiga file: ```text theme={null} first-mod/ ├── .claude-plugin/ │ └── plugin.json └── hooks/ ├── hooks.json └── register.js ``` * **`plugin.json`**: [manifest](/docs/id/plugins/manifest-reference) plugin * **`hooks.json`**: [menunjuk ke file kode Anda](/docs/id/plugins/mods/reference#files) * **`register.js`**: [kode Anda](/docs/id/plugins/mods/create#write-a-mod-yourself), disebut modul hooks. Ini memberitahu Claude Code acara mana yang akan menjalankan fungsi Anda. Ini adalah `register.js` lengkap. Ini menghitung pemanggilan alat yang dibuat Claude dan menampilkan hitungan di samping spinner saat Claude bekerja, seperti `Thinking · tool calls: 3…`. ```javascript hooks/register.js theme={null} // Hitungan, dibagikan oleh dua hooks di bawah let calls = 0 // Claude Code memanggil ini sekali ketika mod dimuat export function register(on) { // Berjalan setiap kali Claude akan menggunakan alat on('tool.call', async ($, e, next) => { calls += 1 // Minta Claude Code untuk menggambar antarmuka lagi, sehingga hitungan baru ditampilkan $.ui.invalidate('ui.render') // Biarkan alat berjalan seperti biasa return next(e) }) // Berjalan setiap kali Claude Code menggambar spinner on('ui.render', { component: 'Spinner' }, async ($, e, next) => { // Pertahankan spinner Claude Code, dengan hitungan ditambahkan setelah katanya return next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } }) }) } ``` File mendaftarkan dua hooks, dan keduanya menggunakan variabel `calls` di atas: * **Hook [`tool.call`](/docs/id/plugins/mods/reference#tools)** berjalan setiap kali Claude akan menggunakan alat. Menambahkan satu ke `calls`, meminta Claude Code untuk menggambar antarmuka lagi, dan membiarkan alat berjalan seperti biasa. * **Hook [`ui.render`](/docs/id/plugins/mods/reference#interface)** berjalan setiap kali Claude Code menggambar spinner. Mempertahankan spinner Claude Code sendiri dan menambahkan hitungan setelah kata. Rekaman ini menunjukkan mod bekerja. Perhatikan baris spinner di atas kotak prompt: saat Claude membuat daftar direktori dan membaca dua file, dibaca `Thinking · tool calls: 1…`, kemudian `2…`, kemudian `3…`.