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

​
Mulai Cepat

Mari kita buat plugin sapaan sederhana untuk membiasakan Anda dengan sistem plugin. Kami akan membangun plugin yang berfungsi yang menambahkan perintah khusus, mengujinya secara lokal, dan memahami konsep inti.

​
Prasyarat

  • Claude Code terinstal di mesin Anda
  • Keakraban dasar dengan alat baris perintah

​
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

Buat .claude-plugin/plugin.json
mkdir .claude-plugin
cat > .claude-plugin/plugin.json << 'EOF'
{
"name": "my-first-plugin",
"description": "A simple greeting plugin to learn the basics",
"version": "1.0.0",
"author": {
"name": "Your Name"
}
}
EOF
4

Tambahkan perintah khusus

Buat commands/hello.md
mkdir commands
cat > commands/hello.md << 'EOF'
---
description: Greet the user with a personalized message
---

# Hello Command

Greet the user warmly and ask how you can help them today. Make the greeting personal and encouraging.
EOF
5

Buat manifest marketplace

Buat 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": "My first test plugin"
}
]
}
EOF
6

Instal dan uji plugin Anda

Mulai Claude Code dari direktori induk
cd ..
claude
Tambahkan marketplace pengujian
/plugin marketplace add ./test-marketplace
Instal plugin Anda
/plugin install my-first-plugin@test-marketplace
Pilih “Install now”. Anda kemudian perlu memulai ulang Claude Code untuk menggunakan plugin baru.
Coba perintah baru Anda
/hello
Anda akan melihat Claude menggunakan perintah sapaan Anda! Periksa /help untuk melihat perintah baru Anda terdaftar.
Anda telah berhasil membuat dan menguji plugin dengan komponen kunci berikut:
  • Manifest plugin (.claude-plugin/plugin.json) - Menjelaskan metadata plugin Anda
  • Direktori perintah (commands/) - Berisi perintah garis miring khusus Anda
  • Marketplace pengujian - Memungkinkan Anda menguji plugin Anda secara lokal

​
Ikhtisar struktur plugin

Plugin Anda mengikuti struktur dasar ini: 
my-first-plugin/
├── .claude-plugin/
│   └── plugin.json          # Plugin metadata
├── commands/                 # Custom slash commands (optional)
│   └── hello.md
├── agents/                   # Custom agents (optional)
│   └── helper.md
├── skills/                   # Agent Skills (optional)
│   └── my-skill/
│       └── SKILL.md
└── hooks/                    # Event handlers (optional)
    └── hooks.json
Komponen tambahan yang dapat Anda tambahkan:
  • Perintah: Buat file markdown di direktori commands/
  • Agen: Buat definisi agen di direktori agents/
  • Skills: Buat file SKILL.md di direktori skills/
  • Hook: Buat hooks/hooks.json untuk penanganan acara
  • Server MCP: Buat .mcp.json untuk integrasi alat eksternal
Langkah berikutnya: 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 baris perintah

​
Tambahkan marketplace

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

​
Instal plugin

​
Melalui menu interaktif (direkomendasikan untuk penemuan)

Buka antarmuka manajemen plugin
/plugin
Pilih “Browse Plugins” untuk melihat opsi yang tersedia dengan deskripsi, fitur, dan opsi instalasi.

​
Melalui perintah langsung (untuk instalasi cepat)

Instal plugin tertentu
/plugin install formatter@your-org
Aktifkan plugin yang dinonaktifkan
/plugin enable plugin-name@marketplace-name
Nonaktifkan tanpa mencopot
/plugin disable plugin-name@marketplace-name
Hapus plugin sepenuhnya
/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

​
Atur 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 mengatur plugin tim:
  1. Tambahkan konfigurasi marketplace dan plugin ke .claude/settings.json repositori Anda
  2. Anggota tim mempercayai folder repositori
  3. Plugin menginstal secara otomatis untuk semua anggota tim
Untuk instruksi lengkap termasuk contoh konfigurasi, pengaturan marketplace, dan praktik terbaik peluncuran, lihat Konfigurasikan marketplace tim.

​
Kembangkan plugin yang lebih kompleks

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

​
Tambahkan Skills ke plugin Anda

Plugin dapat menyertakan Agent Skills untuk memperluas kemampuan Claude. Skills dipanggil model—Claude secara otonom menggunakannya berdasarkan konteks tugas. Untuk menambahkan Skills ke plugin Anda, buat direktori skills/ di akar plugin Anda dan tambahkan folder Skill dengan file SKILL.md. Plugin Skills secara otomatis tersedia ketika plugin diinstal. Untuk panduan penulisan Skill lengkap, lihat Agent Skills.

​
Atur plugin kompleks

Untuk plugin dengan banyak komponen, atur 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 berulang. Alur kerja ini dibangun di atas pola mulai cepat dan bekerja untuk plugin dengan kompleksitas apa pun.
1

Atur struktur pengembangan Anda

Atur plugin dan marketplace Anda untuk pengujian:
Buat struktur direktori
mkdir dev-marketplace
cd dev-marketplace
mkdir my-plugin
Ini membuat:
dev-marketplace/
├── .claude-plugin/marketplace.json  (you'll create this)
└── my-plugin/                        (your plugin under development)
    ├── .claude-plugin/plugin.json
    ├── commands/
    ├── agents/
    └── hooks/
2

Buat manifest marketplace

Buat 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 under development"
}
]
}
EOF
3

Instal dan uji

Mulai Claude Code dari direktori induk
cd ..
claude
Tambahkan marketplace pengembangan Anda
/plugin marketplace add ./dev-marketplace
Instal plugin Anda
/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

Ulangi pada plugin Anda

Setelah membuat perubahan pada kode plugin Anda:
Copot versi saat ini
/plugin uninstall my-plugin@dev-marketplace
Instal ulang untuk menguji perubahan
/plugin install my-plugin@dev-marketplace
Ulangi siklus ini saat Anda mengembangkan dan menyempurnakan plugin Anda.
Untuk beberapa plugin: Atur plugin di subdirektori seperti ./plugins/plugin-name dan perbarui marketplace.json Anda sesuai kebutuhan. Lihat Sumber plugin untuk pola organisasi.

​
Debug masalah plugin

Jika plugin Anda tidak berfungsi seperti yang diharapkan:
  1. Periksa struktur: Pastikan direktori Anda berada di akar 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 versioning semantik di plugin.json Anda
  3. Buat atau gunakan marketplace: Distribusikan melalui marketplace plugin untuk instalasi yang mudah
  4. Uji dengan orang lain: Biarkan anggota tim menguji plugin sebelum distribusi yang lebih luas
Untuk spesifikasi teknis lengkap, teknik debugging, dan strategi distribusi, lihat Referensi Plugin.

​
Langkah berikutnya

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

​
Untuk pengguna plugin

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

​
Untuk pengembang plugin

  • Buat marketplace pertama Anda: Panduan marketplace plugin
  • Komponen lanjutan: Selami lebih dalam ke komponen plugin tertentu:
  • Strategi distribusi: Paket dan bagikan plugin Anda secara efektif
  • Kontribusi komunitas: Pertimbangkan untuk berkontribusi pada koleksi plugin komunitas

​
Untuk pemimpin tim dan administrator

  • Konfigurasi repositori: Atur 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