SpyBara
Go Premium

plugins/mods/overview.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 56 additions and 56 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Tue 6 23:59 Thu 8 22:58 Wed 14 22:58 Thu 15 23:58 Mon 19 23:58 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59

Ikhtisar Mods

Tambahkan pane, perintah, dan aturan panggilan tool ke Claude Code dengan mod. Lihat apa yang dapat dilakukan mod, cara membuat atau memasang mod, dan tempat mod berjalan.

Mod adalah plugin 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.

[!NOTE]

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.
  • 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.
  • 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 dan Ikuti giliran.
  • 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.
  • 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.

Mod bekerja di CLI Claude Code, tab Code aplikasi Desktop Claude, dan ekstensi VS Code. Lihat Tempat mod berjalan untuk memahami cara mod berperilaku di tempat lain, seperti di claude -p dan sesi cloud. Jika hook pengaturan, skill, atau server MCP sudah melakukan apa yang Anda butuhkan, bandingkan mereka sebelum Anda menulis mod. Untuk mengelola mod untuk organisasi, lihat Kelola mod untuk organisasi Anda.

Dapatkan mod

Untuk memulai dengan mod:

Pasang atau perbarui mod

[!WARNING]

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.

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 mencakup marketplaces, scopes, ekstensi VS Code dan aplikasi Desktop, dan menjaga plugins tetap terbaru, 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.

Coba mod contoh

Anthropic membagikan mod contoh di direktori claude-code/mods pada repositori claude-code-playground. Masing-masing adalah plugin lengkap, dan README-nya menjelaskan cara pembuatannya. Repositori ini membagikannya apa adanya, tanpa dukungan.

  • token-weather: menggambar prakiraan context window Anda di atas prompt
  • blast-radius: menahan perintah shell yang berisiko, seperti rm -rf atau force push, dan menampilkan apa yang akan diubahnya, dengan tombol untuk melanjutkan atau membatalkan
  • replay-theater: menambahkan perintah /replay yang menelusuri langkah demi langkah suntingan file yang dibuat Claude pada giliran terakhir

Mod contoh berjalan dengan izin Anda. Untuk melihat apa yang dilakukan sebuah mod sebelum Anda memuatnya, daftarkan hook dan panggilannya.

Untuk mencobanya, clone repositori tersebut dan muat direktori mod untuk satu sesi dengan --plugin-dir. Untuk memastikan mod telah dimuat, periksa mods mana yang dimuat oleh sesi.

Untuk menyimpannya, tambahkan direktori claude-code/mods dari clone sebagai marketplace, lalu pasang mod dari claude-code-playground-mods. Marketplace tersebut menunjuk ke clone Anda, sehingga mod berhenti dimuat jika Anda memindahkan atau menghapusnya.

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.

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: environment variable dan file pengaturan, termasuk kunci API yang Anda simpan di salah satu
  • Lihat sesi Anda: setiap prompt yang Anda kirim dan setiap panggilan tool yang dibuat Claude
  • Ubah sesi Anda: tulis ulang prompt atau panggilan tool, kirimkan prompt seolah-olah Anda telah mengetiknya, atau kirim pesan ke sesi lain Anda
  • Bertindak tanpa meminta Anda: setujui panggilan tool sebelum Anda diminta
  • Habiskan penggunaan Anda: panggil model pada paket atau kunci API Anda

Mod tidak berjalan di dalam sandbox. Jika Anda mengaktifkan sandboxing, sandbox mengisolasi perintah Bash yang dijalankan Claude, dan proses yang dimulai oleh mod berjalan di luarnya.

Dengan pengaturan terkelola atau /login Team atau Enterprise sebagai kredensial sesi, secara default persetujuan mod tidak dapat meloloskan panggilan melewati aturan ask atau hook PreToolUse Anda. Tanpa salah satu dari keduanya, mod dapat menyetujui panggilan yang akan dimintakan izinnya oleh aturan ask, atau yang diblokir oleh hook PreToolUse Anda. Untuk memeriksa kapan mod juga dapat menyetujui panggilan yang ditolak aturan deny, lihat Perluas izin dengan hooks.

Mod dapat mengubah gaya banyak antarmuka Claude Code, tetapi bukan dialog izin. Mod tidak dapat mengubah apa yang ditampilkan dialog tersebut kepada Anda.

Daftar apa yang dilakukan mod sebelum Anda memasangnya

Sebelum Anda memasang mod, Anda dapat membuat daftar peristiwa mana yang ditanganinya 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:

claude plugin validate ./some-mod

Baris hooks: dan calls: dalam output mencantumkan peristiwa yang ditangani mod dan apa yang dimintanya kepada Claude Code untuk dilakukan. Tinjau apa yang dapat dilakukan mod menunjukkan output dan panggilan mana yang harus dicari.

Nyalakan atau matikan mods

Mod aktif secara default. Di terminal, gunakan Claude Code v2.1.287 atau lebih baru. Aplikasi Desktop menyertakan salinan Claude Code miliknya sendiri, dan mod berfungsi di sana mulai dari v2.1.286. Periksa versi di tempat Anda menggunakan mod:

  • Terminal: di shell Anda, jalankan claude --version. Jika milik Anda lebih lama, perbarui Claude Code.
  • Aplikasi Desktop: di sesi lokal pada tab Code, masukkan /status dan baca baris Claude Code, yang menampilkan versi seperti 2.1.286. Jika milik Anda lebih lama, perbarui aplikasi Desktop.

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
  • Setiap mod yang dipasang, untuk satu sesi: mulai Claude Code dengan --safe-mode, yang juga menonaktifkan kustomisasi lain Anda
  • Setiap mod yang Anda pasang, di setiap sesi: atur "disableAllHooks": true di ~/.claude/settings.json. Hook pengaturan dan baris status 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.

disableAllHooks dan allowManagedModsOnly milik organisasi Anda menghentikan mod dan membiarkan bagian lain dari pluginnya tetap di tempat: plugin tetap terpasang, dan skill, perintah, agent, serta server MCP-nya tetap dimuat. Pengaturan dan flag lain menjangkau lebih jauh. disableAllHooks dan Apa yang berjalan di bawah allowManagedHooksOnly mencantumkan apa yang dilakukan masing-masing terhadap plugin dan hook pengaturannya.

Untuk mengetahui apakah mods dapat dimuat untuk Anda, lihat Periksa apakah mods dapat dimuat.

[!NOTE]

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.

Cara kerja mod

Mod adalah plugin yang kodenya mendaftarkan penanganan acara, disebut hooks. Claude Code menjalankan hook ketika acaranya terjadi, seperti ketika Claude memanggil tool atau ketika spinner digambar. Mod kecil memiliki tiga file:

first-mod/
├── .claude-plugin/
│   └── plugin.json
└── hooks/
    ├── hooks.json
    └── register.js

Ini adalah register.js lengkap. Ini menghitung panggilan tool yang dibuat Claude dan menampilkan hitungan di samping spinner saat Claude bekerja, seperti Thinking · tool calls: 3….

// The count, shared by the two hooks below
let calls = 0

// Claude Code calls this once when the mod loads
export function register(on) {
  // Runs each time Claude is about to use a tool
  on('tool.call', async ($, e, next) => {
    calls += 1
    // Ask Claude Code to draw the interface again, so the new count shows
    $.ui.invalidate('ui.render')
    // Let the tool run as usual
    return next(e)
  })

  // Runs each time Claude Code draws the spinner
  on('ui.render', { component: 'Spinner' }, async ($, e, next) => {
    // Keep Claude Code's spinner, with the count added after its word
    return next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } })
  })
}

File mendaftarkan dua hook, dan keduanya menggunakan variabel calls di atas:

  • Hook tool.call berjalan setiap kali Claude akan menggunakan tool. Menambahkan satu ke calls, meminta Claude Code untuk menggambar antarmuka lagi, dan membiarkan tool berjalan seperti biasa.
  • Hook ui.render 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….