Troubleshoot plugins

Perbaiki kesalahan plugin di Claude Code. Temukan pesan yang tepat yang Anda lihat, dikelompokkan berdasarkan tahap dari mana /plugin berjalan melalui instalasi dan kebijakan organisasi.

Halaman ini mencantumkan pesan kesalahan dan gejala untuk plugin Claude Code dan untuk marketplace, katalog tempat Claude Code menginstal plugin. Setiap entri memberikan penyebab, satu perbaikan, dan apa yang Anda lihat setelah perbaikan berhasil.

Jika pesan menyebutkan plugin atau marketplace, entri menunjukkan placeholder seperti <name> sebagai gantinya.

Gunakan halaman ini apakah Anda menginstal plugin, membangunnya, menyelenggarakan marketplace, atau mengelola plugin untuk organisasi.

[!NOTE]

Kasus-kasus ini tercakup di halaman lain:

• Mengapa cakupan, cache, dan prioritas berperilaku seperti yang mereka lakukan: baca Plugin loading reference
• Mencari flag, field, atau perintah: gunakan plugin commands reference, manifest reference, atau marketplace reference
• Pesan hooks module not loaded atau hooks module did not load: plugin tersebut adalah mod, jadi baca The mod doesn't load

Cari pesan yang tepat yang Anda lihat. Setiap pesan tercantum di bawah tahap yang menghasilkannya, yang tidak selalu merupakan perintah yang Anda jalankan. Misalnya, instalasi dapat gagal karena marketplace hilang, jadi pesan itu berada di bawah Add a marketplace.

Find where /plugin runs

/plugin adalah command yang Anda ketik di dalam sesi terminal Claude Code yang sedang berjalan, dan itu membuka panel interaktif. Entri di bagian ini mencakup tempat-tempat di mana Anda dapat mengetiknya tetapi tidak dapat berjalan, dan spelling command yang tidak ada.

/plugin isn't available in this environment

Anda mengetik /plugin di tempat lain selain sesi terminal Claude Code, dan Claude menjawab dengan baris ini alih-alih membuka apa pun.

Anda mendapatkan balasan ini dalam sesi yang tidak memiliki terminal untuk menggambar panel /plugin di dalamnya: non-interactive mode dengan claude -p, Agent SDK, tab Code aplikasi desktop Claude, panel ekstensi VS Code, dan browser di claude.ai/code.

Di panel ekstensi VS Code, hanya baris /plugin dengan sesuatu setelahnya, seperti /plugin install <plugin>@<marketplace>, yang mendapatkan balasan ini. /plugin atau /plugins yang diketik sendiri membuka dialog Manage plugins.

Instal plugin dari permukaan yang Anda gunakan:

• Aplikasi desktop Claude, sesi lokal atau SSH: gunakan tab Desktop app di bawah Install a plugin
• Ekstensi VS Code: gunakan tab VS Code di bawah Install a plugin
• Claude Code di web, atau sesi cloud desktop: sesi cloud tidak memiliki plugin browser. Lihat tab Cloud session di bawah Install a plugin untuk apa yang dimuat sesi cloud
• Terminal yang Anda miliki akses: jalankan claude dan ketik /plugin di sana, atau jalankan claude plugin install <plugin>@<marketplace> di shell Anda tanpa memulai sesi

Ketika instalasi terminal berhasil, /plugin mencetak ringkasan instalasi yang dimulai dengan ✓ Installed <plugin>. dan claude plugin install mencetak Successfully installed plugin: <plugin>@<marketplace>.

zsh: no such file or directory: /plugin

Anda mengetik /plugin ... di prompt shell, dan shell melaporkan bahwa tidak ada file bernama /plugin. Bash melaporkan bash: /plugin: No such file or directory.

/plugin adalah command yang Anda ketik di dalam sesi Claude Code, bukan di prompt shell. Mulai sesi dan ketik command yang sama di sana:

claude

Kemudian, di prompt Claude Code:

/plugin install <plugin>@<marketplace>

Instalasi yang berhasil mencetak ringkasan yang dimulai dengan ✓ Installed <plugin>. Jika instalasi itu sendiri kemudian gagal, pesannya ada di bawah Add a marketplace atau Install a plugin.

Untuk menginstal dari shell tanpa memulai sesi, jalankan claude plugin install <plugin>@<marketplace> sebagai gantinya.

The term '/plugin' is not recognized as the name of a cmdlet

Anda mengetik /plugin ... di prompt PowerShell, dan /plugin adalah command Claude Code, bukan program. Bash dan Zsh melaporkan bentuk kesalahan mereka sendiri.

Gunakan salah satu dari ini:

• Jalankan claude, lalu ketik /plugin di prompt Claude Code
• Jalankan claude plugin install <plugin>@<marketplace> di PowerShell tanpa memulai sesi

claude: command not found after claude plugin ...

Anda menjalankan claude plugin install ... di shell Anda, dan shell tidak dapat menemukan claude sama sekali. Di Windows pesannya adalah 'claude' is not recognized as the name of a cmdlet atau 'claude' is not recognized as an internal or external command.

Penyebabnya bukan perintah plugin. Ikuti Verifikasi PATH Anda, lalu coba ulang perintah plugin.

Unknown command and command spellings that don't exist

Anda mengetik command plugin yang Anda lihat di suatu tempat dan mendapatkan Unknown command: /<name> dalam sesi, atau error: unknown command '<name>' atau error: unknown option '<flag>' dari binary claude di shell Anda.

Beberapa ejaan perintah yang beredar tidak dimiliki oleh Claude Code. Tabel di bawah memetakan masing-masing ke perintah yang sebenarnya. Referensi perintah plugin mencantumkan subcommand beserta flag-nya.

Spelling ini terlihat salah tetapi berfungsi:

• claude plugins adalah alias dari claude plugin
• claude plugin remove adalah alias dari claude plugin uninstall
• /plugins dan /marketplace dalam sesi membuka panel yang sama seperti /plugin

Menambahkan marketplace

Marketplace adalah katalog yang Anda tambahkan ke Claude Code dari repositori git, URL, atau path lokal. Entri-entri berikut membahas pesan yang Anda dapatkan ketika penambahan marketplace gagal atau ketika refresh berikutnya gagal.

Marketplace "claude-plugins-official" not found

Anda menjalankan /plugin install <plugin>@claude-plugins-official dalam sebuah sesi, dan Claude Code melaporkan bahwa tidak ada marketplace dengan nama tersebut.

Marketplace resmi belum terdaftar di mesin ini. Claude Code biasanya mendaftarkannya sendiri saat pertama kali Anda memulai sesi terminal interaktif. Langkah ini belum berjalan jika Anda hanya menggunakan Claude Code melalui ekstensi VS Code, dan Claude Code melewati atau menunda langkah tersebut:

• Ketika sebuah kebijakan memblokir sumbernya
• Ketika CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL diatur
• Setelah percobaan gagal yang sedang menunggu untuk dicoba ulang

Perintah shell claude plugin tidak pernah mendaftarkannya untuk Anda.

Tambahkan marketplace tersebut, lalu coba ulang instalasinya:

/plugin marketplace add anthropics/claude-plugins-official

Claude Code mencetak Successfully added marketplace: claude-plugins-official, dan /plugin marketplace list menampilkan marketplace tersebut beserta sumbernya.

Untuk nama marketplace lain dalam pesan ini, lihat Marketplace "<name>" not found.

String yang sama juga muncul di tab Errors pada /plugin, yaitu daftar kegagalan pemuatan di panel tersebut, ketika sebuah plugin yang tercantum dalam pengaturan Anda menyebut marketplace yang belum Anda tambahkan.

Marketplace "<name>" not found

Anda menjalankan /plugin install dalam sebuah sesi dan Claude Code melaporkan bahwa tidak ada marketplace dengan nama tersebut. Dua bentuk perintah dapat menghasilkan pesan ini:

• /plugin install <plugin>@<name>: baris instalasi, sering kali yang dikirimkan seseorang kepada Anda, menyebut marketplace yang belum Anda tambahkan. Bagian selanjutnya dari entri ini membahas cara menemukan dan menambahkannya.
• /plugin install <source> dengan path, URL, atau owner/repo: bentuk ini melaporkan pesan tersebut alih-alih melakukan instalasi, bahkan untuk sumber yang sudah Anda tambahkan. Untuk menginstal dari sebuah sumber dalam satu perintah, lihat Menambahkan marketplace dan menginstal dalam satu perintah.

Jika nama tersebut diawali dengan claudeai-, marketplace tersebut di-hosting di claude.ai, dan Anda menambahkannya berdasarkan nama dari shell Anda dengan claude plugin marketplace add --claudeai <name>. Lihat Menambahkan marketplace dari claude.ai.

Untuk nama lainnya, baris instalasi menyebut sebuah marketplace tetapi tidak menyebutkan di mana marketplace tersebut di-hosting, dan Claude Code tidak memiliki indeks untuk mencari nama marketplace. Mintalah kepada orang yang mengirimkan baris tersebut sumber marketplace-nya, yaitu owner/repo GitHub, URL git, atau path. Kemudian tambahkan marketplace tersebut dan jalankan baris instalasi itu lagi.

Marketplace yang dikirimkan seseorang kepada Anda adalah pihak ketiga, jadi tinjau plugin sebelum Anda menginstalnya.

Jika Anda sudah menambahkan marketplace tersebut, periksa ejaannya dengan /plugin marketplace list.

Invalid marketplace source format

Anda menjalankan /plugin marketplace add <source>, claude plugin marketplace add <source>, atau claude plugin install <plugin> --marketplace <source>, dan Claude Code membalas Invalid marketplace source format. Try: owner/repo, https://..., or ./path.

Claude Code menerima sumber dalam salah satu bentuk berikut:

• Singkatan owner/repo GitHub
• URL https:// atau http://
• URL SSH user@host:path
• Path lokal yang diawali dengan ./, ../, /, atau ~

Nama polos seperti claude-plugins-official tidak cocok dengan satu pun bentuk tersebut. Demikian pula hostname polos seperti marketplace.anthropic.com.

Ketik ulang sumber dalam salah satu bentuk yang diterima:

/plugin marketplace add anthropics/claude-plugins-official

Claude Code mencetak Successfully added marketplace: <name> ketika penambahan berhasil.

'<source>' is not a valid GitHub owner/repo shorthand

Anda memberikan sumber dengan garis miring yang bukan owner/repo, seperti github.com/owner/repo atau path gitlab.example.com/group/project. Claude Code menolaknya dengan pesan ini dan daftar bentuk yang diterima.

Singkatan owner/repo hanya untuk GitHub dan harus mengikuti aturan penamaan GitHub, sehingga hostname atau segmen path tambahan akan gagal. Berikan sumber dalam bentuk yang sesuai dengan tempat marketplace tersebut di-hosting:

• Repositori di host mana pun: URL clone lengkap
• marketplace.json yang di-hosting: URL https://-nya
• Checkout lokal: ./path atau path absolut

Misalnya, untuk menambahkan marketplace resmi berdasarkan URL clone-nya, dalam sebuah sesi:

/plugin marketplace add https://github.com/anthropics/claude-plugins-official.git

Penambahan yang berhasil akan mencetak Successfully added marketplace: <name>.

Invalid git URL

Anda menambahkan marketplace, menginstal plugin, atau menjalankan update dari alamat git, dan perintah tersebut gagal dengan Invalid git URL di pesannya.

Claude Code memeriksa setiap alamat git sebelum menjalankan git. Claude Code menolak alamat yang protokolnya tidak didukung. Claude Code juga menolak alamat yang dapat dibaca oleh git sebagai merujuk ke server atau folder yang berbeda dari yang ditunjukkan oleh alamat tersebut.

Teks setelah alamat menyebutkan apa yang perlu diubah. Tulis ulang alamat sesuai dengan yang dikatakan pesan tersebut dan jalankan perintahnya lagi.

Penolakan yang justru menyatakan is blocked by enterprise policy berasal dari pengaturan organisasi Anda. Lihat Marketplace source is blocked by enterprise policy.

Path does not exist: <path>

Anda memberikan path lokal ke marketplace add, dan tidak ada apa pun di path tersebut. Path relatif di-resolve relatif ke direktori Anda saat ini.

Periksa path yang telah di-resolve di dalam pesan. Kemudian jalankan perintah dari direktori tempat path relatif tersebut dimulai, atau berikan path absolut ke direktori marketplace. Penambahan yang berhasil akan mencetak Successfully added marketplace: <name>.

Claude Code menerima direktori yang berisi .claude-plugin/marketplace.json, atau path ke file .json. Path ke file lain akan gagal dengan File path must point to a .json file (marketplace.json).

Marketplace file not found at <path>/.claude-plugin/marketplace.json

Claude Code telah meng-clone atau mengunduh marketplace tetapi tidak menemukan marketplace.json di path yang diharapkan di dalamnya. Perintah add melaporkannya sebagai Failed to add marketplace: Marketplace file not found at ....

Lokasi default-nya adalah .claude-plugin/marketplace.json di root repositori, dan referensi marketplace mencantumkan lokasi-lokasi yang diterima.

Perbaikannya berbeda bagi pemilik dan bagi orang lain:

• Anda pemilik marketplace: letakkan file di lokasi tersebut dan tambahkan ulang marketplace
• Orang lain yang meng-hosting-nya: mintalah kepada pemilik sumber persis yang mereka publikasikan

Cannot add marketplace "<name>": Claude Code cannot install plugins from a marketplace with this name

Anda menambahkan marketplace, dan name di marketplace.json-nya tidak valid sebagai bagian setelah @ dalam ID plugin seperti my-plugin@my-marketplace. Claude Code menolak penambahan tersebut dan tidak mendaftarkan apa pun.

Bagian selanjutnya dari pesan menyatakan aturan untuk nama tersebut. Dalam contoh ini, _internal melanggar aturan karena diawali dengan _:

Cannot add marketplace "_internal": Claude Code cannot install plugins from a marketplace with this name. Each part of a plugin id (plugin@marketplace) may use only the letters a-z and A-Z, digits, ".", "_" and "-", and must start with a letter or digit. The name is set by "name" in the marketplace's marketplace.json; ask its maintainer to change it.

Berikan nama yang sesuai dengan aturan tersebut untuk marketplace, lalu tambahkan lagi:

• Anda pemilik marketplace: ubah name di marketplace.json, misalnya menjadi internal-tools
• Orang lain yang meng-hosting-nya: mintalah pemilik untuk mengubah namanya

Sebelum v2.1.295, Claude Code melaporkan penambahan dalam contoh ini sebagai berhasil.

Cannot add marketplace "<name>": Claude Code reserves this name and cannot register a marketplace under it

Anda menambahkan marketplace, dan name di marketplace.json-nya adalah salah satu nama anggota yang dimiliki setiap objek JavaScript, seperti constructor, toString, atau valueOf. Claude Code mencadangkan nama-nama tersebut, sehingga menolak penambahan dan tidak mendaftarkan apa pun. Nama yang dicadangkan mencantumkan nama-nama tersebut.

Dalam contoh ini, marketplace diberi nama constructor:

Cannot add marketplace "constructor": Claude Code reserves this name and cannot register a marketplace under it. The name is set by "name" in the marketplace's marketplace.json; ask its maintainer to change it.

Jika sebuah file pengaturan mendeklarasikan marketplace tersebut di bawah extraKnownMarketplaces, upaya Claude Code untuk menambahkannya saat startup gagal dengan cara yang sama, dan pesan tersebut muncul di tab Errors pada /plugin.

Berikan nama lain untuk marketplace, lalu tambahkan lagi:

• Anda pemilik marketplace: ubah name di marketplace.json
• Orang lain yang meng-hosting-nya: mintalah pemilik untuk mengubah namanya

Sebelum v2.1.296, penambahan marketplace semacam itu gagal dengan error internal alih-alih pesan ini.

SSH authentication failed atau HTTPS authentication failed

Anda menambahkan atau memperbarui marketplace dari repositori git, dan clone gagal dengan Failed to clone marketplace repository: diikuti oleh salah satu baris ini.

Pertama, periksa repositorinya sendiri: owner/repo yang salah eja, repositori yang tidak ada, atau repositori privat yang tidak dapat Anda lihat juga berakhir dengan pesan ini. Buka URL repositori di browser Anda, atau jalankan git ls-remote <url> di terminal Anda, untuk memastikan repositori tersebut ada dan Anda memiliki akses.

Jika repositorinya benar, penyebabnya adalah kredensial. Claude Code mematikan prompt git dan program askpass, termasuk yang diatur di GIT_ASKPASS, dan menjalankan SSH dalam mode batch. Ketika git perlu menampilkan prompt, error clone menyertakan fatal: Cannot prompt because user interactivity has been disabled, terminal prompts disabled, atau fatal: unable to get password from user. Hanya kredensial yang dapat diperoleh git tanpa prompt atau program askpass yang akan berhasil:

• SSH: ssh -T git@<host> harus berhasil tanpa meminta passphrase, dan host harus sudah ada di known_hosts
• HTTPS: credential helper Anda harus menyimpan token untuk host tersebut. Untuk GitHub, jalankan gh auth login dan gh auth setup-git. Untuk host lain, simpan personal access token di git credential helper Anda. Untuk menguji, hapus pengaturan GIT_ASKPASS di terminal Anda dan jalankan git -c core.askPass= ls-remote <url>.

Setelah pemeriksaan untuk protokol Anda berhasil tanpa prompt, jalankan add atau update lagi. Penambahan yang berhasil akan mencetak Successfully added marketplace: <name>. Update yang berhasil akan mencetak Successfully updated marketplace: <name> dari shell Anda, atau ✔ Updated 1 marketplace dalam sebuah sesi.

Agar Claude Code melewati SSH untuk sumber owner/repo GitHub, atur CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1. Tanpa pengaturan ini, Claude Code meng-clone sumber tersebut melalui SSH ketika kunci SSH untuk github.com tampak sudah dikonfigurasi, dan beralih ke HTTPS ketika clone SSH gagal.

Untuk mengetahui apa yang dapat dan tidak dapat dilakukan oleh auto-update di latar belakang dengan kredensial Anda, lihat Apa yang dilakukan auto-update di latar belakang dengan kredensial.

SSH host key is not in your known_hosts file

Anda menambahkan marketplace melalui SSH dari host yang belum pernah Anda hubungkan, dan clone gagal dengan baris ini serta petunjuk ssh -T git@<host>. Untuk host yang kuncinya berubah, pesannya adalah SSH host key has changed dengan petunjuk ssh-keygen -R <host>.

Claude Code melakukan clone dengan StrictHostKeyChecking=yes, sehingga menolak host yang kuncinya belum Anda terima alih-alih menerima kunci tersebut secara otomatis. Hubungkan sekali dari terminal Anda untuk menerima fingerprint, lalu coba lagi:

ssh -T git@github.com

Untuk repositori publik, tambahkan marketplace menggunakan URL https://-nya untuk sepenuhnya menghindari SSH.

Command 'git' not found or is in an unsafe location

Di Windows, Anda menambahkan marketplace dan Claude Code melaporkan Failed to clone marketplace repository: Command 'git' not found or is in an unsafe location (current directory).

Claude Code mencari git di PATH Anda dan menolak menjalankan git yang hanya ditemukan di direktori saat ini. Untuk memperbaikinya, instal Git dan coba lagi:

1. Instal Git for Windows

Instal Git for Windows agar git ada di PATH Anda.

2. Buka terminal baru

Buka terminal baru agar PATH yang diperbarui berlaku.

3. Pastikan git berjalan

Pastikan git --version mencetak sebuah versi.

4. Coba ulang penambahan

Jalankan perintah marketplace add lagi.

Git clone timed out after 120s

Anda menambahkan atau memperbarui marketplace, dan prosesnya gagal dengan Git clone timed out after 120s, diikuti petunjuk untuk mengatur CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS.

Meng-clone marketplace, dan meng-clone ulang untuk memperbaruinya, mendapat waktu 120 detik secara default. Untuk repositori besar atau koneksi lambat, naikkan batasnya. Nilainya dalam milidetik:

[tab] Bash or Zsh

export CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS=300000

[tab] PowerShell

$env:CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS = "300000"

Kemudian coba lagi di shell yang sama.

Jika repositori tersebut adalah monorepo, batasi checkout ke direktori yang Anda sebutkan dengan claude plugin marketplace add <source> --sparse <paths>.

Jika repositori memiliki submodule git yang besar, perbarui Claude Code. Pada v2.1.295 dan yang lebih baru, Claude Code hanya mengambil submodule yang berisi file plugin. Versi sebelumnya mengambil setiap submodule, yang dengan sendirinya dapat menghabiskan 120 detik tersebut.

Update marketplace terus gagal saat offline

Anda bekerja di lingkungan tempat host git marketplace tidak dapat dijangkau, dan setiap sesi mengulangi refresh yang gagal di latar belakang. Checkout marketplace Anda yang sudah ada tetap di tempatnya.

Di setiap sesi, untuk marketplace dengan auto-update aktif, Claude Code memeriksa host git marketplace untuk commit baru di latar belakang. Ketika pemeriksaan tersebut tidak dapat menjangkau host, Claude Code mencoba meng-clone marketplace lagi, dan saat offline clone tersebut juga gagal.

Atur variabel ini untuk melewati upaya clone ulang dan tetap menggunakan checkout yang ada ketika pemeriksaan tidak dapat menjangkau host:

[tab] Bash or Zsh

export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1

[tab] PowerShell

$env:CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE = "1"

Dengan variabel ini diatur, Claude Code melewati clone ulang hanya untuk checkout yang sudah berisi .claude-plugin/marketplace.json. Marketplace yang belum pernah di-clone atau yang clone-nya berhenti di tengah jalan tetap mendapat upaya clone, jadi tambahkan sekali saat online.

Untuk deployment yang sepenuhnya offline, isi terlebih dahulu direktori plugin pada saat build image dengan CLAUDE_CODE_PLUGIN_SEED_DIR, dengan mengikuti Seed container dan CI.

Penambahan marketplace gagal pada host GitHub Enterprise Server

Anda menambahkan marketplace dari URL GitHub Enterprise Server (GHES) dan mendapatkan error kebijakan, atau Anda menambahkannya dari claude.ai dan mendapatkan error akses GitHub.

Kedua kasus dibahas di halaman GHES:

• Error kebijakan berarti organisasi Anda membatasi sumber marketplace dan admin perlu menambahkan hostPattern untuk host tersebut
• Error akses GitHub di claude.ai berarti akun GitHub Enterprise Anda sendiri belum terhubung

Install a plugin

Anda menambahkan marketplace dan menjalankan instalasi, dan instalasi berhenti dengan pesan alih-alih menginstal apa pun. Entri ini mencakup pesan-pesan itu. Mereka juga mencakup pesan terkait yang muncul kemudian di tab Errors /plugin, atau sebagai tab Discover kosong, ketika plugin atau marketplace-nya tidak dapat ditemukan, dibaca, atau dipercaya.

Plugin "<name>" not found in marketplace "<marketplace>"

Anda menjalankan /plugin install <name>@<marketplace> atau claude plugin install <name>@<marketplace>, dan nama plugin tidak ada dalam salinan katalog marketplace itu di mesin Anda.

claude plugin install di shell Anda mencetak pesan yang sama ketika Anda belum menambahkan marketplace sama sekali. Jika claude plugin marketplace update <marketplace> kemudian menjawab Marketplace '<marketplace>' not found, tambahkan marketplace terlebih dahulu.

not found in marketplace with a refresh hint

Hint berbunyi Your local copy may be out of date — try claude plugin marketplace update <marketplace> atau The marketplace couldn't be refreshed (...). Claude Code tidak merefresh marketplace sebelum pencarian, seperti ketika Anda offline, jadi salinan katalog Anda mungkin sudah ketinggalan zaman. Refresh dengan nama marketplace, lalu instal lagi:

/plugin marketplace update <marketplace>

claude plugin marketplace update mencetak Successfully updated marketplace: <name>, dan /plugin marketplace update menunjukkan ✔ Updated 1 marketplace. Jika instalasi yang dicoba ulang mencetak pesan yang sama, periksa nama seperti yang dijelaskan not found in marketplace with no hint. When Claude Code refreshes a marketplace before an install mencantumkan kasus lain di mana refresh tidak berjalan.

not found in marketplace with no hint

Nama adalah masalah yang paling mungkin. Buka /plugin, buka Discover, dan salin nama dari daftar.

Sebelum v2.1.232, Claude Code merefresh marketplace yang dinamai hanya setelah pencarian terlewat, dan hanya ketika auto-update aktif untuk itu.

Plugin "<name>" not found in any marketplace

Anda menjalankan /plugin install <name> tanpa @marketplace, dan tidak ada marketplace terdaftar yang memiliki plugin itu. claude plugin install <name> melaporkan Plugin "<name>" not found in any configured marketplace.

Tanpa nama marketplace, claude plugin install mencari katalog yang sudah dimilikinya dan tidak merefresh mereka terlebih dahulu, dan /plugin install merefresh hanya marketplace yang memiliki auto-update aktif. Beri nama marketplace, dan Claude Code merefresh-nya sebelum mencari plugin:

/plugin install <name>@<marketplace>

Ketika instalasi berhasil, Anda melihat ✓ Installed <plugin>. dalam sesi, atau Successfully installed plugin: <plugin>@<marketplace> dari claude plugin install.

Jika Anda tidak tahu marketplace mana yang mencantumkan plugin, jalankan /plugin marketplace list untuk marketplace yang Anda miliki, dan telusuri Discover di /plugin untuk nama plugin.

Plugin '<name>@<marketplace>' is already installed globally

Anda menjalankan /plugin install untuk plugin yang sudah diinstal di cakupan pengguna atau oleh pengaturan terkelola, dan Claude Code menolak dengan Use '/plugin' to manage existing plugins. Jika Anda mengetik nama plugin tanpa @<marketplace>, pesan menghilangkan globally.

Plugin sudah tersedia di setiap proyek, jadi tidak ada yang perlu ditambahkan. Untuk mengubah cakupan-nya, mengaktifkan atau menonaktifkannya, atau mengonfigurasinya, buka /plugin dan buka Installed.

Plugin yang diinstal hanya di cakupan proyek atau lokal tidak memicu pesan ini. Claude Code memungkinkan Anda menginstalnya di cakupan pengguna juga, jadi tersedia di proyek lain.

claude plugin install di shell Anda mencetak pesan yang berbeda. Untuk plugin yang sudah diinstal di cakupan target, itu mencetak Plugin "<name>@<marketplace>" is already installed (scope: user) dan keluar 0. Jika direktori cache-nya hilang, perintah yang sama mengunduh ulang-nya.

"<plugin>" was not installed: it would share its folder with "<other>"

Anda menginstal plugin melalui claude plugin install, /plugin, atau saran instalasi dalam sesi, dan Claude Code menolaknya dengan baris ini, atau dengan would share its saved data with.

ID plugin yang ditolak dan ID plugin yang diinstal memetakan ke folder yang sama di disk: mereka sama setelah . dan @ ditulis sebagai -. Di macOS dan Windows, id yang berbeda hanya dalam huruf besar memetakan ke folder yang sama juga. Menginstal keduanya akan menempatkan file satu plugin di folder plugin lain, jadi Claude Code menolak dan plugin yang diinstal menyimpan file-nya.

Pesan menyebutkan jalan keluar:

• Plugin lain diinstal: pesan mengatakan Only one of the two can be installed. dan menyebutkan perintah claude plugin uninstall, atau langkah uninstall di /plugin, yang menghapus plugin lain. Jalankan, lalu instal lagi. Untuk apa yang uninstall hapus, lihat What an uninstall deletes and keeps.
• Kedua id tiba dalam satu instalasi, seperti plugin dan dependensi yang dibutuhkannya: tidak ada urutan instalasi yang membantu. Hanya maintainer marketplace yang mencantumkan dua plugin dapat memperbaikinya, dengan mengganti nama salah satu. Ketika keduanya berasal dari marketplace berbeda, maintainer salah satu dapat.

This plugin uses a source type your Claude Code version does not support

Anda menginstal plugin yang entri marketplace-nya menggunakan tipe sumber yang versi Claude Code ini tidak dapat ambil, dan Claude Code berhenti dengan pesan ini dan Update Claude Code and try again.

Perbarui Claude Code, lalu coba ulang instalasi. Tipe sumber ada di marketplace reference.

Plugin archive integrity check failed

Anda menginstal plugin yang didistribusikan sebagai arsip zip, dan Claude Code menolaknya dengan baris ini dan The archive was not installed. Entri marketplace plugin menggunakan archive source dengan pin sha256, dan digest file yang diunduh tidak cocok dengan pin.

Pesan lengkapnya terlihat seperti ini:

Plugin archive integrity check failed for https://artifacts.example.com/claude-plugins/my-plugin.zip: expected sha256 6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1, got ac52220c0914ef8ca6a602e4a7362f88d30fb021110f72a6d15b68c3fe7df2b7. The archive was not installed. Verify the sha256 in the marketplace entry, or that the URL serves the intended file.

Perbaikannya berbeda untuk penerbit dan penginstal:

• Anda menerbitkan plugin: hitung ulang digest file yang tepat yang URL layani dan perbarui sha256 dalam entri marketplace. Gunakan shasum -a 256 my-plugin.zip, atau Get-FileHash -Algorithm SHA256 my-plugin.zip di PowerShell
• Anda menginstal plugin: jalankan /plugin marketplace update <name> dalam sesi untuk merefresh katalog jika entri diperbaiki, lalu coba ulang instalasi. Jika digest masih tidak setuju setelah refresh, tanyakan kepada pemilik marketplace file mana yang mereka pin sebelum menginstal

An npm plugin source must name a registry package

Plugin yang entri marketplace-nya menggunakan sumber npm gagal diinstal, diperbarui, atau dimuat, dan pesannya menyertakan kalimat ini. Claude Code memeriksa nilai package entri sebelum mengambil apa pun dan menolaknya. Pesan menyebutkan nilai dan alasannya:

"github:acme/formatter" was not installed: it is not an http or https link. An npm plugin source must name a registry package (name or name@version) or link to a tarball file. For a plugin in a git repository, use a "github", "url" or "git-subdir" source.

Pemilik marketplace harus mengubah entri tersebut:

• Jika itu Anda: ubah package ke nilai yang diterima oleh referensi sumber plugin npm, atau alihkan entri ke sumber github, url, atau git-subdir
• Jika bukan Anda: laporkan pesan ke pemilik marketplace

Marketplace "<name>" is registered from an untrusted source

Marketplace yang Anda tambahkan sebelumnya berhenti memuat, begitu juga plugin-nya. Baris ini muncul di tab Errors /plugin atau pada refresh berikutnya.

Marketplace terdaftar di bawah nama yang dicadangkan untuk marketplace resmi Anthropic, tetapi sumber terdaftar-nya bukan repositori GitHub anthropics. Nama yang dicadangkan diperiksa ulang setiap kali marketplace memuat atau merefresh, jadi marketplace dan plugin yang diinstal darinya berhenti memuat.

Pesan lengkap menyebutkan nama yang dicadangkan dan perbaikannya:

Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.

Perbaikannya berbeda untuk pengguna dan penerbit:

• Anda menggunakan marketplace: di shell Anda, jalankan claude plugin marketplace remove <name>, lalu tambahkan marketplace lagi dari repositori github.com/anthropics resmi
• Anda menerbitkan marketplace pihak ketiga yang menggunakan nama sebelum itu menjadi dicadangkan: ganti namanya dan minta pengguna untuk menambahkan kembali dari sumber Anda

Sebelum v2.1.205, Claude Code memeriksa nama hanya ketika Anda menambahkan marketplace, jadi entri yang terdaftar sebelum nama-nya menjadi dicadangkan terus memuat.

Marketplace "<name>" is added but ignored

Marketplace memiliki entri di ~/.claude/plugins/known_marketplaces.json, tetapi entri tersebut gagal dalam pemeriksaan yang dijalankan Claude Code setiap kali membaca file itu, sehingga marketplace dan plugin yang diinstal darinya berhenti dimuat. Di shell Anda, claude plugin list melaporkan setiap plugin yang terpengaruh dengan baris yang menyebutkan alasan dan perbaikannya:

Marketplace team-tools is added but ignored. Its location is on a network drive, has "." or ".." in its path, or couldn't be checked. Re-add the marketplace (one added from a folder or file must be re-added from a copy on this computer), or, to trust a folder on a network drive, declare it under extraKnownMarketplaces in user or managed settings.

Dalam sesi, tab Errors /plugin menempatkan nama marketplace dalam tanda kutip, mengakhiri baris setelah alasan, dan menampilkan perbaikan pada baris di bawahnya.

Kalimat setelah is added but ignored menyebutkan pemeriksaan yang gagal dilalui entri:

• Its location is on a network drive, has "." or ".." in its path, or couldn't be checked, atau kalimat yang sama tentang The folder or file it was added from: direktori marketplace, atau path lokal tempat marketplace ditambahkan, berada di lokasi jaringan, memiliki segmen . atau .. dalam path-nya, atau tidak dapat diperiksa
• Its git URL can't be used: <reason> atau Its URL can't be read as an https:// or http:// address: URL sumber yang tercatat pada entri adalah URL yang Claude Code tolak untuk di-clone atau diambil
• Its source doesn't match its extraKnownMarketplaces entry in user or managed settings: entri tidak cocok dengan deklarasi extraKnownMarketplaces dengan nama yang sama

Ketika (see the debug log) mengikuti is added but ignored sebagai pengganti alasan, Claude Code menolak nama marketplace tersebut, seperti ejaan lain dari nama yang dicadangkan. Log debug menyebutkan entri tersebut.

Apa yang harus dilakukan:

• Ikuti perbaikan dalam pesan. Di shell Anda, jalankan claude plugin marketplace remove <name>, lalu tambahkan marketplace lagi dari sumber yang didukung atau path lokal dan instal ulang plugin-nya, yang di-uninstal oleh perintah remove. Perintah remove berfungsi pada entri yang diabaikan
• Untuk mempertahankan marketplace di lokasi jaringan, deklarasikan di bawah extraKnownMarketplaces dalam pengaturan pengguna atau pengaturan terkelola Anda; deklarasi di .claude/settings.json atau .claude/settings.local.json repositori tidak dihitung
• Untuk sumber yang berbeda dari deklarasi pengaturannya, tambahkan kembali marketplace dari sumber yang dideklarasikan atau ubah deklarasinya. claude plugin marketplace add menolak ketidakcocokan yang sama; lihat entri Cannot add marketplace yang sesuai
• Untuk nama yang ditolak, hapus marketplace, menggunakan perintah setelah Remove it: jika baris tersebut menyediakannya; menambahkannya lagi dengan nama yang sama akan ditolak lagi

Sebelum v2.1.286, apa pun alasannya, claude plugin list melaporkan marketplace seperti itu sebagai Marketplace <name> not found, dan tab Errors /plugin melaporkannya sebagai Marketplace "<name>" is registered but was refused (see the debug log). Alasannya hanya muncul di log debug. Di v2.1.286, kalimat alasan dan perbaikan menggunakan kata-kata yang berbeda, seperti Its recorded location is network-shaped or unclassifiable (never probed).

Plugin <name> has a corrupt manifest file or has an invalid manifest file

Claude Code mengambil plugin, lalu gagal membaca .claude-plugin/plugin.json-nya. Di shell, <name> dalam baris ini dapat berupa nama direktori sementara; awalan Failed to install plugin "<name>@<marketplace>" membawa nama asli plugin. Kata-kata pesan menunjukkan pemeriksaan mana yang gagal:

• corrupt manifest file, diikuti oleh JSON parse error:: file bukan JSON yang valid
• invalid manifest file, diikuti oleh Validation errors:: file dapat di-parse tetapi gagal dalam skema, seperti name: Invalid input untuk field wajib yang hilang

claude plugin install melaporkan salah satu sebagai Failed to install plugin "<name>@<marketplace>": dan keluar dengan kode 1.

Penulis plugin harus memperbaiki file, dan plugin tidak dapat diinstal sampai saat itu:

• Jika itu Anda: jalankan claude plugin validate <plugin-directory> di shell Anda untuk melihat kesalahan yang sama dengan path yang bermasalah, lalu perbaiki file
• Jika bukan Anda: laporkan pesan ke pemilik marketplace

Plugin directory not found at path: <path>

Tab Errors di /plugin menunjukkan ini untuk plugin yang diaktifkan yang marketplace-nya mencantumkan dengan path relatif, seperti ./plugins/my-plugin, ketika tidak ada direktori yang ada di path itu di dalam marketplace. Jika Anda memelihara marketplace, perbaiki path source entri atau pulihkan folder. Jika tidak, laporkan pesan ke pemilik marketplace.

Marketplace directory not found at path: <path> berarti direktori marketplace itu sendiri hilang. Untuk marketplace yang Anda tambahkan dari path lokal, direktori itu pindah atau dihapus. Pulihkan, atau hapus marketplace dan tambahkan lagi dari lokasi barunya.

No plugins available or No marketplaces configured

Anda membuka /plugin dan tab Discover kosong, atau claude plugin marketplace list mencetak No marketplaces configured.

Tidak ada marketplace yang terdaftar, jadi tidak ada katalog untuk ditampilkan. Dalam sesi, tambahkan marketplace resmi, anthropics/claude-plugins-official:

/plugin marketplace add anthropics/claude-plugins-official

Claude Code mencetak Successfully added marketplace: claude-plugins-official, dan Discover mencantumkan plugin-nya. Halaman Anthropic marketplaces mencantumkan marketplace lain yang dapat Anda tambahkan.

Marketplace "<name>" is already added from a different source

Anda menyebutkan sumber marketplace baru dengan --marketplace <source> pada perintah instal, dalam sesi atau dari shell Anda. Katalog yang Claude Code ambil dari sumber itu memiliki nama yang sama dengan marketplace yang sudah Anda tambahkan dari sumber berbeda. Claude Code menyimpan marketplace yang ada alih-alih menggantinya, dan plugin tidak diinstal.

Pesan lengkapnya terlihat seperti ini:

Marketplace "acme-tools" is already added from a different source (github:acme/plugins). To use this source instead, remove that marketplace first with /plugin marketplace remove acme-tools.

Pilih sumber mana yang Anda inginkan:

• Marketplace yang sudah Anda tambahkan: instal darinya berdasarkan nama dengan /plugin install <plugin>@<name>
• Sumber baru: jalankan /plugin marketplace remove <name>, lalu coba ulang instalasi

Cannot add marketplace "<name>": its source doesn't match its extraKnownMarketplaces entry in user or managed settings

Anda menambahkan marketplace, dan name dalam marketplace.json-nya sudah memiliki entri extraKnownMarketplaces dalam pengaturan pengguna atau pengaturan terkelola Anda. Sumber yang Anda berikan berbeda dari yang dicantumkan entri tersebut, sehingga Claude Code menolak penambahan dan tidak mendaftarkan apa pun.

Dua sumber cocok ketika keduanya memiliki tipe yang sama dan nilai yang sama di setiap field. Entri yang menetapkan ref yang tidak Anda berikan dihitung sebagai berbeda. Entri github juga dihitung sebagai berbeda ketika Anda memberikan repositori sebagai URL https://github.com/, karena Claude Code mencatat URL tersebut sebagai sumber git. Lakukan salah satu dari ini:

• Gunakan sumber yang dideklarasikan: Claude Code mendaftarkan marketplace yang dideklarasikan dalam pengaturan dengan sendirinya, jadi pertama-tama jalankan /plugin marketplace list dalam sesi. Jika daftar menampilkan nama tersebut, marketplace sudah terdaftar dan tidak ada yang perlu ditambahkan.

  Jika daftar tidak menampilkannya, tambahkan dengan sumber yang diketik sesuai cara entri menuliskannya. Untuk entri yang objek source-nya adalah { "source": "github", "repo": "acme-corp/claude-plugins", "ref": "v1.2.0" }, jalankan ini:

  /plugin marketplace add acme-corp/claude-plugins#v1.2.0
  

• Gunakan sumber baru: edit atau hapus entri extraKnownMarketplaces, lalu tambahkan marketplace lagi. Jika pengaturan terkelola mendeklarasikannya, tanyakan administrator Anda

Sebelum v2.1.287, pesannya berbunyi Cannot add marketplace "<name>": its network source differs from the one declared for it in settings (kind, target, or a fetch-shaping field such as headers / ref / path / sparsePaths).

Failed to install: <plugin> (<reason>)

Anda memilih plugin untuk diinstal di menu /plugin, tidak satupun dari mereka diinstal, dan menu ditutup dengan ringkasan apa yang gagal.

Beberapa alasan, seperti output git setelah klon yang gagal, menunjukkan hanya baris pertama mereka. Ketika alasan seperti itu diperpendek, ringkasan berakhir dengan Installing a plugin from its details (Enter) in /plugin shows its full error.

Apa yang harus dilakukan tergantung pada apakah ringkasan memendekkan alasan:

• Perbaiki apa yang disebutkan oleh alasan dalam tanda kurung
• Ketika alasan diperpendek, jalankan /plugin, pilih plugin di tab Discover, dan tekan Enter untuk menginstalnya dari detailnya. Jika instalasi gagal di sana, tampilan detail menunjukkan kesalahan lengkap

Could not move the new copy of this plugin version into <path>

Ketika Anda menginstal plugin, Claude Code mengunduh salinan segar file-nya dan memindahkannya ke folder versi itu di plugin cache. Pesan ini berarti perpindahan gagal, biasanya karena program lain menggunakan folder saat instalasi berjalan. Kode sistem file muncul dalam tanda kurung:

Could not move the new copy of this plugin version into /home/user/.claude/plugins/cache/acme-tools/formatter/1.2.0: the new copy or the version folder stayed busy while the install ran (ENOTEMPTY) — usually a scanner still reading the freshly downloaded files, another program using that folder, or another process re-creating it. The previously installed copy was moved back. Run the install again once other Claude Code sessions or programs using that folder have finished.

Pesan mengatakan apa yang terjadi pada salinan yang diinstal sebelumnya, yang memberi tahu Anda apakah plugin masih berfungsi:

• The previously installed copy was moved back: versi yang Anda miliki masih diinstal
• had to be removed first, was not moved back, atau could not be moved back: versi plugin itu tidak diinstal sampai instalasi berhasil
• Tidak ada kalimat seperti itu: tidak ada salinan sebelumnya, jadi versi tersebut belum diinstal

Di Windows, ketika program lain menyimpan salinan yang diinstal itu sendiri, pesan malah mengatakan salinan itu could not be replaced dan bahwa It was not replaced and the new copy was discarded, jadi versi yang Anda miliki masih diinstal.

Daftar Left on disk menyebutkan folder yang disisihkan di dalam cache. Instalasi versi itu nanti atau pembersihan cache plugin menghapusnya, jadi Anda tidak perlu menghapusnya.

Untuk memperbaiki instalasi:

• Tutup sesi Claude Code lain, editor, dan terminal yang menggunakan folder plugin di bawah ~/.claude/plugins/cache, lalu jalankan instalasi lagi
• Ketika pesan mengatakan untuk memeriksa hak akses folder cache plugin, pulihkan hak akses tulis Anda di folder yang dinamai dan bebaskan ruang disk, lalu jalankan instalasi lagi

Dependency errors

Plugin yang mendeklarasikan dependensi dapat gagal diinstal, atau diinstal dan tetap dinonaktifkan, ketika dependensi tidak dapat dipenuhi. Pesan sampai kepada Anda pada waktu instalasi atau pada waktu pemuatan:

• Selama instalasi: penolakan kembali sebagai pesan kesalahan instalasi
• Ketika plugin memuat: masalah muncul di claude plugin list dan tab Errors /plugin, dan Claude Code membuat plugin yang terpengaruh tetap dinonaktifkan sampai Anda menyelesaikannya

Tabel mencantumkan setiap pesan dan perbaikannya. Untuk mendeklarasikan dependensi sebagai penulis, lihat Plugin dependencies.

Untuk melihat ini secara terprogram, jalankan claude plugin list --json di shell Anda. Plugin dengan masalah membawa field errors dengan pesan dan field errorDetails dengan type untuk masing-masing: tiga baris pertama adalah dependency-unsatisfied dan yang keempat adalah dependency-version-unsatisfied.

Plugin installed but not working

Instalasi berhasil, tetapi skills, hooks, atau server plugin tidak melakukan apa pun. Mulai dengan Plugin doesn't appear or its skills don't show up, yang memberi tahu Anda di mana Claude Code melaporkan apa yang dimuat, lalu cocokkan pesannya.

Plugin doesn't appear or its skills don't show up

Anda menginstal plugin dan mengetik / mengharapkan skills-nya, atau meminta Claude untuk menggunakannya, dan tidak ada yang terjadi.

Periksa status plugin sebelum mengubah apa pun:

1. Confirm the plugin is installed and enabled

Jalankan /plugin dan buka Installed. Konfirmasi plugin tercantum dan diaktifkan. claude plugin list di shell Anda mencetak daftar yang sama dengan versi, scope, dan Status: ✔ enabled setiap plugin.

2. Read the Errors tab

Buka tab Errors di panel yang sama. Setiap entri memasangkan pesan dengan baris panduan. Sebagian besar pesan di sisa bagian ini berasal dari tab itu.

3. Reload if you installed during this session

Jika plugin diinstal dan bebas kesalahan tetapi Anda menginstalnya selama sesi ini, jalankan /reload-plugins. Itu mencetak Reloaded: dengan hitungan plugin, skills, agents, hooks, dan server. Ketika sesuatu gagal itu menambahkan N errors during load. Run /plugin for details.

Jika plugin memuat tanpa kesalahan dan skills-nya masih tidak muncul, langkah berikutnya berbeda untuk plugin Anda sendiri dan untuk plugin orang lain:

• Plugin yang Anda bangun: lihat Plugin loads but its skills are missing
• Plugin yang diterbitkan orang lain: buka Installed di /plugin dan buka pane detail plugin, yang mencantumkan apa yang berisi plugin. Plugin yang tidak mencantumkan skills di sana tidak memiliki yang ditawarkan ketika Anda mengetik /

Run /reload-plugins to apply.

Ringkasan instalasi di /plugin berakhir dengan Run /reload-plugins to apply. alih-alih Plugin is now active. Pemberitahuan Plugins changed. Run /reload-plugins to activate. dapat muncul di atas prompt pada saat yang sama.

Claude Code tidak mengaktifkan plugin selama instalasi, baik karena mengaktifkannya akan membatalkan prompt cache atau karena upaya aktivasi gagal.

Anda tidak perlu mengetik command. Panel ditutup dan Claude Code menjalankan /reload-plugins untuk Anda, atau mengantrekannya sampai respons yang streaming selesai.

Baca apa yang reload itu cetak:

• Reloaded: dengan hitungan plugin, skills, agents, hooks, dan server: plugin sekarang aktif. Ketika sesuatu gagal memuat, baris menambahkan N errors during load. Run /plugin for details.
• This reload changes MCP tools (...) — your next message will re-read the whole conversation instead of using the cache. Run /reload-plugins --force to apply.: reload akan menambah atau menghapus server MCP plugin, atau tool LSP, dan membatalkan prompt cache Anda. Untuk kasus LSP baris dimulai This reload adds the LSP tool atau This reload removes the LSP tool. Jalankan dengan --force untuk mengaktifkan plugin bagaimanapun, atau mulai sesi baru

Sebelum v2.1.268, instalasi yang tidak diaktifkan selama instalasi tetap tertunda sampai Anda menjalankan /reload-plugins sendiri.

Sebelum v2.1.246, hitungan skills dalam ringkasan itu hanya termasuk entri commands/ plugin, jadi reload dapat memuat skills SKILL.md plugin dan masih melaporkan 0 skills.

The packages it lists are not installed or were not installed, because ...

/plugin dan claude plugin list menampilkan salah satu catatan ini pada plugin yang instalasi dependensinya tidak menghasilkan direktori node_modules. Plugin tetap dimuat, tetapi bagian yang memerlukan paket yang hilang mungkin tidak berfungsi.

• are not installed: instalasi dapat dijalankan untuk plugin ini tetapi tidak selesai, misalnya karena gagal atau melewati batas waktu. Untuk mencoba ulang instalasi, jalankan perintah claude plugin update yang diberikan catatan tersebut di shell Anda, atau perbarui plugin dari /plugin

  claude plugin update formatter@my-marketplace
  

  Jika retry gagal, output menyebutkan penyebabnya. Selama CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC diatur, claude plugin update dan /plugin melewati retry dan melaporkan bahwa plugin sudah berada di versi terbarunya.

• were not installed, because ...: instalasi tidak dapat dijalankan untuk plugin ini, dan catatan menyebutkan alasannya, seperti lockfile Yarn, pnpm, atau bun.lockb, atau lockfile yang package manager-nya tidak terinstal di komputer ini. Memperbarui plugin tidak menginstal paket selama alasan itu masih berlaku. Jika alasannya adalah lockfile, penulis plugin harus menggantinya. Jika alasannya adalah package manager yang hilang, instal package manager tersebut, lalu perbarui plugin

Plugin "<name>" not cached at <path>

Tab Errors menunjukkan baris ini dengan panduan Run /plugin to refresh the plugin cache. Artinya Claude Code tidak menemukan salinan plugin yang dapat digunakan. Misalnya, Anda menghapus cache, sehingga direktori yang ditunjuk catatan instalasinya hilang. Atau Anda membuka repositori yang pengaturannya mengaktifkan plugin tersebut, dan Anda belum menginstalnya.

Instal plugin dari shell Anda. Jika Anda membuka repositori yang .claude/settings.json-nya mengaktifkan plugin tersebut, jalankan perintah ini dari proyek dengan kunci plugin dari enabledPlugins, seperti yang dijelaskan di Enabled in project settings but not installed:

claude plugin install <name>@<marketplace> --scope project

Jika tidak, jalankan perintah ini, yang mengunduh ulang plugin yang direktori instalasinya hilang meskipun catatannya ada:

claude plugin install <name>@<marketplace>

Kemudian jalankan /reload-plugins dalam sesi Anda. Entri tab Errors menghilang dan plugin tercantum di bawah Installed.

installed_plugins.json holds a record under "<id>" that this version of Claude Code cannot read

Pesan muncul dalam bentuk-bentuk ini:

• claude plugin list: mencetaknya sebagai Note:
• claude plugin install, uninstall, dan update: menolak dengan Plugin "<name>" was not installed:, Plugin "<name>" was not uninstalled:, atau Plugin "<name>" was not updated:, diikuti oleh teks yang sama
• --json pada salah satu dari ketiga command itu: baris hasil membawa message yang sama dan failureCode: "install_records_unreadable"
• Beberapa catatan seperti itu: pesan membaca holds records under
• Seluruh file mendeklarasikan format yang versi ini tidak tahu: pesan membaca installed_plugins.json is in a format (version <N>) that this version of Claude Code does not know sebagai gantinya

Catatan bernama di installed_plugins.json adalah JSON yang valid di bawah id plugin yang valid, tetapi field-nya tidak parse untuk versi ini. Kemungkinan besar versi Claude Code lain menulisnya, mungkin yang lebih baru.

Sementara catatan ada di sana, versi ini tidak menulis ulang file, jadi catatan tidak hilang.

Ambil opsi pesan dalam urutan:

1. Perbarui Claude Code dengan claude update.
2. Jika Anda tidak dapat memperbarui, uninstal plugin bernama dengan versi Claude Code yang menulis catatan.
3. Jika tidak ada yang membantu, hapus catatan dari installed_plugins.json dengan tangan, lalu restart Claude Code atau jalankan /reload-plugins.

installed_plugins.json could not be read and was rebuilt

claude plugin list mencetak catatan ini, dengan path file yang disimpan bernama installed_plugins.unreadable.<date>.<hash>.kept, selama file itu duduk di samping installed_plugins.json.

installed_plugins.json yang bukan JSON yang valid, atau bukan daftar plugin, tidak dapat mengatakan apa yang Anda instal.

Buka file .kept untuk melihat apa yang file lama catat, dan instal ulang plugin yang Anda lewatkan. Claude Code tidak pernah membaca file kembali, dan file itu berusia pada jadwal cleanupPeriodDays.

install records under names that no version of Claude Code can use were removed from installed_plugins.json

claude plugin list mencetak catatan ini, dengan path salinan bernama installed_plugins.set-aside.<date>.<hash>.json, selama salinan itu duduk di samping installed_plugins.json. Catatan berakhir Nothing needs doing about these copies.

Catatan di installed_plugins.json duduk di bawah kunci yang bukan id plugin yang valid, jadi tidak ada versi Claude Code yang dapat menggunakannya. Sisa file memuat secara normal.

Claude Code menyalin catatan yang tidak dapat digunakan ke dalam file .set-aside dan menjatuhkannya dari daftar. Claude Code tidak pernah membaca salinan kembali, dan salinan itu berusia pada jadwal cleanupPeriodDays.

does not load (...), so Claude Code ignores the whole file

Perintah berhasil. File pengaturan yang disebutkan peringatan memiliki kesalahan, sehingga Claude Code mengabaikan seluruh file, termasuk apa pun yang ditulis perintah tersebut di sana, sampai Anda memperbaikinya.

Perbaiki kesalahan yang disebutkan peringatan. Untuk nilai yang tidak diterima Claude Code, Fix a broken settings file menjelaskan caranya. Kemudian jalankan perintah lagi jika perubahannya tidak lagi ada di file.

Peringatan muncul setelah baris keberhasilan claude plugin install, enable, disable, atau claude plugin marketplace add di shell Anda:

⚠ /home/user/.claude/settings.json does not load (its "permissions" is not valid), so Claude Code ignores the whole file, including anything this command wrote there. Fix the file, then run this command again if its change is missing. If a newer Claude Code wrote the file, update Claude Code instead.

Teks dalam tanda kurung menyebutkan kesalahannya:

• its "<key>" is not valid: pengaturan yang dikutip berisi nilai yang tidak diterima Claude Code. Cari pengaturan tersebut di referensi pengaturan untuk nilai yang diterimanya. Ketika lebih dari satu nilai gagal, teks menyebutkan pengaturan pertama dan menghitung yang lainnya, seperti dalam its "permissions" and 1 other value are not valid.
• it is not a JSON object: tingkat atas file bukan objek JSON, seperti file yang tingkat atasnya berupa array.

Disabled in ~/.claude/settings.json but still loads

Anda menetapkan plugin ke false di ~/.claude/settings.json, dan barisnya di claude plugin list atau /plugin menunjukkan pesan ini diikuti oleh sumber yang mengaktifkannya, seperti — project settings enable it, which overrides your user setting. true dalam sumber precedence yang lebih tinggi itu menimpa pengaturan pengguna Anda.

Untuk opt out dari plugin yang diaktifkan proyek di mesin Anda, atur id ke false di .claude/settings.local.json, yang memiliki precedence lebih tinggi daripada file proyek. Untuk sumber lain yang pesan dapat beri nama, lihat Disabled in user settings but still loads.

Jika claude plugin list malah menandai plugin required by your org, tidak ada file pengaturan yang terlibat: organisasi Anda menandai plugin yang disinkronkan itu sebagai diperlukan di claude.ai, dan itu memuat bahkan jika Anda menonaktifkannya sebelumnya. Lihat Plugins synced from claude.ai.

Plugin "<name>" is enabled in project settings but isn't installed here

Tab Errors menunjukkan baris ini untuk plugin yang .claude/settings.json proyek Anda aktifkan, dengan panduan Run claude plugin install <name>@<marketplace> --scope project to install it for this project.

Pengaturan repository dapat mengaktifkan plugin untuk semua orang yang membukanya, tetapi mereka tidak menginstalnya. Ketika plugin berasal dari sumber eksternal seperti repository GitHub atau paket npm, Claude Code tidak mengunduhnya sampai Anda menginstalnya sendiri. Jalankan command dari baris panduan di shell Anda, lalu reload:

claude plugin install <name>@<marketplace> --scope project

Setelah Anda menjalankan /reload-plugins dalam sesi Anda, entri tab Errors hilang dan plugin tercantum di bawah Installed.

Jika organisasi Anda pre-install plugin untuk Anda, itu melakukannya melalui pengaturan terkelola. Lihat Pre-install and require plugins.

A plugin stays installed after plugin uninstall on Windows

Di Windows, Anda menjalankan claude plugin uninstall pada cakupan project atau local dan perintah itu melaporkan keberhasilan, tetapi claude plugin list atau /plugin masih mencantumkan plugin tersebut.

installed_plugins.json menyimpan dua catatan instalasi plugin untuk folder proyek, masing-masing menuliskan path folder secara berbeda, dan satu kali uninstall hanya menghapus salah satunya. Untuk memeriksanya, jalankan claude plugin list --json di shell Anda. Baris plugin yang tersisa memiliki projectPath yang menuliskan folder secara berbeda dari tempat Anda menjalankan uninstall, seperti c:\work\app untuk C:\work\app.

Jalankan perintah uninstall yang sama lagi, dengan --scope yang sama, dari folder yang sama. Proses kedua tidak menemukan catatan di bawah penulisan path-nya sendiri, sehingga menghapus catatan di bawah penulisan yang lain. Untuk instalasi cakupan project:

claude plugin uninstall <name>@<marketplace> --scope project

Kemudian jalankan claude plugin list --json lagi untuk memastikan baris tersebut sudah hilang.

Sebelum v2.1.295, proses kedua gagal dengan Plugin "<name>" is not installed in project scope. Jalankan claude update, lalu jalankan uninstall lagi.

A plugin installed from a git repository shows version unknown

Version: unknown di claude plugin list dapat berarti Claude Code tidak dapat membaca commit yang digunakannya sebagai versi plugin yang bersumber dari git. Plugin tersebut mungkin memiliki repositorinya sendiri atau berada di dalam marketplace yang di-host di git.

Jalankan perintah-perintah ini di shell Anda, dengan mengganti formatter@my-marketplace dengan baris name@marketplace plugin dari claude plugin list:

1. Update Claude Code

Perbarui Claude Code ke v2.1.302 atau lebih baru, yang melakukan clone dalam format yang memungkinkannya membaca commit:

claude update

2. Update the marketplace

Perbarui salinan marketplace milik Claude Code, yang menyimpan commit untuk plugin di dalam repositori marketplace:

claude plugin marketplace update my-marketplace

3. Update the plugin

Perbarui plugin untuk menulis ulang versi yang tercatat:

claude plugin update formatter@my-marketplace

4. Check the version

Periksa baris Version: untuk nilai seperti ID commit 12 karakter:

claude plugin list

claude plugin update mengubah blok satu cakupan per eksekusi. Untuk blok yang masih menampilkan unknown, jalankan ulang perintah tersebut dengan nilai Scope: blok itu:

claude plugin update formatter@my-marketplace --scope project

Jika blok masih menampilkan unknown setelah dijalankan ulang, lihat Get more help.

Failed to load hooks from <path> and hooks that don't fire

Hooks plugin tidak berjalan, atau salah satu memblokir tindakan. Baik tab Errors menunjukkan kegagalan beban untuk mereka, hooks memuat dan Anda melihat pemberitahuan <Event> hook error atau kesalahan pemblokiran dalam transkrip, atau hook memuat tanpa kesalahan dan tidak pernah menyala.

Hooks fail to load

Tab Errors menunjukkan salah satu pesan ini:

• Failed to load hooks from <path>: <reason>: hooks/hooks.json bukan JSON yang valid atau gagal schema hooks. Alasan menyebutkan parse atau kesalahan validasi. Perbaiki file. Untuk menangkap masalah sintaks JSON di hooks/hooks.json sebelum Anda menerbitkan plugin, jalankan claude plugin validate <plugin-directory> di shell Anda
• hooks path not found: <path>: field hooks manifest menyebutkan file yang tidak ada di path itu relatif terhadap root plugin. Perbaiki path atau tambahkan file
• hooks path escapes plugin directory: <path>: lihat Path escapes plugin directory

hook error notices in the transcript

Pemberitahuan bentuk ... hook error: Failed with non-blocking status code: <stderr> berarti hook berjalan dan command-nya gagal. Misalnya, Stop hook error: Failed with non-blocking status code: /bin/sh: node: command not found berarti shell yang Claude Code spawn tidak dapat menemukan node. Instal, atau pastikan itu ada di PATH dari terminal yang Anda mulai claude dari.

Jika stderr menunjukkan path plugin terpotong di spasi, command bentuk shell hook menggunakan ${CLAUDE_PLUGIN_ROOT} di luar tanda kutip dan path instalasi berisi spasi. Bungkus variabel dalam tanda kutip ganda atau gunakan exec form. Untuk menemukan variabel yang tidak dikutip, jalankan claude plugin validate pada direktori plugin dan cari peringatan quoting-nya.

Jika pemberitahuan berbunyi Failed to run: Plugin directory does not exist: <path>, lihat Plugin directory does not exist.

Untuk kesalahan lain apa pun, jalankan command hook sendiri dari direktori plugin untuk melihat output lengkap, atau tangkap stderr lengkap dengan debug logging.

A plugin hook blocks a tool call or prompt

Hook yang keluar dengan kode 2 memblokir tindakan yang dijalankannya. Ketika hook plugin memblokir dengan cara ini dan stderr-nya adalah pesan pemblokiran, kesalahan berakhir dengan This hook comes from the <plugin> plugin. sehingga Anda tahu plugin mana yang harus dinonaktifkan atau diperbaiki. Sebelum v2.1.281, kesalahan tidak menyebutkan plugin.

Jika pesan itu menunjukkan path plugin terpotong di spasi, terapkan perbaikan ${CLAUDE_PLUGIN_ROOT} yang tidak dikutip.

Hook loads but never fires

Jika hook memuat tanpa kesalahan tetapi tidak pernah menyala, pertama-tama jalankan /plugin dalam sesi Anda dan buka detail plugin. Catatan di sana yang diawali dengan Its hooks.json hooks do not run berarti plugin lain yang diaktifkan dengan nama yang sama telah mendaftarkan hook-nya sebagai gantinya, dan Hooks when two enabled plugins share a name menjelaskan salinan mana itu dan cara beralih. Jika tidak, periksa definisi hook lalu amati saat hook berjalan:

1. Check the event name

Nama event peka huruf besar-kecil, jadi konfirmasi milik Anda cocok persis, misalnya PostToolUse.

2. Check the matcher

Konfirmasi matcher hook cocok dengan nama tool.

3. Trigger the event on purpose

Untuk hook PostToolUse, minta Claude untuk mengedit file.

4. Read the debug log

Buka debug log, yang mencatat hook mana yang cocok. Hook yang berjalan muncul di sana dengan kode keluar-nya.

Plugin directory does not exist: <path>

Jalankan /reload-plugins di prompt Claude Code terlebih dahulu, meskipun pesan menyuruh Anda untuk menginstal ulang. Hook plugin gagal dengan Failed to run: Plugin directory does not exist: <path> (<plugin> — run /plugin to reinstall), dan hook tidak berjalan, ketika direktori tempat sesi Anda memuat hook plugin sudah hilang dari disk. Plugin directory not found at path: <path> adalah pesan yang berbeda, tentang entri marketplace.

Reload memuat hook plugin dari direktorinya saat ini. Kegagalan ditampilkan sekali per sesi untuk setiap event dan perintah hook, sehingga hook yang tidak lagi memunculkan pesan tidak memastikan bahwa masalahnya sudah diperbaiki. Baca output reload sebagai gantinya:

• Reloaded: tanpa baris kesalahan: hook plugin tidak lagi menunjuk ke direktori yang hilang
• N errors during load. Run /plugin for details.: buka tab Errors di /plugin dan ikuti entri halaman ini untuk pesan yang ditampilkannya
• Baris yang berakhir dengan Run /reload-plugins --force to apply.: tidak ada yang dimuat ulang, dan hook tetap gagal. Jalankan /reload-plugins --force di prompt Claude Code

Invalid MCP server config for "<server>" and MCP servers that don't start

Plugin menggabungkan server MCP, dan tab Errors menunjukkan Invalid MCP server config for "<server>": <error>, atau server tercantum tetapi /mcp tidak pernah menunjukkannya terhubung.

Invalid MCP server config for "<server>": <error>

Konfigurasi server melewati pemeriksaan schema, tetapi Claude Code tidak dapat menyelesaikannya untuk sesi ini. Teks setelah titik dua menyebutkan penyebab dan memutuskan perbaikan:

• Missing environment variables: <names>: atur variabel itu di shell yang Anda mulai Claude Code dari, lalu mulai sesi baru
• URL is unset or invalid: opsi ${user_config.*} yang URL gunakan tidak diatur. Jalankan /plugin configure <plugin> untuk mengaturnya
• has an invalid MCP url atau headersHelper for MCP server '<server>' references ${user_config.*}: konfigurasi plugin itu sendiri yang salah. Perbaiki url atau headersHelper dalam konfigurasi MCP plugin Anda, atau laporkan ke penulis plugin jika plugin bukan milik Anda. Kasus headersHelper memiliki entri sendiri di bawah plugin command references user_config

Bundled MCP server "<name>" was not started: it needs configuration

Plugin menyertakan server sebagai MCPB bundle yang mendeklarasikan user_config, dan pengaturan yang diperlukan tidak memiliki nilai yang disimpan atau nilai yang disimpan gagal validasi bundle itu sendiri, jadi Claude Code melewati memulai server. Sisa plugin berfungsi.

Pilih plugin di tab Installed /plugin dan pilih Configure untuk memberikan nilai. Setelah Anda menyimpan, /plugin menunjukkan Configuration saved. dan ditutup, dan Claude Code memuat ulang plugin seperti yang dijelaskan di bawah Manage installed plugins. Server dimulai setelah reload itu diterapkan. Sebelum v2.1.285, Claude Code melewati server tanpa menunjukkan baris ini.

Server is configured but never connects

Jalankan /mcp untuk melihat status server. Ketika server sehat, /mcp mencantumkannya sebagai terhubung.

Untuk membaca kesalahan yang dicetak server saat memulai, jalankan claude --debug dan buka log di ~/.claude/debug/<session-id>.txt. Flag --debug tidak mencetak ke terminal.

[!NOTE]

Ketika koneksi ke server stdio plugin gagal kurang dari 15 menit sebelum Anda menjalankan claude --debug, Claude Code tidak memulai server tersebut. Dalam sesi baru, pilih Reconnect dari menu server di /mcp untuk memulainya, lalu buka log.

Entri server di .mcp.json yang gagal schema tidak muncul di tab Errors. Claude Code menjatuhkan server itu dan mencatat Invalid MCP server config for <server> in <path> hanya dalam log debug itu. Untuk menemukan entri tanpa memuat plugin, jalankan claude plugin validate di shell Anda pada direktori plugin, yang melaporkannya sebagai kesalahan.

Sebelum v2.1.281, claude plugin validate tidak memeriksa .mcp.json.

Server works with --plugin-dir but fails after install

Anda adalah penulis plugin, dan server dimulai ketika Anda memuat plugin dari direktori sumber-nya dengan --plugin-dir tetapi gagal setelah plugin diinstal.

Claude Code menyalin plugin yang diinstal ke dalam cache-nya, jadi path yang hanya berfungsi dari direktori sumber rusak. Tulis path di dalam plugin dengan ${CLAUDE_PLUGIN_ROOT}.

Untuk path yang menjangkau di luar direktori plugin, lihat Files the plugin references outside its directory aren't found.

Language server doesn't start, uses too much memory, or reports wrong diagnostics

Anda menginstal code intelligence plugin dan Claude tidak melihat diagnostik, atau language server menggunakan terlalu banyak memori atau melaporkan kesalahan yang tidak nyata.

Language server doesn't start

Plugin terhubung ke binary language server yang Anda instal secara terpisah, dan Claude Code memunculkannya dengan nama command dari PATH Anda.

Tab Errors /plugin menunjukkan kegagalan dengan alasannya, seperti Executable not found in $PATH: "<binary>", dan claude --debug mencatatnya sebagai LSP server <name> failed to start: <reason>.

Instal binary dan konfirmasi itu ada di PATH dari terminal yang Anda mulai claude dari, misalnya dengan which typescript-language-server. Kemudian mulai sesi baru.

Language server uses too much memory

Language server seperti rust-analyzer dan pyright mengindeks seluruh proyek. Nonaktifkan plugin dengan /plugin disable <plugin> dalam sesi dan andalkan tool pencarian bawaan Claude sebagai gantinya.

False positive diagnostics in a monorepo

Language server yang tidak dikonfigurasi untuk workspace dapat melaporkan impor yang tidak terselesaikan untuk paket internal. Tidak ada yang perlu diperbaiki di sisi Claude Code, dan diagnostik tidak menghentikan Claude dari mengedit kode.

Build a plugin

Anda mengembangkan plugin dan memuat dengan --plugin-dir atau menginstalnya dari marketplace lokal. Entri ini mencakup kegagalan yang Anda alami saat mengembangkan plugin. Untuk pemeriksaan yang berjalan setelah setiap perubahan, lihat Test and debug.

Dua kegagalan yang juga menjangkau pengguna plugin memiliki entri mereka di bawah Plugin installed but not working:

• Hook yang tidak menyala: lihat hooks that don't fire
• Server MCP yang tidak dimulai: lihat MCP servers that don't start

commands path not found: <path>

Tab Errors menunjukkan commands path not found: <absolute path> dengan panduan Check that the path in your manifest or marketplace config is correct. Pesan yang sama muncul untuk skills, agents, dan hooks.

Claude Code menyelesaikan path dari plugin.json Anda atau entri marketplace terhadap root plugin dan menemukan tidak ada di sana. Path dalam pesan adalah path absolut yang diperiksa, jadi bandingkan dengan apa yang ada di disk. Perbaiki path atau buat direktori, lalu jalankan /reload-plugins.

[!NOTE]

Sebelum v2.1.299, pesan ini dapat muncul saat startup pada baris yang diberi label dengan tag seperti synced[0]. Baris tersebut adalah untuk plugin yang disinkronkan dari claude.ai. Pesan ini muncul ketika sesi Claude Code lain di mesin Anda telah memperbarui plugin beberapa saat sebelumnya dan memindahkan file-nya. Untuk memuat plugin, mulai ulang Claude Code. Agar pesan tidak muncul karena alasan ini, perbarui ke v2.1.299 atau lebih baru.

Path dalam manifest relatif terhadap root plugin dan dimulai dengan ./. Path yang diselesaikan di luar root plugin dilaporkan sebagai <component> path escapes plugin directory sebagai gantinya dan dijatuhkan.

--plugin-dir at a marketplace root doesn't load the plugins under plugins/

Anda memulai claude --plugin-dir <path> dan tidak melihat kesalahan, tetapi skills, agents, dan hooks plugin tidak ada.

--plugin-dir mengambil direktori root plugin, yang berisi .claude-plugin/plugin.json dan direktori komponen seperti skills/. Jika Anda menunjuknya ke root marketplace, Claude Code tidak membaca marketplace.json, jadi plugin di bawah plugins/ tidak memuat, dan Anda tidak melihat kesalahan. Sebelum v2.1.281, Claude Code memuat root marketplace sebagai satu plugin kosong bernama setelah direktori itu. Tunjukkan flag ke direktori plugin itu sendiri:

claude --plugin-dir ./my-marketplace/plugins/my-plugin

Kemudian buka Installed di /plugin, di mana pane detail plugin mencantumkan komponen-nya.

Files the plugin references outside its directory aren't found

Plugin berfungsi dari direktori sumber-nya dengan --plugin-dir tetapi gagal setelah instalasi, dengan kesalahan tentang path seperti ../shared-utils.

Claude Code menyalin plugin yang diinstal ke dalam cache-nya dan memuat dari sana, jadi path yang menjangkau di luar direktori plugin itu sendiri menunjuk pada tidak ada dalam cache. Pindahkan file bersama di dalam direktori plugin, atau referensikan mereka melalui symlink di dalamnya. Untuk di mana cache dan bagaimana path diselesaikan, lihat Find plugins on disk.

${CLAUDE_PLUGIN_ROOT} shows forward slashes on Windows

Di Windows, hook plugin yang berjalan melalui Git Bash menerima ${CLAUDE_PLUGIN_ROOT} sebagai C:/Users/you/... daripada C:\Users\you\..., dan script yang mengharapkan backslash rusak.

Dengan Git Bash terinstal, hook bentuk shell berjalan melalui Git Bash secara default. Untuk hook yang berjalan melalui Git Bash, Claude Code meneruskan path dengan forward slash agar Bash tidak membaca backslash sebagai escape. Bash builtins, alat MSYS, dan binary Windows asli semuanya menerima bentuk itu.

Jika script Anda membutuhkan backslash, alihkan hook ke salah satu bentuk yang menyimpan path asli, dijelaskan di bawah exec form and shell form:

• Hook bentuk exec, yang memunculkan proses langsung dengan array args
• Hook dengan "shell": "powershell"

Plugin loads but its skills are missing

Plugin Anda tercantum di bawah Installed tanpa kesalahan, tetapi skills-nya tidak ditawarkan ketika Anda mengetik /.

Skills memuat dari skills/ di root plugin dan command dari commands/ di root plugin. Hanya plugin.json yang termasuk di dalam .claude-plugin/, dan direktori skills/ di dalam .claude-plugin/ tidak dipindai. Pindahkan direktori ke root plugin dan jalankan /reload-plugins. Setelah itu, pane detail plugin di /plugin mencantumkan skills, dan mengetik / menawarkan mereka.

Setiap skill adalah direktori yang berisi SKILL.md. Entri skills dalam manifest yang menunjuk pada file SKILL.md daripada direktorinya dilaporkan sebagai path is a file; skills entries must be directories containing SKILL.md.

Skill loads but Claude never invokes the skill

Skill plugin Anda berjalan ketika Anda mengetik command /<plugin>:<skill> nya, tetapi Claude tidak pernah memanggilnya sebagai respons terhadap permintaan biasa.

Periksa penyebab ini secara berurutan:

• Skill menetapkan disable-model-invocation: true: template skill di Create your first plugin mengaturnya. Hapus baris dari skill yang ingin Claude panggil sendiri. Control who invokes a skill mencakup field
• Deskripsi tidak cocok dengan cara orang bertanya: kerjakan pemeriksaan di Skill not triggering
• Deskripsi dipotong: ketika banyak skills diinstal, Claude Code memendekkan deskripsi agar sesuai dengan anggaran karakter daftar, yang dapat menghapus kata kunci yang Claude butuhkan untuk mencocokkan permintaan. Lihat Skill descriptions are cut short

Untuk mengukur seberapa sering skill memicu di seluruh prompt realistis daripada memeriksa satu per satu, tulis kasus eval dengan grader tool_used: Skill dan jalankan dengan claude plugin eval setelah setiap perubahan deskripsi.

<directory> is not a plugin or skill folder from claude plugin eval init

Anda menjalankan claude plugin eval init dari direktori yang bukan root plugin, seperti direktori home Anda atau root repositori yang menyimpan plugin dalam subdirektori. init menulis suite di bawah direktori kerja, jadi itu berhenti alih-alih membuat direktori evals/ yang plugin tidak akan pernah lihat.

Ubah ke root plugin, direktori yang menyimpan .claude-plugin/plugin.json atau SKILL.md skill, dan jalankan command lagi. Untuk scaffold suite di tempat lain dengan tujuan, lewatkan --eval-dir. Lihat Test plugins with evals.

The userConfig dialog never appears

Plugin Anda mendeklarasikan opsi userConfig, tetapi tidak ada dialog konfigurasi yang muncul ketika Anda menginstalnya.

Apakah instalasi meminta nilai tergantung pada di mana Anda menjalankannya:

• /plugin install dalam sesi, atau tab Discover di /plugin: dialog adalah bagian dari instalasi interaktif ini
• Dialog Manage plugins ekstensi VS Code: meminta opsi yang tidak diatur sebagai formulir setelah instalasi. Sebelum v2.1.285, menginstal di sana tidak menunjukkan formulir opsi, jadi atur nilai dari sesi terminal dengan /plugin configure <plugin>@<marketplace>
• claude plugin install di shell Anda: tidak pernah meminta nilai userConfig. Itu menyimpan nilai --config KEY=VALUE apa pun yang Anda lewatkan, dan ketika opsi tetap tidak diatur itu mencetak N userConfig options not yet set — run /plugin configure <plugin>@<marketplace> in Claude Code, or pass --config KEY=VALUE. Ketika salah satu opsi yang tidak diatur diperlukan, (M required) mengikuti not yet set.

Jika Anda menginstal dari shell, lewatkan nilai dengan --config, satu flag per opsi:

claude plugin install my-plugin@my-marketplace --config api_url=https://example.com

Ketika setiap opsi diatur, output instalasi tidak membawa baris not yet set.

Untuk membuka dialog setelahnya sebagai gantinya, jalankan /plugin configure my-plugin@my-marketplace dalam sesi. Dari shell, claude plugin configure menunjukkan opsi mana yang masih tidak diatur dan menyimpan nilai yang disalurkan di stdin. Itu memerlukan Claude Code v2.1.285 atau lebih baru.

Jika Anda melewatkan kunci --config yang manifest tidak deklarasikan, plugin masih diinstal, dan command mencetak ⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig. diikuti oleh kunci yang plugin deklarasikan.

Untuk plugin yang mengirimkan file bundle MCPB yang mendeklarasikan user_config miliknya sendiri, pesan berbunyi isn't declared in this plugin's userConfig or by its bundled MCP servers. sebagai gantinya, dan kunci yang dikenal mencakup kunci server itu, ditulis <server>.<key>. Bundle yang manifest referensikan dengan URL tidak dibaca pada waktu instalasi, jadi kunci-nya tidak tercantum dan pesan mengatakan untuk mengonfigurasinya di /plugin. Mengatur kunci <server>.<key> memerlukan Claude Code v2.1.285 atau lebih baru.

claude plugin validate reports errors

Anda menjalankan claude plugin validate <path>, atau /plugin validate <path> dalam sesi, dan itu mencetak Found N errors dan Validation failed, lalu keluar dengan kode 1.

Validator membaca manifest di path yang Anda berikan: .claude-plugin/plugin.json untuk direktori plugin, .claude-plugin/marketplace.json untuk direktori marketplace, atau keduanya untuk direktori yang menyimpan keduanya. Untuk marketplace, itu memprefiks masalah dalam manifest entri sendiri dengan indeks entri, sebagai plugins[1] plugin.json → json: .... Sebelum v2.1.289, Claude Code memvalidasi direktori yang menyimpan keduanya hanya sebagai marketplace.

Tabel mencakup pesan yang menghentikan validasi dan dua peringatan, No frontmatter block found dan Unknown field '<key>', yang menghentikannya hanya ketika Anda melewatkan --strict. Peringatan lain, seperti deskripsi yang hilang, tidak tercantum.

Jalankan command lagi setelah setiap perbaikan sampai itu mencetak tidak ada kesalahan.

Field plugin.json ada di manifest reference, dan pesan tingkat marketplace ada di bawah Marketplace validation errors.

Plugin <name> has conflicting manifests

Plugin gagal memuat dengan Plugin <name> has conflicting manifests: both plugin.json and marketplace entry specify components.

Plugin memiliki plugin.json sendiri, dan entri marketplace-nya menetapkan strict: false sambil juga mendeklarasikan salah satu dari commands, agents, skills, hooks, outputStyles, atau themes. Hapus field itu dari entri, atau atur strict: true dalam entri sehingga Claude Code menambahkannya ke plugin.json. Lihat Strict mode.

Warning: No commands found in plugin <name> custom directory

Ketika plugin memuat, log claude --debug di ~/.claude/debug/<session-id>.txt mencatat Warning: No commands found in plugin <name> custom directory: <path>. Expected .md files or SKILL.md in subdirectories. Tidak ada yang muncul dalam sesi atau tab Errors.

Path commands dalam manifest ada tetapi tidak menyimpan file .md dan tidak ada SKILL.md dalam subdirektori. Tambahkan file command, atau hapus path dari manifest.

Host a marketplace

Anda menerbitkan marketplace dan pengguna melaporkan kesalahan, atau validasi Anda sendiri gagal. Entri ini untuk pemilik marketplace.

Plugins with relative paths fail in URL-based marketplaces

Pengguna menambahkan marketplace Anda dengan URL https://example.com/marketplace.json. Instalasi plugin yang source adalah path relatif, seperti ./plugins/my-plugin, gagal dengan its marketplace entry path does not stay inside the marketplace directory. Plugin yang sudah diinstal gagal memuat dengan Plugin source path refused. Kedua pesan memiliki entri referensi kesalahan.

Ketika pengguna menambahkan marketplace berbasis URL, Claude Code hanya mengunduh file marketplace.json itu sendiri. Itu tidak mengambil file plugin dengan path relatif dari server itu, jadi path relatif dalam entri menunjuk pada direktori yang tidak pernah diambil. Berikan setiap entri sumber yang Claude Code dapat ambil sendiri, seperti repository GitHub:

{ "name": "my-plugin", "source": { "source": "github", "repo": "owner/repo" } }

Atau, host marketplace dalam repository git dan beri tahu pengguna untuk menambahkannya dengan URL repository. Untuk sumber git, Claude Code mengklon seluruh repository, jadi path relatif diselesaikan. Tipe sumber ada di marketplace reference.

A root plugin's files from a git submodule are missing after install

Plugin Anda berada di root marketplace dan menjalankan atau membaca file dari submodule git milik repositori. Setelah instalasi, direktori submodule tersebut kosong. Sebelum v2.1.295, Claude Code mengambil setiap submodule, sehingga direktori tersebut terisi.

Ketika Claude Code mengklon marketplace Anda, Claude Code hanya mengambil submodule yang berisi file plugin. Untuk plugin di root, Claude Code menentukannya dengan membaca path dalam konfigurasi plugin dan teks file-file plugin. Claude Code tidak dapat melihat path yang dibentuk oleh skrip saat skrip tersebut berjalan.

Tuliskan path ke dalam submodule secara lengkap di tempat yang dapat dibaca Claude Code, seperti ${CLAUDE_PLUGIN_ROOT}/vendor/tool/run.sh dalam perintah hook. Claude Code kemudian mengambil setiap submodule dalam repositori untuk plugin tersebut.

Marketplace validation errors

Anda menjalankan claude plugin validate . dari direktori marketplace Anda dan itu melaporkan kesalahan atau peringatan pada file marketplace itu sendiri.

claude plugin validate juga memvalidasi setiap entri yang source adalah path lokal dan memperingatkan ketika version entri tidak setuju dengan manifest plugin itu sendiri.

Tabel mencantumkan pesan tingkat marketplace. Pesan tingkat entri adalah pesan plugin di bawah claude plugin validate reports errors, diprefiks dengan plugins[N] plugin.json →.

Sebelum v2.1.247, nama marketplace yang berisi karakter kontrol atau bidirectional-formatting dilaporkan hanya sebagai Marketplace name impersonates an official Anthropic/Claude marketplace.

Blocked by your organization

Organisasi Anda menerapkan pengaturan terkelola yang membatasi plugin, dan command ditolak dengan pesan kebijakan. Entri ini menyebutkan pengaturan di balik setiap penolakan sehingga Anda tahu apa yang harus diminta administrator Anda. Untuk sisi admin, lihat Manage plugins for your organization.

Marketplace source '<source>' is blocked by enterprise policy

Anda menjalankan /plugin marketplace add, update, atau instalasi, dan Claude Code menolak dengan baris ini.

Administrator Anda menetapkan blockedMarketplaces atau strictKnownMarketplaces dalam pengaturan terkelola, dan sumber ini tidak diizinkan. Minta administrator Anda untuk mengizinkan sumber, atau tambahkan salah satu sumber yang diizinkan yang pesan cantumkan.

Cocokkan sisa pesan untuk melihat jenis kebijakan apa yang memblokir sumber:

• Allowed sources: <list>: blok berasal dari allowlist strictKnownMarketplaces daripada blocklist blockedMarketplaces
• No external marketplaces are allowed.: allowlist strictKnownMarketplaces kosong
• Tip: bahwa shorthand mengasumsikan github.com: allowlist mengizinkan host git dengan hostname, dan shorthand owner/repo yang Anda lewatkan menunjuk pada github.com. Jika repository tinggal di host internal Anda, tambahkan lagi dengan URL lengkapnya, seperti git@your-git-host.com:owner/repo.git

Marketplace yang Anda tambahkan sebelum kebijakan menjadi lebih ketat berhenti merefresh juga, karena kebijakan berlaku pada setiap refresh.

Marketplace "<name>" is not in the allowed marketplace list

Tab Errors menunjukkan baris ini, atau Marketplace "<name>" is blocked by enterprise policy, untuk marketplace yang sudah Anda daftarkan.

Pengaturan terkelola yang sama yang memblokir marketplace source berlaku pada waktu beban. strictKnownMarketplaces tidak termasuk marketplace ini, atau blockedMarketplaces menyebutkannya, jadi Claude Code berhenti memuat dan plugin-nya. Untuk varian allowlist, baris panduan menunjukkan sumber yang diizinkan, atau Contact your administrator to configure allowed marketplace sources. Untuk varian blocklist itu berbunyi This marketplace source is explicitly blocked by your administrator.

Plugin "<name>" is blocked by your organization's policy and cannot be installed

Instalasi ditolak dengan baris ini, enable dengan baris yang sama berakhir cannot be enabled, atau instalasi atau update dengan satu yang menyebutkan alasan: Plugin "<name>" is from marketplace "<marketplace>", which is blocked by your organization's policy, atau Plugin "<name>" depends on "<dep>", which is blocked by your organization's policy.

Pengaturan terkelola memblokir plugin ini, marketplace-nya, atau dependensi yang dibutuhkannya. Tanyakan administrator Anda entri mana yang berlaku. Dependensi yang diblokir berarti plugin tidak dapat diinstal sampai marketplace dependensi diizinkan.

--plugin-dir is disabled by your organization's managed settings (disableSideloadFlags)

Anda memulai claude dengan --plugin-dir, --plugin-url, --agents, atau --mcp-config. Claude Code keluar dengan pesan ini dan Plugins, custom agents, and MCP servers can only be loaded from sources your administrator has approved.

Administrator Anda menetapkan disableSideloadFlags dalam pengaturan terkelola, yang mematikan flag yang memuat plugin, agents, dan server dari path arbitrer. Muat plugin dari marketplace yang disetujui, atau minta administrator Anda untuk menghapus pengaturan.

Pesan terkait di tab Errors /plugin adalah --plugin-dir copy of "<name>" ignored: plugin is locked by managed settings. Pengaturan terkelola mengaktifkan atau menonaktifkan plugin itu berdasarkan nama, dan Claude Code mengabaikan salinan --plugin-dir Anda sehingga flag tidak dapat menimpa kebijakan.

Plugins from ~/.claude/skills/ are blocked by your organization's managed settings

Anda menjalankan claude plugin init atau claude plugin enable, dan itu berhenti dengan baris ini. Pesan menyebutkan strictKnownMarketplaces or blockedMarketplaces dan meminta administrator Anda untuk menambahkan {"source":"skills-dir"} ke strictKnownMarketplaces atau menghapusnya dari blockedMarketplaces.

Sumber skills-dir berdiri untuk plugin yang Claude Code muat dari direktori ~/.claude/skills/ Anda. Minta administrator Anda untuk membuat perubahan yang pesan sebutkan.

Command-sourced plugins are disabled by your organization's managed settings

Anda menginstal atau memperbarui plugin dengan sumber command, dan itu berhenti dengan baris ini dan The plugin was not installed or updated and its command was not run.

Administrator Anda menetapkan disableCommandPluginSources, jadi Claude Code menolak untuk menjalankan command yang dideklarasikan marketplace yang menghasilkan plugin. Menetapkan allowManagedHooksOnly saja memiliki efek yang sama ketika disableCommandPluginSources tidak diatur. Tanyakan administrator Anda apakah plugin dapat diterbitkan dari tipe sumber yang kebijakan izinkan.

Marketplace '<name>' is seed-managed

Anda menjalankan claude plugin marketplace update <name>, dan itu gagal dengan Marketplace '<name>' is seed-managed (<dir>) dan hint untuk meminta admin Anda.

Operator pre-populated marketplace ini melalui CLAUDE_CODE_PLUGIN_SEED_DIR, dan Claude Code memperlakukan marketplace yang seed-managed sebagai read-only. marketplace update massal melewatinya dan memperbarui yang lain.

Untuk mengubah konten marketplace, minta orang yang memelihara gambar seed untuk memperbaruinya. Untuk prosedurnya, lihat Seed containers and CI.

Next steps

• Plugin loading reference: mengapa scope, cache, dan precedence berperilaku seperti yang mereka lakukan
• Plugin commands reference: flag, default, output, dan exit code untuk command claude plugin
• Install and manage plugins: langkah instalasi dari awal
• Manage plugins for your organization: troubleshooting sisi kebijakan untuk administrator