claude plugin dari shell atau skrip Anda, atau sebagai /plugin dan /reload-plugins di dalam sesi Claude Code. Referensi ini memberikan flag, default, output, dan kode keluar setiap perintah, bersama dengan dua flag yang memuat plugin untuk satu sesi.
Jalankan claude plugin --help pada build Anda untuk mengonfirmasi subperintah mana yang dimiliki versi Anda.
Kasus-kasus ini tercakup di halaman lain:
- Instal dan kelola langkah, dan di mana
/pluginberjalan: lihat Instal dan kelola plugin - Apa yang diubah perintah di disk dan cakupan mana yang diutamakan: lihat Referensi pemuatan plugin
- Apa arti pesan kesalahan: lihat Troubleshoot plugin
Perintah claude plugin
Jalankanclaude plugin <subcommand> dari shell atau skrip Anda, di luar sesi Claude Code. Subperintah ini menginstal dan mengelola plugin tanpa membuka panel /plugin.
claude plugins adalah alias untuk claude plugin.
Setiap subperintah berbagi kode keluar, argumen plugin, dan nilai cakupan ini:
- Kode keluar:
0pada kesuksesan dan1pada kegagalan.validatemenambahkan keluar2untuk kesalahan yang tidak terduga, danevalmenambahkan kode yang tercantum di bagiannya. - Argumen plugin: argumen
<plugin>adalah pluginnameatauname@marketplace. Ketika dua marketplace menawarkan nama yang sama, gunakan bentuk yang memenuhi syarat. - Cakupan:
--scopemengambiluser,project, ataulocal, dan menamai file pengaturan yang ditulis perintah.updatejuga mengambilmanaged.
plugin init
Rangka kerja plugin baru di~/.claude/skills/<name>/. Plugin ini dimuat dalam sesi berikutnya Anda sebagai <name>@skills-dir tanpa langkah instal.
new adalah alias untuk init.
Untuk alur kerja buat, uji, dan edit yang dimulai dengan perintah ini, lihat Buat plugin.
<name> menjadi nama direktori di bawah ~/.claude/skills/ dan name plugin dalam manifestnya.
Perintah ini tidak memiliki flag untuk lokasi lain. Untuk rangka kerja di dalam proyek, lihat Buat plugin.
Rangka kerja plugin dengan file skill dan hook pemula:
Created plugin "my-helper" at ~/.claude/skills/my-helper, diikuti oleh id yang dimuat sebagai dan perintah claude plugin disable yang mematikannya.
Claude Code keluar 1 tanpa menulis ketika tidak dapat rangka kerja dengan aman, dan pesan menamai alasannya. Ini adalah alasan umum:
- Nilai
--withyang tidak dikenal - Rangka kerja yang ada di target tanpa
--force - Pengaturan terkelola yang memblokir plugin direktori skills
plugin install
Instal plugin dari marketplace yang telah Anda tambahkan.i adalah alias untuk install.
headersHelper untuk downloadnya, Claude Code terlebih dahulu mencetak perintah dan menanyakan Run this command now? [y/N].
Lewatkan
-y dari terminal Anda sendiri untuk menerima perintah yang ditampilkan tanpa prompt. Berikut yang terjadi tanpa TTY dan ketika Claude menjalankan perintah:
- stdin atau stdout bukan TTY, dan Anda tidak melewatkan
-yatau--accept-command: instalasi ditolak. Output mengatakan perintah hanya ditampilkan, dan kode keluar adalah1 - Claude menjalankan perintah melalui alat Bash-nya:
-ydiabaikan. Jalankan perintah dari terminal Anda sendiri
Successfully installed plugin: formatter@my-marketplace (scope: project). Ketika tidak ada yang baru diinstal, output mengatakan mengapa:
- Sudah diinstal di cakupan itu: output adalah
Plugin "formatter@my-marketplace" is already installed (scope: project)dan kode keluar adalah0 - Anda menolak prompt sumber perintah: output adalah
Aborted.dan kode keluar adalah1 - Anda menolak prompt
headersHelper, atau tidak dapat dikonfirmasi tanpa TTY: output adalahAborted — the command was not run.dan kode keluar adalah1
Format hasil JSON
Ketika Anda melewatkan--json ke plugin install, baris terakhir stdout adalah satu objek JSON. Parsing hanya baris itu, karena Claude Code mencetak perintah apa pun yang dideklarasikan marketplace sebelumnya.
Tiga field selalu ada:
command: subperintah yang berjalan, sepertiinstalloutcome:okataufailedmessage: deskripsi hasil yang dapat dibaca manusia
pluginId, scope, dan failureCode, muncul hanya ketika berlaku.
Kesalahan penggunaan, seperti --scope yang tidak valid, tidak mencetak baris hasil dan keluar 1 dengan alasan di stderr.
Terima perintah instal yang ditampilkan
Ketika run--json menampilkan perintah yang dideklarasikan marketplace dan tidak menjalankannya, hasil failed juga membawa objek shownCommand. Fieldnya mencakup perintah seperti yang ditampilkan, plugin yang dimilikinya, dan sha256 perintah.
Untuk menerima perintah yang tepat itu, jalankan kembali dengan sha256 itu sebagai --accept-command dari terminal Anda sendiri, karena flag tidak memiliki efek di dalam sesi Claude Code. Memerlukan Claude Code v2.1.271 atau lebih baru.
sha256 dihitung sebagai penerimaan untuk perintah, plugin, dan katalog marketplace yang tepat. Jika salah satu dari mereka berubah sejak perintah ditampilkan, Claude Code tidak menerima sha256 dan menampilkan perintah lagi. Perubahan yang refresh marketplace run sendiri ambil juga dihitung sebagai perubahan seperti itu.
Jika shownCommand.acceptCommandMatched adalah false, sha256 yang Anda lewatkan tidak cocok dengan perintah yang sekarang ditampilkan. Tinjau perintah itu sebelum menjalankan kembali dengan sha256-nya.
plugin uninstall
Hapus plugin yang diinstal dari satu cakupan.remove dan rm adalah alias untuk uninstall.
Copot plugin dari cakupan proyek:
Successfully uninstalled plugin: formatter (scope: project). Ketika plugin tidak diinstal di cakupan itu, perintah mencetak baris yang dimulai Failed to uninstall plugin "formatter@my-marketplace": dan keluar 1.
plugin enable
Aktifkan plugin yang dinonaktifkan. Untuk plugin yang disinkronkan dari claude.ai, lewatkan<name>@synced sebagai plugin.
Tanpa
--scope, perintah memeriksa file pengaturan Anda dalam urutan lokal, proyek, pengguna, dan menggunakan cakupan pertama yang menyebutkan plugin.
Jika Anda melewatkan --scope di mana plugin tidak dideklarasikan, perintah menulis override atau gagal:
- Cakupan yang diutamakan di atas yang mendeklarasikan: Claude Code menulis override di cakupan yang Anda lewatkan. Misalnya,
claude plugin disable formatter --scope localmematikan plugin yang diaktifkan proyek hanya untuk Anda - Cakupan lain: perintah gagal dengan
Plugin "formatter" is installed at project scope, not user. Use --scope project or omit --scope to auto-detect.
Plugin "formatter" is already enabled dan keluar 1. Dengan --json, hasil memiliki "failureCode": "already_in_goal_state" dan "alreadyInGoalState": true, jadi skrip dapat memperlakukan kasus itu sebagai kesuksesan.
Ketika plugin mendeklarasikan dependensi, Claude Code juga mengaktifkannya. Perintah gagal dalam kasus ini:
- Dependensi tidak diinstal: aktifkan gagal dan mencetak perintah
claude plugin installuntuk setiap dependensi yang hilang - Dependensi diblokir oleh kebijakan plugin organisasi Anda: aktifkan gagal dan menamai dependensi yang diblokir
- Dependensi diatur ke
falsedi cakupan dengan prioritas lebih tinggi dari cakupan target: aktifkan gagal. Aktifkan dependensi di cakupan itu, atau lewatkan--scopeuntuk menulis di sana
Successfully enabled plugin: formatter (scope: project), menamai cakupan yang terdeteksi.
plugin disable
Nonaktifkan plugin tanpa mencopot. Untuk plugin yang disinkronkan dari claude.ai, lewatkan<name>@synced sebagai plugin.
Tanpa
--scope, cakupan terdeteksi otomatis dalam urutan lokal, proyek, pengguna yang sama seperti plugin enable.
Jika Anda tidak melewatkan nama plugin atau --all, Claude Code mencetak Please specify a plugin name or use --all to disable all plugins dan keluar 1. Menonaktifkan plugin yang sudah dinonaktifkan mencetak Plugin "formatter" is already disabled dan keluar 1, seperti yang dilakukan plugin enable untuk plugin yang sudah diaktifkan.
Perintah gagal untuk plugin yang masih diperlukan:
- Plugin yang diaktifkan lain bergantung pada itu: perintah gagal dan menamai dependennya untuk dinonaktifkan terlebih dahulu
- Organisasi Anda memerlukannya sebagai plugin yang disinkronkan: perintah gagal dan tidak menyimpan apa pun
Successfully disabled plugin: formatter (scope: project).
plugin update
Perbarui plugin ke versi terbaru yang ditawarkan marketplacenya. Versi baru dimuat dalam sesi berikutnya Anda, atau setelah Anda menjalankan/reload-plugins di sesi yang sedang berjalan.
managed adalah satu-satunya cakupan yang dapat Anda perbarui tetapi tidak instal. Untuk plugin yang diinstal admin, lihat Kelola plugin untuk organisasi Anda.
Perbarui plugin:
Checking for updates for plugin "formatter@my-marketplace"…, kemudian hasilnya. Ketika tidak ada yang lebih baru, mencetak formatter is already at the latest version (1.0.0). dan keluar 0.
Anda dapat melewatkan nama plugin telanjang, yang dicocokkan perintah terhadap plugin yang diinstal. Ketika plugin yang diinstal dari marketplace berbeda berbagi nama, perintah menolak pembaruan dan mencantumkan perintah plugin-name@marketplace-name yang memenuhi syarat untuk dijalankan. Memperbarui dengan nama telanjang memerlukan Claude Code v2.1.246 atau lebih baru.
plugin list
Daftar plugin yang diinstal dengan versi, cakupan, dan status mereka.
Claude Code mengelompokkan output yang dapat dibaca manusia berdasarkan cara setiap plugin dimuat:
Installed plugins:: plugin yang Anda instal dari marketplaceSession-only plugins (--plugin-dir / --plugin-url):: plugin yang dimuat oleh flag itu dalam perintah yang sama, seperti dalamclaude --plugin-dir ./my-plugin plugin listSkills-directory plugins (.claude/skills/*):: plugin yang Claude Code temukan di direktori skillsSynced from claude.ai: plugin yang disinkronkan dari akun claude.ai Anda
No plugins installed. Use `claude plugin install` to install a plugin.
Output JSON
Dengan--json, Claude Code mencetak array dengan satu objek per instalasi. Setiap objek membawa field di bawah. id, version, scope, enabled, dan installPath selalu ada, dan yang lain muncul hanya ketika berlaku.
Dengan
--json --available, Claude Code mencetak satu objek alih-alih array. Field installed-nya memegang array objek plugin yang diinstal, dan field available-nya memegang satu objek per plugin marketplace yang tidak diinstal dengan field di bawah.
plugin details
Tampilkan inventaris komponen plugin dan biaya token proyeksiannya. Plugin harus dimuat: diinstal, ditemukan di direktori skills, atau dilewatkan dengan--plugin-dir atau --plugin-url dalam perintah yang sama. <name> adalah plugin name atau name@marketplace.
--help.
Tampilkan apa yang disumbangkan plugin yang diinstal:
Component inventory: skills, agents, hooks, server MCP, dan server LSP pluginProjected token cost: token yang selalu aktif yang ditambahkan plugin ke setiap sesiPer-component (rounded): perkiraan selalu aktif dan on-invoke untuk setiap skill, agent, dan perintah. Dihilangkan ketika plugin tidak memiliki
Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk. dan keluar 1.
plugin prune
Hapus dependensi yang diinstal otomatis yang tidak diperlukan plugin yang diinstal lagi. Perintah tidak pernah menghapus plugin yang Anda instal sendiri.autoremove adalah alias untuk prune.
Pratinjau apa yang akan dihapus prune:
(dry run — nothing removed). Tanpa yang dihapus, mencetak baris yang dimulai Nothing to prune.
Tanpa --dry-run, perintah menghapus dependensi yatim piatu hanya setelah Anda mengonfirmasi di prompt atau melewatkan -y.
Kode keluar adalah 0 apa pun yang Anda jawab di prompt.
Apa yang dilakukan prune tergantung pada apakah terminal terpasang dan apakah Anda melewatkan -y:
plugin eval
Jalankan kasus eval plugin dan laporkan hasil yang dinilai. Memerlukan Claude Code v2.1.269 atau lebih baru. Setiap kasus adalah prompt plus grader. Claude Code menjalankannya beberapa kali dalam sesi terisolasi dengan hanya plugin target yang dimuat, dan secara default juga tanpa plugin sehingga laporan menunjukkan perbedaannya. Lihat Uji plugin dengan eval untuk format kasus, grader, hasil, dan penggunaan CI.target opsional default ke direktori saat ini dan mengambil salah satu bentuk ini:
- Direktori plugin
- File
prompt.mdataucase.yamltunggal - Plugin yang diinstal sebagai
nameatauname@marketplace name@skills-dir
--tag, --allow-tools, dan --json. Setiap opsi ini mengambil kata-kata yang mengikutinya sebagai nilainya, jadi target yang ditulis setelah salah satu dari mereka dibaca sebagai tag, nama alat, atau jalur output JSON alih-alih sebagai target.
Tabel ini mencantumkan opsi yang paling banyak digunakan run. Jalankan claude plugin eval --help untuk set lengkap, termasuk --case, --tag, --output-dir, --report, --allow-real-servers, --keep-temp, dan --verbose.
Kode keluar melaporkan bagaimana run berakhir. Untuk bertindak atas itu dalam pipeline, lihat Jalankan eval dalam CI.
plugin eval init
Buat suite eval untuk plugin di direktori saat ini. Memerlukan Claude Code v2.1.269 atau lebih baru. Lihat Buat suite eval pertama Anda.- Membaca plugin
- Menanyakan apa yang harus dilakukan dengan baik
- Mengusulkan kasus dan grader
- Menulis file kasus
- Menjalankan kasus dan meninjau nilai dengan Anda untuk memeriksa bahwa grader mencetak cara Anda
--bare, atau tanpa terminal, perintah menulis template kasus tunggal kosong. Ketika Claude menjalankan perintah dari dalam sesi Claude Code, perintah mencetak instruksi wawancara untuk sesi itu ikuti daripada menulis template.
name opsional adalah nama kasus. Diperlukan dengan --bare atau tanpa terminal, karena perintah menulis template kosong untuk kasus itu. Wawancara tidak memerlukan.
Perintah menerima opsi ini:
plugin tag
Buat tag git beranotasi bernama<name>--v<version> untuk rilis plugin. Sebelum menandai, perintah memeriksa bahwa plugin.json plugin dan entri marketplace apa pun yang mencantumkannya setuju pada versi.
Untuk kapan menandai rilis, lihat Terbitkan plugin.
[path] adalah direktori plugin, default ke direktori saat ini. Perintah menemukan entri marketplace dengan berjalan naik dari direktori itu ke .claude-plugin/marketplace.json yang mencantumkan plugin.
Pratinjau tag untuk plugin dalam checkout marketplace:
- Nama plugin
- Versi dan file mana asalnya
- Entri marketplace yang cocok, ketika ada
- Nama tag
- Perintah
git tagdangit pushyang akan dijalankan
--dry-run, Claude Code mencetak Created tag formatter--v1.0.0 dan baik Pushed to origin atau perintah push untuk dijalankan sendiri. Jika push gagal, tag masih dibuat secara lokal dan perintah keluar dengan kesalahan.
Perintah keluar 1 dan mencetak alasan ketika tidak dapat menandai dengan aman. Alasan umum adalah:
- Tidak ada
versiondiplugin.jsonatau entri marketplace - Tag sudah ada
- Pohon kerja kotor
plugin validate
Validasi manifest plugin, manifest marketplace, atau skills, agents, dan perintah dalam direktori, dan keluar dengan kode yang dapat ditindaklanjuti pekerjaan CI. Untuk alur kerja buat, uji, dan edit, lihat Buat plugin. Untuk apa yang diperiksa validator di setiap manifest, lihat referensi manifest plugin dan referensi marketplace.
Validasi plugin sebelum melakukan:
Validasi direktori
<path> adalah file manifest atau direktori. Diberikan direktori, Claude Code memilih apa yang akan divalidasi oleh apa yang ditemukannya di sana:
.claude-plugin/marketplace.json, ketika ada- Sebaliknya
.claude-plugin/plugin.json - Sebaliknya file komponen, dipilih oleh nama direktori. Memvalidasi file komponen tanpa manifest memerlukan Claude Code v2.1.233 atau lebih baru:
- Direktori bernama
skills,agents, ataucommands: file di dalamnya - Direktori bernama
.claude: direktoriskills,agents, dancommandsdi dalamnya - Direktori lain: tiga direktori itu di bawah
.claude-nya
- Direktori bernama
- Direktori
skills,agents, ataucommandsyang tertaut di bawah root plugin atau.claude: Claude Code memperingatkan bahwa tidak ada yang di dalamnya dibaca. - Entri tertaut di dalam direktori
skills,agents, ataucommands: Claude Code melewatinya dan memperingatkan, per direktori, berapa banyak entri yang dilewati yang akan dimuat sesi. - Direktori
skills,agents, ataucommandsyang Anda beri nama adalah symlink sendiri, atau direktori.claudeinduknya: Claude Code melaporkan kesalahan dan tidak memeriksa apa pun di dalamnya. Beri nama direktori nyata.
SKILL.mddi root plugin: ketika Anda menjalankanclaude plugin validateterhadap direktori plugin, Claude Code tidak memeriksaSKILL.mddi root pluginCLAUDE.mddi root plugin: dalam run plugin, Claude Code juga memperingatkan tentangCLAUDE.mddi root plugin- File plugin dalam run marketplace: dari direktori marketplace, Claude Code tidak membuka file skill, agent, command, atau hook plugin. Untuk menemukan kesalahan di file itu, validasi setiap direktori plugin
Output dan kode keluar
Claude Code mencetak file yang divalidasi, kesalahan dan peringatan apa pun dengan jalurnya, dan baris putusan. Kode keluar mengikuti putusan:
Dengan
--json, Claude Code menulis laporan ke stdout sebagai satu objek JSON dengan field tingkat atas ini:
success: putusan yang sama yang diberikan kode keluarstrict: apakah run memperlakukan peringatan sebagai kesalahantarget: jalur yang diselesaikan Claude Code divalidasimanifest: hasil manifest sendiri, ataunulluntuk run tanpa manifestcontents: hasil per-file, masing-masing menamaifile-nya dan membawa arrayerrors,warnings, dannotes
2, perintah tidak menulis apa pun ke stdout. Pesan kesalahan pergi ke stderr.
Perintah claude plugin marketplace
Jalankanclaude plugin marketplace <subcommand> dari shell Anda untuk menambah, mencantumkan, menyegarkan, dan menghapus marketplace yang Anda instal plugin.
- Kode keluar: subperintah ini mengikuti konvensi kode keluar perintah plugin
- Cakupan: flag
--scopemereka tidak memiliki bentuk pendek-s
plugin marketplace add
Tambahkan marketplace dari repositori GitHub, URL git,marketplace.json yang dihosting, atau jalur lokal, dan deklarasikan dalam file pengaturan.
Setelah menambahkannya, Claude Code menginstal dependensi apa pun yang hilang dari plugin yang diinstal.
<source> mengambil salah satu bentuk dalam tabel di bawah, dan bentuknya memutuskan tipe sumber dan cara Claude Code mengambil marketplace. Untuk objek sumber yang dihasilkan, lihat referensi marketplace.
Untuk host yang URL klonnya tidak membawa akhiran
.git, seperti AWS CodeCommit, tambahkan marketplace sebagai entri git dalam extraKnownMarketplaces. Claude Code mengkloning entri git apakah atau tidak URL-nya berakhir dengan .git.
Claude Code juga mengkloning URL gitlab.com dengan subgrup bersarang, seperti https://gitlab.com/group/subgroup/project.
Tambahkan marketplace dan bagikan dengan proyek:
Successfully added marketplace: your-marketplace (declared in project settings), menggunakan name dari manifest marketplace sendiri. Penambahan berulang atau sumber yang tidak valid mencetak salah satu hasil ini:
- Marketplace sudah di disk: output adalah
Marketplace 'your-marketplace' already on disk — declared in project settingsdan kode keluar adalah0 - Sumber yang tidak dikenali: output adalah
Invalid marketplace source format. Try: owner/repo, https://..., or ./pathdan kode keluar adalah1 - Host telanjang seperti
gitlab.example.com/team/plugins: penambahan gagal sebagai shorthandowner/repoyang tidak valid, dan pesan memberi tahu Anda untuk menambahkanhttps://atau menggunakan jalur lokal
From claude.ai: dari claude plugin marketplace list:
--claudeai, perintah menolak --scope dan --sparse. Marketplace dihosting untuk akun Anda, bukan dideklarasikan dalam file pengaturan, jadi Anda tidak dapat membagikannya melalui .claude/settings.json proyek.
plugin marketplace list
Daftar setiap marketplace yang telah Anda tambahkan, dengan sumbernya.
Claude Code mencetak
Configured marketplaces: dan satu baris Source: per marketplace, atau No marketplaces configured.
Dengan --json, Claude Code mencetak array dengan satu objek per marketplace, membawa field di bawah. Setiap field adalah string.
Marketplace claude.ai yang ditambahkan tidak memiliki kloning lokal, jadi entrinya membawa pengidentifikasi claude.ai-nya,
marketplaceId dan organizationUuid, sebagai pengganti installLocation. Juga membawa scope ketika satu dicatat, dan status.
Jika sesi terminal Anda menyinkronkan plugin dari akun claude.ai Anda, daftar teks berakhir dengan bagian From claude.ai:. Bagian itu menamai marketplace yang claude.ai daftar untuk akun Anda yang belum Anda tambahkan, baik berbasis git maupun dihosting. Memerlukan Claude Code v2.1.273 atau lebih baru.
Untuk menambahkan marketplace dari bagian itu, lihat Tambahkan marketplace dari claude.ai.
Output --json mencakup marketplace yang dikonfigurasi saja dan meninggalkan bagian.
plugin marketplace remove
Hapus deklarasi marketplace dari pengaturan Anda.rm adalah alias untuk remove.
<name> adalah nama marketplace yang ditunjukkan plugin marketplace list, bukan sumber yang Anda lewatkan ke add.
Hapus marketplace dari setiap cakupan:
Successfully removed marketplace: your-marketplace, menambahkan (from project settings) ketika Anda membatasi cakupannya. Jika Anda membatasi ke file pengaturan yang tidak mendeklarasikan marketplace, perintah gagal dengan Marketplace 'your-marketplace' is not declared in project settings. Omit --scope to remove it from all scopes.
plugin marketplace update
Segarkan satu marketplace, atau setiap marketplace, dari sumbernya untuk mengambil plugin dan versi baru. Marketplace yang ditambahkan dengan cabang atau tagref diperbarui ke commit terbaru dari ref itu, bukan cabang default repositori.
--help.
Segarkan satu marketplace:
Successfully updated marketplace: your-marketplace. Ketika Anda menghilangkan nama, mencetak hitungan seperti Successfully updated 2 marketplaces. Tanpa marketplace yang ditambahkan, mencetak No marketplaces configured dan keluar 0.
/plugin dalam sesi
Di dalam sesi interaktif,/plugin membuka panel plugin. Setiap subperintah membuka panel di tab, menjalankan tindakan di sana, atau mencetak hasil inline. /plugins dan /marketplace adalah alias untuk /plugin.
Anda hanya dapat menjalankan perintah ini dalam sesi terminal interaktif. Dalam run non-interaktif seperti claude -p, Claude Code menjawab bahwa /plugin tidak tersedia di lingkungan ini.
Untuk permukaan mana yang memiliki /plugin, cara menginstal tanpanya, dan apa yang ditunjukkan setiap tab panel, lihat Instal dan kelola plugin.
<plugin> adalah plugin name atau name@marketplace.
Tabel di bawah mencantumkan setiap bentuk sesi. Subperintah shell init, update, details, prune, eval, dan eval init tidak memiliki bentuk sesi.
Jika Anda menamai plugin yang tidak diinstal dalam proyek saat ini dalam
/plugin enable, disable, uninstall, atau configure, Claude Code mencetak Plugin "<plugin>" is not installed in this project alih-alih bertindak.
/reload-plugins
Terapkan perubahan plugin yang tertunda ke sesi yang sedang berjalan tanpa memulai ulang. Perubahan yang tertunda adalah plugin yang Anda instal, perbarui, aktifkan, nonaktifkan, atau edit di disk sejak sesi dimulai. Ketika Anda menutup panel/plugin dengan perubahan yang tertunda yang Anda buat di dalamnya, Claude Code menjalankan /reload-plugins untuk Anda. Jalankan sendiri setelah perubahan plugin yang terjadi di luar panel, seperti perintah claude plugin yang Anda jalankan di terminal lain.
Ringkasan reload
Claude Code memuat ulang setiap plugin aktif dan mencetak satu baris ringkasan,Reloaded: N plugins · N skills · N agents · N hooks · N plugin MCP servers · N plugin LSP servers, menghilangkan hitungan server MCP plugin dalam sesi tanpa terminal interaktif. Ketika plugin apa pun gagal, ringkasan menambahkan N errors during load. Run /plugin for details.
Hitungan skills mencakup setiap skill yang disediakan plugin, baik entri commands/ maupun skill SKILL.md. Hitungan agents adalah jumlah agen yang dimuat dalam sesi, termasuk yang tidak berasal dari plugin.
Ketika dependensi plugin yang dimuat ulang hilang, Claude Code menginstalnya, memuat ulang lagi, dan menambahkan (+ N dependencies: <names>) resolved ke ringkasan.
Reload yang mengubah alat MCP
Ketika reload akan menambah atau menghapus server MCP plugin atau alatLSP, dan perubahan itu akan membatalkan cache prompt, Claude Code tidak menerapkan reload. Mencetak baris seperti This reload changes MCP tools (<server>) — your next message will re-read the whole conversation instead of using the cache. Run /reload-plugins --force to apply. Lewatkan --force untuk menerapkannya.
Sesi tanpa terminal interaktif
/reload-plugins juga berjalan dalam sesi tanpa terminal interaktif, seperti aplikasi desktop, Agent SDK, dan mode non-interaktif dengan -p. Memerlukan Claude Code v2.1.260 atau lebih baru.
Dalam sesi itu, perintah berjalan hanya ketika Anda mengetiknya ke dalam sesi sendiri, seperti dalam prompt -p atau kotak prompt aplikasi desktop. Ketika tiba dengan cara lain, seperti melalui Remote Control atau pesan yang disalurkan dari Slack, perintah menjawab /reload-plugins isn't available over a remote connection in this session. dan memuat ulang tidak ada.
Reload dalam sesi itu tidak menghubungkan atau memutuskan server MCP plugin. Perubahan itu berlaku dalam sesi berikutnya Anda.
Flag yang memuat plugin untuk satu sesi
Dua flagclaude memuat plugin untuk satu sesi saja, tanpa menginstalnya. Keduanya dapat diulang.
Penulis plugin menggunakannya untuk menguji plugin sebelum menerbitkan. Untuk alur kerja muat-edit-muat ulang, lihat Kembangkan tanpa marketplace.
Plugin yang dimuat flag apa pun adalah plugin hanya sesi.
claude plugin list menampilkannya sebagai <name>@inline dengan cakupan session, tetapi hanya ketika flag yang sama mendahului subperintah. Misalnya, jalankan claude --plugin-dir ./my-plugin plugin list.
Ketika plugin hanya sesi berbagi nama dengan plugin yang diinstal, Claude Code memuat salinan hanya sesi untuk sesi itu dan melewati yang diinstal. Salinan yang diinstal memuat sebagai gantinya jika Anda menonaktifkan salinan hanya sesi dengan claude plugin disable <name>@inline, atau jika pengaturan terkelola mengunci nama plugin itu. Untuk prioritas, lihat Referensi pemuatan plugin.
Administrator dapat menolak kedua flag, dan folder yang dinamai dalam variabel CLAUDE_CODE_PLUGIN_DIRS, dengan pengaturan terkelola disableSideloadFlags. Claude Code kemudian mencetak bahwa flag dinonaktifkan oleh pengaturan terkelola organisasi Anda dan keluar 1 tanpa memulai.
Dari Agent SDK, opsi plugins adalah setara dengan --plugin-dir.
Langkah berikutnya
- Instal dan kelola plugin: operasi yang sama seperti langkah, dengan apa yang Anda lihat di setiap
- Referensi pemuatan plugin: apa yang diubah setiap perintah di disk dan cakupan mana yang berlaku
- Troubleshoot plugin: pesan kesalahan instal, marketplace, muat, dan validasi dengan perbaikannya
- Referensi manifest plugin: field yang diperiksa
claude plugin validate