- Skills: kemampuan yang Claude panggil secara otonom ketika relevan. Anda juga dapat menjalankan plugin skill secara langsung dengan
/plugin-name:skill-name. - Agents: subagen khusus untuk tugas-tugas tertentu
- Hooks: penanganan peristiwa yang merespons penggunaan alat dan peristiwa lainnya
- MCP servers: integrasi alat eksternal melalui Model Context Protocol
Memuat plugins
Muat plugins dengan menyediakan jalur sistem file lokal mereka dalam konfigurasi opsi Anda. Bidangtype harus "local", satu-satunya nilai yang diterima SDK. SDK mendukung pemuatan beberapa plugins dari lokasi berbeda.
Untuk menggunakan plugin yang didistribusikan melalui marketplace atau repositori jarak jauh, unduh terlebih dahulu dan sediakan jalur direktori lokal. Untuk tata letak direktori yang dibutuhkan plugin, lihat referensi struktur Plugin di bawah.
Spesifikasi jalur
Jalur plugin dapat berupa:- Jalur relatif: diselesaikan relatif terhadap opsi
cwd(misalnya,"./plugins/my-plugin") - Jalur absolut: jalur sistem file lengkap (misalnya,
"/home/user/plugins/my-plugin")
Jalur harus menunjuk ke direktori root plugin: induk dari
skills/, agents/, hooks/, commands/, atau .claude-plugin/.Memverifikasi instalasi plugin
Ketika plugins dimuat dengan berhasil, mereka muncul dalam pesan inisialisasi sistem. Anda dapat memverifikasi bahwa plugins Anda tersedia:Menggunakan plugin skills
Skills dari plugins secara otomatis diberi namespace dengan nama plugin untuk menghindari konflik. Untuk menjalankan satu secara langsung, kirimkan/plugin-name:skill-name sebagai prompt.
Jika Anda menginstal plugin melalui CLI (misalnya,
/plugin install my-plugin@marketplace), Anda masih dapat menggunakannya di SDK dengan menyediakan jalur instalasinya. Periksa ~/.claude/plugins/ untuk plugins yang diinstal CLI.Contoh lengkap
Berikut adalah contoh lengkap yang mendemonstrasikan pemuatan dan penggunaan plugin:Referensi struktur plugin
Direktori plugin biasanya berisi file manifest.claude-plugin/plugin.json. Manifest bersifat opsional. Ketika dihilangkan, Claude Code secara otomatis menemukan komponen dari tata letak direktori. Direktori dapat mencakup:
Direktori
commands/ menyimpan skills sebagai file Markdown datar. Gunakan skills/ untuk plugin baru. Claude Code mendukung kedua lokasi.Sumber plugin ganda
Gabungkan plugins dari lokasi berbeda:SDK tidak memperluas jalur tilde seperti
~/plugins. Jika jalur plugin tidak ada, SDK melewati plugin tersebut dan sesi berlanjut, jadi periksa daftar plugins dalam pesan init untuk mengonfirmasi setiap plugin dimuat.Troubleshooting
Plugin tidak dimuat
Jika plugin Anda tidak muncul dalam pesan init:- Periksa jalurnya: pastikan jalur menunjuk ke direktori root plugin, induk dari
skills/,agents/,hooks/,commands/, atau.claude-plugin/ - Validasi plugin.json: jika plugin Anda menyertakan manifest, pastikan memiliki sintaks JSON yang valid
- Periksa izin file: pastikan direktori plugin dapat dibaca
- Konfirmasi direktori ada: SDK melewati jalur yang tidak ada, dan plugin tidak muncul dalam daftar
pluginspesan init
Skills tidak muncul
Jika plugin skills tidak berfungsi:- Gunakan namespace: panggil plugin skills sebagai
/plugin-name:skill-name - Periksa pesan init: verifikasi bahwa skill muncul di daftar
skillsdengan namespace yang benar - Validasi file skill: pastikan setiap skill memiliki file
SKILL.mddi subdirektorinya sendiri di bawahskills/, misalnyaskills/my-skill/SKILL.md
Lihat juga
- Plugins - Panduan pengembangan plugin lengkap
- Plugins reference - Spesifikasi teknis
- Commands - Mengirimkan commands di SDK
- Subagents - Bekerja dengan agen khusus
- Skills - Menggunakan Agent Skills