Skip to main content
Plugins memungkinkan Anda memperluas Claude Code dengan fungsionalitas kustom yang dapat dibagikan di seluruh proyek. Melalui Agent SDK, Anda dapat secara terprogram memuat plugins dari direktori lokal untuk menambahkan kemampuan ke sesi agen Anda. Sebuah plugin dapat mencakup:
  • 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
Untuk informasi lengkap tentang struktur plugin dan cara membuat plugins, lihat Plugins.

Memuat plugins

Muat plugins dengan menyediakan jalur sistem file lokal mereka dalam konfigurasi opsi Anda. Bidang type 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:
  1. Periksa jalurnya: pastikan jalur menunjuk ke direktori root plugin, induk dari skills/, agents/, hooks/, commands/, atau .claude-plugin/
  2. Validasi plugin.json: jika plugin Anda menyertakan manifest, pastikan memiliki sintaks JSON yang valid
  3. Periksa izin file: pastikan direktori plugin dapat dibaca
  4. Konfirmasi direktori ada: SDK melewati jalur yang tidak ada, dan plugin tidak muncul dalam daftar plugins pesan init

Skills tidak muncul

Jika plugin skills tidak berfungsi:
  1. Gunakan namespace: panggil plugin skills sebagai /plugin-name:skill-name
  2. Periksa pesan init: verifikasi bahwa skill muncul di daftar skills dengan namespace yang benar
  3. Validasi file skill: pastikan setiap skill memiliki file SKILL.md di subdirektorinya sendiri di bawah skills/, misalnya skills/my-skill/SKILL.md

Lihat juga