Host dan kelola marketplace

​

Host your marketplace

​

Register the marketplace for everyone in a repository

​

Avoid relative-path entries in a URL-hosted marketplace

​

Edit plugins in place on a shared directory

​

Keep plugin files out of Git LFS

​

Share files within a marketplace with symlinks

• Dalam direktori plugin itu sendiri: symlink dipertahankan sebagai symlink relatif dalam cache, jadi tetap menyelesaikan target yang disalin saat runtime.
• Di tempat lain dalam marketplace yang sama: symlink didereferensi. Konten target disalin ke cache di tempatnya. Ini memungkinkan direktori skills/ meta-plugin untuk menghubungkan ke skills yang ditentukan oleh plugin lain di marketplace.
• Di luar marketplace: symlink dilewati untuk keamanan.

ln -s ../../shared-plugin/skills/foo ./skills/foo

​

Distribute through organization settings

• Marketplace repository: di github.com dan gitlab.com, harus pribadi atau internal
• Plugin sources: setiap plugin source harus bertipe github, url, atau git-subdir, atau relative path yang dimulai dengan ./
• Top-level bin/ directory: claude.ai menolak plugin yang memilikinya dan mensinkronkan sisa marketplace. Pesan kesalahan dimulai dengan Plugin contains a top-level bin/ directory. Simpan executable di direktori lain, seperti scripts/, dan referensikan sebagai ${CLAUDE_PLUGIN_ROOT}/scripts/<name> dari hooks atau konfigurasi server MCP Anda

​

Grant access to a private marketplace

• GitHub owner/repo: Claude Code menyelidiki ssh -T git@github.com dan mengkloning melalui SSH ketika penyelidikan berhasil. Jika penyelidikan gagal, atau klon SSH itu sendiri gagal, ia mengkloning melalui HTTPS. Pengguna di mesin tanpa kunci SSH GitHub dapat mengatur CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1 untuk melewati penyelidikan dan mengkloning melalui HTTPS.
• git@host:path.git: SSH.
• https://example.com/repo.git: HTTPS.

• SSH: kunci harus bekerja tanpa prompt passphrase, misalnya karena dimuat di ssh-agent. Host harus sudah ada di known_hosts.
• HTTPS: Claude Code membiarkan helper kredensial git pengguna diaktifkan tetapi melarangnya dari prompting. Kredensial yang sudah disimpan helper bekerja; satu yang harus diminta gagal. Di GitHub, gh auth login diikuti oleh gh auth setup-git menyimpan satu.

​

Serve users who have no git-host account

• archive: zip yang diunduh melalui HTTPS. Pengguna tidak memerlukan git atau akun, hanya akses jaringan ke URL. Memerlukan Claude Code v2.1.224 atau lebih baru. Pin setiap archive dengan sha256 sehingga Claude Code menolak unduhan yang berubah. Untuk mengirim kredensial dengan unduhan, lihat Authenticate archive downloads.
• Repositori git publik: Claude Code mengkloning source url atau git-subdir publik melalui HTTPS tanpa kredensial ketika entri memberikan URL https://. Untuk source github, atau source git-subdir yang ditulis sebagai owner/repo, pengguna tanpa kunci SSH GitHub mengatur CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1.

​

What background auto-update does with credentials

• SSH remotes: kunci yang dimuat di ssh-agent mengautentikasi pemeriksaan.
• HTTPS remotes dengan kredensial yang disimpan: helper yang dapat menyediakan kredensial yang disimpan tanpa prompting mengautentikasi pemeriksaan. Git Credential Manager, helper Keychain macOS, dan git-credential-store bekerja dengan cara ini setelah mereka memegang kredensial untuk host.
• HTTPS remotes dengan helper yang perlu prompt: helper tidak dapat menjawab di latar belakang. Pembaruan gagal diam-diam dan checkout yang ada tetap di tempat, jadi plugin pengguna terus bekerja dari status yang terakhir disinkronkan.

• Checkout sudah terbaru: Claude Code membiarkannya apa adanya.
• Pemeriksaan menemukan commit baru, atau gagal karena tidak dapat menjangkau atau mengautentikasi ke remote: Claude Code mengkloning marketplace lagi dan mengganti checkout yang ada dengan klon baru. Jika klon itu gagal, checkout yang ada tetap di tempat. Klon ulang dapat time out on large repositories.

• Simpan kredensial: masuk ke helper kredensial terlebih dahulu sehingga memegang kredensial untuk host. Untuk GitHub, jalankan gh auth login, kemudian gh auth setup-git.
• Simpan checkout saat gagal: jika pengguna mengatur CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1, Claude Code menyimpan checkout yang ada tanpa mencoba klon ulang ketika pemeriksaan latar belakang tidak dapat menjangkau atau mengautentikasi ke remote. Plugin terus bekerja dari status yang terakhir disinkronkan.

​

Roll out to a whole company

• Entry sources yang tidak memerlukan akun git: Serve users who have no git-host account
• Direktori plugin yang sudah diisi sebelumnya: Seed containers and CI, yang juga melayani pengguna yang tidak memiliki akun git-host
• Pengaturan organisasi claude.ai: Distribute through organization settings, di mana kredensial git pengguna Anda tidak terlibat

​

Keep users up to date

​

Turn on auto-update

• Beri tahu pengguna untuk menyalakannya: setiap pengguna pergi ke Marketplaces di /plugin, memilih marketplace Anda, dan memilih Enable auto-update.
• Minta admin untuk mengaturnya: jika admin mengatur "autoUpdate": true pada entri extraKnownMarketplaces marketplace Anda dalam pengaturan terkelola, itu aktif untuk semua orang yang menerima pengaturan itu. Lihat Set update policy.

​

Release a new version

• Bump version pada setiap rilis: pengguna tetap pada salinan cache mereka sampai string berubah. Jika Anda mengatur "version": "1.0.0" dan push commit baru tanpa mengubahnya, pengguna tidak menerimanya.
• Hilangkan version: pengguna melacak commit Anda sebagai gantinya. Tinggalkan version dari plugin.json dan entri marketplace.

​

Hold users on one version

• ref dan sha pada entri plugin: ref menamai branch atau tag dan sha menamai commit untuk source github, url, atau git-subdir. Lihat Plugin sources.
• #<ref> pada perintah add: pengguna yang menambahkan your-org/your-marketplace#stable mendapatkan branch atau tag itu dari katalog. Untuk dua baris rilis sekaligus, lihat Run release channels.
• <plugin>--v<version> tags: rentang versi dependensi diselesaikan terhadap tag ini. Lihat Release a plugin that others depend on.

​

Change the command of a command source

• Tidak ada lagi background runs: once-per-session run perintah berhenti untuk pengguna itu, jadi output baru tool tidak mencapai mereka.
• Entri di tab /plugin Errors: entri menunjukkan perintah baru dan perintah claude plugin update untuk dijalankan.

​

Run release channels

{
  "name": "stable-tools",
  "owner": { "name": "Your Org" },
  "plugins": [
    { "name": "code-formatter", "source": { "source": "github", "repo": "your-org/code-formatter", "ref": "stable" } }
  ]
}

{
  "name": "latest-tools",
  "owner": { "name": "Your Org" },
  "plugins": [
    { "name": "code-formatter", "source": { "source": "github", "repo": "your-org/code-formatter", "ref": "latest" } }
  ]
}

​

Rename or remove a plugin

​

Migrate users with a renames map

{
  "name": "your-marketplace",
  "owner": { "name": "Your Org" },
  "plugins": [
    { "name": "code-formatter", "source": "./plugins/code-formatter" }
  ],
  "renames": {
    "formatter": "code-formatter",
    "legacy-linter": null
  }
}

• Entri yang diganti nama: plugin memuat di bawah nama barunya. claude plugin list dan detail plugin di bawah /plugin menunjukkan Renamed to "code-formatter" in the "your-marketplace" marketplace sekali, dan Claude Code menulis ulang kunci lama ke yang baru di enabledPlugins dan pluginConfigs dalam scope pengaturan pengguna, proyek, dan lokal.
• Entri null: kunci lama dijatuhkan dari scope itu dan pengguna melihat Removed from the "your-marketplace" marketplace.
• Diaktifkan dalam pengaturan terkelola: plugin masih memuat di bawah nama barunya, tetapi Claude Code tidak dapat menulis ulang pengaturan terkelola, jadi pemberitahuan berulang sampai admin memperbarui enabledPlugins di sana.

​

Uninstall removed plugins from users’ machines

1. Membandingkan apa yang pengguna pasang dari marketplace Anda terhadap entri dan peta renames, dan memperlakukan plugin apa pun yang tidak tercantum atau diganti nama sebagai dihapus.
2. Mencopot setiap plugin yang dihapus dari scope pengguna, proyek, dan lokal. Plugin yang hanya pengaturan terkelola pasang tetap di tempat.
3. Mencantumkan setiap plugin yang dihapus di bawah heading Flagged di /plugin dengan status Removed from marketplace.

​

Autentikasi unduhan arsip

• Sumber url marketplace: sumber url yang Anda daftarkan marketplace darinya, seperti entri extraKnownMarketplaces.
• Entri plugin: pada Claude Code v2.1.238 atau lebih baru, Anda dapat mengaturnya pada entri marketplace.json plugin sebagai gantinya, di samping source.

​

Tambahkan headersHelper ke entri plugin

{
  "name": "my-plugin",
  "description": "Formatting commands for internal services",
  "strict": false,
  "source": {
    "source": "archive",
    "url": "https://registry.example.com/plugins/my-plugin-2.1.0.zip"
  },
  "headersHelper": "/opt/bin/mint-registry-token.sh"
}

​

Tulis perintah headersHelper

• Teks perintah: paling banyak 500 karakter ASCII yang dapat dicetak, tanpa run empat atau lebih spasi.
• Output: cetak satu objek JSON dari nama header dan nilai string pada stdout, kemudian keluar 0 dalam 10 detik.
• Shell dan direktori kerja: Claude Code menjalankan perintah melalui sh, atau melalui cmd.exe di Windows. Direktori kerja adalah direktori konfigurasi, yaitu ~/.claude atau CLAUDE_CONFIG_DIR. Berikan jalur absolut atau perintah pada PATH, karena jalur relatif diselesaikan terhadap direktori tersebut, bukan proyek pengguna.
• Variabel yang Claude Code hapus: ketika perintah diatur dalam entri marketplace.json, atau dalam .claude/settings.json atau .claude/settings.local.json proyek, Claude Code menghapus dari lingkungan setiap variabel yang namanya terlihat seperti kredensial, dengan aturan yang sama yang diterapkannya pada MCP headersHelper. ANTHROPIC_API_KEY dan MY_REGISTRY_TOKEN keduanya dihapus, jadi biarkan perintah membaca kredensialnya dari file atau penyimpanan kredensial. Penghapusan ini tidak berlaku untuk perintah yang diatur dalam pengaturan pengguna, file --settings, atau pengaturan terkelola.
• Variabel yang Claude Code atur: CLAUDE_CODE_MARKETPLACE_URL dan CLAUDE_CODE_MARKETPLACE_NAME untuk perintah sumber url, dan CLAUDE_CODE_PLUGIN_NAME dan CLAUDE_CODE_PLUGIN_ARCHIVE_URL untuk perintah entri. CLAUDE_CODE_MARKETPLACE_NAME tidak diatur pada pengambilan pertama setelah pengguna menambahkan marketplace berdasarkan URL, karena pengambilan tersebut adalah yang menyediakan nama.

{"Authorization": "Bearer eyJhbGciOiJSUzI1NiJ9"}

​

Kapan Claude Code melewati perintah headersHelper atau menghapus outputnya

• Perintah gagal: jika perintah keluar non-nol, berjalan melampaui 10 detik, atau mencetak apa pun selain objek JSON dari nilai string, pengambilan atau unduhan yang perintah dijalankan tidak terjadi.
• URL Marketplace tidak dimulai dengan https://: perintah sumber url tersebut tidak berjalan, dan permintaan hanya membawa header yang tercantum dalam bidang headers-nya.
• Pengalihan meninggalkan asal: ketika unduhan dialihkan dari asal URL arsip, permintaan yang dialihkan tidak membawa nilai headers atau output perintah dari sumber url marketplace atau entri plugin.
• Entri mengatur header perutean atau identitas: Claude Code menghapus nama perutean permintaan dan identitas klien seperti Host, Cookie, dan X-Forwarded-* dari headers entri dan output perintah, dan mempertahankan nama autentikasi seperti Authorization. Setiap entri marketplace.json disaring dengan cara ini. Untuk entri plugin inline dalam pengaturan, lihat extraKnownMarketplaces.
• Perintah diatur dalam pengaturan direktori --add-dir: perintah diabaikan, pada sumber url dan pada entri plugin inline juga, dan hanya headers file tersebut yang dikirim.
• Pengaturan terkelola memblokir perintah: mengatur disableCommandPluginSources ke true memblokir perintah headersHelper, dan allowManagedHooksOnly juga memblokir mereka kecuali disableCommandPluginSources secara eksplisit false. Di bawah salah satu blok, Claude Code masih menjalankan perintah untuk marketplace yang pengaturan terkelola sendiri nyatakan.

​

Bagaimana pengguna menerima perintah headersHelper

​

Pemasangan dan pembaruan yang menolak perintah alih-alih bertanya

• Memasang beberapa plugin sekaligus, dari saran plugin, atau sebagai ketergantungan plugin lain: Claude Code menolak plugin yang memiliki perintah dan mengarahkan pengguna ke tampilan plugin sendiri di /plugin. Plugin lain dalam pemasangan massal masih terpasang. Plugin yang bergantung pada plugin yang ditolak gagal terpasang sampai pengguna memasang plugin yang ditolak sendiri.
• Pembaruan otomatis latar belakang, atau awal sesi untuk plugin yang arsipnya tidak pernah diunduh: Claude Code mencantumkan plugin dalam tab Errors /plugin sehingga pengguna tahu untuk memasang atau memperbarui sendiri.

​

Kapan perintah sumber url marketplace berjalan

​

Depend on and recommend other plugins

• Rentang versi: dependensi dapat membawa rentang semver.
• Dependensi lintas marketplace: dependensi dari marketplace lain memasang hanya ketika marketplace Anda mencantumkan marketplace itu di allowCrossMarketplaceDependenciesOn.

​

Work around what a marketplace can’t do

• Batasi apa yang pengguna lain pasang: daftar allowlist marketplace adalah pengaturan terkelola, strictKnownMarketplaces. Lihat Restrict what users can install.
• Pasang atau aktifkan plugin tanpa pengguna bertanya: tidak ada field entri yang memasang plugin. enabledPlugins terkelola melakukan itu untuk armada; lihat Pre-install and require plugins.
• Tampilkan entri berbeda kepada pengguna berbeda: entri tidak membawa field audiens, dan setiap pengguna yang menambahkan marketplace melihat seluruh katalog. Host marketplace terpisah untuk audiens terpisah.
• Tandai plugin sebagai deprecated: tidak ada status deprecation. Opsinya adalah menghapus entri, memetakan nama-nya ke null di renames, dan secara opsional mengatur forceRemoveDeletedPlugins.
• Nyalakan auto-update untuk pengguna Anda: setiap pengguna menyalakannya di bawah Marketplaces di /plugin, atau admin mengatur autoUpdate dalam pengaturan terkelola. Lihat Turn on auto-update.
• Bawa kredensial git: tidak ada field marketplace yang menyimpan token git. Akses ke marketplace atau plugin yang dihosting git mengikuti setup git pengguna, per Grant access to a private marketplace. Untuk source archive, entri dapat mengatur headers atau headersHelper sebagai gantinya.

​

Next steps

• Marketplace reference: field marketplace.json, tipe source, dan pesan validasi
• Manage plugins for your organization: memerlukan, membatasi, atau seed marketplace Anda di seluruh mesin organisasi Anda
• Plugin dependencies: tag rilis sehingga plugin yang bergantung pada Anda dapat menyelesaikan versi
• Troubleshoot plugins: kesalahan yang pengguna Anda lihat saat menambahkan atau memperbarui dari marketplace Anda