Plugin Claude Code: Apa Itu dan Berapa Biayanya

Apa itu plugin Claude Code

Plugin Claude Code adalah satu direktori yang berisi komponen yang dimuat dan dikelola Claude Code sebagai satu unit. Komponen tersebut mencakup skills, agents, hooks, server MCP, server LSP, dan monitor latar belakang. Menginstal plugin menambahkan semua komponennya sekaligus dengan satu nama, dan menonaktifkannya menghapus komponen tersebut dengan cara yang sama.

Plugin tidak memberi agent kemampuan yang sebelumnya tidak dimilikinya. Setiap komponen di dalam plugin dapat Anda tulis secara manual di direktori .claude/. Plugin adalah lapisan pengemasan: cara untuk membuat versi komponen tersebut, membagikannya kepada lima belas orang, dan memperbaruinya nanti tanpa meminta semua orang menyalin file. Itulah keseluruhan konsepnya. Sebagian besar kebingungan tentang plugin muncul karena orang mengira plugin merupakan jenis kemampuan baru.

Manifest opsional di .claude-plugin/plugin.json menentukan nama plugin, dan nama tersebut menjadi namespace. Skill dalam plugin bernama commit-commands dipanggil sebagai /commit-commands:commit. Dengan demikian, dua plugin dapat merilis skill bernama commit tanpa saling menimpa. Agent plugin menggunakan cakupan yang sama dalam daftar @-mention, yaitu plugin-name:agent-name.

Plugin, skill, MCP server, atau rules file

Keempat istilah ini sering digunakan seolah-olah saling bersaing. Sebenarnya tidak, dan batasnya perlu dijelaskan sekali.

• Skill adalah satu unit instruksi yang dimuat Claude ketika tugas memerlukannya. Lihat penjelasan tentang Agent Skill sebenarnya.
• MCP server adalah proses terpisah yang menyediakan tools untuk agent melalui suatu protokol, sering kali berupa layanan jaringan yang Anda jalankan sendiri.
• Rules file seperti CLAUDE.md adalah konteks proyek yang dibaca saat sesi dimulai dan berlaku untuk segala hal.
• Plugin adalah wadah yang dapat menampung skill, agent, hook, dan definisi MCP server secara bersamaan, serta memiliki nomor versi dan saluran distribusi.

Jadi, pertanyaan yang dijawab oleh plugin bukanlah "apa yang dapat dilakukan agent". Pertanyaannya adalah "bagaimana cara mendistribusikan ini kepada tim saya dan memperbaruinya bulan depan". Jika Anda sedang memilih di antara tiga yang pertama, perbandingan skill, MCP server, dan rules file membahas keputusan tersebut secara terperinci. Jika bagian MCP yang Anda perlukan, menjalankan MCP server sendiri pada VPS membahas aspek hosting.

Lokasi plugin dan isi di dalamnya

Plugin yang diinstal dari marketplace disalin ke cache lokal di ~/.claude/plugins/cache, bukan dijalankan dari lokasi tempat plugin tersebut di-clone. Setiap versi yang diinstal memiliki direktorinya sendiri. Saat Anda memperbarui atau menghapus instalasi plugin, direktori versi lama ditandai sebagai yatim dan dihapus sekitar dua minggu kemudian. Dengan demikian, sesi yang sudah memuat versi lama tetap berjalan dan tidak gagal di tengah tugas.

Karena path berubah pada setiap pembaruan, plugin tidak boleh melakukan hardcode terhadap lokasinya sendiri. Hook dan konfigurasi MCP di dalam plugin menggunakan ${CLAUDE_PLUGIN_ROOT}, yang mengarah ke direktori instalasi saat ini. Data yang harus tetap tersedia setelah pembaruan disimpan di ${CLAUDE_PLUGIN_DATA}, yang mengarah ke direktori stabil di bawah ~/.claude/plugins/data/.

Hanya direktori milik plugin yang disalin ke cache. Hal ini menimbulkan masalah yang sering baru diketahui belakangan. Path yang mengarah ke luar root plugin, seperti ../shared-utils, berfungsi saat Anda mengembangkan plugin menggunakan path lokal, tetapi gagal setelah instalasi karena file tersebut tidak pernah disalin.

Strukturnya terlihat seperti berikut.

my-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── code-review/
│       └── SKILL.md
├── agents/
├── hooks/
│   └── hooks.json
├── .mcp.json
└── bin/

Hanya plugin.json yang berada di dalam .claude-plugin/. Semua yang lain berada di root plugin. Menempatkan skills/ atau hooks/ di dalam .claude-plugin/ adalah alasan paling umum plugin berhasil diinstal, tetapi kemudian sama sekali tidak melakukan apa pun: Claude Code mencari direktori tersebut di root, tidak menemukannya, lalu memuat plugin tanpa komponen.

Manifest itu sendiri berukuran kecil.

{
  "name": "my-first-plugin",
  "description": "A greeting plugin to learn the basics",
  "version": "1.0.0"
}

Cara menginstal plugin Claude Code

Instalasi terdiri atas dua langkah, dan langkah pertama tidak menginstal apa pun. Anda menambahkan marketplace, yaitu katalog plugin, lalu menginstal plugin individual dari marketplace tersebut. Marketplace resmi Anthropic, claude-plugins-official, didaftarkan untuk Anda saat pertama kali menjalankan Claude Code secara interaktif. Marketplace lain harus Anda tambahkan sendiri.

/plugin marketplace add anthropics/claude-code
/plugin install commit-commands@claude-code-plugins

Perhatikan bahwa repositorinya adalah anthropics/claude-code, sedangkan marketplace-nya bernama claude-code-plugins. Nama tersebut berasal dari file katalog di dalam repositori, bukan dari path repositori. Karena itu, baca nama marketplace pada tab Marketplaces di /plugin sebelum mengetik perintah instalasi.

Setelah instalasi selesai, baca baris ringkasannya. Plugin is now active. berarti komponennya dimuat dalam sesi ini. Run /reload-plugins to activate. berarti komponennya belum dimuat dan Anda perlu menjalankan perintah tersebut. Jika /reload-plugins memperingatkan bahwa percakapan akan dibaca ulang, jalankan ulang sebagai /reload-plugins --force. Selanjutnya, pastikan plugin benar-benar tersedia: /plugin menampilkannya pada tab Installed, /help mencantumkan skill-nya pada tab Custom commands, dan komponen yang gagal dimuat akan muncul pada tab Errors beserta alasannya.

Instalasi meminta scope, dan scope menentukan pengguna plugin tersebut. User scope berarti plugin tersedia untuk Anda pada setiap project. Project scope menulis plugin ke enabledPlugins di dalam .claude/settings.json repositori, sehingga setiap orang yang melakukan clone terhadap repositori tersebut akan ditawari plugin itu. Local scope berarti plugin tersedia untuk Anda hanya dalam repositori ini.

Untuk script, Dockerfile, atau sesi apa pun yang tidak menyediakan panel interaktif, gunakan format shell. Format ini menginstal plugin dengan user scope, kecuali Anda memberikan --scope.

claude plugin install commit-commands@claude-code-plugins --scope project
claude plugin list

claude plugin install berjalan di luar sesi. Karena itu, sesi yang sudah terbuka tidak akan melihat plugin baru sampai Anda menjalankan /reload-plugins atau memulai sesi baru.

Pola pengelolaan plugin yang sudah Anda miliki sama pada kedua tempat tersebut. /plugin list menampilkan plugin yang terinstal dan menerima --enabled atau --disabled. /plugin disable name@marketplace menonaktifkan plugin tanpa menghapusnya, /plugin enable mengaktifkannya kembali, dan /plugin uninstall menghapusnya. Format perintah slash membuka panel plugin untuk menerapkan perubahan. Karena itu, gunakan padanan shell claude plugin ... dalam script.

Untuk membagikan marketplace kepada seluruh tim, masukkan marketplace tersebut ke .claude/settings.json milik project. Anggota tim akan diminta menginstalnya setelah mereka mempercayai folder repositori.

{
  "extraKnownMarketplaces": {
    "my-team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}

Saat mengembangkan plugin sendiri, jangan gunakan marketplace. claude --plugin-dir ./my-plugin memuat sebuah direktori untuk sesi tersebut, /reload-plugins memuat perubahan Anda tanpa restart, dan claude plugin validate ./my-plugin memeriksa manifest, frontmatter skill dan agent, serta hooks/hooks.json sebelum plugin digunakan oleh orang lain.

Berapa biaya plugin Claude Code?

Mekanismenya gratis. Per Agustus 2026, tidak ada biaya untuk menambahkan marketplace, menginstal plugin, atau membiarkan plugin tetap aktif. Marketplace resmi dan komunitas merupakan repositori git publik, sedangkan plugin adalah direktori yang berisi file teks.

Biaya plugin dihitung dalam token. Token inilah yang sebenarnya diukur oleh penggunaan langganan atau tagihan API Anda. Biaya tersebut muncul dalam tiga cara, dan masing-masing berperilaku berbeda.

Biaya konteks tetap. Kontribusi plugin masuk ke konteks Anda dan dibaca ulang pada setiap giliran sesi. Sebelum menginstal, tampilan detail /plugin menampilkan perkiraan Context cost dalam token serta bagian Will install yang mencantumkan command, skill, agent, hook, dan server MCP serta LSP yang akan Anda tambahkan. Baca keduanya. Marketplace lokal atau marketplace khusus mungkin tidak menyediakan data tersebut. Dalam hal ini, Anda harus memperkirakannya secara manual. Plugin yang menyertakan server MCP biasanya paling berat karena definisi tool berukuran besar. Namun, pada model yang mendukung pencarian tool MCP, definisi tersebut ditunda sampai tool diperlukan.

Biaya pemanggilan. Menjalankan skill dari plugin menambahkan instruksinya ke percakapan. Karena itu, Anda hanya membayar isi skill saat skill tersebut digunakan. Agent berbeda. Subagent menjalankan percakapannya sendiri dengan system prompt dan cache sendiri, serta memulai tanpa cache hit. Karena itu, plugin yang alurnya membuat agent dapat berbiaya jauh lebih besar daripada yang ditunjukkan oleh perkiraan konteksnya.

Biaya cache. Mengaktifkan atau menonaktifkan plugin di tengah sesi dapat memaksa request berikutnya memproses ulang seluruh percakapan. Skill, command, agent, hook, server LSP, monitor, dan tema tidak pernah melakukan hal ini. Konten yang ditambahkannya ditempatkan setelah riwayat yang sudah ada, sehingga request berikutnya membayar konten baru dan tetap membaca seluruh konten sebelumnya dari cache. Pengecualiannya adalah plugin yang menyediakan server MCP. Jika tool-nya ditunda oleh pencarian tool, cache tetap bertahan. Jika tool tersebut dimuat ke prefix prompt, request berikutnya membaca ulang seluruh percakapan sebagai input yang belum di-cache. Karena alasan inilah /reload-plugins memberikan peringatan dan menolak tindakan tersebut sampai Anda meneruskan --force.

Anda dapat memantau hal ini, bukan sekadar memperkirakannya. Setiap respons API melaporkan cache_read_input_tokens dan cache_creation_input_tokens. Statusline khusus yang menampilkan penggunaan token secara langsung juga menampilkan keduanya. Sesi yang sehat membaca jauh lebih banyak daripada membuat token. Jika jumlah token yang dibuat tetap tinggi dari satu giliran ke giliran berikutnya, berarti ada sesuatu dalam prefix Anda yang berubah pada setiap giliran. Untuk melihat gambaran yang lebih luas tentang hal-hal yang memenuhi window, lihat cara mengelola window konteks Claude Code dan arti sebenarnya dari jumlah token tersebut.

Satu langkah pemeliharaan dapat menghemat biaya. Tab Installed mengelompokkan plugin yang tidak Anda gunakan setidaknya selama dua minggu di bawah header Not used recently, dengan baris Last used pada tampilan detail. Plugin tersebut tetap menghabiskan waktu startup dan konteks pada setiap sesi. Nonaktifkan atau hapus instalasinya.

Plugin berjalan dengan izin Anda

Dokumentasi Anthropic sendiri menjelaskannya secara tegas: plugin dan marketplace adalah komponen dengan tingkat kepercayaan tinggi yang dapat menjalankan kode arbitrer pada mesin Anda dengan hak akses pengguna Anda. Ini bukan risiko hipotetis. Hook plugin menjalankan perintah shell pada berbagai peristiwa sesi, termasuk sebelum dan sesudah pemanggilan tool. Direktori bin/ ditambahkan ke PATH milik Bash tool selama plugin diaktifkan. Server MCP-nya adalah proses yang dijalankan oleh plugin. Tidak ada bagian yang di-sandbox dari akun pengguna Anda.

Pada laptop, risiko ini dibatasi oleh hal-hal yang dapat diakses oleh pengguna desktop Anda. Pada server, biasanya tidak demikian. Akun yang menjalankan agent sering memiliki SSH key, deploy token, sesi cloud CLI, dan akses ke Docker socket. Karena itu, “kode arbitrer sebagai pengguna Anda” berarti akses ke mesin tersebut. Jika Claude Code berjalan pada VPS, baca cara menjalankan Claude Code dengan aman pada VPS sebelum memasang apa pun, dan baca cara menjaga kredensial agar tidak dapat dijangkau agent sebelum memasang plugin yang berkomunikasi dengan layanan eksternal.

Beberapa pembatasan memang tersedia, dan penting untuk memahami fungsinya. Plugin dengan cakupan proyek berasal dari repository, bukan dari Anda, sehingga plugin hanya dimuat setelah Anda mempercayai workspace. Server MCP-nya tetap memerlukan persetujuan per server. Server LSP-nya menunggu persetujuan tersebut, sedangkan monitor latar belakangnya tidak dimuat sama sekali. Agent yang dikirim bersama plugin tidak diizinkan mendeklarasikan hook, server MCP, atau mode izin. Plugin marketplace disalin ke cache, dan symlink yang mengarah ke luar marketplace akan dilewati. Dengan demikian, plugin tidak dapat mengambil file host arbitrer.

Semua itu tidak menggantikan pemeriksaan terhadap hal yang Anda pasang. Periksa daftar Will install, utamakan plugin yang source code-nya dapat Anda buka dan baca, simpan plugin tim Anda di repository marketplace yang Anda kendalikan, dan jalankan claude plugin validate pada apa pun yang Anda tulis sendiri.

FAQ

Apakah plugin Claude Code memerlukan biaya tambahan?

Tidak. Tidak ada biaya untuk sistem plugin, menambahkan marketplace, atau menginstal plugin. Biayanya berasal dari penggunaan token yang dibebankan ke paket atau pengeluaran API Anda, seperti konteks lainnya. Plugin menambahkan konteks tetap pada setiap giliran, menambahkan konteks lebih banyak saat salah satu skill atau agent-nya dipanggil, dan dapat memaksa satu giliran mahal yang tidak diambil dari cache jika menyediakan server MCP yang alatnya dimuat ke dalam awalan prompt. Tampilan detail /plugin menampilkan perkiraan Context cost sebelum Anda menginstalnya.

Apa perbedaan antara plugin dan skill?

Skill adalah satu unit instruksi. Plugin adalah paket yang dapat berisi skill, agent, hook, server MCP, server LSP, dan monitor, dengan nama, versi, serta marketplace sebagai sumber instalasinya. Tulis skill mandiri di .claude/ jika skill tersebut hanya ditujukan untuk Anda dan proyek ini. Skill dengan satu tujuan, seperti Ponytail, yang mengarahkan agent untuk membuat perubahan sekecil mungkin yang berfungsi, adalah contoh paling jelas: satu file dengan satu aturan di dalamnya, hingga suatu saat tim Anda juga membutuhkannya. Ubah skill tersebut menjadi plugin jika orang lain membutuhkannya dan skill itu perlu diperbarui seiring waktu. Skill dalam plugin menggunakan namespace, sehingga skill di dalam plugin dipanggil sebagai /plugin-name:skill-name, bukan /skill-name.

Plugin saya terinstal, tetapi skill-nya tidak muncul. Apa masalahnya?

Periksa ringkasan instalasi terlebih dahulu. Jika tertulis Run /reload-plugins to activate., komponennya belum dimuat, dan jika proses reload memperingatkan bahwa percakapan akan dibaca ulang, jalankan kembali dengan /reload-plugins --force. Jika komponen sudah dimuat tetapi tidak menampilkan apa pun, buka /plugin dan baca tab Errors. Kesalahan struktur yang paling umum adalah menempatkan skills/, agents/, atau hooks/ di dalam .claude-plugin/, karena Claude Code tidak mencarinya di sana. Ingat bahwa skill plugin menggunakan namespace, jadi Anda harus mencari /plugin-name:skill-name di tab Custom commands pada /help. Sebagai upaya terakhir, jalankan rm -rf ~/.claude/plugins/cache, mulai ulang, lalu instal ulang.

Dapatkah saya menginstal plugin tanpa panel interaktif?

Ya. Gunakan perintah shell claude plugin install name@marketplace, yang menginstal plugin dalam cakupan pengguna kecuali Anda memberikan --scope project atau --scope local. Perintah ini dapat digunakan dalam skrip, image, dan lingkungan noninteraktif ketika panel /plugin tidak tersedia. Karena perintah ini berjalan di luar sesi, sesi yang sudah terbuka memerlukan /reload-plugins sebelum plugin tersebut berlaku.

Apakah aman menginstal plugin dari marketplace yang saya temukan di GitHub?

Perlakukan proses tersebut seperti menjalankan skrip instalasi repositori itu sebagai pengguna Anda sendiri, karena pada dasarnya prosesnya hampir sama. Plugin dapat menjalankan perintah shell melalui hook, menambahkan executable ke PATH milik alat Bash, dan memulai server MCP, semuanya dengan hak akses pengguna Anda. Anthropic tidak mengendalikan atau memverifikasi isi plugin pihak ketiga. Instal plugin dari sumber yang dapat Anda baca, tinjau daftar Will install sebelum mengonfirmasi, dan terapkan pemeriksaan yang lebih ketat pada server daripada pada laptop, karena akun di server biasanya menyimpan key dan token yang berharga untuk dicuri.