Skip to main content
Menginstal plugin menambahkan skills, agents, hooks, dan MCP servers-nya ke Claude Code di mesin Anda. Halaman ini untuk siapa pun yang menggunakan plugin di mesin atau akun mereka sendiri, baik di terminal, aplikasi desktop, IDE, atau sesi cloud: ini mencakup instalasi, memilih cakupan, menambahkan marketplace, dan menjaga plugin tetap terbaru.
Kasus-kasus ini tercakup di halaman lain:
Mulai dengan Instal plugin. Jika seseorang mengirimkan Anda perintah instalasi yang nama @-nya bukan claude-plugins-official, tambahkan marketplace itu terlebih dahulu.

Instal plugin

Sebagai contoh, bagian ini menginstal commit-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.
Mulai Claude Code dengan claude di proyek Anda, kemudian:
1

Buka detail plugin dengan perintah instalasi

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.
Untuk menjelajahi sebagai gantinya, jalankan /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.
Plugin dari marketplace lokal atau kustom dapat menunjukkan 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
Pilih cakupan instalasi mengatakan file pengaturan mana yang ditulis masing-masing dan mana yang berlaku ketika plugin yang sama diatur di lebih dari satu.Setelah Anda memilih cakupan, Claude Code menginstal plugin bersama dengan dependensi apa pun yang dideklarasikannya, kemudian mencetak ringkasan instalasi.
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 --force untuk mengaktifkannya bagaimanapun, yang biaya satu permintaan uncached.
  • Load failed: The plugin couldn't be loaded. Buka tab Errors di /plugin untuk 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 baris Version, Scope, dan Status.
Jika /commit-commands:commit tidak muncul, lihat After install: plugin not working.
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 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 enabledPlugins di ~/.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.
Beberapa plugin diatur oleh penulis mereka untuk mulai dimatikan, melalui bidang 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 -p dan non-interactive runs lainnya: /plugin tidak 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 perintah claude plugin.
  • Agent SDK: muat plugin melalui opsi plugin SDK. Lihat Load plugins in the Agent SDK.
Jika Claude Code melaporkan bahwa plugin yang diaktifkan di .claude/settings.json repository tidak diinstal, lihat Enabled in project settings but not installed.
Jika Anda adalah penulis plugin yang menguji salinan plugin Anda di disk, mulai Claude Code dari shell Anda dengan --plugin-dir untuk memuatnya untuk satu sesi alih-alih menginstalnya. Lihat Flags that load a plugin for one session.

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 /plugin dan claude plugin list di 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 /plugin atau claude plugin install tetap di mesin ini dan tidak ditambahkan ke akun claude.ai Anda.
Untuk waktu sinkronisasi, persyaratan sign-in, dan mematikan sinkronisasi, lihat Plugins synced from claude.ai.

Instal dari shell Anda

Jalankan claude plugin install di shell Anda untuk menginstal plugin tanpa memulai sesi Claude Code, misalnya dari skrip setup.
  • Scope: cakupan pengguna secara default. Lewatkan --scope project atau --scope local untuk mengubahnya.
  • When the plugins load: plugin yang diinstalnya memuat lain kali Anda memulai Claude Code, atau ketika Anda menjalankan /reload-plugins dalam 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-official sebelum instalasi.
Perintah mencetak 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.
/plugin market juga berfungsi sebagai bentuk lebih pendek dari /plugin marketplace.
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.
Sumber mengambil bentuk yang sama seperti /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, atau git-credential-store berfungsi. Prompt interaktif ditekan, jadi host yang belum pernah Anda autentikasi gagal alih-alih meminta kata sandi.
  • SSH: host harus sudah ada di file known_hosts Anda dan kunci harus berfungsi tanpa prompt passphrase, karena prompt host-fingerprint dan passphrase juga ditekan.
  • GitHub owner/repo shorthand: Claude Code memeriksa apakah kunci SSH Anda mengautentikasi ke github.com, kemudian mengklonnya melalui SSH jika ya dan melalui HTTPS jika tidak. Atur CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1 untuk melewati pemeriksaan itu dan selalu mengklonnya melalui HTTPS.
Kredensial yang sama berlaku ketika Anda menjalankan /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 /plugin dan 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 bagian From claude.ai:. Kemudian jalankan claude plugin marketplace add dengan bendera --claudeai dan nama yang ditampilkan dalam daftar.
Misalnya, perintah ini menambahkan marketplace bernama claudeai-organization-library:
Claude Code mendaftarkan marketplace di bawah nama lokal yang dimulai dengan 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.
Tab juga dapat menunjukkan plugin di cakupan Managed. Organisasi Anda menginstal mereka melalui pengaturan terkelola, dan Anda tidak dapat mengaktifkan, menonaktifkan, atau mencopot mereka di sini. Untuk plugin yang disinkronkan yang organisasi Anda perlukan di claude.ai, lihat Manage plugins synced from claude.ai. Ketika Anda menutup panel /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.
Ketika Claude Code menyinkronkan plugin yang ditambahkan, diperbarui, atau dihapus ke sesi interaktif, Anda melihat 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 false untuk plugin di .claude/settings.local.json Anda dan meninggalkannya diinstal untuk proyek.
  • Uninstall for everyone: tekan u. Claude Code menghapus plugin dari .claude/settings.json bersama.

Lihat apa yang ditambahkan plugin yang diinstal ke sesi Anda

Di shell Anda, jalankan claude 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 prune di shell Anda; lihat plugin prune.
Jika Anda memuat plugin dengan --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, jalankan claude 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:
  • enable dan disable bertindak pada cakupan paling spesifik yang pengaturannya sudah mencantumkan plugin.
  • install dan uninstall bertindak pada cakupan pengguna.
Misalnya, perintah ini menonaktifkan dan mengaktifkan kembali plugin, kemudian mencopotnya di cakupan proyek:

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 melihat Plugin updated: <name> · Run /reload-plugins to apply, dan sesi berikutnya memuat versi baru secara otomatis. Ini adalah default auto-update untuk setiap jenis marketplace: Untuk kapan auto-update berjalan, plugin mana yang dilewati, dan variabel lingkungan yang mematikannya, lihat When auto-update runs.

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