Kasus-kasus ini tercakup di halaman lain:
- Anda menggunakan claude.ai chat atau Cowork, bukan Claude Code: lihat Plugins on claude.ai and in Cowork
- Claude Code mencetak error: temukan di Troubleshoot plugins
@-nya bukan claude-plugins-official, tambahkan marketplace itu terlebih dahulu.
Instal plugin
Sebagai contoh, bagian ini menginstalcommit-commands dari marketplace resmi Anthropic, yang menambahkan perintah untuk commit, push, dan membuka pull request.
Langkah yang sama menginstal plugin lain apa pun: ganti namanya dan nama marketplace-nya di mana pun commit-commands dan claude-plugins-official muncul. Jika plugin itu berasal dari marketplace yang berbeda, tambahkan marketplace terlebih dahulu.
Pilih tab untuk tempat Anda menjalankan Claude Code.
- Terminal
- Desktop app
- VS Code
- Cloud session
Mulai Claude Code dengan Menginstal dari marketplace lain apa pun memerlukan satu langkah ekstra terlebih dahulu: tambahkan marketplace. Claude Code menambahkan marketplace resmi Anthropic untuk Anda pertama kali Anda memulai sesi terminal interaktif, itulah mengapa contoh melewati langkah itu. Jika Anda menemukan plugin di claude.com/marketplace, tombol Claude Code-nya menyalin perintah instalasi dalam bentuk shell-nya,
claude di proyek Anda, kemudian:1
Buka detail plugin dengan perintah instalasi
Jalankan Untuk menjelajahi sebagai gantinya, jalankan
/plugin install dengan nama plugin dan marketplace. Dalam sesi, perintah ini tidak langsung menginstal: ini membuka panel /plugin pada detail plugin itu sehingga Anda dapat meninjau dan memilih cakupan terlebih dahulu./plugin tanpa nama plugin: panel membuka pada tab Discover, yang mencantumkan plugin dari setiap marketplace yang telah Anda tambahkan, dan Anda dapat mengetik untuk mencari, kemudian tekan Enter pada plugin untuk membuka detailnya.2
Tinjau apa yang ditambahkan plugin
Panel detail menunjukkan deskripsi plugin. Ini juga dapat menunjukkan:
- Will install: perintah, agents, skills, hooks, dan MCP dan LSP servers yang ditambahkan plugin.
- Last updated: ditampilkan untuk plugin di marketplace resmi Anthropic.
- Context cost: untuk plugin di marketplace resmi Anthropic, dua perkiraan token. Every turn adalah apa yang ditambahkan plugin ke setiap pesan yang Anda kirim, dan When invoked adalah apa yang ditambahkan skills dan agents-nya setelah Claude memuatnya. Perkiraan muncul ketika Anda membuka plugin dengan menamai marketplace-nya, seperti yang dilakukan perintah langkah 1, atau dari tab Marketplaces. Panel detail yang Anda capai dari daftar Discover tidak menunjukkannya.
Components will be discovered at installation sebagai gantinya.Plugin dapat menjalankan hooks dan MCP servers, jadi baca panel sebelum Anda menginstal. Lihat Plugin security and trust.3
Pilih cakupan
Pilih salah satu dari tiga opsi instalasi:
- Install for you (user scope): Anda mendapatkan plugin di setiap proyek di mesin ini
- Install for all collaborators on this repository (project scope): ini diaktifkan untuk semua orang yang bekerja di repository ini
- Install for you, in this repo only (local scope): Anda mendapatkannya di repository ini saja
4
Baca ringkasan instalasi
Kalimat terakhir ringkasan memberi tahu Anda apakah plugin dapat digunakan dalam sesi ini:
- Active now:
Plugin is now active.Tidak perlu reload. - Reload needed:
Run /reload-plugins to activate.Panel ditutup dan Claude Code menjalankan reload itu untuk Anda. Jika reload akan membatalkan prompt cache, itu memperingatkan dan meninggalkan plugin tertunda sebagai gantinya. Jalankan/reload-plugins --forceuntuk mengaktifkannya bagaimanapun, yang biaya satu permintaan uncached. - Load failed:
The plugin couldn't be loaded. Buka tab Errors di/pluginuntuk alasannya, kemudian lihat After install: plugin not working.
5
Konfirmasi plugin berfungsi
Ketik
/ dan cari skills plugin di bawah namanya, dalam bentuk /<plugin>:<skill>. Untuk commit-commands, /commit-commands:commit muncul. Dua tempat lain juga mencantumkan plugin:- Buka tab Installed di
/plugin, yang mencantumkan plugin dengan cakupannya. - Di shell Anda, jalankan
claude plugin list, yang mencetak daftar yang sama dengan barisVersion,Scope, danStatus.
/commit-commands:commit tidak muncul, lihat After install: plugin not working.claude plugin install <name>@claude-plugins-official.Pilih cakupan instalasi
Cakupan instalasi plugin memutuskan siapa yang mendapatkan plugin dan file pengaturan mana yang mencatat sebagai diaktifkan:- User scope: plugin diaktifkan untuk Anda di setiap proyek di mesin ini. Entri masuk di
enabledPluginsdi~/.claude/settings.json. - Project scope: plugin diaktifkan untuk semua orang yang bekerja di repository ini. Entri masuk di
.claude/settings.json, yang Anda commit. - Local scope: plugin diaktifkan untuk Anda di repository ini saja. Entri masuk di
.claude/settings.local.json.
defaultEnabled. Plugin seperti itu diinstal tetapi tetap mati sampai Anda mengaktifkannya dengan claude plugin enable <name> di shell Anda, atau dari tab Installed dari /plugin dalam sesi.
Ketika plugin yang sama diatur di beberapa cakupan, pengaturan lokal menimpa pengaturan proyek, dan pengaturan proyek menimpa pengaturan pengguna. Lihat Find where a plugin is enabled untuk aturan lengkapnya.
Terminal, sesi lokal aplikasi desktop, dan ekstensi VS Code di satu komputer membaca file pengaturan yang sama, jadi plugin yang Anda instal di cakupan pengguna di salah satu dari mereka tersedia di dua lainnya.
JetBrains, non-interactive runs, dan Agent SDK
Beberapa tempat Anda menjalankan Claude Code tidak memiliki browser plugin mereka sendiri:- JetBrains IDEs: plugin JetBrains menjalankan Claude Code di terminal IDE, jadi gunakan langkah-langkah tab Terminal di sana.
claude -pdan non-interactive runs lainnya:/plugintidak berjalan, dan Claude menjawab/plugin isn't available in this environment.Plugin yang sudah Anda instal memang memuat. Instal dan kelola dari shell Anda dengan perintahclaude plugin.- Agent SDK: muat plugin melalui opsi plugin SDK. Lihat Load plugins in the Agent SDK.
.claude/settings.json repository tidak diinstal, lihat Enabled in project settings but not installed.
Plugin dari akun claude.ai Anda
Akun claude.ai Anda adalah sumber plugin terpisah, bersama dengan marketplace yang Anda instal dari:- What arrives: setiap plugin yang Anda aktifkan untuk akun claude.ai Anda, dan setiap plugin yang organisasi Anda aktifkan untuk anggotanya. Dalam sesi terminal mereka disinkronkan di latar belakang setiap kali Anda memulai Claude Code sambil masuk dengan akun itu; dalam sesi Cowork mereka diunduh ketika sesi dimulai.
- Where you see them: di
/plugindanclaude plugin listdi bawah ID<name>@synced. Anda dapat mematikan satu di cakupan Anda sendiri kecuali organisasi Anda memerlukannya. - What doesn’t go the other way: plugin yang Anda instal dengan
/pluginatauclaude plugin installtetap di mesin ini dan tidak ditambahkan ke akun claude.ai Anda.
Instal dari shell Anda
Jalankanclaude plugin install di shell Anda untuk menginstal plugin tanpa memulai sesi Claude Code, misalnya dari skrip setup.
- Scope: cakupan pengguna secara default. Lewatkan
--scope projectatau--scope localuntuk mengubahnya. - When the plugins load: plugin yang diinstalnya memuat lain kali Anda memulai Claude Code, atau ketika Anda menjalankan
/reload-pluginsdalam sesi yang sudah terbuka. - The marketplace must be added first: di mesin di mana tidak ada yang telah membuka sesi Claude Code interaktif, marketplace resmi tidak terdaftar, jadi skrip yang menginstal darinya menjalankan
claude plugin marketplace add anthropics/claude-plugins-officialsebelum instalasi.
Successfully installed plugin: formatter@your-org (scope: project) ketika selesai.
Beberapa plugin menginstal dengan menjalankan perintah yang dinamai marketplace mereka, disebut sumber command. Claude Code menunjukkan perintah itu kepada Anda dan meminta Anda menerimanya sebelum berjalan. Skrip tidak memiliki siapa pun untuk menjawab prompt itu, jadi lewatkan --yes di sana untuk menerimanya.
Untuk setiap bendera claude plugin install, lihat plugin install.
Tambahkan marketplace
Anda hanya memerlukan bagian ini ketika plugin yang Anda inginkan tidak ada di marketplace resmi Anthropic, misalnya satu yang diterbitkan rekan kerja atau satu dari marketplace komunitas Anthropic. Marketplace adalah katalog plugin, dan Claude Code harus tahu tentang marketplace sebelum Anda dapat menginstal darinya. Anda menambahkan marketplace sekali. Setelah itu, plugin-nya muncul di tab Discover dan menginstal dengan/plugin install <plugin>@<marketplace> dalam sesi atau claude plugin install <plugin>@<marketplace> di shell Anda, di mana <marketplace> adalah nama yang didaftarkan marketplace. Untuk melakukan keduanya dalam satu langkah, lihat Add a marketplace and install in one command.
Dalam sesi Claude Code, jalankan /plugin marketplace add diikuti oleh sumber marketplace: repository GitHub, repository git di host apa pun, direktori atau file lokal, atau marketplace.json yang dihosting.
Dari shell Anda,
claude plugin marketplace add mengambil sumber yang sama.
Sertakan awalan https:// pada setiap URL, atau gunakan bentuk git@host:path untuk SSH. Jika Anda mengetik gitlab.example.com/your-group/your-marketplace.git telanjang, Claude Code membacanya sebagai shorthand GitHub owner/repo dan menolaknya.
Ketika perintah berhasil, itu mencetak Successfully added marketplace: <name>, dan plugin marketplace muncul di tab Discover lain kali Anda membuka /plugin, tanpa reload diperlukan. Jika gagal, cocokkan pesan error di Troubleshoot plugins.
Tambahkan marketplace dan instal dalam satu perintah
Untuk menginstal plugin dari marketplace yang belum Anda tambahkan, jalankan/plugin install dalam sesi Claude Code dan namai sumber marketplace dengan --marketplace. Memerlukan Claude Code v2.1.275 atau lebih baru.
/plugin marketplace add, seperti GitHub owner/repo, URL git, atau jalur lokal, kecuali bahwa tidak dapat berisi spasi. Berikan nama plugin sendiri, tanpa akhiran @marketplace.
Jika Anda belum menambahkan marketplace itu, Claude Code menunjukkan sumber yang diselesaikan dan meminta Anda mengonfirmasi sebelum menambahkannya. Setelah marketplace ditambahkan, detail plugin membuka dan Anda memilih cakupan instalasi. Jika sumber cocok dengan marketplace yang sudah Anda tambahkan, Claude Code melewati konfirmasi dan membuka detail plugin di marketplace itu.
Tambahkan marketplace pribadi
Marketplace pribadi adalah satu di repository yang Anda butuhkan kredensial untuk clone, di GitHub atau host git apa pun. Anda menambahkannya dengan perintah/plugin marketplace add atau claude plugin marketplace add yang sama seperti yang publik. Claude Code mengklonnya dengan kredensial git yang sudah ada di mesin Anda dan tidak pernah meminta, jadi setiap cara koneksi memiliki persyaratan:
- HTTPS: pembantu kredensial git Anda berlaku, jadi akses yang Anda atur dengan
gh auth login, Keychain macOS, ataugit-credential-storeberfungsi. Prompt interaktif ditekan, jadi host yang belum pernah Anda autentikasi gagal alih-alih meminta kata sandi. - SSH: host harus sudah ada di file
known_hostsAnda dan kunci harus berfungsi tanpa prompt passphrase, karena prompt host-fingerprint dan passphrase juga ditekan. - GitHub
owner/reposhorthand: Claude Code memeriksa apakah kunci SSH Anda mengautentikasi kegithub.com, kemudian mengklonnya melalui SSH jika ya dan melalui HTTPS jika tidak. AturCLAUDE_CODE_PLUGIN_PREFER_HTTPS=1untuk melewati pemeriksaan itu dan selalu mengklonnya melalui HTTPS.
/plugin install, /plugin marketplace update, dan claude plugin update.
Di host GitHub Enterprise Server, lihat Plugin marketplaces on GHES untuk kredensial yang dibutuhkan setiap operasi.
Jika organisasi Anda mendaftarkan marketplace untuk Anda melalui pengaturan terkelola, Anda tidak menambahkannya sendiri. Lihat Pre-install and require plugins.
Tambahkan marketplace dari claude.ai
Dalam sesi terminal di mana plugin disinkronkan dari akun claude.ai Anda, claude.ai juga dapat mencantumkan marketplace plugin untuk Anda, seperti perpustakaan plugin organisasi Anda dan unggahan claude.ai Anda sendiri. Anda menambahkan salah satu dari ini dengan namanya daripada oleh sumber. Menambahkan marketplace dari claude.ai memerlukan Claude Code v2.1.273 atau lebih baru. Tambahkan marketplace claude.ai dari panel/plugin atau dari shell Anda:
- Inside a session: jalankan
/plugindan buka tab Marketplaces, yang mencantumkan marketplace dari claude.ai. Pilih satu di sana untuk menambahkannya. - From your shell: jalankan
claude plugin marketplace list, yang mencetaknya di bagianFrom claude.ai:. Kemudian jalankanclaude plugin marketplace adddengan bendera--claudeaidan nama yang ditampilkan dalam daftar.
claudeai-organization-library:
claudeai-, berasal dari nama yang tercantum claude.ai. Misalnya, marketplace yang tercantum sebagai “Organization library” menjadi claudeai-organization-library. Instal plugin-nya dengan nama itu, misalnya dengan claude plugin install <plugin>@claudeai-organization-library.
Jika Anda keluar, atau masuk ke organisasi claude.ai yang berbeda, marketplace tetap dikonfigurasi tetapi tidak menunjukkan plugin, dan plugin yang sudah Anda instal darinya terus memuat.
Bagian From claude.ai: juga dapat mencantumkan marketplace berbasis git yang dibagikan melalui claude.ai, dan itu mencetak sumber untuk masing-masing. Tambahkan mereka dengan sumber itu seperti di Add a marketplace, bukan dengan --claudeai.
Kelola plugin yang diinstal
Tab Installed di/plugin mencantumkan plugin Anda dengan tindakan untuk mengaktifkan, menonaktifkan, memperbarui, atau mencopot masing-masing. Dalam sesi Claude Code, jalankan /plugin dan tekan Tab untuk mencapainya, atau jalankan /plugin enable, /plugin disable, atau /plugin uninstall untuk membuka panel dan membuat perubahan itu di sana. Plugin yang dinonaktifkan dikelompokkan di bawah header yang diciutkan di bagian bawah daftar. Gunakan kunci ini di daftar:
- Ketik untuk memfilter berdasarkan nama atau deskripsi.
- Tekan Space untuk mengaktifkan atau menonaktifkan plugin yang dipilih, dan f untuk menyukainya.
- Tekan Enter untuk membuka detail plugin. Menu di sana menawarkan Disable plugin atau Enable plugin, Update now, dan Uninstall. Plugin yang mengambil pengaturan juga menawarkan Configure options.
/plugin dengan perubahan tertunda yang Anda buat di dalamnya, Claude Code menjalankan /reload-plugins untuk Anda untuk menerapkannya. Jika reload akan membatalkan prompt cache, itu memperingatkan dan meninggalkan perubahan tertunda sebagai gantinya. Jalankan /reload-plugins --force untuk menerapkannya bagaimanapun.
Kelola plugin yang disinkronkan dari claude.ai
Tab Installed di/plugin juga mencantumkan plugin yang disinkronkan dari akun claude.ai Anda, dengan synced sebagai sumber mereka. Plugin yang disinkronkan muncul dalam sesi terminal di Claude Code v2.1.273 atau lebih baru.
- Enable or disable: gunakan tab Installed, kecuali organisasi Anda menandai plugin sebagai diperlukan.
- Remove: matikan plugin di claude.ai.
Plugins changed. Run /reload-plugins to activate. Jalankan /reload-plugins untuk memuat perubahan dalam sesi itu, atau biarkan untuk lain kali Anda memulai Claude Code.
Copot plugin yang diaktifkan proyek
Ketika Anda memilih Uninstall untuk plugin yang diaktifkan repository ini.claude/settings.json, baik dari tab Installed atau dengan /plugin uninstall, Claude Code menanyakan apakah akan menonaktifkannya untuk Anda atau mencopotnya untuk semua orang:
- Disable for me: tekan y. Claude Code menulis
falseuntuk plugin di.claude/settings.local.jsonAnda dan meninggalkannya diinstal untuk proyek. - Uninstall for everyone: tekan u. Claude Code menghapus plugin dari
.claude/settings.jsonbersama.
Lihat apa yang ditambahkan plugin yang diinstal ke sesi Anda
Di shell Anda, jalankanclaude plugin details <name> untuk plugin yang diinstal. Baris Always-on adalah jumlah token yang ditambahkan plugin ke setiap sesi di mana diaktifkan, dan baris per-komponen menunjukkan skill atau agent mana yang berkontribusi paling banyak. Untuk output lengkap dan apa arti setiap angka, lihat Measure what a plugin costs.
Temukan plugin yang tidak lagi Anda gunakan
Di tab Installed di/plugin, plugin yang Anda instal sendiri dan belum digunakan baru-baru ini muncul di bawah header Not used recently, dan detail setiap plugin menunjukkan baris Last used. Gunakan header itu dan baris itu untuk menemukan plugin yang masih menambahkan startup dan context cost, kemudian nonaktifkan atau copot.
Plugin dengan dependensi
Plugin dapat mendeklarasikan plugin lain yang bergantung padanya. Ketika Anda menginstal, menonaktifkan, atau mencopot plugin seperti itu dari marketplace, Claude Code bertindak pada dependensi itu juga:- Install: Claude Code juga menginstal dan mengaktifkan dependensi yang dideklarasikan plugin di cakupan yang sama. Pesan kesuksesan mencantumnya.
- Enable: Claude Code juga mengaktifkan dependensi plugin yang diinstal tetapi dinonaktifkan. Jika dependensi yang dideklarasikan tidak diinstal, enable gagal dan pesan memberi tahu Anda untuk menginstalnya terlebih dahulu.
- Disable: ketika plugin yang diaktifkan lain masih membutuhkan yang Anda namai, Claude Code menolak dan mencetak perintah berantai yang menonaktifkan keduanya dalam urutan yang benar.
- Uninstall: dependensi yang diinstal otomatis tetap sampai Anda menjalankan
claude plugin prunedi shell Anda; lihat plugin prune.
--plugin-dir sebagai gantinya, lihat Test a plugin and its dependency locally.
Kelola plugin dari shell Anda
Anda juga dapat mengelola plugin tanpa memulai sesi Claude Code. Di shell Anda, jalankanclaude plugin install, enable, disable, atau uninstall sebagai perintah terminal biasa; mereka mengubah pengaturan yang sama yang dilakukan panel /plugin. Masing-masing mengambil --scope untuk menargetkan satu cakupan, dan menggunakan cakupan default ketika Anda menghilangkannya:
enabledandisablebertindak pada cakupan paling spesifik yang pengaturannya sudah mencantumkan plugin.installdanuninstallbertindak pada cakupan pengguna.
Jaga plugin tetap terbaru
Plugin memperbarui secara otomatis ketika marketplace yang mereka berasal dari memiliki auto-update diaktifkan. Setelah sesi dimulai, Claude Code menyegarkan marketplace itu dan memperbarui salinan on-disk plugin yang Anda instal darinya. Sesi yang berjalan menyimpan versi yang sudah dimuat. Setelah pembaruan, Anda melihatPlugin updated: <name> · Run /reload-plugins to apply, dan sesi berikutnya memuat versi baru secara otomatis.
Ini adalah default auto-update untuk setiap jenis marketplace:
- On by default:
claude-plugins-officialdan nama marketplace resmi lainnya kecualiknowledge-work-pluginsdanfirst-party-plugins, ditambah marketplace yang ditambahkan dari claude.ai. - Off by default: setiap marketplace lainnya, termasuk marketplace komunitas, marketplace pihak ketiga, dan marketplace pengembangan lokal.
Aktifkan atau matikan auto-update untuk marketplace
Dalam sesi Claude Code, jalankan/plugin dan buka tab Marketplaces. Pilih marketplace, kemudian pilih Enable auto-update atau Disable auto-update.
Perbarui satu plugin sekarang
Dalam sesi, buka plugin di tab Installed di/plugin dan pilih Update now, atau di shell Anda jalankan claude plugin update <plugin>@<marketplace>.
Auto-update dari marketplace pribadi
Untuk marketplace pribadi, lihat What background auto-update does with credentials untuk cara background auto-updates mengautentikasi melalui SSH dan HTTPS, dan Troubleshoot plugins untuk pesan yang Anda lihat ketika mereka gagal.Kelola marketplace
Tab Marketplaces di/plugin mencantumkan setiap marketplace yang Anda daftarkan, bersama dengan sumbernya. Pilih satu untuk menjelajahi plugin-nya, perbarui daftarnya, aktifkan atau matikan auto-update, atau hapusnya.
Anda juga dapat mencantumkan, memperbarui, dan menghapus marketplace dengan perintah, dari shell Anda atau dalam sesi:
Ketika Anda menghapus marketplace, Claude Code mencopot setiap plugin yang Anda instal darinya dan menghapus entri
enabledPlugins mereka dari file pengaturan Anda. Tab Marketplaces menamai plugin itu sebelum meminta Anda mengonfirmasi.
Langkah berikutnya
- Anthropic’s marketplaces: bagaimana marketplace resmi, komunitas, dan demo berbeda dan di mana untuk menjelajahi masing-masing
- Plugin loading reference: mengapa plugin dimuat, tidak dimuat, atau tidak berubah setelah pembaruan
- Plugin security and trust: apa yang harus ditinjau sebelum Anda menginstal plugin dari marketplace yang tidak Anda kenal
- Troubleshoot plugins: instal dan pesan error marketplace dengan perbaikan mereka
- Create a plugin: bangun milik Anda sendiri