Skip to main content
Mempublikasikan plugin Claude Code berarti mencantumkannya di marketplace, katalog JSON yang mencantumkan plugin dan tempat mengambil masing-masing plugin, sehingga orang lain dapat memasangnya berdasarkan nama dan menerima pembaruan Anda. Anda dapat menjalankan marketplace Anda sendiri atau mengirimkan plugin Anda ke marketplace komunitas Anthropic. Untuk berbagi plugin tanpa mempublikasikannya, kirimkan direktori plugin atau .zip darinya kepada orang-orang untuk dimuat sendiri. Halaman ini adalah untuk penulis plugin yang berfungsi dan siap untuk membagikannya.
Kasus-kasus ini tercakup di halaman lain:
Mulai dengan Pilih cara mendistribusikan untuk membandingkan opsi distribusi. Jika Anda sudah tahu rute Anda, buka Siapkan plugin Anda untuk rilis, kemudian ikuti bagian rute Anda untuk apa yang harus diberitahukan kepada pengguna Anda dan bagaimana mereka menerima pembaruan Anda.

​
Pilih cara mendistribusikan

Pilih opsi distribusi berdasarkan siapa yang perlu memasang plugin: Auto-update adalah pengaturan per-marketplace di sisi pengguna yang mengambil versi baru di latar belakang.

​
Siapkan plugin Anda untuk rilis

Nama, versi, validasi, dan pemasangan dari marketplace menentukan apakah rilis berfungsi untuk orang-orang yang memasangnya. Periksa sebelum rilis pertama dan lagi sebelum setiap rilis berikutnya.
1

Pilih nama permanen

Pengguna memasang, mengaktifkan, dan mengonfigurasi plugin Anda dengan name@marketplace, jadi plugin yang diganti nama adalah plugin yang berbeda untuk setiap pemasangan yang ada. Pilih nama kebab-case seperti deploy-helper, karena claude plugin validate memperingatkan bentuk lain, dan perlakukan sebagai permanen. Atur displayName di plugin.json untuk label yang dilihat pengguna.
2

Tentukan cara Anda akan membuat versi

Jika Anda menetapkan version di plugin.json dan kemudian mendorong commit tanpa mengubahnya, claude plugin update mencetak <name> is already at the latest version (1.0.0). dan pengguna menyimpan salinan lama. Baik tingkatkan version pada setiap rilis, atau hilangkan di marketplace yang dihosting git sehingga Claude Code menggunakan SHA commit sebagai gantinya. Lihat Versi dan pembaruan.
3

Validasi

Di shell Anda, jalankan claude plugin validate --strict ./your-plugin. Jalankan bersih mencetak ✔ Validation passed.
  • Di CI: pertahankan --strict, yang juga gagal jalankan dengan kode keluar 1 pada peringatan seperti bidang manifes yang tidak dikenal atau version yang hilang. Lepaskan --strict jika Anda memilih untuk menghilangkan version di langkah sebelumnya.
  • Jalur: validasi melaporkan jalur komponen yang tidak dimulai dengan ./. Di dalam perintah hook dan konfigurasi server MCP, rujuk file sebagai ${CLAUDE_PLUGIN_ROOT}/.... Lihat aturan jalur.
4

Pasang dari marketplace lokal

Di shell Anda, tambahkan marketplace lokal yang mencantumkan plugin dengan claude plugin marketplace add ./path-to-marketplace, pasang plugin darinya, dan mulai sesi untuk mengonfirmasi bahwa plugin dimuat.
5

Isi metadata yang dilihat pengguna

Atur description, author, homepage, dan repository di plugin.json, dan tambahkan README.md di root plugin. homepage harus diurai sebagai URL. Referensi manifes mencantumkan setiap bidang.
6

Jalankan suite eval Anda

Jika Anda memiliki suite eval, jalankan claude plugin eval di shell Anda. Ini menjalankan kasus uji plugin dan mencetak hasil, yang menangkap regresi saat Anda mengubah plugin. Lihat Plugin uji dengan eval.

​
Bagikan plugin tanpa marketplace

Jika plugin berada di repositori git, orang dapat mengklonnya dan memuat checkout, atau memulai Claude Code dari shell mereka dengan --plugin-url yang menunjuk ke .zip yang Anda lampirkan ke rilis. Untuk mendapatkan versi berikutnya mereka menarik atau mengunduh lagi. Jika tidak ada di repositori, kirimkan direktori atau .zip darinya. Mereka memuat dengan salah satu dari dua cara:
  • Untuk satu sesi: mereka memulai Claude Code dari shell mereka dengan claude --plugin-dir ./deploy-helper, di mana jalurnya adalah klon, folder yang tidak dizip, atau .zip itu sendiri. Lihat Bendera yang memuat plugin untuk satu sesi.
  • Untuk setiap sesi: mereka memindahkan direktori plugin, dengan .claude-plugin/plugin.json miliknya, di bawah ~/.claude/skills/ sehingga Claude Code memuat dalam setiap sesi.
Menambahkan .claude-plugin/marketplace.json ke repositori yang sama adalah apa yang memungkinkan orang memasang berdasarkan nama dan memperbarui dengan perintah; lihat Publikasikan melalui marketplace Anda sendiri.

​
Kirim plugin dengan alat Anda sendiri

Jika Anda memelihara CLI atau SDK, publikasikan plugin di marketplace dan buat installer atau pesan pasca-instalasi Anda menjalankan atau mencetak dua perintah yang dibutuhkan pengguna: claude plugin marketplace add <source>, kemudian claude plugin install <name>@<marketplace>. Untuk penemuan dalam sesi ketika seseorang menggunakan alat Anda, lihat Rekomendasikan plugin Anda dari CLI Anda.

​
Publikasikan melalui marketplace Anda sendiri

Marketplace Anda sendiri adalah file .claude-plugin/marketplace.json yang mencantumkan plugin Anda, ditambahkan ke repositori git. Setelah file berada di repositori, plugin dipublikasikan, tanpa formulir pengajuan. Anda dapat menyimpan file di repositori plugin Anda sendiri atau di repositori terpisah.

​
Tambahkan file marketplace ke repositori Anda

Untuk mempublikasikan dari repositori plugin Anda sendiri, simpan file marketplace di samping plugin.json di .claude-plugin/, dengan satu entri yang source adalah "./", root repositori. Berikan entri name yang sama dengan plugin.json, per Jaga nama entri dan nama manifes tetap sama:
.claude-plugin/marketplace.json
Di shell Anda, jalankan claude plugin validate . di repositori untuk memeriksa file sebelum Anda mendorong. Buat marketplace mencakup tata letak dengan beberapa plugin di satu repositori.

​
Kontrol siapa yang dapat memasang

Siapa pun yang dapat mengkloning repositori dapat memasang darinya, jadi jika repositori pribadi, marketplace juga pribadi. Untuk host selain repositori git, lihat Host marketplace. Untuk menjangkau semua orang di perusahaan, termasuk orang yang tidak menggunakan git, lihat Luncurkan ke seluruh perusahaan.

​
Beritahu pengguna cara memasang

Beritahu pengguna Anda untuk menambahkan marketplace dan kemudian memasang plugin dari shell mereka, mengganti sumber dan nama dengan milik Anda:
  • Tambahkan marketplace sekali: claude plugin marketplace add your-org/your-marketplace, di mana argumennya adalah shorthand GitHub owner/repo, URL, atau jalur
  • Pasang plugin: claude plugin install deploy-helper@your-marketplace
  • Atau lakukan keduanya dari dalam sesi: /plugin install deploy-helper --marketplace your-org/your-marketplace. Memerlukan Claude Code v2.1.275 atau lebih baru. Lihat Tambahkan marketplace dan pasang dalam satu perintah

​
Kirim pembaruan kepada pengguna

Pengguna menerima rilis ketika mereka memintanya atau ketika auto-update aktif untuk marketplace Anda:
  • Atas permintaan: claude plugin update deploy-helper@your-marketplace di shell pengguna menyegarkan marketplace dan memasang salinan baru ketika versi plugin Anda telah berubah
  • Auto-update: mati secara default untuk marketplace Anda. Lihat Aktifkan auto-update. Setelah aktif, ini melakukan hal yang sama dengan claude plugin update dengan penundaan setelah sesi dimulai
Pasang plugin mencakup perintah sisi pengguna, dan kapan auto-update berjalan mencakup waktu.

​
Kirimkan ke marketplace komunitas

Marketplace komunitas Anthropic, claude-community, adalah marketplace publik yang mencantumkan plugin yang dikirimkan melalui formulir pengajuan direktori plugin. Pengguna menambahkan marketplace komunitas dalam sesi Claude Code dengan /plugin marketplace add anthropics/claude-plugins-community dan memasang darinya sebagai @claude-community. Untuk cara marketplace komunitas berbeda dari marketplace resmi, lihat Marketplace Anthropic. Untuk mengirimkan plugin Anda ke marketplace komunitas, gunakan salah satu formulir dalam aplikasi: Formulir claude.ai memerlukan organisasi Team atau Enterprise dan izin Directory, yang dipegang Owner secara default. Penulis individual yang bukan bagian dari organisasi Team atau Enterprise dapat menggunakan formulir Console sebagai gantinya. Di shell Anda, jalankan claude plugin validate ./your-plugin secara lokal sebelum Anda mengirimkan, mengganti ./your-plugin dengan jalur ke direktori plugin Anda. Ketika validasi lulus, Claude Code mencetak ✔ Validation passed, atau ✔ Validation passed with warnings jika ada peringatan. Peringatan tidak gagal validasi; tambahkan --strict untuk memperlakukan mereka sebagai kesalahan. Plugin yang tercantum muncul di katalog anthropics/claude-plugins-community, dalam hampir setiap kasus disematkan ke SHA commit tertentu. Mungkin ada penundaan antara pengajuan dan plugin Anda muncul di marketplace.json. Untuk memeriksa apakah plugin Anda dapat dipasang, cari namanya di katalog komunitas. Marketplace resmi, claude-plugins-official, tidak menerima pengajuan melalui formulir ini. Jika Anda bekerja dengan kontak mitra Anthropic, tanyakan tentang daftar marketplace resmi.

​
Kirim pembaruan, penggantian nama, dan penghapusan

​
Rilis versi baru

Jika Anda mempublikasikan melalui marketplace Anda sendiri dan plugin.json Anda menetapkan version, tingkatkan dan dorong. Pengguna yang menjalankan claude plugin update atau memiliki auto-update aktif kemudian menerima versi baru, seperti dijelaskan di bawah Kirim pembaruan kepada pengguna.

​
Tag rilis

Tag rilis di git ketika plugin lain mendeklarasikan rentang versi pada milik Anda, karena rentang tersebut diselesaikan terhadap tag. Jika tidak, Anda tidak memerlukan tag. Untuk tag, jalankan claude plugin tag di shell Anda dari direktori plugin. Ini membuat tag {name}--v{version}. Tambahkan --push untuk mengirim tag ke origin. Referensi plugin tag mencantumkan bendera-bendera miliknya.

​
Ganti nama atau hapus plugin

Jangan pernah ubah name plugin yang dipublikasikan. Setelah penggantian nama, pengguna yang sudah memasangnya kehilangan plugin, karena pemasangan mereka dicatat di bawah nama lama. Entri renames di file marketplace Anda memigrasikan mereka sebagai gantinya. Ubah displayName ketika Anda menginginkan label yang berbeda. Jika penggantian nama tidak dapat dihindari, gunakan peta renames file marketplace sehingga pemasangan yang ada bermigrasi alih-alih gagal dengan Plugin "<name>" not found in marketplace. Untuk menghapus plugin dari marketplace, atau untuk detail renames lengkap, lihat Ganti nama atau hapus plugin di halaman hosting. Referensi marketplace memiliki bidang.

​
Deklarasikan dependensi

Jika plugin Anda memerlukan plugin lain dari marketplace yang sama untuk diaktifkan, cantumkan di array dependencies dari plugin.json. Setiap entri adalah nama telanjang atau objek dengan rentang version semver. Ketika pengguna memasang plugin Anda, Claude Code memasang dan mengaktifkan dependensi juga. Dependensi plugin mencakup sintaks rentang, dependensi lintas-marketplace, dan cara pengguna memangkas dependensi yang tidak lagi mereka butuhkan.

​
Langkah berikutnya