Pasar plugin memungkinkan pemilik paket Team dan Enterprise untuk mendistribusikan plugin yang dikurasi kepada semua orang di organisasi mereka melalui Cowork. Anda membuat pasar, menambahkan plugin ke dalamnya, dan mengontrol dengan tepat plugin mana yang dapat dilihat dan digunakan oleh anggota tim Anda.
Pemilik dan Pemilik Utama paket Team dan Enterprise dapat mengelola plugin organisasi di Claude Desktop.
Persyaratan: Cowork dan Skills harus keduanya diaktifkan untuk organisasi Anda sebelum Anda dapat menggunakan pasar plugin.
Ada dua cara untuk menambahkan plugin ke pasar:
Unggahan manual—Unggah file ZIP plugin individual melalui UI admin. Terbaik untuk iterasi cepat, alat sekali pakai, atau tim yang tidak menggunakan GitHub untuk pengembangan plugin.
Sinkronisasi GitHub—Hubungkan repositori GitHub pribadi dan Cowork secara otomatis menyinkronkan plugin darinya. Terbaik ketika beberapa pengembang berkolaborasi pada plugin atau Anda menginginkan pembaruan yang dikontrol versi.
Anda dapat menggunakan kedua pendekatan secara paralel—misalnya, pasar yang disinkronkan GitHub untuk plugin inti Anda dan pasar manual terpisah untuk alat ad-hoc.
Siapkan pasar manual
Buka Claude Desktop dan buka Pengaturan Organisasi > Plugin.
Klik "Tambahkan plugin" dan pilih "Unggah file" sebagai sumbernya.
Jika ini adalah pertama kali Anda menyiapkan pasar, "Unggah ke pasar baru" akan dipilih secara otomatis.
Anda akan dapat memilih "Tambahkan ke pasar yang ada" saat mengunggah plugin ke depannya.
Masukkan nama untuk pasar Anda.
Seret file Anda, atau klik prompt unggahan dan pilih file Anda.
Catatan: File harus berupa .zip yang valid di bawah 50 MB.
Ulangi untuk setiap plugin yang ingin Anda tambahkan.
Klik "Unggah" untuk menambahkan plugin Anda ke pasar baru.
Jika Anda mengunggah plugin dengan nama yang sama dengan yang sudah ada, plugin tersebut secara otomatis menimpa versi sebelumnya—tidak perlu menghapus yang lama terlebih dahulu.
Siapkan pasar yang disinkronkan GitHub
Sinkronisasi GitHub memungkinkan Anda mengelola plugin sebagai kode dalam repositori. Ketika Anda mendorong perubahan, Anda dapat memicu sinkronisasi untuk memperbarui pasar Anda.
Siapkan repositori Anda
Repositori Anda harus pribadi atau internal—repo publik tidak diizinkan untuk pasar organisasi. Repo yang dihosting di instans GitHub Enterprise Server khusus tidak didukung. Repo Anda harus dihosting di github.com.
Untuk detail tentang struktur plugin dan pemformatan, lihat dokumentasi referensi plugin.
Sumber daya tambahan:
Hubungkan repositori
Pastikan Cowork dan Skills keduanya diaktifkan untuk organisasi Anda.
Buka Pengaturan Organisasi > Plugin.
Klik "Tambahkan plugin" dan pilih "GitHub" sebagai sumbernya.
Masukkan repositori dalam format
pemilik/repo(misalnya,acme-corp/claude-plugins).
Token GitHub pribadi Anda diverifikasi untuk mengkonfirmasi Anda memiliki akses, kemudian Cowork menggunakan token instalasi GitHub App-nya untuk operasi sinkronisasi.
Tidak dapat melihat repo Anda? Pastikan GitHub App Cowork diinstal di repositori tersebut.
Cara kerja sinkronisasi
Sinkronisasi awal berjalan secara otomatis ketika Anda menghubungkan repositori. Setelah itu, Anda dapat memicu sinkronisasi secara manual dengan mengklik "Periksa pembaruan" di pasar Anda di Pengaturan Organisasi > Plugin.
Selama sinkronisasi, Cowork membandingkan commit terbaru di repo Anda dengan commit yang terakhir disinkronkan. Jika tidak ada yang berubah, sinkronisasi dilewati. Jika ada perubahan, Cowork membaca manifes, memvalidasi setiap plugin, dan mengganti semua plugin di pasar dengan status saat ini dari repo. Sinkronisasi dapat memakan waktu hingga 30 menit tergantung pada jumlah plugin.
Penting: Jika sinkronisasi gagal, plugin mungkin sementara dihapus untuk anggota tim Anda. Jika ini terjadi, periksa pesan kegagalan, perbaiki masalah di repo Anda, dorong pembaruan, dan picu sinkronisasi lagi. Setelah sinkronisasi berhasil, verifikasi bahwa preferensi instalasi Anda masih diatur dengan benar — preferensi tersebut mungkin telah direset selama kegagalan.
Kontrol distribusi plugin
Setelah pasar Anda memiliki plugin, Anda mengontrol cara didistribusikan menggunakan preferensi instalasi. Untuk setiap plugin, Anda dapat mengatur salah satu dari tiga opsi:
Preferensi
|
Apa yang dilakukannya
|
Apa yang dilihat anggota
|
Instal otomatis
|
Secara otomatis diinstal untuk semua anggota organisasi
|
Plugin muncul di daftar terinstal mereka tanpa tindakan apa pun. Anggota dapat mencopot instalasi jika mereka memilih.
|
Tersedia
|
Terdaftar dalam katalog plugin
|
Anggota melihatnya saat menjelajahi plugin dan dapat menginstalnya sendiri.
|
Tidak tersedia
|
Disembunyikan dari katalog sepenuhnya
|
Anggota tidak dapat melihat atau menginstal plugin. Berguna untuk staging atau menghapus plugin.
|
Atur preferensi
Di Pengaturan Organisasi > Plugin, navigasikan ke pasar Anda.
Pilih preferensi instalasi untuk setiap plugin.
Perubahan berlaku pada sesi berikutnya atau penyegaran plugin setiap anggota.
Apa yang dialami anggota
Anggota menjelajahi plugin yang tersedia melalui modal Jelajahi plugin di Cowork. Plugin yang diinstal otomatis muncul di daftar terinstal mereka secara otomatis. Plugin yang tersedia muncul di katalog untuk instalasi self-service.
Anggota tidak dapat mengedit plugin yang dikelola organisasi, yang mencegah perubahan yang bertentangan dengan alat bersama.
Perbarui dan hapus plugin
Pasar manual
Untuk memperbarui plugin, unggah file ZIP baru dengan nama plugin yang sama. Versi baru secara otomatis menimpa yang sudah ada. Nama plugin adalah pengidentifikasi unik — legal akan selalu menggantikan legal.
Untuk menghapus plugin, hapus dari pasar Anda di Pengaturan Organisasi > Plugin.
Pasar yang disinkronkan GitHub
Dorong perubahan Anda ke repositori yang terhubung, kemudian buka Pengaturan Organisasi > Plugin, temukan pasar Anda, dan klik "Periksa pembaruan" untuk memicu sinkronisasi. Setiap sinkronisasi mengganti semua plugin dengan status saat ini dari repo.
Untuk menghapus plugin, hapus dari repositori dan picu sinkronisasi.
Batas
Batas
|
Nilai
|
Catatan
|
Ukuran ZIP plugin maks (unggah)
|
50 MB
|
Diberlakukan di sisi klien dan server
|
Plugin maks per pasar (manual)
|
100
|
Per pasar
|
Plugin maks per pasar (sinkronisasi GitHub)
|
500
|
Per pasar
|
Panjang nama plugin maks
|
64 karakter
|
Harus menggunakan kata huruf kecil dipisahkan dengan tanda hubung
|
Waktu tunggu sinkronisasi
|
30 menit
|
Per operasi sinkronisasi
|
Visibilitas repo GitHub
|
Hanya pribadi atau internal
|
Harus dihosting di github.com. Repo publik dan instans GitHub Enterprise Server tidak didukung.
|
Aturan penamaan
Nama plugin harus menggunakan kata huruf kecil dipisahkan dengan tanda hubung (misalnya, deployment-tools, bukan Deployment Tools). Nama pasar berikut dicadangkan dan tidak dapat digunakan:
claude-code-marketplaceclaude-code-pluginsclaude-plugins-officialanthropic-marketplaceanthropic-pluginsagent-skillslife-sciences
Nama yang menyamar sebagai pasar Anthropic resmi juga diblokir.
Pilih antara unggahan manual dan sinkronisasi GitHub
Skenario
|
Pendekatan yang direkomendasikan
|
Plugin dikelola dalam kontrol versi dengan CI/CD
|
Sinkronisasi GitHub
|
Beberapa pengembang berkolaborasi pada plugin
|
Sinkronisasi GitHub
|
Anda menginginkan propagasi pembaruan otomatis
|
Sinkronisasi GitHub
|
Anda membutuhkan lebih dari 100 plugin di pasar
|
Sinkronisasi GitHub
|
Prototyping cepat atau alat sekali pakai
|
Unggahan manual
|
Plugin dibangun oleh tim non-teknis
|
Unggahan manual
|
Lingkungan tanpa akses GitHub
|
Unggahan manual
|
Menguji plugin sebelum menambahkannya ke repo yang disinkronkan
|
Unggahan manual
|
Pemecahan masalah
Unggahan ditolak
Penyebab umum: file melebihi 50 MB, bukan file ZIP yang valid, atau pasar telah mencapai batas 100 plugin. Periksa ukuran dan format file, dan hapus plugin yang tidak digunakan jika Anda mencapai kapasitas.
Plugin tidak muncul untuk anggota
Periksa preferensi instalasi plugin di pengaturan pasar Anda. Jika diatur ke Tidak tersedia, anggota tidak akan melihatnya. Juga konfirmasi bahwa Cowork dan Skills keduanya diaktifkan untuk organisasi Anda.
Plugin yang diperbarui tidak tercermin untuk anggota
Perubahan berlaku pada sesi berikutnya atau penyegaran plugin setiap anggota. Jika pembaruan masih tidak ditampilkan, konfirmasi unggahan berhasil dengan memeriksa versi plugin di pasar Anda.
Sinkronisasi GitHub gagal dengan kesalahan konten
Satu atau lebih plugin di repo Anda kemungkinan diformat dengan tidak benar. Perbaiki masalah pemformatan, dorong pembaruan ke GitHub, dan picu sinkronisasi lagi. Untuk persyaratan struktur plugin, lihat dokumentasi referensi plugin.
Plugin hilang setelah sinkronisasi gagal
Sinkronisasi GitHub yang gagal dapat sementara menghapus plugin dari pasar Anda. Perbaiki masalah yang mendasar, sinkronkan ulang dengan berhasil, kemudian verifikasi bahwa preferensi instalasi diatur dengan benar—preferensi tersebut mungkin telah direset.
Tidak dapat melihat repo GitHub saat menghubungkan
Pastikan GitHub App Cowork diinstal di repositori tersebut. Token GitHub pribadi Anda diperiksa terlebih dahulu untuk mengkonfirmasi akses, tetapi sinkronisasi itu sendiri menggunakan token instalasi GitHub App.