Buat plugins

Buat plugins kustom untuk memperluas Claude Code dengan skills, agents, hooks, dan MCP servers.

Plugins memungkinkan Anda memperluas Claude Code dengan fungsionalitas kustom yang dapat dibagikan di seluruh proyek dan tim. Panduan ini mencakup pembuatan plugins Anda sendiri dengan skills, agents, hooks, dan MCP servers.

Mencari untuk memasang plugins yang sudah ada? Lihat Temukan dan pasang plugins. Untuk spesifikasi teknis lengkap, lihat Referensi plugins.

Kapan menggunakan plugins vs konfigurasi standalone

Claude Code mendukung dua cara untuk menambahkan skills, agents, dan hooks kustom:

Gunakan konfigurasi standalone ketika:

• Anda menyesuaikan Claude Code untuk satu proyek
• Konfigurasi bersifat pribadi dan tidak perlu dibagikan
• Anda bereksperimen dengan skills atau hooks sebelum mengemas mereka
• Anda menginginkan nama skill pendek seperti /hello atau /deploy

Gunakan plugins ketika:

• Anda ingin berbagi fungsionalitas dengan tim atau komunitas Anda
• Anda memerlukan skills/agents yang sama di seluruh beberapa proyek
• Anda menginginkan kontrol versi dan pembaruan mudah untuk ekstensi Anda
• Anda mendistribusikan melalui marketplace
• Anda tidak keberatan dengan skills yang diberi namespace seperti /my-plugin:hello (namespace mencegah konflik antara plugins)

Quickstart

Quickstart ini memandu Anda melalui pembuatan plugin dengan skill kustom. Anda akan membuat manifest (file konfigurasi yang mendefinisikan plugin Anda), menambahkan skill, dan mengujinya secara lokal menggunakan flag --plugin-dir.

Prasyarat

• Claude Code diinstal dan diautentikasi

Buat plugin pertama Anda

mkdir my-first-plugin

mkdir my-first-plugin/.claude-plugin

{
"name": "my-first-plugin",
"description": "A greeting plugin to learn the basics",
"version": "1.0.0",
"author": {
"name": "Your Name"
}
}

mkdir -p my-first-plugin/skills/hello

---
description: Greet the user with a friendly message
disable-model-invocation: true
---

Greet the user warmly and ask how you can help them today.

claude --plugin-dir ./my-first-plugin

/my-first-plugin:hello

---
description: Greet the user with a personalized message
---

# Hello Skill

Greet the user named "$ARGUMENTS" warmly and ask how you can help them today. Make the greeting personal and encouraging.

/my-first-plugin:hello Alex

Anda telah berhasil membuat dan menguji plugin dengan komponen kunci ini:

• Plugin manifest (.claude-plugin/plugin.json): menjelaskan metadata plugin Anda
• Direktori skills (skills/): berisi skills kustom Anda
• Argumen skill ($ARGUMENTS): menangkap input pengguna untuk perilaku dinamis

Ikhtisar struktur plugin

Anda telah membuat plugin dengan skill, tetapi plugins dapat mencakup banyak hal lagi: agents kustom, hooks, MCP servers, LSP servers, dan background monitors.

Kembangkan plugins yang lebih kompleks

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

Tambahkan Skills ke plugin Anda

Plugins dapat mencakup Agent Skills untuk memperluas kemampuan Claude. Skills diinvokasi oleh model: Claude secara otomatis menggunakannya berdasarkan konteks tugas.

Tambahkan direktori skills/ di root plugin Anda dengan folder Skill yang berisi file SKILL.md:

my-plugin/
├── .claude-plugin/
│   └── plugin.json
└── skills/
    └── code-review/
        └── SKILL.md

Setiap SKILL.md berisi frontmatter YAML dan instruksi. Sertakan description sehingga Claude tahu kapan menggunakan skill:

---
description: Reviews code for best practices and potential issues. Use when reviewing code, checking PRs, or analyzing code quality.
---

When reviewing code, check for:
1. Code organization and structure
2. Error handling
3. Security concerns
4. Test coverage

Setelah memasang plugin, jalankan /reload-plugins untuk memuat Skills. Untuk panduan authoring Skill lengkap termasuk progressive disclosure dan pembatasan tool, lihat Agent Skills.

Tambahkan LSP servers ke plugin Anda

Plugin LSP (Language Server Protocol) memberikan Claude code intelligence real-time. Jika Anda perlu mendukung bahasa yang tidak memiliki plugin LSP resmi, Anda dapat membuat plugin Anda sendiri dengan menambahkan file .lsp.json ke plugin Anda:

{
  "go": {
    "command": "gopls",
    "args": ["serve"],
    "extensionToLanguage": {
      ".go": "go"
    }
  }
}

Pengguna yang memasang plugin Anda harus memiliki binary language server yang diinstal di mesin mereka.

Untuk opsi konfigurasi LSP lengkap, lihat LSP servers.

Tambahkan background monitors ke plugin Anda

Background monitors memungkinkan plugin Anda untuk menonton logs, file, atau status eksternal di latar belakang dan memberi tahu Claude saat event tiba. Claude Code memulai setiap monitor secara otomatis ketika plugin aktif, jadi Anda tidak perlu menginstruksikan Claude untuk memulai watch.

Tambahkan file monitors/monitors.json di root plugin dengan array entri monitor:

[
  {
    "name": "error-log",
    "command": "tail -F ./logs/error.log",
    "description": "Application error log"
  }
]

Setiap baris stdout dari command dikirimkan ke Claude sebagai notifikasi selama sesi. Untuk skema lengkap, termasuk trigger when dan substitusi variabel, lihat Monitors.

Kirim default settings dengan plugin Anda

Plugins dapat menyertakan file settings.json di root plugin untuk menerapkan konfigurasi default ketika plugin diaktifkan. Saat ini, hanya key agent dan subagentStatusLine yang didukung.

Mengatur agent mengaktifkan salah satu custom agents plugin sebagai thread utama, menerapkan system prompt, pembatasan tool, dan modelnya. Ini memungkinkan plugin untuk mengubah perilaku Claude Code secara default ketika diaktifkan.

{
  "agent": "security-reviewer"
}

Contoh ini mengaktifkan agent security-reviewer yang didefinisikan di direktori agents/ plugin. Settings dari settings.json mengambil prioritas atas settings yang dideklarasikan di plugin.json. Key yang tidak dikenal diabaikan secara diam-diam.

Organisir plugins kompleks

Untuk plugins dengan banyak komponen, organisir struktur direktori Anda berdasarkan fungsionalitas. Untuk layout direktori lengkap dan pola organisasi, lihat Struktur direktori plugin.

Uji plugins Anda secara lokal

Gunakan flag --plugin-dir untuk menguji plugins selama pengembangan. Ini memuat plugin Anda secara langsung tanpa memerlukan instalasi.

claude --plugin-dir ./my-plugin

Flag juga menerima arsip .zip dari direktori plugin, yang memerlukan Claude Code v2.1.128 atau lebih baru.

claude --plugin-dir ./my-plugin.zip

Ketika plugin --plugin-dir memiliki nama yang sama dengan plugin marketplace yang diinstal, salinan lokal mengambil prioritas untuk sesi itu. Ini memungkinkan Anda menguji perubahan pada plugin yang sudah Anda instal tanpa mencopot pemasangannya terlebih dahulu. Pengecualian adalah plugins yang managed settings force-enable atau force-disable: --plugin-dir tidak dapat menimpa pengaturan tersebut.

Saat Anda membuat perubahan pada plugin Anda, jalankan /reload-plugins untuk mengambil pembaruan tanpa memulai ulang. Ini memuat ulang plugins, skills, agents, hooks, plugin MCP servers, dan plugin LSP servers. Uji komponen plugin Anda:

• Coba skills Anda dengan /plugin-name:skill-name
• Periksa bahwa agents muncul di /agents
• Verifikasi hooks bekerja seperti yang diharapkan

Untuk menguji plugin yang sudah dikemas sebagai arsip .zip dan dihosting di URL, seperti artefak build CI, gunakan --plugin-url sebagai gantinya. Claude Code mengambil arsip saat startup dan memuatnya hanya untuk sesi itu. Jika pengambilan gagal atau arsip tidak valid, Claude Code melaporkan kesalahan pemuatan plugin dan dimulai tanpanya. Pertimbangan kepercayaan yang sama berlaku seperti untuk sumber plugin apa pun: hanya arahkan flag ini ke arsip yang Anda kontrol atau percayai.

Untuk memuat beberapa plugins, ulangi flag untuk setiap URL:

claude --plugin-url https://example.com/my-plugin.zip --plugin-url https://example.com/other.zip

Atau teruskan URL yang dipisahkan spasi sebagai satu argumen yang dikutip:

claude --plugin-url "https://example.com/my-plugin.zip https://example.com/other.zip"

Debug masalah plugin

Jika plugin Anda tidak bekerja seperti yang diharapkan:

1. Periksa struktur: Pastikan direktori Anda berada di root plugin, bukan di dalam .claude-plugin/
2. Uji komponen secara individual: Periksa setiap skill, agent, dan hook secara terpisah
3. Gunakan alat validasi dan debugging: Lihat Alat debugging dan pengembangan untuk perintah CLI dan teknik troubleshooting

Bagikan plugins Anda

Ketika plugin Anda siap untuk dibagikan:

1. Tambahkan dokumentasi: Sertakan README.md dengan instruksi instalasi dan penggunaan
2. Pilih strategi versioning: Tentukan apakah akan menetapkan version eksplisit atau mengandalkan SHA commit git. Lihat manajemen versi
3. Buat atau gunakan marketplace: Distribusikan melalui plugin marketplaces untuk instalasi
4. Uji dengan orang lain: Minta anggota tim menguji plugin sebelum distribusi yang lebih luas

Setelah plugin Anda berada di marketplace, orang lain dapat memasangnya menggunakan instruksi di Temukan dan pasang plugins. Untuk menjaga plugin tetap internal bagi tim Anda, hosting marketplace di private repository.

Kirimkan plugin Anda ke marketplace resmi

Untuk mengirimkan plugin ke marketplace Anthropic resmi, gunakan salah satu formulir pengajuan in-app:

• Claude.ai: claude.ai/settings/plugins/submit
• Console: platform.claude.com/plugins/submit

Setelah plugin Anda terdaftar, Anda dapat memiliki CLI Anda sendiri yang meminta pengguna Claude Code untuk memasangnya. Lihat Rekomendasikan plugin Anda dari CLI Anda.

Konversi konfigurasi yang ada ke plugins

Jika Anda sudah memiliki skills atau hooks di direktori .claude/ Anda, Anda dapat mengonversinya menjadi plugin untuk berbagi dan distribusi yang lebih mudah.

Langkah migrasi

mkdir -p my-plugin/.claude-plugin

{
"name": "my-plugin",
"description": "Migrated from standalone configuration",
"version": "1.0.0"
}

# Copy commands
cp -r .claude/commands my-plugin/

# Copy agents (if any)
cp -r .claude/agents my-plugin/

# Copy skills (if any)
cp -r .claude/skills my-plugin/

mkdir my-plugin/hooks

{
"hooks": {
"PostToolUse": [
{
"matcher": "Write|Edit",
"hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix" }]
}
]
}
}

claude --plugin-dir ./my-plugin

Apa yang berubah saat migrasi

Langkah berikutnya

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

Untuk pengguna plugin

• Temukan dan pasang plugins: jelajahi marketplaces dan pasang plugins
• Konfigurasi marketplaces tim: atur plugins tingkat repository untuk tim Anda

Untuk pengembang plugin

• Buat dan distribusikan marketplace: paket dan bagikan plugins Anda
• Referensi plugins: spesifikasi teknis lengkap
• Selami lebih dalam komponen plugin spesifik:
  • Skills: detail pengembangan skill
  • Subagents: konfigurasi dan kemampuan agent
  • Hooks: penanganan event dan otomasi
  • MCP: integrasi tool eksternal