Kelola plugin Claude Code untuk organisasi Anda

​

Pre-install dan require plugins

​

Pilih mekanisme pengiriman

• Pengaturan terkelola server: tetapkan kunci plugin sebagai JSON di Organization settings > Claude Code > Managed settings. Memerlukan peran Owner dalam organisasi Claude Anda. Sesi cloud mengambil pengaturan ini sebelum menginstal plugin.
• Kebijakan MDM: di macOS, berikan plist yang kunci tingkat atas adalah kunci pengaturan. Di Windows, simpan seluruh dokumen JSON sebagai string dalam nilai registri. Domain plist dan kunci registri ada di Tempat setiap mekanisme menyimpan kebijakan.
• File pengaturan terkelola: tempatkan managed-settings.json di jalur sistem platform. Anda juga dapat menambahkan file ke direktori drop-in managed-settings.d/ di sebelahnya. Jalur file per platform ada di Tempat setiap mekanisme menyimpan kebijakan, dan aturan penggabungan drop-in ada di Pisahkan kebijakan berbasis file di seluruh tim.

​

Sumber terkelola mana yang berlaku di mesin

​

Memerlukan marketplace dan pluginnya

{
  "extraKnownMarketplaces": {
    "your-marketplace": {
      "source": { "source": "github", "repo": "your-org/your-marketplace" },
      "autoUpdate": true
    }
  },
  "enabledPlugins": {
    "code-formatter@your-marketplace": true,
    "deploy-helper@your-marketplace": true
  }
}

• autoUpdate: true membuat marketplace dan pluginnya menyegarkan di latar belakang, dan false mematikannya. Lihat Tetapkan kebijakan pembaruan.
• source: github adalah salah satu dari beberapa jenis sumber. Sumber git mengambil url untuk GitLab atau host internal, dan sumber url mengambil alamat marketplace.json yang dihosting. Setiap bentuk sumber ada di referensi marketplace.

• Marketplaces: entri marketplace terkelola mengganti entri dengan prioritas lebih rendah dengan nama yang sama, dan bidang dua entri tidak digabungkan.
• Salinan --plugin-dir: --plugin-dir memuat plugin dari direktori lokal untuk satu sesi. Untuk apa yang terjadi ketika nama salinan itu cocok dengan plugin yang dinamai enabledPlugins terkelola Anda, lihat Konflik nama.

​

Memerlukan plugin per repositori

• Sesi interaktif: Claude Code mendaftarkan marketplace hanya setelah kontributor menerima dialog kepercayaan workspace untuk folder itu.
• Lari -p non-interaktif: entri hanya berlaku dalam folder yang kepercayaannya sudah diterima pengguna secara interaktif, atau yang bendera hasTrustDialogAccepted Anda tetapkan dalam ~/.claude.json.

​

Ketika setiap permukaan menerapkan kunci plugin

​

Konfirmasi peluncuran

• Di satu mesin: mulai Claude Code dan jalankan /plugin. Marketplace dan plugin terdaftar.
• Dalam CI: jalankan claude -p dengan --output-format stream-json --verbose. Acara init mencantumkan plugin yang dimuat di bawah plugins.

​

Seed containers dan CI

CLAUDE_CODE_PLUGIN_CACHE_DIR=/opt/claude-seed claude plugin marketplace add your-org/your-marketplace
CLAUDE_CODE_PLUGIN_CACHE_DIR=/opt/claude-seed claude plugin install code-formatter@your-marketplace

• Baca-saja: Claude Code tidak pernah menulis ke seed dan memaksa autoUpdate mati untuk marketplace seed.
• Entri seed mengambil prioritas: pada setiap startup, marketplace yang dideklarasikan dalam seed menimpa entri pengguna dengan nama yang sama. Pengguna keluar dari plugin seed dengan claude plugin disable, bukan dengan menghapus marketplace.
• Pembaruan dan penghapusan gagal: claude plugin marketplace update <name> dan remove tanpa --scope pada marketplace seed gagal dengan pesan yang menamai direktori seed.
• Kebijakan masih berlaku: allowlist dan blocklist memeriksa sumber marketplace seed yang tercatat juga. Izinkan sumber yang Anda bangun seed darinya.

​

Batasi apa yang dapat diinstal pengguna

• Sebelum unduhan: daftar berlaku ketika pengguna menambahkan marketplace dan pada setiap instalasi, pembaruan, penyegaran, dan auto-update.
• Pada awal sesi: daftar berlaku lagi ke plugin yang sudah diinstal, jadi plugin yang diinstal yang sumber marketplace-nya tidak lagi cocok tidak dimuat. /plugin mencantumkannya dengan Marketplace "<name>" is not in the allowed marketplace list atau Marketplace "<name>" is blocked by enterprise policy.

• Konsol admin claude.ai: Claude Code menerapkan kedua daftar dalam sesi yang membaca pengaturan terkelola server. claude.ai juga memeriksanya ketika siapa pun dalam organisasi Anda menambahkan marketplace baru dari repositori git di claude.ai, atau dari Customize di Claude Desktop app di luar tab Code-nya. Itu mencakup marketplace yang ditambahkan anggota untuk akun mereka sendiri dan yang ditambahkan untuk seluruh organisasi di bawah Organization settings > Plugins. claude.ai menolak repositori yang allowlist tidak terima atau yang blocklist namai. Ini tidak memeriksa ulang marketplace yang ditambahkan di tempat mana pun sebelum Anda menetapkan daftar, dan tidak memeriksa plugin yang diunggah.
• File pengaturan terkelola, kebijakan tingkat OS, atau sumber terkelola lainnya: Claude Code menerapkan kedua daftar di mana ia membaca sumber itu. claude.ai tidak membacanya.

​

Matriks kontrol

• enabledPlugins: Anda dapat menetapkannya dalam cakupan apa pun, dan pengaturan terkelola menguncinya.
• syncClaudeAiPlugins: setiap pengguna juga dapat menetapkannya dalam pengaturan pengguna atau lokal mereka sendiri. Lihat cakupannya dalam referensi pengaturan.
• CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL: ini adalah variabel lingkungan yang Anda berikan melalui blok env terkelola yang ditunjukkan di bawah Matikan pembaruan untuk seluruh armada.

​

Alias untuk kunci marketplace

• Versi: alias memerlukan Claude Code v2.1.232 atau lebih baru, dan klien yang lebih lama mengabaikannya. Dalam file yang dibaca armada campuran, pertahankan nama kanonik.
• Kedua ejaan ditetapkan: ketika file menetapkan kedua ejaan, nilai kunci kanonik berlaku.

​

Allowlist dengan strictKnownMarketplaces

• github: { "source": "github", "repo": "your-org/approved-plugins" }, dengan ref dan path opsional.
• Wildcard pemilik github: { "source": "github", "repo": "your-org/*" } cocok dengan setiap repositori di bawah pemilik itu. * harus berdiri untuk seluruh nama repositori. Claude Code mengabaikan entri seperti */plugins dan your-org/tools-* sebagai tidak valid, jadi mereka tidak cocok dengan apa pun. Memerlukan Claude Code v2.1.223 atau lebih baru.
• git: { "source": "git", "url": "https://gitlab.example.com/tools/plugins.git" }, dengan ref dan path opsional.
• url: { "source": "url", "url": "https://plugins.example.com/marketplace.json" }, dengan headers opsional.
• file dan directory: { "source": "file", "path": "/opt/marketplace/marketplace.json" } atau { "source": "directory", "path": "/opt/marketplace/plugins" }, dengan jalur absolut.
• hostPattern: { "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }, dicocokkan terhadap host sumber github, git, dan url. Pola cocok di mana saja dalam nama host, jadi jangkarnya dengan ^ dan $ seperti yang ditunjukkan untuk mencocokkan seluruh host. Sumber github selalu dihitung sebagai github.com. Gunakan entri hostPattern untuk GitHub Enterprise Server atau host GitLab di mana pengembang membuat marketplace mereka sendiri. Halaman GHES memiliki contoh yang dikerjakan.
• pathPattern: { "source": "pathPattern", "pathPattern": "^/opt/approved/" }, dicocokkan terhadap path sumber file dan directory. Pola cocok di mana saja dalam jalur, jadi mulai dengan ^ untuk menjepit awalan direktori. ".*" memungkinkan setiap jalur lokal.
• skills-dir: { "source": "skills-dir" } membuat plugin direktori skills terus memuat saat allowlist ditetapkan, dan tidak cocok dengan marketplace apa pun.

​

Bagaimana entri cocok

• Entri tanpa ref tidak mencakup sumber dengan ref: "main".
• Entri untuk your-org/your-marketplace tidak mencakup URL git yang mengklon repositori yang sama.
• Garis miring trailing, akhiran .git, atau ssh:// sebagai pengganti https:// adalah nilai berbeda. Ketika marketplace dapat diklon oleh lebih dari satu URL, lebih suka entri hostPattern.

​

Jaga plugin direktori skills tetap memuat

​

Marketplace yang dihosting di claude.ai

​

Kunci setiap sumber

​

Blocklist dengan blockedMarketplaces

• URL Git dikanonikalisasi, jadi bentuk git@ dan https://, akhiran .git, dan garis miring trailing dari satu repositori github.com semuanya cocok dengan entri yang sama.
• Entri github juga memblokir URL git yang setara, dan sebaliknya.
• Untuk entri owner/*, perbandingan pemilik tidak peka huruf besar-kecil.
• Entri tanpa ref atau path memblokir setiap ref dan path dari repositori yang cocok.

{
  "blockedMarketplaces": [
    { "source": "github", "repo": "untrusted-org/*" }
  ]
}

​

Izinkan marketplace resmi dan milik Anda sendiri

{
  "strictKnownMarketplaces": [
    { "source": "github", "repo": "anthropics/claude-plugins-official" },
    { "source": "github", "repo": "your-org/*" },
    { "source": "skills-dir" }
  ],
  "extraKnownMarketplaces": {
    "claude-plugins-official": {
      "source": { "source": "github", "repo": "anthropics/claude-plugins-official" }
    },
    "your-marketplace": {
      "source": { "source": "github", "repo": "your-org/your-marketplace" }
    }
  },
  "enabledPlugins": {
    "code-formatter@your-marketplace": true,
    "deploy-helper@your-marketplace": true
  },
  "disableSideloadFlags": true
}

• Allowlist tidak mendaftarkan apa pun: entri extraKnownMarketplaces melakukannya, dan itu harus melewati allowlist itu sendiri. Claude Code menolak untuk mendaftarkan marketplace terkelola yang sumber allowlist tidak cocok.
• Marketplace resmi mendaftarkan dirinya sendiri hanya dalam sesi terminal interaktif: bahkan di sana, itu mendaftarkan hanya ketika allowlist mengizinkannya. Lari -p atau terminal yang terpasang ke sesi cloud tidak pernah mendaftarkannya.
• Upaya yang diblokir diingat: jika mesin pernah berjalan di bawah kebijakan yang memblokir marketplace resmi, Claude Code mencatat upaya yang diblokir dan tidak mencoba ulang setelah kebijakan berubah. Lockdown [] adalah satu kebijakan seperti itu. Mesin itu mendaftarkannya lagi hanya melalui entri extraKnownMarketplaces seperti yang ada dalam kebijakan ini, entri enabledPlugins untuk salah satu pluginnya, atau /plugin marketplace add manual.

​

Tetapkan kebijakan pembaruan

​

Aktifkan atau matikan auto-update per marketplace

• Jika entri terkelola menetapkan bidang, Claude Code menolak toggle /plugin pengguna dengan kesalahan yang dimulai Auto-update for '<name>' is set by.
• Jika entri terkelola membiarkan bidang tidak ditetapkan, toggle pengguna bertahan.

​

Matikan pembaruan untuk seluruh armada

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

​

Tetapkan saluran rilis ke grup pengguna

• Terapkan pengaturan terkelola endpoint terpisah, seperti file pengaturan terkelola atau profil MDM, ke perangkat setiap grup. Untuk memeriksa apakah file per-grup atau profil berlaku pada perangkat yang juga memiliki sumber organisasi-lebar, lihat Bagaimana Claude Code menggabungkan sumber terkelola.
• Tentukan satu kebijakan gateway aplikasi Claude per grup. Gateway menerapkan kebijakan pertama yang aturan kecocokannya sesuai dengan pengguna, jadi urutkan kebijakan sehingga setiap pengguna mencapai kebijakan grup mereka. Peta extraKnownMarketplaces kebijakan itu tidak digabungkan dengan peta kebijakan lain, jadi cantumkan setiap marketplace yang dibutuhkan grup di dalamnya, bukan hanya marketplace saluran-nya.

{
  "extraKnownMarketplaces": {
    "stable-tools": {
      "source": { "source": "github", "repo": "your-org/stable-tools" }
    }
  }
}

​

Rekomendasikan plugin

​

Audit dan tinjau

​

Acara OpenTelemetry

​

Analytics API

​

Rencanakan apa yang tidak dapat ditegakkan pengaturan terkelola

• Penargetan per-pengguna atau per-grup: setiap kunci plugin berlaku untuk setiap pengguna yang menerima pengaturan. Pengaturan terkelola server mengirimkan satu konfigurasi per organisasi. Untuk kebijakan per-grup, gunakan pengaturan terkelola endpoint terpisah atau kebijakan gateway, seperti di bawah Tetapkan saluran rilis ke grup pengguna.
• Membatasi entri dalam marketplace yang diizinkan: allowlist cocok dengan sumber marketplace. Untuk memblokir satu plugin dari marketplace yang diizinkan, tetapkan ke false dalam enabledPlugins terkelola.
• Menyembunyikan /plugin: tidak ada kunci yang menonaktifkan perintah. Setara terdekat menggabungkan allowlist yang hanya menamai marketplace Anda, entri enabledPlugins terkelola untuk plugin yang Anda sediakan, dan disableSideloadFlags.
• Gating --plugin-dir melalui allowlist: allowlist tidak mencakup --plugin-dir. disableSideloadFlags melakukannya.
• Menerapkan toggle plugin claude.ai melalui kunci ini: Organization settings > Plugins & skills tidak menetapkan kunci di halaman ini. Apa yang diaktifkan anggota dan organisasi Anda di sana mencapai CLI sebagai synced plugins, yang memiliki kontrol mereka sendiri.

​

Troubleshoot kebijakan

• File terkelola tidak diurai: ketika managed-settings.json bukan JSON yang valid, Claude Code menolak untuk memulai dan mencetak kesalahan yang menamai file. File yang diurai tetapi memiliki satu entri tidak valid menyimpan sisa kebijakan-nya. Lihat Entri tidak valid dalam pengaturan terkelola.
• Sumber terkelola tidak dimuat: jalankan /status dan cari Enterprise managed settings dalam baris Setting sources. Jika hilang, sumber tidak dimuat.
• Pengguna melaporkan blocked by enterprise policy: pesan menamai marketplace atau sumbernya. Untuk allowlist, itu juga mencantumkan sumber yang diizinkan. Entri yang menghadap pengguna ada di Troubleshoot plugins.
• Plugin yang dinonaktifkan pengguna dalam ~/.claude/settings.json masih dimuat: sumber pengaturan lain mengaktifkannya kembali, seperti entri enabledPlugins terkelola yang force-enable-nya. /plugin dan claude plugin list menunjukkan Disabled in ~/.claude/settings.json but still loads dengan sumber pengaturan itu.

​

Langkah berikutnya

• Referensi marketplace: nilai source yang extraKnownMarketplaces, strictKnownMarketplaces, dan blockedMarketplaces terima
• Host dan pertahankan marketplace: jalankan marketplace yang kebijakan Anda arahkan
• Plugin security dan trust: apa yang dapat dilakukan plugin di mesin dan cara meninjau satu sebelum menginstal
• Pengaturan terkelola server: berikan kunci ini dari konsol admin claude.ai
• Troubleshoot plugins: pesan yang dilihat pengguna ketika kebijakan memblokir mereka