Untuk spesifikasi teknis lengkap dan skema, lihat Referensi plugin. Untuk manajemen marketplace, lihat Marketplace plugin.
Plugin memungkinkan Anda memperluas Claude Code dengan fungsionalitas kustom yang dapat dibagikan di seluruh proyek dan tim. Instal plugin dari marketplace untuk menambahkan perintah, agen, hook, dan server MCP yang sudah dibuat sebelumnya, atau buat sendiri untuk mengotomatisasi alur kerja Anda.

​
Mulai Cepat

Mari buat plugin salam sederhana untuk membiasakan Anda dengan sistem plugin. Kita akan membangun plugin yang berfungsi yang menambahkan perintah kustom, mengujinya secara lokal, dan memahami konsep inti.

​
Prasyarat

  • Claude Code terinstal di mesin Anda
  • Keakraban dasar dengan alat command-line

​
Buat plugin pertama Anda

1

Buat struktur marketplace

mkdir test-marketplace
cd test-marketplace
2

Buat direktori plugin

mkdir my-first-plugin
cd my-first-plugin
3

Buat manifest plugin

Create .claude-plugin/plugin.json
mkdir .claude-plugin
cat > .claude-plugin/plugin.json << 'EOF'
{
"name": "my-first-plugin",
"description": "Plugin salam sederhana untuk mempelajari dasar-dasar",
"version": "1.0.0",
"author": {
"name": "Nama Anda"
}
}
EOF
4

Tambahkan perintah kustom

Create commands/hello.md
mkdir commands
cat > commands/hello.md << 'EOF'
---
description: Sapa pengguna dengan pesan yang dipersonalisasi
---

# Perintah Hello

Sapa pengguna dengan hangat dan tanyakan bagaimana Anda dapat membantu mereka hari ini. Buat sapaan yang personal dan mendorong.
EOF
5

Buat manifest marketplace

Create marketplace.json
cd ..
mkdir .claude-plugin
cat > .claude-plugin/marketplace.json << 'EOF'
{
"name": "test-marketplace",
"owner": {
"name": "Test User"
},
"plugins": [
{
  "name": "my-first-plugin",
  "source": "./my-first-plugin",
  "description": "Plugin tes pertama saya"
}
]
}
EOF
6

Instal dan uji plugin Anda

Start Claude Code from parent directory
cd ..
claude
Add the test marketplace
/plugin marketplace add ./test-marketplace
Install your plugin
/plugin install my-first-plugin@test-marketplace
Pilih “Install now”. Anda kemudian perlu me-restart Claude Code untuk menggunakan plugin baru.
Try your new command
/hello
Anda akan melihat Claude menggunakan perintah salam Anda! Periksa /help untuk melihat perintah baru Anda terdaftar.
Anda telah berhasil membuat dan menguji plugin dengan komponen kunci ini:
  • Manifest plugin (.claude-plugin/plugin.json) - Menjelaskan metadata plugin Anda
  • Direktori perintah (commands/) - Berisi perintah slash kustom Anda
  • Marketplace tes - Memungkinkan Anda menguji plugin secara lokal

​
Gambaran struktur plugin

Plugin Anda mengikuti struktur dasar ini: 
my-first-plugin/
├── .claude-plugin/
│   └── plugin.json          # Metadata plugin
├── commands/                 # Perintah slash kustom (opsional)
│   └── hello.md
├── agents/                   # Agen kustom (opsional)
│   └── helper.md
└── hooks/                    # Penangan event (opsional)
    └── hooks.json
Komponen tambahan yang dapat Anda tambahkan:
  • Perintah: Buat file markdown di direktori commands/
  • Agen: Buat definisi agen di direktori agents/
  • Hook: Buat hooks/hooks.json untuk penanganan event
  • Server MCP: Buat .mcp.json untuk integrasi alat eksternal
Langkah selanjutnya: Siap menambahkan lebih banyak fitur? Lompat ke Kembangkan plugin yang lebih kompleks untuk menambahkan agen, hook, dan server MCP. Untuk spesifikasi teknis lengkap dari semua komponen plugin, lihat Referensi plugin.

​
Instal dan kelola plugin

Pelajari cara menemukan, menginstal, dan mengelola plugin untuk memperluas kemampuan Claude Code Anda.

​
Prasyarat

  • Claude Code terinstal dan berjalan
  • Keakraban dasar dengan antarmuka command-line

​
Tambahkan marketplace

Marketplace adalah katalog plugin yang tersedia. Tambahkan mereka untuk menemukan dan menginstal plugin:
Add a marketplace
/plugin marketplace add your-org/claude-plugins
Browse available plugins
/plugin
Untuk manajemen marketplace terperinci termasuk repositori Git, pengembangan lokal, dan distribusi tim, lihat Marketplace plugin.

​
Instal plugin

​
Melalui menu interaktif (direkomendasikan untuk penemuan)

Open the plugin management interface
/plugin
Pilih “Browse Plugins” untuk melihat opsi yang tersedia dengan deskripsi, fitur, dan opsi instalasi.

​
Melalui perintah langsung (untuk instalasi cepat)

Install a specific plugin
/plugin install formatter@your-org
Enable a disabled plugin
/plugin enable plugin-name@marketplace-name
Disable without uninstalling
/plugin disable plugin-name@marketplace-name
Completely remove a plugin
/plugin uninstall plugin-name@marketplace-name

​
Verifikasi instalasi

Setelah menginstal plugin:
  1. Periksa perintah yang tersedia: Jalankan /help untuk melihat perintah baru
  2. Uji fitur plugin: Coba perintah dan fitur plugin
  3. Tinjau detail plugin: Gunakan /plugin → “Manage Plugins” untuk melihat apa yang disediakan plugin

​
Siapkan alur kerja plugin tim

Konfigurasikan plugin di tingkat repositori untuk memastikan alat yang konsisten di seluruh tim Anda. Ketika anggota tim mempercayai folder repositori Anda, Claude Code secara otomatis menginstal marketplace dan plugin yang ditentukan. Untuk menyiapkan plugin tim:
  1. Tambahkan konfigurasi marketplace dan plugin ke .claude/settings.json repositori Anda
  2. Anggota tim mempercayai folder repositori
  3. Plugin terinstal secara otomatis untuk semua anggota tim
Untuk instruksi lengkap termasuk contoh konfigurasi, pengaturan marketplace, dan praktik terbaik rollout, lihat Konfigurasikan marketplace tim.

​
Kembangkan plugin yang lebih kompleks

Setelah Anda nyaman dengan plugin dasar, Anda dapat membuat ekstensi yang lebih canggih.

​
Organisasi plugin kompleks

Untuk plugin dengan banyak komponen, organisasikan struktur direktori Anda berdasarkan fungsionalitas. Untuk tata letak direktori lengkap dan pola organisasi, lihat Struktur direktori plugin.

​
Uji plugin Anda secara lokal

Saat mengembangkan plugin, gunakan marketplace lokal untuk menguji perubahan secara iteratif. Alur kerja ini dibangun berdasarkan pola mulai cepat dan bekerja untuk plugin dengan kompleksitas apa pun.
1

Siapkan struktur pengembangan Anda

Organisasikan plugin dan marketplace Anda untuk pengujian:
Create directory structure
mkdir dev-marketplace
cd dev-marketplace
mkdir my-plugin
Ini membuat:
dev-marketplace/
├── .claude-plugin/marketplace.json  (akan Anda buat)
└── my-plugin/                        (plugin Anda yang sedang dikembangkan)
    ├── .claude-plugin/plugin.json
    ├── commands/
    ├── agents/
    └── hooks/
2

Buat manifest marketplace

Create marketplace.json
mkdir .claude-plugin
cat > .claude-plugin/marketplace.json << 'EOF'
{
"name": "dev-marketplace",
"owner": {
"name": "Developer"
},
"plugins": [
{
  "name": "my-plugin",
  "source": "./my-plugin",
  "description": "Plugin yang sedang dikembangkan"
}
]
}
EOF
3

Instal dan uji

Start Claude Code from parent directory
cd ..
claude
Add your development marketplace
/plugin marketplace add ./dev-marketplace
Install your plugin
/plugin install my-plugin@dev-marketplace
Uji komponen plugin Anda:
  • Coba perintah Anda dengan /command-name
  • Periksa bahwa agen muncul di /agents
  • Verifikasi hook bekerja seperti yang diharapkan
4

Iterasi pada plugin Anda

Setelah membuat perubahan pada kode plugin Anda:
Uninstall the current version
/plugin uninstall my-plugin@dev-marketplace
Reinstall to test changes
/plugin install my-plugin@dev-marketplace
Ulangi siklus ini saat Anda mengembangkan dan menyempurnakan plugin Anda.
Untuk beberapa plugin: Organisasikan plugin dalam subdirektori seperti ./plugins/plugin-name dan perbarui marketplace.json Anda sesuai. Lihat Sumber plugin untuk pola organisasi.

​
Debug masalah plugin

Jika plugin Anda tidak bekerja seperti yang diharapkan:
  1. Periksa strukturnya: Pastikan direktori Anda berada di root plugin, bukan di dalam .claude-plugin/
  2. Uji komponen secara individual: Periksa setiap perintah, agen, dan hook secara terpisah
  3. Gunakan alat validasi dan debugging: Lihat Alat debugging dan pengembangan untuk perintah CLI dan teknik pemecahan masalah

​
Bagikan plugin Anda

Ketika plugin Anda siap untuk dibagikan:
  1. Tambahkan dokumentasi: Sertakan README.md dengan instruksi instalasi dan penggunaan
  2. Versi plugin Anda: Gunakan semantic versioning di plugin.json Anda
  3. Buat atau gunakan marketplace: Distribusikan melalui marketplace plugin untuk instalasi yang mudah
  4. Uji dengan orang lain: Minta anggota tim menguji plugin sebelum distribusi yang lebih luas
Untuk spesifikasi teknis lengkap, teknik debugging, dan strategi distribusi, lihat Referensi plugin.

​
Langkah selanjutnya

Sekarang setelah Anda memahami sistem plugin Claude Code, berikut adalah jalur yang disarankan untuk tujuan yang berbeda:

​
Untuk pengguna plugin

  • Temukan plugin: Jelajahi marketplace komunitas untuk alat yang berguna
  • Adopsi tim: Siapkan plugin tingkat repositori untuk proyek Anda
  • Manajemen marketplace: Pelajari cara mengelola beberapa sumber plugin
  • Penggunaan lanjutan: Jelajahi kombinasi plugin dan alur kerja

​
Untuk pengembang plugin

  • Buat marketplace pertama Anda: Panduan marketplace plugin
  • Komponen lanjutan: Pelajari lebih dalam komponen plugin spesifik:
    • Perintah slash - Detail pengembangan perintah
    • Subagen - Konfigurasi dan kemampuan agen
    • Hook - Penanganan event dan otomatisasi
    • MCP - Integrasi alat eksternal
  • Strategi distribusi: Paket dan bagikan plugin Anda secara efektif
  • Kontribusi komunitas: Pertimbangkan berkontribusi pada koleksi plugin komunitas

​
Untuk pemimpin tim dan administrator

  • Konfigurasi repositori: Siapkan instalasi plugin otomatis untuk proyek tim
  • Tata kelola plugin: Tetapkan pedoman untuk persetujuan plugin dan tinjauan keamanan
  • Pemeliharaan marketplace: Buat dan pertahankan katalog plugin khusus organisasi
  • Pelatihan dan dokumentasi: Bantu anggota tim mengadopsi alur kerja plugin secara efektif

​
Lihat juga

  • Marketplace plugin - Membuat dan mengelola katalog plugin
  • Perintah slash - Memahami perintah kustom
  • Subagen - Membuat dan menggunakan agen khusus
  • Hook - Mengotomatisasi alur kerja dengan penangan event
  • MCP - Menghubungkan ke alat dan layanan eksternal
  • Pengaturan - Opsi konfigurasi untuk plugin