Claude Code Mods, Cara Baru Mengubah Perilaku Agen Coding

Pernah ingin Claude Code menahan dulu perintah rm -rf sebelum dijalankan, atau menampilkan sisa konteks di samping layar tanpa harus mengetik perintah? Sejak awal Oktober 2026, hal seperti itu bisa dibuat sendiri lewat mods.

Mods adalah plugin yang mengubah cara Claude Code tampil dan berperilaku. Isinya event handler JavaScript atau TypeScript yang dipanggil Claude Code saat sebuah peristiwa terjadi, misalnya Claude akan memakai tool, kamu mengirim prompt, atau bagian antarmuka sedang digambar. Handler itu bisa mengamati, mengubah, atau mengambil alih peristiwa tersebut. Fitur ini membutuhkan Claude Code v2.1.287 atau lebih baru di terminal.

Apa bedanya mods dengan hooks dan skill?

Claude Code sudah lama punya settings hook, skill, status line, dan server MCP. Menurut dokumentasi resmi, semuanya bekerja dari luar: menjalankan skrip, atau memberi Claude teks dan tool. Mods berjalan di dalam proses Claude Code, sehingga bisa melakukan hal yang tidak bisa dilakukan yang lain.

Beberapa contoh kemampuan mods menurut dokumentasi:

• Menggambar antarmuka sendiri, seperti pane di samping transkrip atau band di atas kotak prompt, lengkap dengan tab, tombol, dan kolom teks.
• Mengubah tampilan bawaan Claude Code, misalnya baris tool call atau spinner.
• Masuk ke tool call atau request: menahan tool call sambil bertanya ke pengguna, menjawabnya tanpa menjalankan tool, atau mengirim request ke model lain.
• Menambah perintah / yang langsung menjalankan fungsi tanpa giliran Claude, bahkan saat Claude sedang bekerja.

Setiap handler menerima tiga hal: objek API (di contoh resmi ditulis $), objek event, dan fungsi next(). Memanggil next(e) meneruskan peristiwa apa adanya, memanggilnya dengan event yang sudah diubah berarti menulis ulang, dan tidak memanggilnya berarti handler menjawab sendiri. Beberapa fitur bawaan Claude Code sendiri, seperti /diff, kini dibangun sebagai mod.

Mods dikemas dalam sistem plugin yang sudah dipakai Claude Code sebelumnya, jadi cara memasang, memperbarui, dan mencopotnya sama dengan plugin lain. Kalau kamu baru mengenal Claude Code, perbandingannya dengan asisten coding lain ada di ulasan AI coding assistant.

Langkah mencoba dan memasang mods

1. Cek versi Claude Code

Jalankan claude --version di shell. Untuk terminal, mods butuh v2.1.287 atau lebih baru. Aplikasi Desktop membawa salinan Claude Code sendiri, dan mods berjalan di sana mulai v2.1.286. Cek versinya dengan mengetik /status di tab Code. Bila masih lama, perbarui dulu.

2. Coba contoh resmi untuk satu sesi

Anthropic membagikan contoh mods di repositori claude-code-playground, folder claude-code/mods. Beberapa contohnya: token-weather yang menggambar "ramalan" isi jendela konteks di atas prompt, blast-radius yang menahan perintah shell berisiko seperti rm -rf atau force push lalu menampilkan dampaknya dengan tombol lanjut atau batal, dan replay-theater yang menambah perintah /replay.

Clone repositorinya, lalu muat folder mod tersebut untuk satu sesi saja dengan opsi --plugin-dir. Cara ini membuat mod aktif tanpa memasangnya permanen.

3. Periksa isi mod sebelum dipasang

Ini langkah yang paling sering dilewati. Sebelum memasang mod dari mana pun, jalankan:

claude plugin validate ./nama-mod

Baris hooks: dan calls: di hasilnya menunjukkan peristiwa apa saja yang ditangani mod dan apa yang dia minta dari Claude Code, misalnya membaca berkas atau membuat request jaringan. Semua aksi di luar kode mod sendiri wajib lewat API mods, itulah sebabnya daftar ini bisa dibuat tanpa menjalankan mod.

4. Pasang dari marketplace tepercaya

Mod dipasang seperti plugin biasa, dengan format nama-plugin@nama-marketplace. Di dalam sesi, ketik /plugin install token-chart@your-org, atau dari shell jalankan claude plugin install token-chart@your-org (contoh nama dari dokumentasi). Bila memasang dari shell saat sesi sedang terbuka, jalankan /reload-plugins di sesi itu.

5. Pastikan mod termuat dan tahu cara mematikannya

Ketik /plugin di prompt. Baris redup di bawah tab menunjukkan jumlah dan nama mod aktif. Untuk mematikan satu mod, nonaktifkan dari tab Installed. Untuk satu sesi tanpa kustomisasi apa pun, jalankan Claude Code dengan --safe-mode. Untuk mematikan semua mod yang kamu pasang di semua sesi, set "disableAllHooks": true di ~/.claude/settings.json, dengan catatan settings hook dan status line kustom ikut berhenti.

6. Atau minta Claude membuatkannya

Dokumentasi menyebut kamu bisa mendeskripsikan mod yang diinginkan di sesi Claude Code, lalu Claude menuliskannya. Tetap baca kodenya dan jalankan claude plugin validate sebelum dipakai rutin.

Kenapa mods perlu diperlakukan seperti kode asing?

Dokumentasi resmi sangat terang soal ini. Mod adalah kode yang berjalan dengan izin kamu. Setelah dimuat, mod bisa membaca dan menulis berkas di mana pun akunmu bisa, menjalankan program, membuat request jaringan, membaca variabel lingkungan dan berkas pengaturan termasuk API key, melihat setiap prompt dan tool call, menyetujui tool call sebelum kamu ditanya, dan memakai kuota model di paket atau API key-mu.

Mods tidak di-sandbox. Bila sandboxing Claude Code diaktifkan, yang diisolasi hanya perintah Bash yang dijalankan Claude, sedangkan proses yang dimulai mod tetap berjalan di luar sandbox. Ada pelindung bawaan bernama cc-plugin-sec-default yang secara default mencegah mod milik pengguna menyetujui tool call yang ditolak aturan organisasi, dan mod tidak bisa mengubah tampilan permission prompt.

Saran berikut adalah penalaran kami sendiri, bukan saran resmi Anthropic. Perlakukan mod seperti ekstensi browser: sedikit, dari sumber jelas, dan diaudit berkala. Pola audit yang mirip kami bahas di cara mengaudit ekstensi browser berbahaya di kantor. Bila kamu menjalankan Claude Code di server bersama atau mesin yang menyimpan kredensial produksi, pertimbangkan memisahkan lingkungan kerja agen dari server penting, seperti dijelaskan di panduan menjalankan AI agent di sandbox.

Ringkasan perbandingan

Checklist singkat sebelum memakai mods:

• Claude Code sudah v2.1.287 atau lebih baru.
• Mod dicoba dulu dengan --plugin-dir untuk satu sesi.
• Hasil claude plugin validate sudah dibaca.
• Sumber marketplace jelas dan tepercaya.
• Kamu tahu cara mematikan mod lewat /plugin atau --safe-mode.