Claude Code Mods Hadir, Developer Bisa Ubah Perilaku dan UI Claude Code

Anthropic memperkenalkan Claude Code Mods, mekanisme yang memungkinkan developer mengubah cara kerja Claude Code melalui plugin berbasis JavaScript atau TypeScript. Fitur ini dapat digunakan untuk menambahkan tampilan baru, mengubah perilaku tool, membuat perintah khusus, hingga menambahkan pengaman sebelum Claude menjalankan perintah tertentu.

Penjelasan mengenai Mods dipublikasikan melalui Claude.dev pada 1 Oktober 2026. Anthropic menunjukkan cara membuat mod dari folder kosong, sekaligus memberikan contoh penerapannya untuk memantau penggunaan context window, memeriksa perintah berisiko, dan meninjau perubahan kode yang dilakukan Claude.

Claude Code Mods Bekerja sebagai Plugin

Berbeda dengan pengaturan biasa, Mods berjalan sebagai bagian dari sesi Claude Code. Secara teknis, sebuah mod merupakan plugin yang memiliki manifest .claude-plugin/plugin.json dan modul JavaScript atau TypeScript yang didaftarkan melalui hooks/hooks.json.

Mod menggunakan sistem hooks untuk menangkap berbagai event yang terjadi di Claude Code. Event tersebut mencakup pemanggilan tool, awal dan akhir sesi, awal dan akhir turn, pengiriman prompt, slash command, hingga proses rendering antarmuka.

Jenis Hook	Fungsi	Contoh
Observe	Mengamati event tanpa mengubah perilakunya	Mencatat perubahan file
Rewrite	Mengubah data sebelum diteruskan	Mengganti perintah dengan versi yang lebih aman
Answer	Menghentikan proses dan memberikan respons sendiri	Menolak tool call tertentu

Anthropic menjelaskan mekanisme tersebut menyerupai middleware. Sebuah hook dapat memproses event kemudian meneruskannya dengan next(e), sehingga plugin lain dan perilaku bawaan Claude Code tetap dapat berjalan.

Claude Code 2.1.287 Menjadi Syarat

Dokumentasi Anthropic menyebut Mods tersedia secara default mulai Claude Code versi 2.1.287. Developer tidak perlu mengaktifkan fitur tersebut melalui pengaturan khusus.

Untuk memeriksa versi yang digunakan, developer dapat menjalankan:

claude --version

Anthropic juga mencatat bahwa API Mods dapat berubah antarversi. Saat sebuah mod dimuat, Claude Code menuliskan deklarasi tipe untuk build yang digunakan ke direktori .claude-plugin/types/. Deklarasi tersebut menjadi acuan untuk API pada versi tersebut.

Token Weather Menjadi Contoh Mod Pertama

Dalam tutorialnya, Anthropic membuat sebuah mod bernama Token Weather. Mod tersebut menampilkan kondisi context window Claude Code di atas prompt.

Informasi yang ditampilkan meliputi persentase context yang telah digunakan, jumlah token, kapasitas context window, serta grafik sederhana dari beberapa turn sebelumnya.

Penggunaan Context	Status
Di bawah 25 persen	Clear
25–49 persen	Cloudy
50–74 persen	Showers
75–89 persen	Storm
90 persen atau lebih	Compact soon

Data tersebut diambil menggunakan $.session.usage(). Riwayat penggunaan kemudian disimpan melalui $.state, bukan variabel biasa, agar data tetap tersedia ketika modul mengalami hot reload.

Developer Bahkan Bisa Meminta Claude Membuat Mod

Anthropic juga menunjukkan pendekatan yang lebih sederhana. Developer tidak harus memahami seluruh API Mods sejak awal. Claude Code dapat diminta untuk membuat mod berdasarkan deskripsi fungsi yang diinginkan.

Dalam contoh Token Weather, developer cukup menjelaskan informasi yang ingin ditampilkan, seperti persentase context window, jumlah token, grafik beberapa turn terakhir, dan perubahan penggunaan token.

Setelah mod dibuat, Claude Code dapat menjalankannya dengan mekanisme hot reload sehingga perubahan pada file langsung terlihat dalam sesi yang sedang berjalan.

Mods Bisa Mengubah Tampilan Claude Code

API Mods tidak hanya digunakan untuk membaca data. Developer juga dapat membuat komponen antarmuka sendiri.

Salah satu target yang digunakan dalam tutorial adalah komponen AbovePrompt, yaitu area tepat di atas kolom prompt. Dengan hook ui.render, mod dapat menggambar elemen seperti Box dan Text.

on(
  "ui.render",
  { component: "AbovePrompt" },
  ($, e, next) => {
    const { Box, Text } = $.ui.resolve(e);

    return Box({
      paddingX: 1,
      children: [
        Text({
          color: "yellow",
          bold: true,
          children: "☀ Clear skies",
        }),
      ],
    });
  }
);

Claude Code juga mendukung hot reload untuk pengembangan mod. Developer dapat menjalankan plugin menggunakan --plugin-dir, kemudian perubahan pada file dimuat kembali tanpa harus memulai ulang sesi.

Blast Radius untuk Perintah Berisiko

Anthropic kemudian menunjukkan contoh mod yang lebih kompleks bernama Blast Radius. Mod ini dirancang untuk menahan perintah tertentu sebelum dijalankan dan memberikan gambaran mengenai dampaknya.

Contoh perintah yang dapat ditahan antara lain rm -rf, git reset --hard, git clean, force push, dan migrasi database.

Ketika menemukan perintah yang dianggap berisiko, mod dapat membuka panel yang memberikan pilihan Proceed atau Cancel. Jika pengguna membatalkan, hook dapat mengembalikan respons deny sehingga perintah tidak diteruskan ke Claude Code.

Namun Anthropic menekankan bahwa mekanisme seperti Blast Radius merupakan lapisan pengaman, bukan pengganti permission system. Karena mod membaca teks perintah, pola seperti alias, subshell, atau script yang menjalankan perintah tertentu dapat melewati pemeriksaan tersebut.

Replay Theater Menampilkan Perubahan Kode

Contoh ketiga adalah Replay Theater, yang berfungsi merekam perubahan file selama satu turn Claude Code.

Mod ini mengamati pemanggilan tool seperti Edit dan Write, kemudian menyimpan informasi mengenai file serta perubahan sebelum dan sesudah operasi. Setelah turn selesai, developer dapat membuka replay untuk melihat perubahan satu per satu.

Replay Theater juga mendaftarkan slash command /replay. Dengan demikian, developer dapat meminta Claude Code menampilkan kembali perubahan yang terjadi pada turn sebelumnya tanpa harus mencari diff secara manual.

Validasi dan Testing Disediakan

Mods juga memiliki mekanisme validasi dan pengujian. Anthropic menyediakan perintah claude plugin validate untuk memeriksa manifest, hook, penggunaan API, serta state yang digunakan oleh plugin.

claude plugin validate ./token-weather

Untuk pengujian, developer dapat menggunakan:

claude plugin test ./token-weather

Pengujian tersebut dapat menjalankan file *.test.ts menggunakan runtime Claude Code dan melakukan stub terhadap respons tertentu. Dalam contoh Anthropic, pengujian memastikan tampilan Token Weather berubah ketika penggunaan context meningkat.

Mod Bisa Dibagikan Melalui Marketplace

Karena Mods merupakan plugin, cara distribusinya mengikuti mekanisme plugin Claude Code. Developer dapat menyimpan mod di repository GitHub dan menyediakan file marketplace.

Contoh instalasi yang diberikan Anthropic menggunakan tiga perintah:

/plugin marketplace add your-org/my-mods /plugin install token-weather@my-mods /reload-plugins

Anthropic juga membuka direktori Claude untuk plugin yang memiliki Mods sehingga developer dapat mendistribusikan mod kepada pengguna lain.

Anthropic Mengingatkan Risiko Instalasi Mod

Karena mod merupakan kode yang berjalan di komputer pengguna dan memiliki akses yang sama dengan Claude Code, Anthropic mengingatkan developer untuk memeriksa kode sumber sebelum memasangnya.

Mod juga ditulis oleh pembuat plugin, bukan oleh Anthropic. Karena itu, mekanisme instalasi perlu diperlakukan seperti memasang package atau plugin pihak ketiga.

Dokumentasi tersebut menyarankan pengguna hanya memasang mod dari sumber yang dipercaya dan memahami akses yang dimiliki kode tersebut.

Claude Code Mulai Bisa Dikustomisasi Lebih Dalam

Claude Code sebelumnya sudah menyediakan sejumlah mekanisme seperti settings, permission rules, slash commands, skills, dan status line. Mods menambahkan lapisan baru yang dapat memengaruhi perilaku internal, event, dan tampilan antarmuka.

Anthropic bahkan menyebut beberapa fitur Claude Code sendiri dibuat menggunakan mekanisme Mods, termasuk dukungan AGENTS.md dan panel /diff. Source code beserta pengujiannya tersedia di repository publik Claude Code.

Bagi developer, kemampuan tersebut membuka kemungkinan membuat Claude Code lebih sesuai dengan workflow masing-masing. Contohnya antara lain meter biaya dan rate limit, pengingat standar coding perusahaan, daftar file yang telah dibaca Claude, timer untuk sesi kerja, hingga pengaman khusus untuk perintah seperti kubectl atau terraform apply.

Dengan pendekatan tersebut, Claude Code Mods bukan hanya menambahkan fitur baru ke terminal, tetapi menyediakan mekanisme bagi developer untuk membentuk kembali bagaimana agen coding berinteraksi dengan kode, tool, dan antarmuka selama sebuah sesi.