Kelola plugin untuk organisasi Anda

Pasar plugin memungkinkan pemilik paket Team dan Enterprise mendistribusikan plugin yang dikurasi kepada semua orang di organisasi mereka. Anda membuat pasar, menambahkan plugin ke dalamnya, dan mengontrol dengan tepat plugin mana yang dapat dilihat dan digunakan oleh anggota tim Anda. Plugin yang Anda distribusikan muncul di chat (di web dan tab Chat di Claude Desktop) dan Claude Cowork.

Persyaratan: Cowork dan Skills harus keduanya diaktifkan untuk organisasi Anda sebelum Anda dapat menggunakan pasar plugin.

Anthropic menyediakan pasar plugin bawaan untuk berbagai fungsi, seperti hukum dan keuangan. Pasar Knowledge Work ditambahkan ke organisasi Anda secara default.

Untuk menambahkan pasar yang dibangun Anthropic:

Untuk menghapus pasar Knowledge Work jika tidak relevan dengan tim Anda:

Pasar yang dibangun Anthropic menampilkan nama yang dapat dibaca, seperti "Knowledge Work," bukan slug repositori yang mendasarinya.

Selain pasar yang dibangun Anthropic, Anda dapat membuat pasar Anda sendiri. Ada dua cara untuk menambahkan plugin ke pasar yang Anda buat:

Anda dapat menggunakan kedua pendekatan secara paralel. Misalnya, jalankan pasar yang disinkronkan GitHub untuk plugin inti Anda dan pasar manual terpisah untuk alat ad-hoc.

Jika Anda mengunggah plugin dengan nama yang sama dengan yang sudah ada, plugin tersebut akan menimpa versi sebelumnya secara otomatis. Anda tidak perlu menghapus yang lama terlebih dahulu.

Sinkronisasi GitHub memungkinkan Anda mengelola plugin sebagai kode dalam repositori. Ketika Anda mendorong perubahan, Anda dapat memicu sinkronisasi untuk memperbarui pasar Anda, baik secara manual maupun otomatis.

Siapkan repositori Anda

Repositori Anda harus pribadi atau internal—repo publik tidak diizinkan untuk pasar organisasi. Anda dapat menghubungkan repo yang dihosting di github.com atau pada instans GitHub Enterprise Server yang di-host sendiri.

Pasar yang disinkronkan GitHub mendukung set source yang lebih sempit dalam marketplace.json daripada yang dilakukan Claude Code CLI. Jalur relatif ke folder plugin di dalam repositori yang terhubung (misalnya, "source": "./plugins/my-plugin") sepenuhnya didukung. Jenis sumber github, url, dan git-subdir didukung hanya ketika repositori target bersifat publik. Jenis sumber npm dan pip tidak didukung. Jika kode plugin Anda berada di repositori pribadi terpisah, salin folder plugin tersebut ke dalam repositori pasar (submodul git, subtree git, atau langkah CI berfungsi dengan baik) dan referensikan dengan jalur relatif.

Untuk detail tentang struktur plugin dan pemformatan, lihat dokumentasi referensi plugin.

Sumber daya tambahan:

Hubungkan repositori

Token GitHub pribadi Anda diverifikasi untuk mengonfirmasi Anda memiliki akses, kemudian Cowork menggunakan token instalasi GitHub App-nya untuk operasi sinkronisasi.

Tidak bisa melihat repo Anda? Pastikan Claude GitHub App sudah diinstal di repository tersebut.

Cara sinkronisasi bekerja

Sinkronisasi awal berjalan secara otomatis saat Anda menghubungkan repository. Setelah itu, pemilik organisasi dapat memilih untuk melanjutkan pembaruan otomatis per marketplace dengan membuka Pengaturan Organisasi > Plugin, mengklik tombol menu di sudut kanan atas marketplace, lalu mengaktifkan "Sinkronisasi otomatis":

Mengaktifkan sinkronisasi otomatis membuat webhook di repository yang terhubung. Orang yang mengaktifkan toggle harus memiliki akses tingkat admin ke repository tersebut di GitHub. Ini diperiksa melalui koneksi GitHub pribadi mereka, yang terpisah dari instalasi Claude GitHub App. Tanpa akses admin, halaman menampilkan "Tidak dapat mengakses repository. Pastikan repository ada dan Claude GitHub App sudah diinstal," bahkan ketika App sudah diinstal dengan benar dan pembaruan manual berfungsi.

Izin Webhooks (Baca & Tulis) Claude GitHub App juga harus disetujui pada instalasi. Pada instalasi yang dibuat sebelum izin ini diperkenalkan, GitHub menampilkan prompt "Claude meminta izin yang diperbarui" yang perlu disetujui oleh admin repository atau organisasi.

Setelah diaktifkan, sinkronisasi otomatis berjalan saat pull request yang menyertakan bump versi plugin digabungkan ke branch default repository. Push langsung ke branch default tidak memicu sinkronisasi. Anda selalu dapat memicu sinkronisasi secara manual dengan mengklik "Perbarui" di marketplace.

Selama sinkronisasi, Cowork membandingkan commit terbaru di repo Anda dengan commit terakhir yang disinkronkan. Jika tidak ada yang berubah, sinkronisasi dilewati. Jika ada perubahan, Cowork membaca manifest, memvalidasi setiap plugin, dan mengganti semua plugin di marketplace dengan status terkini repo. Sinkronisasi dapat memakan waktu hingga 30 menit tergantung jumlah plugin.

Setelah marketplace Anda memiliki plugin, Anda mengontrol cara distribusinya menggunakan preferensi instalasi. Untuk setiap plugin, Anda dapat menetapkan salah satu dari empat opsi:

Anggota menjelajahi plugin yang tersedia melalui modal Jelajahi plugin. 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 pada alat bersama.

Admin Enterprise dapat mengganti preferensi instalasi plugin di seluruh organisasi untuk grup tertentu. Misalnya, Anda dapat menginstal otomatis plugin untuk grup Engineering, membuatnya tersedia bagi Legal untuk diinstal sendiri, dan menyembunyikannya dari yang lain.

Setiap plugin di marketplace Anda memiliki preferensi instalasi di seluruh organisasi (Diinstal secara default, Tersedia untuk diinstal, Diperlukan, atau Tidak tersedia). Secara default, setiap grup mewarisi pengaturan di seluruh organisasi tersebut.

Ketika Anda menetapkan penggantian tingkat grup untuk plugin, itu menggantikan pengaturan di seluruh organisasi untuk anggota grup tersebut. Urutan resolusi adalah: pengaturan grup, kemudian pengaturan di seluruh organisasi, kemudian default marketplace.

Grup yang dibuat secara manual dan grup yang disediakan SCIM dari penyedia identitas Anda muncul di pemilih grup dan bekerja dengan cara yang sama.

Jika anggota termasuk dalam dua atau lebih grup dengan pengaturan berbeda untuk plugin yang sama, pengaturan paling permisif berlaku. Urutan dari paling hingga paling tidak permisif adalah: Diperlukan > Diinstal secara default > Tersedia untuk diinstal > Tidak tersedia.

Misalnya, jika Grup A menetapkan plugin ke "Tidak tersedia" dan Grup B menetapkannya ke "Diinstal secara default," anggota di kedua grup mendapatkan plugin yang diinstal secara default.

Jika grup dihapus (misalnya, dihapus dari penyedia identitas Anda), penggantian tetap ada di UI admin tetapi ditandai sebagai yatim piatu. Ini tidak berpengaruh pada anggota (karena tidak ada yang termasuk dalam grup yang dihapus) dan tidak dihitung menuju lencana akses kustom. Anda dapat menghapus penggantian yatim piatu dari pengaturan akses kustom plugin.

Ya. Penggantian tingkat grup bertahan ketika Anda menyinkronkan ulang marketplace yang terhubung GitHub. Mereka hanya dihapus jika plugin itu sendiri dihapus dari marketplace.

Untuk memperbarui plugin, unggah file ZIP baru dengan nama plugin yang sama. Versi baru menimpa yang sudah ada secara otomatis. Nama plugin adalah pengenal unik, jadi legal akan selalu menggantikan legal.

Untuk menghapus plugin, hapusnya dari marketplace Anda di Pengaturan Organisasi > Plugin.

Dorong perubahan Anda ke repositori yang terhubung, kemudian buka Pengaturan Organisasi > Plugin, temukan marketplace Anda, dan klik "Perbarui" untuk memicu sinkronisasi. Setiap sinkronisasi menggantikan semua plugin dengan status saat ini dari repo. Jika pemilik telah mengaktifkan "Sinkronkan secara otomatis" untuk marketplace, sinkronisasi juga berjalan setiap kali permintaan tarik dengan bump versi plugin digabungkan ke cabang default repositori.

Untuk menghapus plugin, hapusnya dari repositori dan picu sinkronisasi.

Nama plugin harus menggunakan kata-kata huruf kecil yang dipisahkan dengan tanda hubung (misalnya, deployment-tools, bukan Deployment Tools). Nama marketplace berikut ini dicadangkan dan tidak dapat digunakan:

Nama yang menyamar sebagai marketplace resmi Anthropic juga diblokir.

Penyebab umum: file melebihi 50 MB, bukan file ZIP yang valid, atau marketplace telah mencapai batas 100 plugin. Periksa ukuran dan format file, dan hapus plugin yang tidak digunakan jika Anda sudah mencapai kapasitas.

Periksa preferensi instalasi plugin di pengaturan marketplace Anda. Jika diatur ke Tidak tersedia, anggota tidak akan melihatnya. Juga konfirmasi bahwa Cowork dan Skills keduanya diaktifkan untuk organisasi Anda.

Perubahan berlaku pada sesi berikutnya atau penyegaran plugin setiap anggota. Jika pembaruan masih tidak ditampilkan, konfirmasi bahwa unggahan berhasil dengan memeriksa versi plugin di marketplace Anda.

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.

Satu atau lebih entri plugin di marketplace.json Anda menggunakan source yang menunjuk di luar repositori yang terhubung (sumber github, url, atau git-subdir), dan repositori target bersifat pribadi. Sinkronisasi organisasi saat ini hanya dapat mengambil sumber eksternal dari repositori publik. Pindahkan folder plugin ke repositori marketplace dan ubah source setiap entri ke jalur relatif (misalnya, "./plugins/my-plugin"), kemudian dorong dan sinkronisasi ulang. Atau, unggah plugin yang terpengaruh secara individual melalui Customize > Add plugin > Create plugin > Upload plugin.

Sinkronisasi GitHub yang gagal dapat sementara menghapus plugin dari marketplace Anda. Perbaiki masalah yang mendasar, sinkronisasi ulang dengan berhasil, kemudian verifikasi bahwa preferensi instalasi diatur dengan benar, karena preferensi tersebut mungkin telah direset.

Pastikan Claude GitHub App diinstal di repositori tersebut. Token GitHub pribadi Anda diperiksa terlebih dahulu untuk mengonfirmasi akses, tetapi sinkronisasi itu sendiri menggunakan token instalasi GitHub App.

Jika pembaruan manual berfungsi tetapi mengaktifkan "Sinkronisasi otomatis" menampilkan "Tidak dapat mengakses repositori. Pastikan repositori ada dan Claude GitHub App diinstal," ada dua kemungkinan penyebab: