Skip to main content
Dependensi plugin adalah plugin lain yang plugin Anda andalkan, seperti plugin yang memanggil MCP server atau skill-nya. Setiap dependensi melacak versi terbaru yang disediakan marketplace-nya kecuali Anda mendeklarasikan batasan versi, rentang semantic-version seperti ^2.0 atau ~2.1.0 yang telah Anda uji. Halaman ini adalah untuk penulis plugin yang mendeklarasikan dependensi dalam plugin.json dan untuk pengelola marketplace yang menandai rilis.
Kasus-kasus ini tercakup di halaman lain:
Untuk menambahkan batasan, mulai dari Deklarasikan dependensi dengan batasan versi. Jika Anda mengelola plugin yang bergantung padanya oleh orang lain, tandai rilis Anda sehingga batasan mereka dapat diselesaikan.

​
Deklarasikan dependensi

Tanpa batasan versi, dependensi bergerak ke setiap rilis baru yang marketplace-nya terbitkan saat pengguna memperbarui. Jika rilis itu mengganti nama alat MCP yang plugin Anda panggil, plugin Anda rusak untuk semua orang yang memperbarui. Dengan batasan seperti ~2.1.0 pada dependensi dari sumber yang didukung git, pengguna yang memiliki plugin Anda terinstal terus menerima patch 2.1.x dari dependensi dan tidak pernah pindah ke 2.2. Untuk meningkatkan sesuai jadwal Anda sendiri, uji terhadap rilis yang lebih baru dan kemudian terbitkan versi baru plugin Anda dengan batasan yang lebih luas.

​
Deklarasikan dependensi dengan batasan versi

Daftar dependensi dalam array dependencies dari .claude-plugin/plugin.json plugin Anda. Manifes berikut mendeklarasikan satu dependensi tanpa versi dan satu dependensi terbatas:
.claude-plugin/plugin.json
Entri dapat berupa string: nama plugin saja, seperti "audit-logger" dalam manifes ini, atau "name@marketplace" untuk menyelesaikannya di marketplace lain. Dengan string kosong, plugin Anda bergantung pada versi apa pun yang disediakan marketplace plugin tersebut. Untuk menetapkan batasan versi, gunakan objek dengan bidang-bidang ini, masing-masing berupa string: Rentang tidak cocok dengan versi pra-rilis seperti 2.0.0-beta.1 kecuali Anda memilih dengan akhiran pra-rilis seperti ^2.0.0-0.

​
Bundel plugin untuk tim

Untuk memungkinkan insinyur menginstal set plugin yang dikurasi dengan satu perintah, terbitkan plugin yang manifesnya berisi name dan array dependencies. Manifes plugin hanya membutuhkan name, jadi ini adalah plugin yang valid, dan menginstalnya menginstal setiap dependensi. Misalnya, tim platform dapat menerbitkan bundel khusus peran di marketplace internal sehingga insinyur menjalankan satu claude plugin install alih-alih menginstal setiap plugin secara terpisah:
.claude-plugin/plugin.json
Untuk menambahkan plugin ke set standar nanti, terbitkan versi backend-standard baru dengan dependensi tambahan. Ketika marketplace tidak auto-update secara default, insinyur baik mengaktifkan auto-update untuk marketplace atau memperbarui secara manual:
  • Aktifkan auto-update untuk marketplace: pembaruan auto-update berikutnya memindahkan bundel ke versi baru dan menginstal dependensi apa pun yang ditambahkannya.
  • Perbarui secara manual: jalankan claude plugin update backend-standard di shell, kemudian /reload-plugins dalam sesi terbuka untuk menginstal dependensi yang baru ditambahkan.
Untuk langkah-langkah sisi insinyur, lihat Jaga plugin tetap diperbarui. Untuk menerapkan bundel ke semua orang dalam organisasi, administrator menambahkannya ke enabledPlugins dalam pengaturan terkelola. Lihat Pra-instal dan butuhkan plugin.

​
Bergantung pada plugin dari marketplace lain

Secara default, Claude Code tidak menginstal dependensi dari marketplace berbeda dari marketplace plugin yang mendeklarasikan sendiri, kecuali pengguna sudah memiliki dependensi itu terinstal dan diaktifkan pada cakupan yang sama. Default ini mencegah satu marketplace secara diam-diam menginstal plugin dari sumber yang belum ditinjau pengguna. Untuk memungkinkan instalasi, tambahkan nama marketplace target ke allowCrossMarketplaceDependenciesOn dalam marketplace.json marketplace root. Marketplace root adalah yang menghosting plugin yang pengguna instal. Hanya daftar izin marketplace root yang berlaku. marketplace.json berikut memungkinkan deploy-kit bergantung pada plugin dari your-shared-marketplace:
.claude-plugin/marketplace.json
Jika allowCrossMarketplaceDependenciesOn hilang atau tidak menyertakan marketplace target, Claude Code tidak menginstal dependensi. Ketika dependensi dideklarasikan dalam entri marketplace, instalasi itu sendiri ditolak dengan pesan yang dimulai Dependency "audit-logger@your-shared-marketplace" (required by deploy-kit@your-marketplace) is in marketplace "your-shared-marketplace", which is not in the allowlist dan menyebutkan bidang yang akan ditetapkan. Ketika dideklarasikan dalam plugin.json, instalasi selesai tanpa dependensi dan plugin Anda kemudian gagal dimuat. Pemeriksaan daftar izin tidak berlaku untuk dependensi yang sudah diaktifkan. Jika pengguna menginstal audit-logger dari your-shared-marketplace sendiri terlebih dahulu, pada cakupan yang sama, deploy-kit kemudian menginstal tanpa perubahan apa pun pada daftar izin.

​
Uji plugin dan dependensinya secara lokal

Jika Anda mengembangkan plugin dan plugin yang bergantung padanya pada saat yang sama, mulai Claude Code dari shell Anda dan muat keduanya dengan --plugin-dir:
Salinan lokal dependensi memenuhi entri dependensi plugin Anda, jadi Anda tidak perlu menginstal dependensi dari marketplace-nya.
  • Tidak ada version yang diperlukan: plugin.json lokal juga tidak perlu version, karena batasan versi tidak diperiksa terhadap salinan lokal.
  • Entri yang menyebutkan marketplace: entri yang menyebutkan marketplace juga cocok dengan salinan lokal pada Claude Code v2.1.242 atau lebih baru.
Sampai Anda menginstal dependensi dari marketplace-nya, plugin Anda berhenti dimuat setiap kali salinan lokal dinonaktifkan atau tidak ada:
  • Anda menonaktifkan salinan lokal: plugin Anda dinonaktifkan pada pemuatan plugin berikutnya, dengan kesalahan yang berakhir is disabled — enable it or remove the dependency. Ketika kesalahan menyebutkan dependensi sebagai <name>@inline, pengidentifikasi itu merujuk pada salinan --plugin-dir.
  • Anda memulai sesi tanpa flag --plugin-dir dependensi: kesalahan melaporkan dependensi sebagai tidak terinstal. Lewatkan flag lagi, atau instal dependensi dari marketplace-nya.
Ketika kedua plugin berada dalam satu folder induk, Anda dapat meneruskan folder itu ke --plugin-dir sekali. Jika folder itu sendiri bukan plugin, Claude Code memuat setiap folder anak yang memiliki .claude-plugin/plugin.json. Memerlukan Claude Code v2.1.265 atau lebih baru.

​
Rilis plugin yang bergantung pada orang lain

Jika Anda mengelola plugin yang plugin lain bergantung padanya dengan batasan versi, tandai rilis-nya sehingga batasan itu dapat diselesaikan. Batasan diselesaikan terhadap tag git pada repositori yang menghosting plugin. Tandai repositori yang sumber plugin plugin dalam marketplace.json tunjuk:
  • Sumber github, url, atau git-subdir: repositori plugin itu sendiri, jadi penulis plugin membuat tag
  • Jalur relatif seperti ./plugins/secrets-vault: repositori marketplace, jadi pengelola marketplace membuat tag

​
Buat tag rilis

Tandai setiap rilis sebagai <plugin-name>--v<version>, di mana <version> cocok dengan bidang version dalam plugin.json commit itu. Awalan plugin-name memungkinkan satu repositori marketplace menghosting beberapa plugin dengan riwayat versi independen. Buat tag dari direktori plugin, dengan remote origin yang dikonfigurasi untuk menerima tag yang didorong, menggunakan claude plugin tag:
Perintah membangun nama tag dari manifes plugin. Sebelum membuat tag, ia menjalankan pemeriksaan ini:
  • Memvalidasi plugin
  • Memeriksa bahwa plugin.json dan entri marketplace setuju pada versi, ketika direktori plugin berada di dalam checkout marketplace
  • Memerlukan pohon kerja yang bersih di bawah direktori plugin
  • Menolak jika tag sudah ada
Jalankan yang berhasil mencetak Created tag secrets-vault--v2.1.0. Dengan --push, ia juga mencetak Pushed to origin. Tanpa --push, ia mencetak perintah git push untuk dijalankan sendiri. Lewatkan --dry-run untuk melihat rencana tanpa membuat apa pun. Referensi claude plugin tag mencantumkan flag yang tersisa. Anda juga dapat menjalankan git tag secrets-vault--v2.1.0 secara langsung, selama Anda menjaga version dalam plugin.json dan dalam entri marketplace tetap sinkron sendiri.

​
Batasi dependensi yang memiliki sumber non-git

Resolusi berbasis tag hanya berlaku untuk sumber yang didukung git. Untuk dependensi dengan sumber plugin npm, archive, atau command , batasan tidak mengontrol versi mana yang diambil. Ini masih diperiksa ketika plugin dimuat, dan plugin dependen dinonaktifkan jika versi yang terinstal tidak memenuhinya. Untuk sumber npm, archive, dan command, versi yang diperiksa adalah version dalam plugin.json dependensi. Tetapkan satu di sana sebelum Anda membatasi dependensi itu, karena plugin.json yang tidak menetapkan versi tidak memenuhi batasan apa pun. Claude Code tidak pernah menginstal dependensi dengan sumber command itu sendiri, jadi pengguna menginstalnya terlebih dahulu. Ini juga tidak pernah menjalankan headersHelper dependensi, jadi pengguna juga menginstal dependensi yang entri marketplace-nya menetapkan satu sebelum mereka menginstal plugin Anda. Selain claude plugin install, operasi ini juga menginstal dependensi yang dideklarasikan yang hilang, dan batasan command dan headersHelper berlaku untuk mereka juga:
  • /reload-plugins
  • Auto-update dari marketplace plugin dependen
  • Menjalankan kembali claude plugin install pada plugin dependen
  • claude plugin marketplace add

​
Bagaimana dependensi berperilaku untuk pengguna Anda

Bagian-bagian ini menjelaskan bagaimana Claude Code menyelesaikan, memeriksa, dan menggabungkan batasan yang Anda deklarasikan setelah plugin Anda diinstal bersama yang lain.

​
Bagaimana batasan diselesaikan terhadap tag

Ketika pengguna menginstal plugin yang mendeklarasikan { "name": "secrets-vault", "version": "~2.1.0" }, dependensi menginstal dari tag secrets-vault--v tertinggi yang memenuhi ~2.1.0 pada repositori yang menghosting secrets-vault. Ketika tidak ada tag yang memenuhi rentang, instalasi baik gagal atau menggunakan salinan marketplace saat ini:
  • Plugin dengan repositori sendiri: instalasi gagal dengan pesan yang berisi Dependency "secrets-vault@your-marketplace" has no git tag satisfying.
  • Plugin yang direferensikan oleh jalur relatif: instalasi menggunakan salinan marketplace saat ini sebagai gantinya, dan batasan diperiksa ketika plugin dimuat. Jika salinan itu berada di luar rentang, plugin dependen tetap dinonaktifkan dan claude plugin list menunjukkan Requires "secrets-vault@your-marketplace" ~2.1.0, installed 3.0.0.
Untuk plugin yang direferensikan marketplace oleh jalur folder lokal, marketplace yang Anda tambahkan sebagai jalur folder lokal juga menyelesaikan batasan terhadap tag git folder itu, ketika folder adalah repositori git. Ini memerlukan Claude Code v2.1.196 atau lebih baru. Folder lokal yang bukan repositori git tidak memiliki tag, jadi Claude Code menginstal dependensi dari konten folder saat ini sebagai gantinya.

​
Konfirmasi versi yang diselesaikan

Untuk mengonfirmasi versi mana yang diselesaikan batasan, jalankan claude plugin list di shell Anda. Dependensi yang diselesaikan tag menunjukkan versinya dengan akhiran commit 12 karakter, seperti 2.1.0-8713c5b11005. Pemeriksaan batasan menggunakan versi tag daripada version dalam plugin.json, bahkan jika plugin.json pada commit itu tertinggal. Jika Anda memaksa-pindahkan tag ke commit berbeda, instalasi berikutnya mengambil konten commit itu alih-alih menggunakan kembali salinan cache yang basi. Lihat Versi dan pembaruan untuk bagaimana versi plugin menjadi kunci cache-nya.

​
Gabungkan batasan dari beberapa plugin

Ketika beberapa plugin yang terinstal membatasi dependensi yang sama, dependensi diselesaikan ke versi tertinggi yang memenuhi semua rentang mereka. Kombinasi umum diselesaikan seperti ini: Auto-update mengambil dependensi terbatas pada tag git tertinggi yang memenuhi rentang setiap plugin yang terinstal, daripada pada versi terbaru marketplace. Jika rentang plugin yang terinstal tidak tumpang tindih, auto-update meninggalkan dependensi itu pada versi saat ini, dan tab Errors /plugin menunjukkan entri yang menyebutkan plugin yang membatasi. Jika mereka tumpang tindih tetapi tidak ada tag yang jatuh dalam rentang, auto-update mengambil salinan marketplace saat ini dan melewati pembaruan ketika version salinan itu jatuh di luar rentang plugin yang terinstal apa pun. Ketika pengguna mencopot plugin terakhir yang membatasi dependensi, dependensi tidak lagi dibatasi ke rentang versi dan melanjutkan pelacakan entri marketplace-nya pada pembaruan berikutnya.

​
Lihat juga