Kelola mod untuk organisasi Anda

• Jauhkan mod milik pengguna, dengan atau tanpa mod milik Anda sendiri: Hentikan mod yang dipasang pengguna dari memuat
• Lihat apa yang didapat pengguna Anda saat Anda tidak mengubah apa pun: Ketahui apa yang terjadi secara default
• Biarkan mod tetap aktif dengan batasan lain: Pilih berapa banyak yang akan diizinkan

​

Hentikan mod yang dipasang pengguna dari memuat

{
  "pluginConfigs": {
    "cc-plugin-sec-default@builtin": {
      "options": {
        "allowManagedModsOnly": true
      }
    }
  }
}

• Tidak ada mod yang dibawa pengguna yang memuat: itu mencakup mod dalam plugin yang dipasang pengguna, mod yang dimuat dengan --plugin-dir, dan mod yang ditulis Claude selama sesi
• Mod organisasi Anda masih memuat: mod yang dihitung sebagai milik organisasi Anda tidak diperiksa. Setiap mod lainnya dihitung sebagai milik pengguna dan tidak memuat. Itu termasuk mod dalam plugin yang Anda aktifkan dari GitHub atau pasar jarak jauh lainnya, dan yang diaktifkan organisasi Anda untuk anggotanya di claude.ai. Jika tidak ada yang dihitung sebagai milik Anda, tidak ada mod yang dipasang yang memuat.
• Pengguna tidak dapat membatalkannya: penjaga membaca opsi dari pengaturan terkelola saja, jadi entri yang sama dalam file pengaturan pengguna, proyek, atau lokal, atau dalam file yang dilewatkan dengan --settings, tidak mengubah apa pun
• File atau kebijakan MDM mencakup setiap penyedia: saat Anda mengirimkan opsi sebagai file atau melalui MDM, opsi ini bekerja dengan cara yang sama di Amazon Bedrock, Agent Platform Google Cloud, dan Microsoft Foundry. Untuk pengiriman dari konsol admin claude.ai, lihat Ketersediaan Platform
• Kustomisasi lain pengguna tetap berfungsi: hook mereka dalam file pengaturan, baris status, dan /goal tidak terpengaruh
• Mod bawaan tetap berjalan: mod yang dibangun ke dalam Claude Code, seperti dukungan AGENTS.md, masing-masing memiliki sakelar mereka sendiri

​

Ketahui apa yang terjadi secara default

• Mod aktif. Pengguna dapat memasang plugin yang berisi mod dari pasar apa pun yang diizinkan pengaturan plugin Anda, atau memuat satu dari direktori dengan --plugin-dir.
• Penjaga bawaan berjalan terlebih dahulu. Claude Code memuat mod bawaan bernama sec-default@builtin sebelum setiap mod yang dipasang pengguna. Pengguna tidak dapat mematikannya. /plugin dan log debug mencantumkannya sebagai cc-plugin-sec-default. Penjaga memuat saat salah satu dari ini benar:
  • Mesin memiliki pengaturan terkelola
  • Pengguna masuk ke Claude Code dengan paket Team atau Enterprise
  Pengguna yang mengautentikasi dengan kunci API, atau melalui Amazon Bedrock, Agent Platform Google Cloud, atau Microsoft Foundry, mendapatkan penjaga hanya di mesin yang memiliki pengaturan terkelola.
• Penjaga melindungi apa yang Anda kelola. Mod pengguna tidak dapat mengubah apa yang diterima atau diputuskan hook terkelola Anda, prompt sistem, CLAUDE.md terkelola Anda dan instruksi terkelola lainnya, apa yang dibaca mod apa pun sebagai pengaturan, atau alat dan deskripsi server MCP terkelola Anda.
• Semuanya yang lain diizinkan. Penjaga tidak menambahkan batasan lain. Mod pengguna masih dapat membaca dan menulis file, memulai proses, membuat permintaan jaringan, menulis ulang panggilan alat dan prompt, menolak panggilan alat, menyetujui yang sebaliknya akan meminta, dan menggambar di antarmuka, semuanya dengan izin pengguna itu.
• Aturan penolakan dan hook terkelola Anda memiliki prioritas. Di mana penjaga memuat, mod pengguna tidak dapat menyetujui panggilan yang ditolak aturan deny, file pengaturan mana pun yang menyimpan aturan. Blok dari hook PreToolUse dalam pengaturan terkelola juga final. Keduanya berlaku untuk panggilan alat Claude. Tidak satupun berlaku untuk panggilan $.fs dan $.process milik mod: dengan Read(.env) ditolak, mod masih dapat membaca file itu dengan $.fs.read atau memulai program yang melakukannya. Untuk membatasi panggilan tersebut, jauhkan mod dari memuat atau hook panggilan dalam mod kebijakan.
• Pemeriksaan izin lainnya dapat ditimpa. Mod pengguna yang menyetujui panggilan alat dapat menyetujui panggilan yang akan diminta aturan ask, atau yang diblokir hook PreToolUse di luar pengaturan terkelola. Dalam mode otomatis, panggilan yang disetujui mod berjalan tanpa pemeriksaan pengklasifikasi.

​

Ketahui kontrol mana yang masih berlaku

• Hook pengaturan tetap berfungsi. Hook perintah, HTTP, prompt, dan agen dalam file pengaturan dan dalam hooks/hooks.json plugin berjalan seperti sebelumnya, bersama mod. Tidak ada yang sudah usang tentang mereka.
• Aturan penolakan memiliki prioritas di mana penjaga memuat. Mod pengguna tidak dapat menyetujui panggilan yang ditolak aturan deny, kecuali Anda menetapkan allowModsToOverrideDenyRules.
• Hook terkelola berjalan terlebih dahulu. Hook PreToolUse dalam pengaturan terkelola berjalan sebelum mod apa pun melihat panggilan alat, dan bloknya final. Jika mod kemudian menulis ulang panggilan, hook terkelola Anda berjalan lagi pada panggilan yang ditulis ulang, jadi blok masih berlaku. Hook PreToolUse dari file pengaturan lain dan dari plugin berjalan setelah mod terakhir, jadi mod yang mengembalikan hasilnya sendiri sebagai pengganti menjalankan alat mencegah yang lain berjalan. Lihat Urutan mod berjalan.
• Kebijakan jaringan mencakup $.http.fetch. Jika organisasi Anda mematikan pengambilan web, atau lalu lintas jaringan yang tidak penting dimatikan untuk sesi, Claude Code menolak permintaan jaringan yang dibuat mod dengan $.http.fetch. Kebijakan tidak mencakup program yang dimulai mod dengan $.process.run. Program itu menjangkau jaringan dengan akses pengguna mereka sendiri.
• Kontrol plugin mencakup mod. Mod adalah plugin, jadi pengaturan yang membatasi apa yang dapat dipasang pengguna, seperti strictKnownMarketplaces, memutuskan apakah itu dapat dipasang sama sekali.
• Mod tidak dapat mengubah prompt izin. Mod dapat mengubah gaya banyak antarmuka Claude Code, tetapi bukan prompt izin, jadi tidak dapat mengubah apa yang ditampilkan prompt. Mod masih dapat menyetujui atau menolak panggilan alat sebelum prompt muncul, seperti yang dijelaskan Ketahui apa yang terjadi secara default.
• Prompt kepercayaan datang terlebih dahulu. Dalam sesi interaktif di direktori yang belum dipercaya pengguna, tidak ada mod yang memuat sampai mereka menjawab prompt kepercayaan.
• --safe-mode mematikan mod yang dipasang, termasuk milik Anda. Mulai sesi dengan claude --safe-mode untuk memeriksa apakah mod menyebabkan masalah.

​

Putuskan apakah akan membiarkan mod tetap aktif

​

Tinjau apa yang dapat dilakukan mod

claude plugin validate ./some-mod

  ❯ ./register.js hooks: session.start, tool.call, ui.render{component=Pane}
  ❯ ./register.js calls: $.fs.read, $.http.fetch, $.store.set, $.ui.open

​

Pilih berapa banyak yang akan diizinkan

• allowManagedModsOnly: opsi pada penjaga bawaan. Mod pengguna tidak memuat, dan hook pengaturan, baris status, dan /goal mereka tetap berfungsi. Hentikan mod yang dipasang pengguna dari memuat mencantumkan apa yang dicakupnya.
• allowManagedHooksOnly: pengaturan yang lebih luas. Hanya mod organisasi Anda dan mod yang dibangun ke dalam Claude Code yang memuat. Mod yang dipasang pengguna sendiri tidak. Pengaturan juga memblokir hook dalam file pengaturan pengguna mereka sendiri. Baca Apa yang berjalan di bawah allowManagedHooksOnly sebelum Anda menetapkannya.
• disableAllHooks: pengaturan terluas. Dalam pengaturan terkelola, ini menghentikan mod dalam setiap plugin yang dipasang, termasuk milik Anda, dan mematikan setiap hook dalam file pengaturan, jadi hook PreToolUse dalam pengaturan terkelola Anda tidak lagi memblokir apa pun. Baris status khusus dan /goal juga berhenti bekerja. Baca disableAllHooks sebelum Anda menetapkannya.
• disableSideloadFlags: menolak --plugin-dir dan --plugin-url saat startup, jadi tidak ada yang memuat mod dari direktori, dan menjaga mod yang ditulis Claude selama sesi dari memuat. Pengaturan juga menolak --agents dan --mcp-config. Baca disableSideloadFlags sebelum Anda menetapkannya.

​

Atur opsi pada penjaga bawaan

• Id memiliki satu ejaan di sini: Claude Code membaca opsi hanya di bawah cc-plugin-sec-default@builtin. prependPlugins menerima sec-default@builtin juga, dan pluginConfigs tidak.
• Hanya pengaturan terkelola yang dihitung: entri yang sama dalam file pengaturan pengguna, proyek, atau lokal, atau dalam file yang dilewatkan dengan --settings, tidak menetapkan opsi atau melonggarkan opsi
• Penjaga harus memuat: jika Anda menetapkan prependPlugins, sebutkan penjaga dalam daftar. Di mana penjaga tidak memuat, opsi tidak berlaku.
• Penjaga gagal tertutup: jika penjaga tidak dapat membaca pengaturan terkelola, penjaga menolak setiap mod pengguna saat memuat. Jika tidak dapat memeriksa aturan penolakan untuk panggilan yang disetujui mod pengguna, penjaga menolak panggilan.

​

Jalankan mod organisasi Anda sendiri

​

Pasang mod organisasi Anda dan atur urutan

• Managed enabledPlugins menetapkan plugin mod ke true
• Pengaturan terkelola menyebutkan pasar plugin sebagai direktori di mesin pengguna, menurut jalur absolut. Entri extraKnownMarketplaces melakukan itu dan juga mendaftarkan pasar untuk pengguna.
• Pasar mencantumkan plugin menurut jalur relatif, jadi Claude Code memuatnya di tempat dari direktori itu

/opt/acme/claude-plugins/
├── .claude-plugin/
│   └── marketplace.json
└── plugins/
    └── acme-guard/
        ├── .claude-plugin/
        │   └── plugin.json
        └── hooks/
            ├── hooks.json
            └── register.js

{
  "name": "acme-tools",
  "owner": { "name": "Acme" },
  "plugins": [
    { "name": "acme-guard", "source": "./plugins/acme-guard", "description": "Acme policy mod" }
  ]
}

• prependPlugins: mod Anda melihat setiap peristiwa sebelum mod pengguna apa pun dan setiap hasil setelahnya. Ini dapat mengubah peristiwa, menolaknya, atau melewati mod pengguna.
• appendPlugins: mod Anda berjalan setelah setiap mod pengguna, jadi hanya melihat peristiwa yang dilewatkan mod tersebut, dalam bentuk yang mereka lewatkan

{
  "extraKnownMarketplaces": {
    "acme-tools": {
      "source": { "source": "directory", "path": "/opt/acme/claude-plugins" }
    }
  },
  "enabledPlugins": { "acme-guard@acme-tools": true },
  "prependPlugins": ["acme-guard@acme-tools", "sec-default@builtin"]
}

• extraKnownMarketplaces: menyebutkan direktori yang menyimpan pasar acme-tools. path adalah jalur absolut direktori yang berisi .claude-plugin/marketplace.json.
• enabledPlugins: mengaktifkan acme-guard untuk setiap pengguna yang menerima pengaturan terkelola ini
• prependPlugins: menempatkan acme-guard terlebih dahulu dan penjaga bawaan kedua, keduanya sebelum mod apa pun yang dipasang pengguna. Claude Code mengikuti urutan yang Anda cantumkan.

• hooks module acme-guard@acme-tools loaded, dengan tier prepend: mod dihitung sebagai milik organisasi Anda dan berjalan terlebih dahulu
• Baris yang sama dengan tier user: Claude Code memperlakukannya sebagai mod pengguna. Baris kedua, prependPlugins names acme-guard@acme-tools, which is not an enabled managed plugin with a hooks module; skipped, mengatakan daftar melewatinya.

• Daftar menggantikan default: saat Anda menetapkan prependPlugins dalam pengaturan terkelola, sebutkan sec-default@builtin di dalamnya untuk menjaga penjaga bawaan. Penjaga dibangun dan tidak memerlukan entri enabledPlugins.
• Id Anda sendiri harus dihitung sebagai milik Anda: dalam pengaturan terkelola, Claude Code melewati id yang pluginnya tidak memenuhi tiga kondisi untuk mod organisasi
• Repositori tidak dapat menetapkannya: Claude Code membaca kedua pengaturan dari pengaturan terkelola dan tidak pernah dari file pengaturan repositori. Pengguna dapat menetapkannya dalam ~/.claude/settings.json untuk mengurutkan mod mereka sendiri hanya di mesin tanpa pengaturan terkelola, dan hanya saat tidak masuk dengan paket Team atau Enterprise. Di tempat lain, Claude Code mengabaikan kedua kunci dalam pengaturan pengguna. Daftar di sana tidak menambah atau menghapus penjaga bawaan.

​

Terapkan kebijakan dengan mod Anda sendiri

// Metode yang tidak boleh dipanggil mod pengguna apa pun, masing-masing dieja namespace.method
const BLOCKED_CALLS = ['process.run', 'process.spawn']

export function register(on) {
  // Berjalan setiap kali mod lain akan memuat
  on('plugin.register', async ($, e, next) => {
    // Simpan panggilan dalam kode mod itu yang ada dalam daftar yang diblokir
    const blocked = e.uses.calls.filter((call) => BLOCKED_CALLS.includes(call))
    if (e.tier === 'user' && blocked.length > 0) {
      // Mengembalikan refuse menjaga mod dari memuat, dan teksnya adalah alasannya
      return { refuse: 'Acme policy: mods may not call ' + blocked.join(', ') }
    }
    // Biarkan setiap mod lain memuat
    return next(e)
  })

  // Catat setiap panggilan alat, kemudian biarkan maju tanpa perubahan
  on('tool.call', async ($, e, next) => {
    $.ui.log('audit tool.call ' + e.tool, { to: 'debug' })
    return next(e)
  })

  // Catat mod mana yang menulis file, kemudian jalurnya, dikutip karena mod memilihnya
  on('fs.write', async ($, e, next) => {
    $.ui.log('audit fs.write by ' + next.origin.plugin + ' ' + JSON.stringify(e.path), { to: 'debug' })
    return next(e)
  })
}

• plugin.register: memutuskan apakah mod lain memuat. Ini menolak mod pengguna yang memanggil metode yang diblokir dan meneruskan setiap mod lainnya.
• tool.call: menulis baris seperti audit tool.call Bash ke log debug untuk setiap panggilan alat, dan tidak mengubah apa pun
• fs.write: menulis baris seperti audit fs.write by reader "/tmp/notes.md" untuk setiap panggilan $.fs.write yang dibuat mod lain, dan tidak mengubah apa pun. Nama mod datang terlebih dahulu dan jalurnya dikutip, jadi jalur yang dipilih mod tidak dapat lulus sebagai bidang lain dari baris.

• e.tier: di mana mod akan berjalan, salah satu dari prepend, user, append, atau builtin. Setiap mod yang dipasang orang adalah user.
• e.uses.calls: metode API mod yang dipanggil mod, masing-masing dieja namespace.method seperti process.run, tanpa $. yang dicetak claude plugin validate

​

Tolak mod saat pemeriksaan Anda gagal

const BLOCKED_CALLS = ['process.run', 'process.spawn']

// Pemeriksaan yang sama seperti sebelumnya, dipindahkan ke fungsi miliknya sendiri
async function checkMod($, e, next) {
  const blocked = e.uses.calls.filter((call) => BLOCKED_CALLS.includes(call))
  if (e.tier === 'user' && blocked.length > 0) {
    return { refuse: 'Acme policy: mods may not call ' + blocked.join(', ') }
  }
  return next(e)
}

export function register(on) {
  // Handler berjalan hanya saat checkMod melempar atau melampaui batas waktu
  on('plugin.register', checkMod).catch(async ($, e, next) => {
    // Biarkan mod organisasi Anda dan mod bawaan memuat
    if (e.tier !== 'user') return next(e)
    // Tolak mod pengguna yang tidak dapat diperiksa
    return { refuse: 'Acme policy check failed, so this mod was not loaded' }
  })
}

​

Langkah berikutnya

• Keamanan plugin: apa yang dapat dilakukan plugin apa pun di mesin pengguna, dan cara meninjau satu sebelum dipasang
• Ikhtisar mod: apa itu mod dan bagaimana perbandingannya dengan hook, skill, dan server MCP
• Urutan mod berjalan: bagaimana prependPlugins dan appendPlugins cocok dengan mod pengguna
• Pengaturan dan variabel lingkungan: setiap pengaturan yang dinamai di halaman ini dalam satu tabel