Cara Membangun Plugin Claude Code: Panduan Langkah demi Langkah

Claude Code menangani sebagian besar tugas pengembangan secara default, tetapi setiap tim memiliki alur kerja spesifik yang tidak tercakup oleh setelan bawaan. Anda mungkin ingin perintah kustom yang membuat kerangka komponen sesuai struktur pilihan perusahaan, linting otomatis sebelum setiap commit, atau akses cepat ke dokumentasi untuk kerangka kerja yang sering Anda gunakan.

Plugin Claude Code memungkinkan Anda menambahkan fitur-fitur ini sendiri. Anda dapat memasang plugin buatan komunitas atau membuatnya sendiri.

Jika Anda baru mengenal alat pengodean agentik dari Anthropic, saya sarankan mulai dari Panduan Claude Code atau kursus Pengantar Claude Models. Tutorial ini mengasumsikan Anda telah memasang Claude Code dan pernah menggunakannya untuk tugas dasar.

Pada akhirnya, Anda akan mengetahui cara:

• Menemukan dan memasang plugin dari direktori Anthropic dan sumber komunitas
• Memahami tiga jenis komponen yang dapat dimuat plugin
• Memilih jenis yang tepat untuk berbagai kasus penggunaan
• Membangun dan membagikan plugin Anda sendiri

Untuk ringkasan kemampuan model terbaru Anthropic, lihat panduan kami tentang Claude Sonnet 4.6

Apa Itu Plugin Claude Code?

Plugin adalah paket yang membundel satu atau beberapa ekstensi Claude Code agar mudah dibagikan dan dipasang. Alih-alih menyalin berkas konfigurasi secara manual antar mesin atau rekan tim, Anda dapat membungkus semuanya ke dalam satu plugin dan mendistribusikannya sebagai satu kesatuan.

Plugin dapat memuat tiga jenis komponen:

• Skills: Perintah kustom yang Anda panggil dengan /skill-name, atau prompt kontekstual yang digunakan Claude secara otomatis saat relevan
• Server MCP: Koneksi ke layanan eksternal dan API yang memberi Claude akses ke data yang sebaliknya tidak tersedia
• Hooks: Skrip shell yang berjalan otomatis pada peristiwa tertentu, seperti sebelum berkas diedit atau setelah commit

Sebuah plugin bisa berisi salah satu dari ini saja, atau menggabungkan beberapa yang bekerja bersama. Plugin "deployment" dapat mencakup skill /deploy untuk deployment manual, server MCP yang memeriksa status lingkungan staging Anda, dan hook yang menjalankan pengujian sebelum perintah deployment apa pun dieksekusi.

Berkas manifes plugin.json mendefinisikan isi plugin. Berkas ini menentukan skill, server MCP, dan hook mana yang dipasang, beserta metadata seperti nama plugin, versi, dan penulis. Saat Anda memasang plugin, Claude Code membaca manifes ini dan menyiapkan setiap komponen di lokasi yang tepat.

Format pengemasan ini berarti Anda tidak perlu memahami struktur berkas internal ekstensi Claude Code. Anda cukup memasang plugin, dan semuanya ditempatkan sebagaimana mestinya.

Menemukan dan Memasang Plugin Claude Code

Sebagian besar plugin berada di dua tempat. Direktori resmi Anthropic di plugins.claude.ai memuat plugin buatan Anthropic, kontribusi komunitas yang terverifikasi, dan ekstensi pihak ketiga populer. Setiap listing menampilkan komponen yang disertakan plugin, informasi kompatibilitas, dan instruksi pemasangan.

Sumber kedua adalah GitHub. Repositori awesome-claude-code merawat daftar kurasi yang diorganisasi per kategori, dan pengembang individual menerbitkan plugin di repositori mereka sendiri.

Setelah Anda menemukan plugin yang diinginkan, perintah pemasangannya bergantung pada tempat plugin tersebut berada:

# From the official directory
claude plugin add @anthropic/deploy-helper
 
# From a GitHub repository
claude plugin add github:username/repo-name
 
# From a local directory (useful during development)
claude plugin add ./my-plugin

Setelah memasang beberapa plugin, Anda akan ingin melacaknya. Perintah plugin menangani listing, pembaruan, dan penghapusan:

# List all installed plugins
claude plugin list
 
# Update a specific plugin to the latest version
claude plugin update @anthropic/deploy-helper
 
# Update all plugins
claude plugin update --all
 
# Remove a plugin
claude plugin remove @anthropic/deploy-helper

Salah satu keputusan yang akan Anda buat saat pemasangan adalah cakupannya. Plugin dapat berada di dua tempat: cakupan pengguna dipasang ke ~/.claude/plugins/ dan bekerja di semua proyek Anda, sedangkan cakupan proyek dipasang ke .claude/plugins/ dalam repositori tertentu.

Default-nya adalah cakupan pengguna. Untuk memasang plugin hanya untuk proyek saat ini, tambahkan flag --project:

claude plugin add @anthropic/deploy-helper --project

Plugin bercakupan proyek masuk akal ketika ekstensi terikat pada basis kode tertentu. 

Plugin yang mengetahui proses deployment perusahaan Anda sebaiknya berada di proyek tersebut. Plugin yang memformat kode sesuai preferensi pribadi Anda sebaiknya berada di tingkat pengguna. Ketika plugin ada pada kedua cakupan, versi proyek memiliki prioritas, memungkinkan tim menegakkan konfigurasi khusus proyek sementara pengembang tetap mempertahankan plugin pribadi mereka aktif di tempat lain.

Memilih Jenis Plugin Claude Code yang Tepat

Ketiga jenis komponen memiliki tujuan berbeda dan mengonsumsi sumber daya dengan cara yang berbeda. Memahami trade-off ini menjaga jendela konteks Anda tetap sehat dan membantu Anda mengambil alat yang tepat untuk setiap pekerjaan.

Skills vs server MCP: pertukaran token

Server MCP memuat awal setiap definisi tool ke jendela konteks saat sesi dimulai. Setiap tool memerlukan nama, deskripsi, dan skema parameter lengkap, yang biasanya sekitar 100–300 token per tool. Penyiapan lima server menghabiskan sekitar 55.000 token sebelum Anda mengetik satu karakter pun:

• GitHub: 35 tool
•  Slack: 11 tool
• Sentry: 5 tool
• Grafana: 5 tool
• Splunk: 2 tool

Satu analisis menemukan penyiapan dengan 7+ server mengonsumsi 67.000+ token, yang berarti sepertiga dari jendela konteks 200K Anda habis sebelum percakapan dimulai.

Skills mengambil pendekatan berbeda melalui pengungkapan progresif. Saat sesi dimulai, Claude hanya melihat nama setiap skill dan satu baris deskripsi dari frontmatter YAML, sekitar 100 token per skill. 

Instruksi lengkap baru dimuat ketika Claude menentukan skill tersebut relevan untuk tugas saat ini. Berkas referensi hanya dimuat saat benar-benar diperlukan. Dan skrip tidak pernah masuk ke jendela konteks; Claude menjalankannya secara eksternal, dan hanya keluarannya yang kembali.

Anthropic mengatasi ketidakseimbangan ini pada akhir 2025 dengan Tool Search, fitur yang menghadirkan lazy loading ke server MCP. 

Alih-alih memuat awal semua definisi tool, Claude Code kini mendeteksi ketika deskripsi tool akan mengonsumsi lebih dari 10% konteks yang tersedia dan beralih ke pemuatan sesuai permintaan. 

Pengujian internal menunjukkan penggunaan konteks turun dari ~134.000 token menjadi ~5.000 token untuk pustaka tool yang besar. Akurasi pemilihan tool juga meningkat, dengan Opus 4 naik dari 49% menjadi 74% dan Opus 4.5 dari 79,5% menjadi 88,1% pada evaluasi MCP.

Jadi kapan sebaiknya Anda menggunakan masing-masing?

Skills paling cocok ketika Anda ingin Claude memiliki akses ke pengetahuan atau alur kerja yang dapat diterapkannya dengan pertimbangan. Sebuah skill yang mendeskripsikan daftar periksa code review tim Anda akan dimuat saat Claude meninjau kode, tetapi Claude tetap memutuskan bagaimana menerapkan setiap butir berdasarkan konteks. 

Skills juga masuk akal untuk operasi yang memerlukan skrip untuk komputasi berat, karena kode skrip tetap berada di luar jendela konteks.

Server MCP paling cocok ketika Claude memerlukan data waktu nyata dari layanan eksternal seperti pesan Slack, PR GitHub, atau kueri basis data. Ini juga pilihan tepat ketika banyak agen AI membutuhkan tool yang sama, atau ketika Anda memerlukan fitur enterprise seperti audit log dan izin eksplisit.

Banyak penyiapan menggabungkan keduanya: skills menyediakan "cara" dan "kapan" melalui instruksi berbahasa natural, sementara server MCP menangani panggilan API yang sebenarnya.

Skill Claude Code populer yang layak dipasang

• Superpowers: 20+ alur kerja teruji produksi untuk TDD, debugging, dan perencanaan terstruktur
• frontend-design: Mengarahkan Claude untuk menghindari estetika generik dan membuat keputusan desain yang berani
• mcp-builder: Panduan membuat server MCP untuk mengintegrasikan API eksternal
•  webapp-testing: Menguji aplikasi web lokal menggunakan Playwright untuk verifikasi UI
•  skill-creator: Alat interaktif yang memandu Anda membangun skill baru

Server MCP populer yang layak dihubungkan

• Context7: Pencarian dokumentasi real-time spesifik versi
• GitHub: Pencarian repositori, manajemen PR, pelacakan isu
• Playwright: Otomatisasi browser menggunakan accessibility tree alih-alih tangkapan layar
• Supabase: Kueri basis data dengan kesadaran Row Level Security
• Sentry: Pelacakan error dan pemantauan performa langsung di editor Anda

Anda juga dapat membaca panduan kami tentang server MCP remote teratas.

Hooks: Lapisan yang deterministik

Hooks sama sekali berada di luar perdebatan skills versus MCP. Sementara skills dan server MCP menghadap ke Claude (Claude memutuskan kapan menggunakannya), hooks menghadap ke sistem. Hooks dipicu pada peristiwa seperti PreToolUse atau PostToolUse, menjalankan skrip shell sebelum atau sesudah Claude mengambil tindakan tertentu. Claude tidak punya andil apakah sebuah hook berjalan.

Ini menjadikan Hooks pilihan tepat ketika sesuatu harus terjadi tanpa pengecualian: linting sebelum setiap commit, memblokir penulisan ke direktori terlindungi, mencatat setiap perintah bash, atau menjalankan pengujian sebelum deployment apa pun.

Pengembang ini merekomendasikan hook "block-at-submit" dibanding "block-at-write". Memblokir Claude di tengah tugas akan membingungkan agen dan menghasilkan hasil yang lebih buruk. Timnya menggunakan hook PreToolUse yang membungkus Bash(git commit) dan memeriksa berkas sementara yang hanya ada jika pengujian lulus. Tidak ada berkas, tidak ada commit. Agen menyelesaikan pekerjaannya, lalu validasi terjadi di akhir.

Hooks tidak menambah beban token karena berjalan sebagai skrip shell di luar jendela konteks.

Hook Claude yang berguna untuk disiapkan

• ESLint/Prettier saat edit: Memformat berkas otomatis setelah Claude menulisnya
• Gerbang pengujian saat commit: Memblokir commit kecuali pengujian lulus
• Path terlindungi: Mencegah penulisan ke direktori migrations, configs, atau vendor
• Notifikasi saat selesai: Mengirim peringatan Slack atau desktop saat tugas panjang selesai
• Cadangan transkrip: Menyimpan riwayat percakapan sebelum kompaksi berjalan

Cara Membangun Plugin Claude Code Anda Sendiri

Saat sebuah skill berada di direktori pribadi .claude/ Anda, hanya Anda yang dapat menggunakannya. Mengemasnya sebagai plugin memungkinkan Anda membagikannya kepada rekan tim atau menggunakannya kembali di berbagai proyek.

Kita akan membangun plugin bernama session-logger yang menambahkan perintah /session-logger:summarize. Saat dipanggil, Claude meninjau percakapan dan menambahkan ringkasan terstruktur ke SESSION_LOG.md.

Buat struktur plugin

Plugin dapat ditempatkan di mana saja pada sistem berkas Anda. Untuk tutorial ini, kita akan membuatnya di direktori home Anda:

cd ~
mkdir -p session-logger/.claude-plugin
mkdir -p session-logger/skills/summarize

Ini akan membuat:

~/session-logger/
├── .claude-plugin/
│   └── plugin.json  	# manifest goes here, nowhere else
└── skills/
	└── summarize/   	# folder name becomes the command name
    	└── SKILL.md 	# must be named exactly this

Tulis manifes

Buat ~/session-logger/.claude-plugin/plugin.json:

{
  "name": "session-logger",
  "description": "Log session summaries to a markdown file",
  "version": "1.0.0"
}

Kolom name menjadi prefiks namespace. Semua perintah di plugin ini akan diawali dengan /session-logger:.

Tulis skill

Buat ~/session-logger/skills/summarize/SKILL.md:

---
description: Log a summary of the current session to SESSION_LOG.md
disable-model-invocation: true
---
 
When invoked, review the conversation and create a summary with these sections:
 
- **Date/time**: Current timestamp
- **Tasks completed**: What was accomplished
- **Files modified**: List of files created or changed
- **Decisions made**: Architectural or implementation choices
- **Open questions**: Unresolved items for future sessions
 
Append the summary to SESSION_LOG.md in the project root. Create the file if it doesn't exist.

Baris disable-model-invocation: true memberi tahu Claude bahwa hanya Anda yang dapat memicu skill ini. Tanpa flag ini, Claude mungkin memutuskan menjalankan perintah secara mandiri jika dianggap membantu percakapan. Untuk logger atau alat deployment, Anda biasanya menginginkan kendali manual.

Uji secara lokal

Navigasikan ke proyek mana pun tempat Anda ingin menggunakan plugin, lalu jalankan Claude Code dengan flag --plugin-dir yang mengarah ke plugin Anda:

cd ~/your-project
claude --plugin-dir ~/session-logger

Ketik /session-logger:summarize untuk memanggil perintah. Perhatikan bahwa perintah plugin tidak muncul di saran autocomplete hingga Anda mengetikkan nama lengkapnya. Teks akan berubah menjadi biru setelah Claude Code mengenalinya sebagai perintah yang valid.

Setelah melakukan beberapa pekerjaan dalam sesi, jalankan perintah tersebut. Claude meninjau percakapan dan menambahkan entri ke SESSION_LOG.md di direktori proyek Anda saat ini.

Bagikan kepada orang lain

Push plugin Anda ke GitHub. Untuk mendistribusikannya melampaui cloning manual, tambahkan ke marketplace plugin. Panduan marketplace membahas cara membuat marketplace sendiri atau mengajukannya ke marketplace yang sudah ada.

Kesimpulan

Plugin mengubah Claude Code dari asisten serbaguna menjadi sesuatu yang dibentuk untuk alur kerja spesifik Anda. Session logger yang kita bangun memakan waktu sekitar lima menit dan tiga berkas. Sebagian besar plugin yang berguna tidak jauh lebih rumit dari itu.

Jika Anda mengikuti langkah-langkahnya, kini Anda memiliki plugin yang berfungsi di mesin Anda. Coba modifikasi. Ubah format ringkasannya, tambahkan bagian baru, atau ganti dengan sesuatu yang benar-benar dibutuhkan tim Anda. Strukturnya tetap sama baik Anda membangun alat pribadi cepat maupun sesuatu yang akan didistribusikan ke ratusan pengembang.

Jelajahi repositori komunitas saat ada kesempatan. Melihat bagaimana orang lain menyusun plugin mereka mengajarkan pola yang tidak selalu bisa ditangkap dokumentasi. Dan ketika Anda membangun sesuatu yang berguna, publikasikan. Ekosistem tumbuh satu plugin bersama pada satu waktu.