Kelola plugin Claude Cowork untuk organisasi Anda

Pasar plugin memungkinkan pemilik paket Team dan Enterprise untuk mendistribusikan plugin yang dikurasi kepada semua orang di organisasi mereka melalui Claude Cowork. Anda membuat pasar, menambahkan plugin ke dalamnya, dan mengontrol dengan tepat plugin mana yang dapat dilihat dan digunakan oleh anggota tim Anda.

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

Ada dua cara untuk menambahkan plugin ke pasar:

Anda dapat menggunakan kedua pendekatan secara paralel—misalnya, 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—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.

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.

Pasar yang disinkronkan GitHub mendukung kumpulan tipe 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. Tipe sumber github, url, dan git-subdir didukung hanya ketika repositori target bersifat publik. Tipe 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:

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

Tidak dapat melihat repo Anda? Pastikan Claude GitHub App diinstal di repositori tersebut.

Sinkronisasi awal berjalan secara otomatis ketika Anda menghubungkan repositori. Setelah itu, pemilik organisasi dapat memilih untuk melanjutkan pembaruan otomatis per pasar dengan membuka Pengaturan Organisasi > Plugin (di bawah Perpustakaan), mengklik tombol menu di sudut kanan atas pasar, kemudian mengalihkan "Sinkronkan secara otomatis" ke:

Pasar GitHub kemudian akan disinkronkan secara otomatis setiap kali PR digabungkan ke repo tersebut. Anda juga dapat memicu sinkronisasi secara manual dengan mengklik "Perbarui" di pasar.

Selama sinkronisasi, Cowork membandingkan komit terbaru di repo Anda dengan komit 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 repo saat ini. Sinkronisasi dapat memakan waktu hingga 30 menit tergantung pada jumlah plugin.

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

Anggota menjelajahi plugin yang tersedia melalui modal Jelajahi plugin di Cowork. Plugin yang dipasang otomatis muncul di daftar terinstal mereka secara otomatis. Plugin yang tersedia muncul di katalog untuk pemasangan layanan mandiri.

Anggota tidak dapat mengedit plugin yang dikelola organisasi, yang mencegah perubahan yang bertentangan dengan alat bersama.

Admin Enterprise dapat mengganti preferensi pemasangan organisasi-lebar plugin untuk grup tertentu. Misalnya, Anda dapat memasang otomatis plugin untuk grup Engineering, membuatnya tersedia untuk Legal untuk dipasang sendiri, dan menyembunyikannya dari semua orang lain.

Setiap plugin di marketplace Anda memiliki preferensi pemasangan organisasi-lebar (Dipasang secara default, Tersedia untuk dipasang, Diperlukan, atau Tidak tersedia). Secara default, setiap grup mewarisi pengaturan organisasi-lebar itu.

Ketika Anda menetapkan penggantian tingkat grup untuk plugin, itu menggantikan pengaturan organisasi-lebar untuk anggota grup itu. Urutan resolusi adalah: pengaturan grup, kemudian pengaturan organisasi-lebar, 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 > Dipasang secara default > Tersedia untuk dipasang > Tidak tersedia.

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

Jika grup dihapus—misalnya, jika 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 khusus. Anda dapat menghapus penggantian yatim piatu dari pengaturan akses khusus 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 pengidentifikasi unik — legal akan selalu menggantikan legal.

Untuk menghapus plugin, hapus 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. Perhatikan bahwa jika pemilik telah mengaktifkan "Sinkronkan secara otomatis" untuk marketplace yang disinkronkan GitHub, ini akan terjadi secara otomatis setelah mendorong perubahan ke repo.

Untuk menghapus plugin, hapus 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 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 pastikan bahwa Cowork dan Skills keduanya diaktifkan untuk organisasi Anda.

Perubahan berlaku pada sesi berikutnya atau penyegaran plugin setiap anggota. Jika pembaruan masih tidak ditampilkan, pastikan 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 repository yang terhubung (sumber github, url, atau git-subdir), dan repository target bersifat pribadi. Sinkronisasi organisasi saat ini hanya dapat mengambil sumber eksternal dari repository publik. Pindahkan folder plugin ke repository 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—preferensi mungkin telah direset.

Pastikan Aplikasi GitHub Cowork diinstal di repository tersebut. Token GitHub pribadi Anda diperiksa terlebih dahulu untuk mengonfirmasi akses, tetapi sinkronisasi itu sendiri menggunakan token instalasi Aplikasi GitHub.