Lewati ke konten utama

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), di Claude Cowork, dan di sesi Claude Code tempat anggota masuk dengan akun Claude yang sama.

Pemilik dan Pemilik Utama paket Team dan Enterprise dapat mengelola plugin organisasi di Pengaturan Organisasi > Plugin & keterampilan. Pada paket Enterprise, anggota dengan peran khusus yang mencakup pengelolaan perpustakaan organisasi juga dapat melakukannya.

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

Untuk versi referensi kontrol ini, lihat Kelola plugin untuk organisasi Anda di dokumentasi Claude Code.

Catatan: Menonaktifkan Skills untuk organisasi Anda juga menghentikan sinkronisasi keterampilan dan plugin ke Claude Code, dan menghapus yang sudah tersinkronisasi di sana. Menonaktifkan Cowork tidak mempengaruhi sinkronisasi ke Claude Code. Untuk menyimpan keterampilan dan plugin di Claude tetapi menghentikan hanya sinkronisasi, atur syncClaudeAiSkills dan syncClaudeAiPlugins ke false dalam pengaturan terkelola Claude Code. Pelajari lebih lanjut tentang penyiapan admin Claude Code.

Catatan: Pasar adalah cara pemilik mendistribusikan plugin ke organisasi mereka. Pengguna juga dapat berbagi plugin yang mereka buat dengan rekan kerja atau grup tertentu, atau mengirimkannya untuk dipublikasikan ke perpustakaan organisasi Anda. Berbagi dan penerbitan dikendalikan oleh pengaturan di Pengaturan Organisasi > Plugin & keterampilan di tab "Kebijakan", dan pengajuan plugin ditinjau di sana di tab "Permintaan". Pelajari lebih lanjut tentang menggunakan plugin di Claude dan membiarkan pengguna menerbitkan keterampilan dan plugin ke organisasi Anda.


Lihat apa yang ada di organisasi Anda

Tab "Inventaris" mencantumkan setiap keterampilan dan plugin yang diatur oleh organisasi Anda, termasuk yang dibuat pengguna untuk diri mereka sendiri. Keterampilan dan plugin sekarang berada di halaman yang sama, jadi Anda tidak perlu beralih antar pengaturan.

Untuk setiap item, tabel menampilkan sumbernya, versi, kemampuan, audiens, dan berapa banyak orang yang menggunakannya dalam 30 hari terakhir.

Untuk menemukan item, cari berdasarkan nama atau gunakan filter:

  • Sumber: Organisasi Anda, perpustakaan Organisasi, atau pasar tertentu

  • Audiens: Siapa yang dapat menggunakan item

  • Jenis: Keterampilan atau plugin

Keterampilan yang dikelola organisasi Anda muncul di bawah Perpustakaan Organisasi. Anda mengelola pasar plugin di tab Pasar.

Untuk bertindak pada item, klik tombol menu di akhir barisnya. Anda dapat melihat detail dan file, melihat riwayat versi, dan mengubah akses default dan grup.

Untuk keterampilan dan plugin yang dibuat pengguna, tab Inventaris menampilkan metadata dan status berbagi. Ini tidak menampilkan file itu sendiri.

Gunakan pasar yang dibangun Anthropic

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

Untuk menambahkan pasar yang dibangun Anthropic:

  1. Klik "Tambah," lalu pilih "Tambah pasar."

  2. Pilih "Jelajahi sumber Anthropic."

  3. Klik "Tambah" 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. Temukan Knowledge Work.

  2. Klik tombol menu di sudut kanan atas.

  3. Pilih "Hapus."

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


Buat pasar Anda sendiri

Selain pasar yang dibangun 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 menyimpan plugin di repositori Git.

  • Sinkronisasi repositori: Hubungkan repositori GitHub atau GitLab pribadi dan Claude 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. Klik "Tambah," lalu pilih "Unggah plugin."

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

  3. Masukkan nama untuk pasar Anda.

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

  5. Ulangi untuk setiap plugin yang ingin Anda tambahkan.

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

Jika Anda mengunggah plugin dengan nama yang sama dengan yang sudah ada, itu akan 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

Anda dapat menghubungkan repo yang dihosting di github.com atau di host GitHub Enterprise organisasi Anda. Di github.com, repositori Anda harus pribadi atau internal—repo publik tidak diizinkan untuk pasar organisasi. Untuk menyinkronkan dari GitLab, lihat Siapkan pasar yang disinkronkan GitLab.

Pasar yang disinkronkan GitHub mendukung set source yang lebih sempit dalam marketplace.json daripada yang dilakukan Claude Code. Jalur relatif ke folder plugin di dalam repositori pasar (misalnya, "source": "./plugins/my-plugin") sepenuhnya didukung, dan merupakan opsi paling sederhana. Jenis sumber github, url, dan git-subdir juga didukung. Jenis sumber npm, archive, dan command tidak didukung.

Sumber plugin dapat bersifat pribadi dalam tiga kasus:

  • Sumber github.com yang membagikan pemilik repositori marketplace Anda, yang sinkronisasi organisasi diambil melalui Claude GitHub App.

  • Sumber di host GitHub Enterprise organisasi Anda dengan Claude GitHub Enterprise App organisasi Anda yang dipasang di repositori tersebut.

  • Sumber url atau git-subdir di host GitLab yang sama dengan repositori marketplace Anda. Di gitlab.com, sumber juga harus berada di bawah grup tingkat atas atau namespace pengguna yang sama dengan repositori marketplace.

Setiap sumber lainnya diambil tanpa kredensial, jadi harus berupa repositori publik di github.com, gitlab.com, atau bitbucket.org. Sumber di host lain ditolak.

Jika kode plugin Anda berada di repositori pribadi yang tidak memenuhi kriteria di atas, salin folder plugin tersebut ke repositori marketplace dan ubah sumber setiap plugin menjadi jalur relatif (git subtree atau langkah CI yang memvendor file berfungsi dengan baik).

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

Sumber daya tambahan:

Hubungkan repositori

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

  2. Buka Pengaturan organisasi > Plugin & skills dan klik tab "Marketplaces".

  3. Klik "Tambah plugin," lalu pilih "Sinkronkan dari GitHub."

  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 dipasang di repositori tersebut.

Cara sinkronisasi bekerja

Sinkronisasi awal berjalan secara otomatis saat Anda menghubungkan repositori. Dalam alur pembuatan GitHub, Anda juga dapat mematikan "Sinkronkan secara otomatis," yang aktif secara default. Dengan opsi ini aktif, sinkronisasi berjalan saat pull request digabungkan ke cabang yang diikuti marketplace, atau saat seseorang mendorong ke cabang tersebut secara langsung.

Orang yang mengaktifkan atau menonaktifkan sinkronisasi otomatis harus memiliki akses tingkat admin ke repositori 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 repositori. Pastikan repositori ada dan Claude GitHub App dipasang," bahkan ketika App dipasang 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 repositori atau organisasi.

Setelah diaktifkan, sinkronisasi otomatis untuk repositori GitHub berjalan saat pull request yang mencakup bump versi plugin digabungkan ke cabang default repositori. Dorongan langsung ke cabang default tidak memicu sinkronisasi. Anda selalu dapat memicu sinkronisasi secara manual dengan mengklik "Sinkronkan ulang" di marketplace.

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 marketplace dengan status repo saat ini. Sinkronisasi dapat memakan waktu hingga 30 menit tergantung jumlah plugin.

Penting: Jika sinkronisasi gagal, anggota menyimpan versi terakhir yang disinkronkan dari setiap plugin. Periksa pesan kegagalan, perbaiki repo, dan sinkronkan ulang.

Siapkan marketplace yang disinkronkan GitLab

Anda dapat menyinkronkan marketplace organisasi dari repositori di gitlab.com atau di instans GitLab yang dikelola sendiri. Untuk jenis sumber plugin yang didukung dan sumber mana yang dapat bersifat pribadi, lihat Siapkan repositori Anda di atas.

Dukungan GitLab dalam beta dan berlaku untuk sinkronisasi marketplace plugin saja. Claude Code di web belum mendukung repositori GitLab.

Sebelum Anda mulai

  • Peran. Anda memerlukan peran Owner atau Primary Owner untuk menambahkan konfigurasi GitLab.

  • Visibilitas proyek. Di gitlab.com, proyek marketplace harus bersifat pribadi atau internal. Di instans yang dikelola sendiri, visibilitas apa pun berfungsi.

  • Token akses. Buat token akses GitLab untuk Claude membaca proyek marketplace dan proyek sumber plugin apa pun di host yang sama. Token akses pribadi, grup, dan proyek semuanya berfungsi. Pengguna token memerlukan setidaknya peran Reporter di proyek tersebut.

    • Token warisan (berjangkauan): setidaknya cakupan read_api.

    • Token akses pribadi berbutir halus: izin Proyek: Baca, Cabang: Baca, dan Repositori: Baca.

    • Opsional, untuk penyiapan webhook otomatis (langkah 3): peran Maintainer di proyek marketplace ditambah cakupan api (warisan) atau izin Webhook: Buat dan Hapus (berbutir halus). Tanpa ini, Anda menambahkan webhook dengan tangan sekali (langkah 4).

  • Hanya instans yang dikelola sendiri.

    • Nama host instans harus diselesaikan ke alamat IP publik, dan instans harus menerima koneksi HTTPS dari alamat IP keluar Anthropic.

    • Jika otoritas sertifikat pribadi mengeluarkan sertifikat TLS-nya, siapkan sertifikat CA (PEM).

    • Pengiriman webhook untuk sinkronisasi otomatis berasal dari instans Anda ke api.anthropic.com, jadi instans harus dapat membuat permintaan HTTPS keluar ke host tersebut.

Langkah 1: Tambahkan konfigurasi GitLab

Untuk menambahkan konfigurasi GitLab:

  1. Di bawah Infrastruktur yang dihosting sendiri, temukan GitLab dan klik "Tambah konfigurasi."

  2. Masukkan nama tampilan, nama host (gitlab.com, atau nama host instans Anda seperti gitlab.example.com), token akses, dan, untuk instans yang dikelola sendiri dengan CA pribadi, sertifikat CA.

  3. Klik "Tambah konfigurasi." Claude menjalankan tes koneksi segera dan menampilkan hasilnya dalam dialog tes koneksi GitLab.

  4. (Opsional) Untuk memverifikasi bahwa token dapat membaca proyek marketplace Anda, masukkan jalurnya (misalnya, platform/claude-plugins) di bawah Jalur proyek dan klik "Uji akses sinkronisasi."

Anda dapat menjalankan kembali tes kapan saja dari menu konfigurasi dengan Uji koneksi. Nama host tidak dapat diubah nanti. Jika berubah, hapus konfigurasi dan tambahkan yang baru.

Langkah 2: Tambahkan marketplace

Untuk menambahkan marketplace:

  1. Buka Pengaturan organisasi > Plugin & keterampilan dan klik tab "Marketplaces".

  2. Klik "Tambah," lalu pilih "Sinkronkan dari GitLab."

  3. Di URL repositori GitLab, masukkan URL HTTPS proyek, misalnya https://gitlab.example.com/platform/claude-plugins. Proyek dalam subgrup bersarang berfungsi.

  4. Biarkan Sinkronkan secara otomatis aktif jika Anda ingin push memicu sinkronisasi (lihat Langkah 3).

  5. Pilih Akses default untuk plugin yang dimuat marketplace.

  6. Klik "Buat."

Claude membaca cabang default proyek dan memvalidasi file marketplace sebelum membuat marketplace, yang dinamai menurut jalur proyek.

Langkah 3: Sinkronisasi otomatis

Dengan Sinkronkan secara otomatis aktif, setiap push ke cabang default proyek memicu sinkronisasi melalui webhook di proyek GitLab. Jika token Anda dapat mengelola webhook (lihat Sebelum Anda mulai), Claude membuat webhook untuk Anda dan tidak ada yang perlu dilakukan.

Anda dapat mengaktifkan atau menonaktifkan Sinkronkan secara otomatis nanti dari menu marketplace. Mengaktifkannya menyiapkan webhook dengan cara yang sama.

Langkah 4: Jika Claude tidak dapat membuat webhook

Jika token tidak dapat mengelola webhook, Claude menampilkan pesan Selesaikan penyiapan webhook di GitLab di layar dengan URL Webhook dan token. Token ditampilkan hanya sekali, jadi selesaikan langkah ini sebelum menutup pesan.

  1. Di proyek GitLab Anda, buka Pengaturan > Webhook dan tambahkan webhook baru dengan URL dari pesan.

  2. Tempel token ke dalam bidang.

    1. Jika pesan menampilkan Token rahasia, tempel ke bidang Token rahasia GitLab.

    2. Jika pesan menampilkan Token penandatanganan (gitlab.com dan versi yang dikelola sendiri 19.1 atau lebih baru), pilih "Hasilkan token penandatanganan" di GitLab dan ganti nilai yang dihasilkan dengan nilai dari Claude.

  3. Aktifkan Acara push dan simpan.

  4. (Opsional) Gunakan Uji > Acara push pada webhook baru di GitLab dan konfirmasi melaporkan HTTP 200.

Jika Anda kehilangan token, buka Konfigurasi webhook dari menu marketplace, klik "Hapus webhook," lalu "Aktifkan webhook" untuk mendapatkan yang baru. Token lama akan berhenti berfungsi.

Pilih antara unggahan manual dan sinkronisasi repositori

Skenario

Pendekatan yang disarankan

Plugin dikelola dalam kontrol versi dengan CI/CD

Sinkronisasi GitHub atau GitLab

Beberapa pengembang berkolaborasi pada plugin

Sinkronisasi GitHub atau GitLab

Anda menginginkan propagasi pembaruan otomatis

Sinkronisasi GitHub atau GitLab

Prototyping cepat atau alat sekali pakai

Unggahan manual

Plugin yang dibangun oleh tim non-teknik

Unggahan manual

Lingkungan tanpa akses GitHub atau GitLab

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

Pra-instal plugin untuk semua anggota organisasi

Plugin muncul dalam daftar mereka tanpa tindakan apa pun. Anggota dapat mematikannya jika mereka memilih.

Tersedia untuk diinstal

Terdaftar di tab Temukan

Pengguna melihatnya di tab Temukan dan dapat menambahkannya sendiri.

Tidak tersedia

Tersembunyi sepenuhnya

Pengguna tidak dapat melihat atau menambahkan plugin. Berguna untuk staging atau menghapus plugin.

Diperlukan

Pra-menginstal plugin untuk semua anggota organisasi tanpa opsi untuk menghapusnya

Plugin muncul dalam daftar mereka tanpa tindakan apa pun, ditandai "Plugin ini diperlukan oleh organisasi Anda." Pengguna tidak dapat mematikannya atau menghapusnya. Plugin juga tetap aktif dalam sesi Claude Code yang menyinkronkan plugin akun anggota.

Penting: Plugin yang diatur ke "Diinstal secara default" atau "Diperlukan" juga diinstal di Claude Code untuk pengguna yang masuk dengan akun Claude mereka. Di Claude Code, hook plugin, sub-agen, dan server MCP berjalan di komputer pengguna, dan plugin "Diperlukan" tidak dapat dinonaktifkan di sana. Tinjau hook plugin sebelum Anda mengaturnya ke "Diperlukan." Pelajari lebih lanjut tentang plugin yang disinkronkan dalam dokumentasi Claude Code.

Atur preferensi

  1. Temukan plugin dan klik tombol menu di akhir barisnya.

  2. Klik "Akses default," lalu pilih opsi di bawah Instal.

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

Apa yang dialami anggota

Anggota menjelajahi plugin yang tersedia di tab Temukan di Sesuaikan > Plugin. Plugin yang Anda atur ke "Diinstal secara default" atau "Diperlukan" muncul dalam daftar mereka secara otomatis. Plugin yang Anda atur ke "Tersedia untuk diinstal" muncul di Temukan agar anggota dapat menambahkannya sendiri.

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


Sesuaikan akses plugin berdasarkan grup

Admin Enterprise 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 diinstal sendiri, dan menyembunyikannya dari semua orang lain.

Akses plugin tingkat grup tersedia pada paket Enterprise. Anda mengaturnya di halaman Pengaturan Organisasi > Plugin & keterampilan yang sama, yang memerlukan Pemilik atau peran khusus yang mencakup pengelolaan perpustakaan organisasi.

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

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

Atur akses plugin untuk grup

  1. Temukan plugin yang ingin Anda sesuaikan dan klik tombol menu di akhir barisnya.

  2. Klik "Akses grup...".

  3. Klik "Tambah grup" di sebelah Penargetan instalasi.

  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 berbeda dari cara batas pengeluaran grup diselesaikan. Batas pengeluaran menerapkan nilai grup yang lebih tinggi atau lebih rendah tergantung pada pengaturan Batas pengeluaran multi-grup Anda. 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, 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 grup..." plugin.

Apakah pengaturan grup bertahan di seluruh sinkronisasi ulang marketplace?

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


Batasi marketplace mana yang dapat ditambahkan pengguna

Pemilik atau Pemilik Utama dapat membatasi marketplace plugin mana yang dapat ditambahkan orang di organisasi Anda, menggunakan daftar izin, daftar blokir, atau keduanya. Anda menetapkan daftar ini dalam pengaturan terkelola Claude Code, tetapi mereka juga berlaku di Claude dan Claude Cowork.

Untuk menetapkan daftar izin atau daftar blokir:

  1. Temukan Pengaturan terkelola.

  2. Klik "Kelola."

  3. Tambahkan strictKnownMarketplaces (daftar izin), blockedMarketplaces (daftar blokir), atau keduanya ke JSON.

  4. Klik "Tambah pengaturan" atau "Perbarui pengaturan."

Masukkan nama organisasi GitHub Anda persis seperti yang ditampilkan GitHub, karena pencocokan daftar izin peka huruf besar-kecil. Jika sumber ada di kedua daftar, itu diblokir.

Setelah daftar diatur, Claude memeriksanya setiap kali seseorang di organisasi Anda menambahkan marketplace dari repositori Git di Claude, Claude Desktop, atau Cowork. Ini mencakup marketplace yang ditambahkan pengguna untuk diri mereka sendiri di Sesuaikan dan marketplace yang ditambahkan untuk seluruh organisasi di Pengaturan Organisasi > Plugin & keterampilan. Claude menolak repositori apa pun yang tidak diizinkan daftar, kecuali marketplace yang dibangun Anthropic.

Ingat:

  • Atur daftar di Pengaturan Organisasi. File managed-settings.json atau kebijakan MDM yang diterapkan ke komputer hanya berlaku untuk Claude Code di komputer tersebut.

  • Marketplace yang ada tidak diperiksa ulang. Marketplace yang ditambahkan sebelum Anda menetapkan daftar tetap ada sampai seseorang menghapusnya.

  • Plugin yang diunggah tidak diperiksa. Untuk menghentikan pengguna dari mengunggah file plugin, matikan Keterampilan yang dibuat pengguna di Pengaturan Organisasi > Plugin & keterampilan di tab "Kebijakan".

Untuk setiap jenis sumber yang diterima daftar, lihat Batasi apa yang dapat diinstal pengguna dalam dokumentasi Claude Code.


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

Untuk menghapus plugin, hapusnya dari marketplace Anda di Pengaturan Organisasi > Plugin & keterampilan di bawah tab "Inventaris".

Marketplace yang disinkronkan GitHub

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

Untuk marketplace yang disinkronkan GitLab, lihat Siapkan marketplace yang disinkronkan GitLab.

Untuk menghapus plugin, hapusnya dari repositori dan picu sinkronisasi.


Batas

Batas

Nilai

Catatan

Ukuran ZIP plugin maksimal (unggah)

200 MB

Diberlakukan di sisi klien dan server

Plugin maksimal per marketplace (manual)

1000

Per marketplace

Plugin maksimal per marketplace (sinkronisasi GitHub atau GitLab)

1000

Per marketplace

Panjang nama plugin maksimal

64 karakter

Harus menggunakan kata huruf kecil dipisahkan dengan tanda hubung

Waktu tunggu sinkronisasi

30 menit

Per operasi sinkronisasi

Visibilitas repositori yang disinkronkan

Pribadi atau internal saja di github.com dan gitlab.com

Dihosting di github.com, GitHub Enterprise Server, gitlab.com, atau instans GitLab yang dikelola sendiri. Host GitLab (termasuk gitlab.com) memerlukan konfigurasi GitLab di Pengaturan Organisasi > Claude Code.
​
Repositori publik tidak didukung.


Aturan penamaan

Nama plugin harus menggunakan kata huruf kecil dipisahkan dengan 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 marketplace resmi Anthropic juga diblokir.

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


Pemecahan masalah

Unggahan ditolak

Penyebab umum: file melebihi 200 MB, bukan file ZIP yang valid, atau marketplace telah mencapai batas 1000 plugin. Periksa ukuran dan format file, dan hapus plugin yang tidak digunakan jika Anda sudah penuh. Jika pemindaian keterampilan dan plugin aktif, plugin juga dapat ditolak karena ditandai untuk konten berbahaya. Tinjau alasannya, perbaiki masalahnya, dan unggah plugin lagi.

Plugin tidak muncul untuk anggota

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

Plugin yang diperbarui tidak tercermin untuk anggota

Perubahan berlaku pada sesi berikutnya atau penyegaran plugin setiap anggota. Di Claude Code, pengguna mendapatkan perubahan saat mereka memulai Claude Code berikutnya. Jika pembaruan masih tidak ditampilkan, konfirmasi unggahan berhasil dengan memeriksa versi plugin di marketplace 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 referensi manifes plugin.

Sinkronisasi gagal dengan "Jenis sumber plugin eksternal tidak didukung. Jenis yang didukung: git-subdir, github, url" atau plugin dilewati dengan "Repositori tidak ditemukan di gitlab.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 sinkronisasi organisasi tidak dapat mengambilnya. Sumber pribadi hanya berfungsi dalam tiga kasus: repositori github.com berbagi pemilik repositori marketplace Anda, repositori di host GitHub Enterprise organisasi Anda dengan Aplikasi GitHub Enterprise Anda diinstal di atasnya, atau sumber url atau git-subdir di host GitLab yang sama dengan repositori marketplace Anda (di gitlab.com, juga di bawah grup tingkat atas atau namespace pengguna yang sama).

Untuk sumber pribadi lainnya, pindahkan folder plugin ke repositori marketplace dan ubah source setiap entri menjadi jalur relatif (misalnya, "./plugins/my-plugin"), kemudian dorong dan sinkronkan ulang. Atau, unggah plugin yang terpengaruh secara individual melalui Pengaturan Organisasi > Plugin & keterampilan Klik "Tambah," "Unggah plugin," lalu pilih "Tambahkan ke marketplace yang ada." Plugin yang diunggah melalui menu Kustomisasi anggota sendiri hanya dipasang untuk anggota tersebut dan tidak didistribusikan ke organisasi Anda, meskipun anggota dapat berbagi plugin dengan rekan kerja atau grup tertentu jika berbagi diaktifkan.

Tidak dapat melihat repositori GitHub saat menghubungkan

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.

"Tidak dapat mengakses repositori" saat mengaktifkan "Sinkronkan secara otomatis"

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

  • Anda tidak memiliki akses admin ke repositori. Mengaktifkan sinkronisasi otomatis membuat webhook, yang memerlukan akses tingkat admin ke repo melalui koneksi GitHub pribadi Anda. Minta admin repositori untuk mengaktifkan toggle, atau tingkatkan akses GitHub Anda.

  • Izin Webhooks Claude GitHub App belum disetujui. Pada instalasi yang lebih lama, GitHub menampilkan prompt "Claude meminta izin yang diperbarui". Admin repositori atau organisasi perlu menyetujui izin Webhooks (Baca & Tulis) pada instalasi.

"Tidak ada instans GitLab yang dikonfigurasi untuk organisasi Anda. Tambahkan satu di pengaturan Claude Code, lalu kembali ke sini" saat menambahkan marketplace

Jika Anda melihat pesan ini saat menambahkan marketplace di GitLab, pastikan Anda telah menambahkan konfigurasi GitLab terlebih dahulu. Lihat Langkah 1: Tambahkan konfigurasi GitLab di bawah Siapkan marketplace yang disinkronkan GitLab.

"URL ini tidak ada di instans GitLab yang dikonfigurasi"

Pastikan nama host URL cocok dengan nama host GitLab yang dikonfigurasi dengan tepat.

Menambahkan proyek gitlab.com gagal dengan "Gagal membuat marketplace. Coba lagi."

Periksa bahwa visibilitas proyek bersifat pribadi atau internal. Proyek gitlab.com publik tidak dapat digunakan sebagai marketplace organisasi.

Tes koneksi gagal di Reach host (misalnya "Nama host tidak dapat diselesaikan," "Koneksi ditolak," atau "GitLab tidak merespons tepat waktu"), atau menambahkan marketplace pada instans yang dikelola sendiri gagal dengan kesalahan umum

Konfirmasi instans dapat dijangkau dari internet publik melalui HTTPS dan bahwa alamat IP keluar Anthropic diizinkan melalui firewall Anda. "Koneksi aman tidak dapat diestablish" biasanya berarti sertifikat CA hilang atau salah.

Kesalahan yang dimulai dengan "Autentikasi ke … gagal" atau "Akses ditolak"

Token telah kedaluwarsa, dicabut, atau kehilangan cakupan atau peran yang tercantum di bagian Sebelum Anda mulai di bawah Siapkan marketplace yang disinkronkan GitLab. Buat token baru dan tempel ke dalam konfigurasi (Edit > Token Akses).

Apakah pertanyaan Anda terjawab?