Referensi Marketplace

Referensi lengkap untuk field marketplace.json, entri plugin, dan objek sumber plugin dan marketplace, dengan tempat masing-masing valid.

marketplace.json adalah file yang mendefinisikan marketplace plugin. File ini berisi nama marketplace, pemiliknya, dan satu entri per plugin. Sumber plugin setiap entri mengatakan di mana Claude Code mengambil plugin tersebut.

Sumber marketplace adalah objek terpisah yang mengatakan di mana Claude Code mengambil file marketplace itu sendiri. Anda menulis satu di pengaturan, atau Claude Code membangunnya ketika Anda menjalankan claude plugin marketplace add.

Referensi ini untuk pengelola marketplace yang membutuhkan nama atau nilai field yang tepat, dan untuk administrator yang perlu mengetahui nilai source mana yang valid dalam extraKnownMarketplaces, strictKnownMarketplaces, dan blockedMarketplaces.

[!NOTE]

Kasus-kasus ini tercakup di halaman lain:

• Membangun atau menghosting marketplace: lihat Buat marketplace dan Host dan kelola marketplace
• Resep allowlist dan blocklist: lihat Kelola plugin untuk organisasi Anda

Temukan bagian untuk apa yang Anda tulis atau baca:

• File marketplace: Field tingkat atas dan Entri plugin
• source entri: Sumber plugin
• Objek source di pengaturan: Sumber marketplace
• Output dari claude plugin validate <path>: Pesan validasi, yang memetakan setiap pesan ke field yang disebutnya

File marketplace

Simpan file marketplace di .claude-plugin/marketplace.json di direktori marketplace Anda. Jika Anda menyimpan file di tempat lain di repositori, pengguna harus mendeklarasikan marketplace di extraKnownMarketplaces dengan path diatur pada sumbernya, karena claude plugin marketplace add tidak memiliki opsi untuk itu.

Direktori yang berisi .claude-plugin/ disebut akar marketplace, dan setiap sumber plugin relatif diselesaikan darinya, bukan dari .claude-plugin/.

Setiap pengguna mendaftarkan satu marketplace per name, jadi pengguna tidak dapat memiliki dua marketplace dengan nama yang sama terdaftar sekaligus.

Claude Code mengabaikan kunci tingkat atas yang tidak dikenal atau kunci entri plugin daripada menolaknya, jadi typo dimuat diam-diam. claude plugin validate melaporkan setiap kunci yang tidak dikenal sebagai peringatan.

Nama yang dicadangkan

Anda tidak dapat memberikan marketplace Anda salah satu nama berikut:

• Nama marketplace resmi: claude-code-marketplace, claude-code-plugins, claude-plugins-official, anthropic-marketplace, anthropic-plugins, agent-skills, anthropic-agent-skills, life-sciences, knowledge-work-plugins, claude-for-legal, claude-for-financial-services, financial-services-plugins, first-party-plugins, dan claude-tag-plugins. Dicadangkan kecuali marketplace berasal dari github atau git sumber marketplace di bawah github.com/anthropics/.
• Nama marketplace komunitas: claude-community, claude-plugins-community, dan healthcare. Dicadangkan di bawah aturan yang sama dengan nama resmi.
• Nama direktori plugin: anthropic-plugin-directory dan claude-plugin-directory. Dicadangkan di bawah aturan yang sama dengan nama resmi.
• Nama yang menyamar sebagai marketplace resmi: nama seperti official-claude-plugins atau claude-plugins-v2, dan nama apa pun yang berisi karakter non-ASCII. Kesalahannya adalah Marketplace name impersonates an official Anthropic/Claude marketplace. Karakter kontrol atau pemformatan bidirectional dalam nama juga melaporkan Marketplace name cannot contain control or bidirectional-formatting characters. Marketplace yang sudah terdaftar di bawah nama seperti itu berhenti dimuat, bersama dengan pluginnya.
• Ejaan lain dari nama yang dicadangkan: nama yang berbeda dari nama yang dicadangkan hanya dengan titik di akhir, atau dengan simbol selain garis bawah sebagai pengganti tanda hubung, jadi claude.code.plugins dihitung sebagai claude-code-plugins. Menambahkan marketplace gagal dengan is another spelling of "<reserved>", a reserved marketplace name, dan marketplace yang sudah terdaftar dengan nama seperti itu berhenti dimuat. Pemeriksaan ini memerlukan Claude Code v2.1.280 atau lebih baru.
• Nama yang Claude Code gunakan untuk plugin yang tidak berasal dari marketplace: inline untuk plugin yang dimuat dengan --plugin-dir, builtin untuk plugin bawaan, skills-dir untuk plugin yang dimuat otomatis dari .claude/skills/, dan synced untuk plugin yang disinkronkan dari akun claude.ai Anda. claude-plugin-test juga dicadangkan. skills-dir juga muncul sebagai {"source": "skills-dir"} dalam strictKnownMarketplaces dan blockedMarketplaces, dijelaskan di bawah Nilai sumber yang valid hanya dalam daftar kebijakan.
• npm, pip, uv, cargo, github, dan gh: dicadangkan dalam huruf apa pun. Pemeriksaan ini memerlukan Claude Code v2.1.275 atau lebih baru.
• Nama anggota yang dimiliki setiap objek JavaScript: constructor, hasOwnProperty, isPrototypeOf, propertyIsEnumerable, toLocaleString, toString, dan valueOf. claude plugin marketplace add menolak marketplace yang menggunakan salah satunya dengan Claude Code reserves this name and cannot register a marketplace under it. Pemeriksaan ini memerlukan Claude Code v2.1.296 atau lebih baru.
• Nama yang dimulai dengan claudeai-: dicadangkan untuk marketplace yang dihosting di claude.ai. claude plugin marketplace add menolak marketplace lain apa pun yang menggunakannya dengan Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai.
• Folder unduhan dari marketplace GitHub yang terdaftar, <owner>-<repo>: Claude Code mengunduh marketplace yang ditambahkan dari sumber github seperti acme/x-tools melalui folder bernama acme-x-tools, apa pun name milik marketplace tersebut. Selama marketplace tersebut terdaftar dengan nama selain acme-x-tools, claude plugin marketplace add menolak marketplace lain yang bernama acme-x-tools setelah mengunduhnya, dan melaporkan Can't use the marketplace name "acme-x-tools". Pemeriksaan ini memerlukan Claude Code v2.1.290 atau lebih baru.

Ketika marketplace yang terdaftar berhenti dimuat karena namanya meniru nama resmi, claude plugin list dan /plugin melaporkan Claude Code refuses the marketplace name "<name>". Pesan tersebut memberi tahu Anda untuk menghapus marketplace. Menghapusnya juga mencopot plugin-nya dan menghapus data, opsi, dan secret-nya. Pesan penolakan bernama ini memerlukan Claude Code v2.1.282 atau lebih baru.

Jika file pengaturan mendeklarasikan marketplace secara inline, pesan tersebut memberi tahu Anda untuk mengganti nama entrinya sebelum Anda menghapus nama lama. Untuk langkah-langkahnya, lihat Claude Code refuses the marketplace name. Pesan tersebut mencantumkan langkah-langkah ini di Claude Code v2.1.292 atau lebih baru.

Field tingkat atas

Tabel mencantumkan setiap kunci yang Claude Code baca dari marketplace.json. name, owner, dan plugins diperlukan.

Entri plugin

Setiap objek dalam array plugins tingkat atas dari marketplace.json memberi nama plugin dan menunjukkan di mana mengambilnya. name dan source diperlukan.

Selain field daftar direktori, sebuah entri juga menerima setiap field plugin.json, seperti description, version, author, commands, dan hooks. Untuk mengetahui kapan field tersebut berlaku, lihat Bagaimana entri menggabungkan dengan plugin.json.

Tabel mencantumkan field entri sendiri dan field manifest yang maknanya berubah dalam entri.

Bagaimana entri menggabungkan dengan plugin.json

Field entri berlaku berbeda untuk plugin yang diambil yang memiliki .claude-plugin/plugin.json sendiri dan untuk yang tidak:

• Tidak ada plugin.json: entri adalah manifest terlepas dari strict. Setiap field manifest yang diterima entri berlaku, termasuk mcpServers, lspServers, userConfig, dan channels.
• plugin.json ada: plugin.json adalah manifest. Mode ketat memutuskan apakah enam field komponen entri, commands, agents, skills, hooks, outputStyles, dan themes, digabungkan dengannya atau ditolak sebagai konflik. Entry mcpServers, lspServers, userConfig, dan channels tidak berlaku. Deklarasikan mereka dalam plugin.json.

Hooks dalam entri

Tulis entry hooks sebagai objek inline yang memetakan nama event hook ke array matcher. Jika Anda menulis jalur file atau array sebagai gantinya, claude plugin validate menerimanya. Hook tersebut tidak akan pernah berjalan, dan Claude Code melaporkan error not yet supported in a marketplace entry untuk plugin. Letakkan hook berbasis file dalam hooks/hooks.json plugin sendiri atau plugin.json.

Field tampilan

Baik entri maupun plugin.json plugin sendiri dapat menetapkan field tampilan displayName, description, author, homepage, repository, license, dan keywords. Pengguna melihat nilai-nilai ini dalam daftar dan detail plugin, sebelum dan sesudah instalasi:

• Untuk field yang Anda tetapkan pada entri, pengguna melihat nilai entri, bahkan ketika plugin.json menetapkan yang berbeda.
• Untuk field yang entri biarkan tidak ditetapkan, pengguna melihat nilai plugin.json.

Sebelum instalasi, Claude Code hanya dapat membaca plugin.json untuk entri dengan sumber jalur relatif, yang file pluginnya berada di dalam marketplace itu sendiri. Untuk entri dengan jenis sumber lain apa pun, pengguna hanya melihat field entri sendiri sampai mereka menginstal plugin.

Mode ketat

strict memutuskan apa yang terjadi ketika plugin yang diambil memiliki plugin.json sendiri dan entri juga mendeklarasikan salah satu dari field komponen: commands, agents, skills, hooks, outputStyles, atau themes. Dengan strict: true, default, Claude Code menambahkan field komponen entri ke plugin.json, kecuali hooks, yang matcher-nya menggantikan manifest per event. Dengan strict: false, entri yang mendeklarasikan field komponen apa pun adalah konflik, dan plugin gagal dimuat. Tabel menunjukkan setiap kombinasi strict, plugin.json, dan field komponen entri.

Sumber plugin

source pada entri plugin menyatakan dari mana Claude Code mengambil plugin tersebut. Nilainya berupa string path relatif atau objek yang key source-nya sendiri menyebutkan tipenya, sehingga sebuah entri terlihat seperti "source": { "source": "github", "repo": "your-org/formatter" }.

Tabel berikut mencantumkan setiap tipe sumber plugin beserta field-nya.

Nama url dan github juga merupakan tipe sumber marketplace, di mana url berarti tautan langsung ke file marketplace.json, bukan repositori git. git hanya ada sebagai sumber marketplace, dan npm ada sebagai keduanya. git-subdir, archive, dan command hanya ada sebagai sumber plugin.

Gunakan path relatif untuk plugin di subdirektori repositori marketplace itu sendiri. Gunakan git-subdir untuk subdirektori dari repositori lain.

Sumber github, url, dan git-subdir berbagi field ref dan sha:

• ref: branch atau tag. Default-nya adalah branch default repositori.
• sha: SHA commit lengkap 40 karakter dalam huruf kecil. Saat Anda mengatur ref dan sha sekaligus, Claude Code melakukan checkout sha. Pada sebagian besar host git, termasuk GitHub, GitLab, dan Bitbucket, ini berarti instalasi berhasil meskipun branch atau tag yang disebut oleh ref telah dihapus di upstream, selama commit tersebut masih dapat dijangkau dari repositori. Beberapa server, seperti AWS CodeCommit, tidak mendukung pengambilan commit berdasarkan SHA. Pada server tersebut, ref harus tetap ada dan commit yang disematkan harus dapat dijangkau darinya.

Untuk cara setiap tipe diambil, di-cache, dan diberi versi, lihat Referensi pemuatan plugin.

Sumber plugin path relatif

Path di-resolve dari root marketplace. ./plugins/formatter adalah <root>/plugins/formatter meskipun file marketplace berada di <root>/.claude-plugin/.

Path yang berisi .. gagal validasi. Di macOS dan Linux, Claude Code menolak path entri yang berisi backslash di mana pun setelah ./ di awal, jadi tulis path dengan garis miring maju.

{ "name": "formatter", "source": "./plugins/formatter" }

Path relatif hanya dapat di-resolve ketika Claude Code memiliki file-file marketplace, jadi periksa tipe sumber marketplace:

• github, git, file, dan directory: Claude Code memiliki file-file marketplace.
• url: Claude Code hanya mengambil marketplace.json, sehingga path relatif tidak dapat di-resolve. Berikan setiap plugin sumber berupa objek, seperti github atau git-subdir.
• settings: path relatif langsung ditolak.

Submodule git di repositori marketplace

Saat Claude Code meng-clone repositori marketplace, Claude Code hanya mengambil submodule git yang berisi file plugin. Memerlukan Claude Code v2.1.295 atau lebih baru.

Versi sebelumnya mengambil setiap submodule, termasuk yang bersarang. Jika repositori memiliki submodule besar, Claude Code dapat melewati timeout clone saat mengambilnya.

Untuk plugin di subdirektori, seperti ./plugins/formatter, Claude Code mengambil submodule dalam kasus-kasus berikut:

• Plugin berada di dalam submodule: submodule adalah direktori plugin atau direktori di atasnya
• Submodule berada di dalam plugin: submodule berada di mana pun di bawah direktori plugin
• Tautan simbolis mengarah ke dalam submodule: tautan yang di-commit ke repositori memiliki target di dalam submodule

Plugin di root marketplace, dengan "source": "./", mendapatkan semua submodule di repositori atau tidak sama sekali. Claude Code mengambil semua submodule ketika salah satu dari hal berikut mengarah ke submodule mana pun:

• Direktori komponen: direktori di root yang berisi komponen plugin, seperti skills/, hooks/, atau bin/
• Path dalam konfigurasi plugin: path dalam entri marketplace plugin, dalam plugin.json-nya, atau dalam file konfigurasi seperti .mcp.json atau hooks/hooks.json
• Tautan simbolis: tautan yang di-commit ke repositori
• Teks dalam file plugin: path submodule, seperti vendor/tool, yang ditulis dalam file konfigurasi atau dalam file di bawah direktori komponen

Jika tidak satu pun yang demikian, Claude Code tidak mengambil submodule apa pun untuk plugin tersebut. Repositori yang sekaligus merupakan proyek dan plugin sering kali memiliki submodule yang hanya digunakan oleh build proyek, dan aturan ini mengecualikannya.

Claude Code juga mengambil semua submodule ketika tidak dapat menentukan mana yang berisi file plugin, seperti:

• SKILL.md di root: seluruh repositori kemudian menjadi direktori satu skill
• File yang tidak dapat dibaca Claude Code: file marketplace, salah satu file konfigurasi plugin, atau .gitmodules

Jika Anda menambahkan marketplace dengan --sparse, atau sumbernya mengatur sparsePaths, Claude Code hanya melakukan checkout direktori yang disebutkan di sana dan tidak mengambil submodule apa pun. Versi sebelumnya melakukan hal yang sama.

Untuk mengecualikan submodule yang tidak digunakan plugin Anda dari clone, lihat Keluarkan submodule yang tidak digunakan dari clone.

Nama polos di bawah pluginRoot

Nama polos adalah satu nama direktori tanpa /, seperti "formatter". Untuk menulis nama polos alih-alih path ./, atur metadata.pluginRoot ke direktori tempat nama tersebut di-resolve. Dengan "pluginRoot": "./plugins", "source": "formatter" di-resolve ke ./plugins/formatter. Memerlukan Claude Code v2.1.239 atau lebih baru.

metadata.pluginRoot memiliki batasan berikut:

• Nilainya sendiri harus berupa path relatif di dalam marketplace.
• Tidak berpengaruh pada sumber yang sudah diawali dengan ./.
• Sumber yang berisi /, seperti team-a/formatter, bukan nama polos dan tetap memerlukan awalan ./, bahkan ketika metadata.pluginRoot diatur.

Sumber plugin github

repo menerima owner/repo. ref dan sha bersifat opsional.

{
  "name": "formatter",
  "source": {
    "source": "github",
    "repo": "your-org/formatter",
    "ref": "v2.0.0",
    "sha": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"
  }
}

Sumber plugin url

url adalah URL git lengkap: https://, http://, file://, atau git@. Akhiran .git tidak diperlukan, sehingga URL Azure DevOps dan AWS CodeCommit berfungsi sebagaimana ditulis. Tipe ini tidak menerima singkatan owner/repo.

{
  "name": "formatter",
  "source": {
    "source": "url",
    "url": "https://gitlab.example.com/your-group/formatter.git",
    "ref": "main"
  }
}

Sumber plugin git-subdir

url menerima URL git lengkap atau singkatan GitHub owner/repo. path adalah subdirektori yang berisi plugin, dan Claude Code hanya melakukan checkout subdirektori tersebut. Melalui URL https atau SSH, Claude Code meminta partial clone dari server, sehingga dari host yang mendukung partial clone, plugin dalam monorepo besar dapat diinstal tanpa mengunduh sisa repositori.

{
  "name": "formatter",
  "source": {
    "source": "git-subdir",
    "url": "https://github.com/your-org/monorepo.git",
    "path": "tools/formatter"
  }
}

Sumber plugin npm

Sumber npm menerima field berikut:

• package: nama paket registry seperti @your-org/formatter, nama dengan versi yang ditambahkan seperti @your-org/formatter@2.0.0, atau tautan https ke file tarball paket
• version: versi, rentang semver, atau dist-tag, digunakan ketika package adalah nama paket tanpa versi yang ditambahkan. Hilangkan untuk mengambil latest
• registry: URL registry untuk paket yang tidak berada di registry default

Claude Code mengambil paket dengan klien npm Anda. Skrip install paket, seperti preinstall atau postinstall, tidak pernah dijalankan, dan dependensinya tidak diinstal selama pengambilan. Jika paket memiliki lockfile yang didukung di samping package.json-nya, Claude Code menginstal dependensi paket Node.js tersebut dalam langkah terpisah, juga dengan skrip dinonaktifkan.

Claude Code memeriksa nilai package sebelum mengambil apa pun. Nilai yang ditolak menggagalkan instalasi dengan pesan yang menyebutkan nilai dan alasannya. Nilai yang ditolak meliputi:

• Alamat git, folder atau path file:, atau alias npm:: gunakan sumber github, url, atau git-subdir untuk repositori git, path relatif untuk folder di marketplace, dan nama paket itu sendiri untuk alias
• Tautan tarball di github.com, gist.github.com, gitlab.com, bitbucket.org, atau git.sr.ht: ditolak bahkan ketika tautan tersebut adalah unduhan rilis GitHub, kecuali jika tautan tersebut adalah tautan registry npm GitLab di bawah gitlab.com/api/v4/
• Tautan tarball melalui http: ditolak kecuali jika mengarah ke registry npm default milik pengguna yang menginstal

URL registry harus menggunakan https kecuali jika URL tersebut adalah registry npm default milik pengguna yang menginstal. Dengan registry http lainnya, instalasi gagal sebelum npm menghubunginya.

{
  "name": "formatter",
  "source": {
    "source": "npm",
    "package": "@your-org/formatter",
    "version": "^2.0.0",
    "registry": "https://npm.example.com"
  }
}

Sumber plugin archive

url harus menggunakan https:// dan tidak boleh mengarah ke host loopback, link-local, atau cloud-metadata. Untuk batas ukuran, timeout, redirect, dan ekstraksi pada unduhan, lihat Tetap dalam batas unduhan untuk file yang di-host.

Root plugin boleh berada di tingkat teratas zip atau satu direktori di bawahnya.

sha256 adalah digest arsip berupa 64 karakter heksadesimal, huruf besar atau huruf kecil. Saat Anda mengaturnya, Claude Code menolak unduhan yang tidak cocok.

{
  "name": "formatter",
  "source": {
    "source": "archive",
    "url": "https://artifacts.example.com/formatter-2.0.0.zip",
    "sha256": "6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1"
  }
}

Sumber plugin command

Gunakan sumber command ketika alat yang terinstal di mesin pengguna menghasilkan direktori plugin, seperti IDE yang me-render plugin-nya untuk toolchain yang dipilih pengguna. Claude Code menjalankan perintah tersebut saat pengguna menginstal atau memperbarui plugin, dan sekali lagi per sesi, sehingga pengguna mendapatkan output alat yang berubah tanpa menginstal ulang.

Sumber command menerima field berikut:

• command: perintah shell yang mencetak path absolut direktori plugin sebagai satu baris dan keluar dengan 0. Claude Code menampilkan seluruh string kepada pengguna untuk ditinjau sebelum dijalankan. Tulis dalam ASCII yang dapat dicetak, maksimal 500 karakter, tanpa deretan empat spasi atau lebih.
• timeout: bilangan bulat detik dari 1 hingga 600. Default-nya 60.
• mode: copy, default, atau link. Lihat Mode copy dan mode link.

{
  "name": "formatter",
  "source": {
    "source": "command",
    "command": "my-tool claude-plugin-path",
    "timeout": 120
  }
}

Untuk cara pengguna menerima perintah, lihat Instal dari shell Anda. Untuk apa yang dilihat pengguna setelah Anda mengubahnya, lihat Ubah perintah sumber command. Administrator mematikan sumber command dengan disableCommandPluginSources.

Apa yang harus dilakukan perintah

Tulis perintah agar memenuhi persyaratan berikut:

• Shell dan direktori kerja: Claude Code menjalankan perintah melalui sh, atau melalui cmd.exe di Windows, dari direktori home pengguna. Berikan path absolut atau perintah yang ada di PATH.
• Output: cetak tepat satu baris di stdout, yaitu path absolut direktori plugin, dan keluar dengan 0 dalam timeout detik.
• Isi direktori: direktori berisi plugin lengkap pada saat perintah keluar. Path dapat berbeda dari satu eksekusi ke eksekusi berikutnya.

Output yang menggagalkan instalasi atau pembaruan

Instalasi atau pembaruan gagal ketika perintah keluar dengan nilai bukan nol, berjalan lebih lama dari timeout, atau mencetak apa pun selain satu path absolut. Instalasi atau pembaruan juga gagal ketika direktori yang dicetak adalah salah satu dari berikut:

• Tidak ada konten plugin: direktori yang dicetak tidak memiliki konten plugin di tingkat teratasnya, seperti direktori .claude-plugin/ atau direktori skills/, commands/, agents/, atau hooks/.
• Direktori sesi itu sendiri: direktori yang dicetak adalah direktori tempat Claude Code dimulai, atau salah satu induknya.
• Path jaringan: di Windows, path yang dicetak adalah path UNC.
• Terlalu besar untuk disalin: dalam mode copy, direktori berukuran lebih dari 256 MiB atau memiliki lebih dari 20.000 entri.

Mode copy dan mode link

mode menentukan apakah Claude Code menyalin direktori yang dicetak atau menggunakannya di tempat:

• copy: Claude Code menyalin direktori ke cache plugin dan menurunkan versi plugin dari hash file yang disalin. Alat Anda dapat menghapus atau menulis ulang direktori setelah perintah keluar. Eksekusi ulang yang menghasilkan file identik dianggap sudah mutakhir.
• link: Claude Code mengisi entri cache plugin dengan tautan ke setiap entri tingkat teratas dari direktori yang dicetak dan memuat file di tempat. Tidak ada yang disalin, isi file tidak di-hash, dan batas ukuran tidak berlaku. Gunakan untuk direktori yang terlalu besar untuk disalin, seperti ekspor SDK yang di-render.

Plugin mode link memiliki persyaratan berikut:

• Biarkan direktori di tempatnya: Claude Code memuat plugin melalui tautan di setiap startup, sehingga direktori yang dicetak harus tetap berada di tempatnya selama plugin tetap terinstal.
• Cetak path yang berbeda untuk menandakan konten baru: versi berasal dari path sebenarnya direktori yang dicetak dan entri tingkat teratasnya, bukan dari file di dalamnya.
• Jaga symlink tingkat teratas tetap di dalam direktori: instalasi gagal jika entri tingkat teratas adalah symlink yang mengarah ke luar direktori yang dicetak.
• Sertakan node_modules: Claude Code melewati instalasi dependensi paket Node.js untuk plugin mode link, jadi cetak direktori yang sudah berisi paket yang dibutuhkan plugin.
• Sesi yang dimulai di dalam direktori: sesi yang dimulai di direktori yang dicetak atau di mana pun di bawahnya tidak memuat plugin.
• Tidak di Windows: Claude Code menolak menginstal plugin mode link di Windows. Deklarasikan "mode": "copy" di sana.

Sumber marketplace

Sumber marketplace mengatakan di mana Claude Code mengambil marketplace.json dari. CLI membangun satu untuk Anda ketika Anda menambahkan marketplace, dan Anda menulis satu sendiri di pengaturan:

• claude plugin marketplace add: Claude Code membangun sumber dari string yang Anda lewatkan.
• extraKnownMarketplaces: Anda menulis sumber sendiri sebagai objek source.
• strictKnownMarketplaces dan blockedMarketplaces: administrator menulis sumber dalam dua daftar kebijakan ini. strictKnownMarketplaces adalah allowlist dan blockedMarketplaces adalah blocklist.

Nama tipe url, git, dan github berarti sesuatu yang berbeda dalam sumber marketplace daripada dalam sumber plugin:

Tabel mencantumkan setiap tipe sumber marketplace dengan field-nya, input claude plugin marketplace add yang menghasilkannya, dan apa yang dilakukannya di masing-masing dari tiga kunci pengaturan.

Field menurut tipe

Tabel mencantumkan setiap field sumber marketplace yang memiliki default, batasan, atau makna khusus untuk tipenya.

Nilai sumber yang valid hanya dalam daftar kebijakan

hostPattern, pathPattern, skills-dir, dan bentuk owner/* dari repo hanya valid dalam dua daftar kebijakan, strictKnownMarketplaces dan blockedMarketplaces:

• hostPattern dan pathPattern: ekspresi reguler yang Claude Code uji terhadap sumber sebelum mengambil darinya.
• skills-dir: bukan sumber. Jika Anda menetapkan strictKnownMarketplaces tanpa entri {"source": "skills-dir"}, plugin direktori skills berhenti dimuat. Jika Anda mengunci tipe kustomisasi apa pun dengan strictPluginOnlyCustomization, plugin tersebut berhenti dimuat terlepas dari ada atau tidaknya entri tersebut.
• owner/*: sebagai nilai repo github, cocok dengan setiap repositori di bawah pemilik GitHub yang tepat. Memerlukan Claude Code v2.1.223 atau lebih baru.

Untuk urutan kecocokan, semantik ref yang tepat, dan resep, lihat Kelola plugin untuk organisasi Anda.

Objek sumber di pengaturan

Nilai extraKnownMarketplaces adalah peta dari nama marketplace ke objek dengan source. Entri ini mendaftarkan marketplace dari repositori git di cabang main-nya:

{
  "extraKnownMarketplaces": {
    "your-marketplace": {
      "source": {
        "source": "git",
        "url": "https://git.example.com/your-org/your-marketplace.git",
        "ref": "main"
      }
    }
  }
}

strictKnownMarketplaces dan blockedMarketplaces adalah array objek sumber. Allowlist ini mengakui satu pemilik GitHub dan satu host internal:

{
  "strictKnownMarketplaces": [
    { "source": "github", "repo": "your-org/*" },
    { "source": "hostPattern", "hostPattern": "^git\\.example\\.com$" }
  ]
}

Pesan validasi

claude plugin validate <path> mengambil akar marketplace atau file marketplace itu sendiri. Agar file tersebut divalidasi sebagai marketplace dan bukan sebagai manifest plugin, beri nama marketplace.json. Untuk kode keluar dan --strict, lihat plugin validate.

Pesan menamai entri plugin menurut indeksnya, ditulis sebagai plugins.1.source atau plugins[1].source.

Pesan yang diawali dengan indeks entri dan plugin.json →, seperti plugins[2] plugin.json →, adalah tentang file plugin itu sendiri. claude plugin validate melaporkan kesalahan mencantumkan pesan tersebut dengan perbaikannya.

Peringatan yang menyebutkan nama flag Claude Desktop menandai nama yang Claude Desktop tolak.

Tabel memetakan pesan tingkat marketplace ke field yang masing-masing tentang.

Invalid input pada sumber

Invalid input pada source berarti objek tidak cocok dengan tipe sumber apa pun. Periksa penyebab ini:

• package npm yang berisi ..
• Tipe source yang bukan salah satu dari sumber plugin
• Tipe yang dikenal dengan field yang diperlukan hilang atau tipe yang salah, seperti github tanpa repo

Jalur relatif yang tidak dimulai dengan ./, selain "." atau nama bare di bawah metadata.pluginRoot, gagal dengan Invalid string: must start with "./". Sebelum v2.1.285, jalur tersebut mencetak Invalid input seperti penyebab di atas.

Kegagalan yang validasi tidak tangkap

claude plugin validate tidak melaporkan setiap kegagalan. Entri hooks yang ditulis sebagai jalur file atau array melewati validasi, dan kesalahan muncul hanya ketika plugin dimuat, seperti Hooks dalam entri menjelaskan. Kesalahan pengambilan source juga muncul hanya setelah install, bukan dalam validasi.

claude plugin list menunjukkan plugin yang gagal dimuat dengan kesalahannya, dan Troubleshoot plugins mencakup string waktu muat.

Langkah berikutnya

• Buat marketplace: bangun marketplace dari field ini dan pasang darinya secara lokal
• Host dan kelola marketplace: di mana menempatkan file dan cara pengguna menerima perubahan
• Referensi manifest plugin: field plugin.json yang dapat ditimpa entri
• Kelola plugin untuk organisasi Anda: resep allowlist dan blocklist yang menggunakan nilai sumber ini