SpyBara
Go Premium

plugins/publish.md 2026-09-28 22:59 UTC to 2026-09-29 17:57 UTC

This page contains 21 additions and 18 deletions.

2026
Fri 25 23:58 Mon 28 22:59 Tue 29 17:57

Publikasikan dan distribusikan plugin

Publikasikan plugin Claude Code melalui marketplace Anda sendiri atau direktori Anthropic, dengan daftar periksa pra-rilis dan cara pengguna mendapatkan pembaruan.

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 direktori 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.

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:

Rute Siapa yang dapat memasang Apa yang Anda butuhkan Apakah pengguna mendapatkan pembaruan Anda secara otomatis?
Tanpa marketplace Orang-orang yang Anda kirimkan folder plugin atau .zip darinya Folder plugin Tidak ada. Mereka memuat salinan yang Anda kirimkan
Marketplace Anda sendiri Siapa pun yang dapat menjangkau repositori, yang dapat berupa repositori pribadi yang dapat dikloning tim Anda Repositori git atau host lain dengan .claude-plugin/marketplace.json yang mencantumkan plugin Anda Mati
Direktori Anthropic Orang-orang yang menambahkannya di claude.ai atau di Cowork. Ini juga dimuat dalam sesi Claude Code mereka melalui sinkronisasi akun Repositori GitHub yang menyimpan plugin dan paket claude.ai berbayar untuk dikirimkan dari Ya, setelah versi yang Anda dorong dipublikasikan

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:

{
  "name": "your-marketplace",
  "owner": { "name": "Your Name" },
  "plugins": [
    { "name": "deploy-helper", "source": "./" }
  ]
}

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 direktori Anthropic

Direktori Anthropic adalah katalog yang dijelajahi orang di claude.ai dan di Cowork untuk menambahkan plugin dan konektor. Satu daftar di sana menjangkau orang di claude.ai, di Cowork, dan di Claude Code. Anda mengirimkan dari portal pengembang di claude.ai/directory/manage; Persiapkan untuk tinjauan di claude.com menjelaskan apa yang terjadi pada setiap versi sebelum dipublikasikan.

Pengiriman memerlukan paket claude.ai berbayar. Di Pro dan Max Anda mengirimkan dari akun Anda sendiri. Di Team dan Enterprise, seorang Owner dapat mengirimkan, dan di Enterprise seorang Owner juga dapat memberikan izin Directory kepada anggota lain melalui peran khusus di bawah Organization settings > Roles. Lihat Konfirmasi bahwa Anda dapat mengirimkan ke direktori.

Langkah-langkah pengiriman, pemeriksaan yang harus dilalui setiap versi, dan apa yang terjadi setelah Anda mempublikasikan didokumentasikan di claude.com, karena sama di mana pun permukaan pengguna Anda berada:

Sebelum Anda membuka portal, validasi secara lokal dan periksa komponen mana dari Anda yang dimuat di luar Claude Code:

  • Jalankan claude plugin validate ./your-plugin --strict di shell Anda: ganti ./your-plugin dengan jalur ke direktori plugin Anda. Perintah menangkap kesalahan manifest secara lokal; plugin validate mencantumkan file mana yang dibaca setiap kali dijalankan. Portal menerapkan aturan direktori tambahan yang tidak diperiksa CLI, jadi jalankan lokal yang bersih tidak menjamin validasi portal yang bersih.
  • Periksa apa yang dimuat di mana: beberapa komponen plugin hanya Claude Code dan tidak dimuat di claude.ai atau di Cowork. Tabel dukungan komponen mencantumkan setiap komponen menurut aplikasi, sehingga Anda tahu apa yang akan diterima pengguna di luar Claude Code.

Marketplace resmi Anthropic, claude-plugins-official, tidak menerima pengiriman melalui portal direktori. Jika Anda bekerja dengan kontak mitra Anthropic, tanyakan tentang daftar marketplace resmi.

Bagaimana plugin yang terdaftar menjangkau pengguna Claude Code

Seseorang yang memasang plugin Anda dari direktori di claude.ai memilikinya di akun mereka, dan Claude Code memuatnya sebagai <name>@synced. Plugin yang disinkronkan dari claude.ai mencakup apa yang mereka lihat dan bagaimana mereka mematikannya.

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. Untuk daftar direktori, lihat Perbarui plugin yang dipublikasikan.

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