Lewati ke konten utama

Kelola plugin untuk organisasi Anda

Pasar plugin memungkinkan pemilik paket Team dan Enterprise untuk 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.

Pemilik dan Pemilik Utama paket Team dan Enterprise dapat mengelola plugin organisasi di Pengaturan Organisasi > Plugin.

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


Gunakan pasar yang dibangun oleh Anthropic

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 oleh Anthropic:

  1. Buka Pengaturan Organisasi > Plugin.

  2. Klik "Tambahkan plugin."

  3. Pilih "Jelajahi sumber Anthropic."

  4. Klik "Tambahkan" pada masing-masing yang ingin Anda tampilkan untuk semua orang di organisasi Anda.

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

  1. Buka Pengaturan Organisasi > Plugin.

  2. Temukan Knowledge Work.

  3. Klik tombol menu di sudut kanan atas.

  4. Pilih "Hapus."

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


Buat pasar Anda sendiri

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

  • 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, jalankan pasar yang disinkronkan GitHub untuk plugin inti Anda dan pasar manual terpisah untuk alat ad-hoc.

Siapkan pasar manual

  1. Buka Pengaturan Organisasi > Plugin.

  2. Klik "Tambahkan plugin" dan pilih "Unggah file" sebagai sumbernya.

  3. Jika ini adalah pertama kalinya Anda menyiapkan pasar, "Unggah ke pasar baru" dipilih secara otomatis. Anda akan dapat memilih "Tambahkan ke pasar yang ada" saat mengunggah plugin nanti.

  4. Masukkan nama untuk pasar Anda.

  5. Seret file Anda masuk, atau klik prompt unggahan dan pilih file Anda. File harus berupa .zip yang valid di bawah 50 MB.

  6. Ulangi untuk setiap plugin yang ingin Anda tambahkan.

  7. Klik "Unggah" untuk menambahkan plugin Anda ke pasar baru.

Jika Anda mengunggah plugin dengan nama yang sama dengan yang sudah ada, itu menimpa versi sebelumnya secara otomatis. Anda 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—baik secara manual maupun otomatis.

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.

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

  1. Pastikan Cowork dan Skills keduanya diaktifkan untuk organisasi Anda.

  2. Buka Pengaturan Organisasi > Plugin.

  3. Klik "Tambahkan plugin" dan pilih "GitHub" sebagai sumbernya.

  4. Masukkan repositori dalam format owner/repo (misalnya, acme-corp/claude-plugins).

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 kerja sinkronisasi

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

GitHub marketplace akan disinkronkan secara otomatis setiap kali PR digabung ke repo tersebut. Anda juga 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 perubahan, sinkronisasi dilewati. Jika ada perubahan, Cowork membaca manifest, memvalidasi setiap plugin, dan mengganti semua plugin di marketplace dengan status terkini dari repo. Sinkronisasi dapat memakan waktu hingga 30 menit tergantung jumlah plugin.

Penting: Jika sinkronisasi gagal, plugin mungkin dihapus sementara 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 mungkin telah direset selama kegagalan.

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 marketplace

Sinkronisasi GitHub

Prototyping cepat atau alat sekali pakai

Unggahan manual

Plugin yang dibuat oleh tim non-teknis

Unggahan manual

Lingkungan tanpa akses GitHub

Unggahan manual

Menguji plugin sebelum menambahkannya ke repo yang disinkronkan

Unggahan manual


Kontrol distribusi plugin

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

Preferensi

Apa yang dilakukannya

Apa yang dilihat anggota

Diinstal secara default

Diinstal secara otomatis untuk semua anggota organisasi

Plugin muncul di daftar terinstal mereka tanpa tindakan apa pun. Anggota dapat mencopot pemasangan jika mereka memilih.

Tersedia untuk diinstal

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.

Diperlukan

Diinstal secara otomatis untuk semua anggota organisasi tanpa opsi untuk menghapusnya

Plugin muncul di daftar terinstal mereka tanpa tindakan apa pun dan tidak dapat dinonaktifkan atau dihapus.

Atur preferensi

  1. Di Pengaturan Organisasi > Plugin, navigasikan ke marketplace Anda.

  2. Pilih preferensi instalasi untuk setiap plugin.

  3. Perubahan berlaku pada sesi berikutnya atau penyegaran plugin setiap anggota.

Apa yang dialami anggota

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 layanan mandiri.

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


Sesuaikan akses plugin berdasarkan grup

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

Akses plugin tingkat grup tersedia pada paket Enterprise dan dapat dikonfigurasi oleh Admin dan yang lebih tinggi.

Cara kerja penggantian grup

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.

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

Atur akses plugin untuk grup

  1. Di Pengaturan Organisasi > Plugin, navigasikan ke marketplace Anda.

  2. Temukan plugin yang ingin Anda sesuaikan.

  3. Di kolom Akses Kustom, klik "Tambah grup".

  4. Pilih grup dan pilih salah satu preferensi instalasi yang tercantum di atas.

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

Apa yang terjadi ketika anggota berada di beberapa grup

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.

Catatan: Ini adalah kebalikan dari cara batas pengeluaran grup diselesaikan. Batas pengeluaran menerapkan nilai paling ketat secara default, karena berfungsi sebagai kontrol anggaran. Akses plugin menerapkan nilai paling permisif, karena grup di sini dimaksudkan untuk memungkinkan akses bagi tim yang membutuhkan alat—bukan untuk bertindak sebagai batas keamanan. Jika Anda perlu memblokir plugin dengan keras, atur preferensi di seluruh organisasi ke "Tidak tersedia" dan hanya berikan akses ke grup yang seharusnya memilikinya.

Apa yang terjadi ketika grup dihapus

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 kustom. Anda dapat menghapus penggantian yatim piatu dari pengaturan akses kustom plugin.

Apakah pengaturan grup bertahan di seluruh sinkronisasi ulang marketplace?

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


Perbarui dan hapus plugin

Marketplace manual

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 — legal akan selalu menggantikan legal.

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

Marketplace yang disinkronkan GitHub

Dorong perubahan Anda ke repositori yang terhubung, lalu 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, hapusnya 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 marketplace (manual)

100

Per marketplace

Plugin maks per marketplace (sinkronisasi GitHub)

500

Per marketplace

Panjang nama plugin maks

64 karakter

Harus menggunakan kata-kata huruf kecil yang dipisahkan oleh 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-kata huruf kecil yang dipisahkan oleh tanda hubung (misalnya, deployment-tools, bukan Deployment Tools). Nama marketplace berikut dicadangkan dan tidak dapat digunakan:

  • claude-code-marketplace

  • claude-code-plugins

  • claude-plugins-official

  • anthropic-marketplace

  • anthropic-plugins

  • agent-skills

  • life-sciences

Nama yang menyamar sebagai pasar resmi Anthropic juga diblokir.

Catatan: Penulis plugin dapat mengatur displayName sehingga plugin menampilkan nama yang dapat dibaca di katalog alih-alih slug-nya. Jika penulis tidak mengaturnya, plugin menampilkan slug-nya (misalnya, deployment-tools).


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

Sinkronisasi gagal dengan "Sumber plugin eksternal belum didukung," atau plugin dilewati dengan "Repositori tidak ditemukan di github.com. Periksa URL dan pastikan repositori bersifat publik."

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

Plugin Hilang Setelah Sinkronisasi Gagal

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

Tidak Dapat Melihat Repo GitHub Saat Menghubungkan

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

Apakah pertanyaan Anda terjawab?