Referensi Marketplace

• 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

​

Nama yang dicadangkan

• 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.
• 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. claude plugin validate menerima nama seperti itu; menambahkan marketplace gagal dengan is another spelling of "<reserved>", a reserved marketplace name, dan marketplace yang sudah terdaftar di bawah satu 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 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.

​

Field tingkat atas

​

Entri plugin

​

Bagaimana entri menggabungkan dengan plugin.json

• Tidak ada plugin.json: entri adalah manifest terlepas dari strict. Setiap field manifest dalam entri berlaku, termasuk mcpServers, lspServers, userConfig, dan channels.
• plugin.json hadir: 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. Entri mcpServers, lspServers, userConfig, dan channels tidak berlaku. Deklarasikan mereka di plugin.json.

​

Hooks dalam entri

​

Field tampilan

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

​

Mode ketat

​

Sumber plugin

• ref: cabang atau tag. Default ke cabang default repositori.
• sha: SHA commit 40-karakter lowercase penuh. Ketika Anda menetapkan baik ref maupun sha, Claude Code melakukan checkout sha. Di sebagian besar host git, termasuk GitHub, GitLab, dan Bitbucket, ini berarti pemasangan berhasil bahkan jika cabang atau tag yang dinamai oleh ref telah dihapus upstream, selama commit masih dapat dijangkau dari repositori. Beberapa server, seperti AWS CodeCommit, tidak mendukung pengambilan commit menurut SHA. Di server tersebut ref masih harus ada dan commit yang disematkan harus dapat dijangkau darinya.

​

Sumber plugin jalur relatif

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

• github, git, file, dan directory: Claude Code memiliki file marketplace.
• url: Claude Code hanya mengambil marketplace.json, jadi jalur relatif tidak dapat diselesaikan. Berikan setiap plugin sumber objek sebagai gantinya, seperti github atau git-subdir.
• settings: jalur relatif ditolak sepenuhnya.

​

Nama bare di bawah pluginRoot

• Itu sendiri harus jalur relatif di dalam marketplace.
• Itu tidak berpengaruh pada sumber yang sudah dimulai dengan ./.
• Sumber yang berisi /, seperti team-a/formatter, bukan nama bare dan masih memerlukan awalan ./, bahkan ketika metadata.pluginRoot diatur.

​

Sumber plugin github

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

​

Sumber plugin url

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

​

Sumber plugin git-subdir

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

​

Sumber plugin npm

• package: nama paket, atau nama scoped seperti @your-org/formatter
• version: versi atau rentang
• registry: URL registry untuk paket yang bukan di registry default

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

​

Sumber plugin archive

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

​

Sumber plugin command

• command: perintah shell yang mencetak jalur absolut direktori plugin sebagai satu baris dan keluar 0. Claude Code menunjukkan seluruh string kepada pengguna untuk ditinjau sebelum menjalankannya. Tulis sebagai ASCII yang dapat dicetak, paling banyak 500 karakter, tanpa run empat atau lebih spasi.
• timeout: bilangan bulat detik dari 1 hingga 600. Default ke 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
  }
}

​

Apa yang harus dilakukan perintah

• Shell dan direktori kerja: Claude Code menjalankan perintah melalui sh, atau melalui cmd.exe di Windows, dari direktori home pengguna. Berikan jalur absolut atau perintah di PATH.
• Output: cetak tepat satu baris di stdout, jalur absolut direktori plugin, dan keluar 0 dalam timeout detik.
• Isi direktori: direktori menyimpan plugin lengkap pada saat perintah keluar. Jalur dapat berbeda dari satu run ke run berikutnya.

​

Output yang gagal install atau update

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

​

Mode copy dan mode link

• 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. Re-run yang menghasilkan file identik dihitung sebagai up to date.
• link: Claude Code mengisi entri cache plugin dengan tautan ke setiap entri tingkat atas direktori yang dicetak dan memuat file di tempat. Tidak ada yang disalin, konten file tidak di-hash, dan batas ukuran tidak berlaku. Gunakan untuk direktori terlalu besar untuk disalin, seperti ekspor SDK yang dirender.

• Simpan direktori di tempat: Claude Code memuat plugin melalui tautan di setiap startup, jadi direktori yang dicetak harus tetap di mana itu selama plugin tetap dipasang.
• Cetak jalur berbeda untuk menandakan konten baru: versi berasal dari jalur nyata direktori yang dicetak dan entri tingkat atasnya, bukan dari file di dalamnya.
• Simpan symlink tingkat atas di dalam direktori: install gagal jika entri tingkat atas adalah symlink yang menunjuk di luar direktori yang dicetak.
• Sertakan node_modules: Claude Code melewati install dependensi paket Node.js untuk plugin mode link, jadi cetak direktori yang sudah berisi paket yang dibutuhkan plugin.
• Sesi dimulai di dalam direktori: sesi yang dimulai di direktori yang dicetak atau di mana pun di bawahnya tidak memuat plugin.
• Bukan di Windows: Claude Code menolak untuk memasang plugin mode link di Windows. Deklarasikan "mode": "copy" di sana.

​

Sumber marketplace

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

​

Field menurut tipe

​

Nilai sumber yang valid hanya dalam daftar kebijakan

• hostPattern dan pathPattern: ekspresi reguler yang Claude Code uji terhadap sumber sebelum mengambil darinya.
• skills-dir: bukan sumber. Jika Anda menetapkan strictKnownMarketplaces sama sekali, plugin direktori skills berhenti dimuat sampai Anda menambahkan {"source": "skills-dir"} ke daftar itu.
• owner/*: sebagai nilai repo github, cocok dengan setiap repositori di bawah pemilik GitHub yang tepat. Memerlukan Claude Code v2.1.223 atau lebih baru.

​

Objek sumber di pengaturan

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

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

​

Pesan validasi

​

Invalid input pada sumber

• Jalur relatif yang tidak dimulai dengan ./, selain "." atau nama bare di bawah metadata.pluginRoot
• 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

​

Kegagalan yang validasi tidak tangkap

​

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