SpyBara
Go Premium

plugins/overview.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 34 additions and 34 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Wed 14 22:58 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59 Wed 28 23:57

Ikhtisar plugin

Pahami apa itu plugin Claude Code, kapan Anda membutuhkannya daripada skill mandiri atau server MCP, dan halaman mana yang harus dibaca untuk memasang atau membuat satu.

Plugin Claude Code adalah direktori skill, agent, hooks, server MCP, atau komponen lainnya yang Claude Code pasang dan muat sebagai satu unit. Sebagian besar plugin berasal dari marketplace, yang merupakan katalog yang mencantumkan plugin dan tempat mengambil masing-masing. Anda juga dapat memuat plugin dari folder yang diberikan seseorang kepada Anda, atau membangun plugin Anda sendiri.

[!NOTE]

Kasus-kasus berikut dibahas di halaman lain:

Untuk mencoba plugin sekarang, jalankan /plugin dalam sesi terminal Claude Code dan pasang satu dari tab Discover, yang mencantumkan plugin dari marketplace Anda. Dari sana:

Pahami apa itu plugin

Plugin adalah direktori komponen, biasanya dengan manifes. Manifes, file JSON di .claude-plugin/plugin.json, memberikan nama plugin dan dapat menambahkan versi, deskripsi, dan metadata lainnya. Komponen adalah apa yang ditambahkan plugin ke Claude Code, seperti:

  • Skills: instruksi SKILL.md yang Claude muat saat relevan, dan yang juga dapat Anda jalankan sebagai perintah
  • Agents: definisi subagent yang dapat didelegasikan Claude
  • Hooks: perintah yang dijalankan Claude Code pada titik dalam siklus hidupnya, seperti setelah setiap edit
  • Modul hook: hook yang ditulis sebagai fungsi JavaScript, yang juga dapat menggambar pane dan menambahkan perintah. Plugin yang memiliki satu disebut mod. Beberapa mod sudah terpasang di Claude Code.
  • MCP servers: server alat yang terhubung dengan Claude Code saat plugin diaktifkan

Diagram ini menunjukkan plugin bernama my-plugin yang menyimpan skill, agent, hooks, dan server MCP, dan apa yang Anda dapatkan dari setiap file setelah plugin dimuat.

Diagram dalam dua kolom yang digabungkan oleh lima panah lurus. Di sebelah kiri, direktori plugin bernama my-plugin, menyimpan manifes di .claude-plugin/plugin.json, skills/review/SKILL.md, agents/reviewer.md, hooks/hooks.json, .mcp.json, dan komponen lainnya. Di sebelah kanan, apa yang diberikan setiap file dalam sesi Anda: manifes menetapkan nama plugin, my-plugin; skill berjalan sebagai /my-plugin:review; file agent adalah subagent yang dapat didelegasikan Claude; file hooks menyimpan hook yang berjalan pada acara siklus hidup; dan .mcp.json menambahkan server MCP yang memberikan alat Claude.

Untuk setiap jenis komponen yang dapat disimpan plugin, dengan contoh masing-masing, lihat Plugin components. Untuk melihat di mana setiap bagian berada dalam direktori plugin, gunakan plugin explorer di halaman itu.

Tentukan apakah Anda membutuhkan plugin

Skills, subagent, hooks, dan server MCP semuanya bekerja sendiri, tanpa plugin. Skill yang Anda simpan di ~/.claude/skills/, misalnya, tersedia di setiap proyek di mesin Anda. Untuk menyiapkan satu sendiri, lihat Skills, Subagents, Hooks, atau MCP.

Gunakan plugin ketika Anda ingin beberapa skill, subagent, hooks, atau server MCP dikemas sebagai satu unit. Pasang satu untuk mendapatkan setup yang dibangun orang lain, dengan satu perintah dan pembaruan dari marketplace-nya. Buat satu untuk memberikan setup Anda sendiri kepada rekan kerja, pasang di banyak proyek, atau terbitkan rilis yang diberi versi.

Apa yang ditambahkan plugin yang diaktifkan ke sesi Anda

Plugin yang diaktifkan adalah bagian dari setiap sesi, bukan hanya sesi tempat Anda menggunakannya. Itu memiliki beberapa konsekuensi yang patut diketahui sebelum Anda memasang satu:

  • Konteks dan penggunaan: untuk setiap skill, agent, dan perintah yang dapat dijalankan Claude sendiri, nama dan deskripsi ada dalam konteks Claude di setiap giliran sehingga Claude tahu itu ada. Token tersebut dihitung menuju penggunaan Anda dan meninggalkan lebih sedikit ruang di jendela konteks bahkan dalam sesi di mana tidak ada yang dari plugin berjalan. Teks lengkap skill atau agent dimuat hanya saat digunakan. Apa yang ditambahkan server MCP plugin per giliran mengikuti pencarian alat MCP.
  • Proses: server MCP yang didefinisikan plugin berjalan bersama setiap sesi tempat plugin diaktifkan, dan hook-nya menyala pada acara mereka.
  • Izin: apa yang dijalankan plugin, dijalankan sebagai Anda. Lihat Plugin security and trust untuk apa yang harus ditinjau terlebih dahulu.

Anda dapat memeriksa jejak plugin di setiap tahap:

  • Sebelum Anda memasang: buka plugin dari tab Marketplaces di /plugin. Plugin di marketplace resmi Anthropic menunjukkan perkiraan Context cost di sana.
  • Setelah Anda memasang: Measure what a plugin costs menunjukkan cara membaca jejak plugin, dan grup Not used recently tab Installed mencantumkan plugin yang dapat Anda matikan.
  • Untuk menghentikannya tanpa mencopot: nonaktifkan plugin dengan /plugin atau, di shell Anda, claude plugin disable. Lihat Manage installed plugins.

Dapatkan plugin dari marketplace

Marketplace adalah repositori atau direktori dengan file .claude-plugin/marketplace.json yang mencantumkan plugin dan tempat mengambil masing-masing. Ini adalah katalog, bukan toko yang dihosting. Anda menambahkan marketplace sekali, kemudian memasang plugin darinya berdasarkan nama, seperti commit-commands@claude-plugins-official.

[!NOTE]

Marketplace plugin bukanlah Claude Marketplace. Claude Marketplace adalah situs web di claude.com/marketplace tempat Anda menjelajahi plugin, konektor, produk mitra, dan mitra layanan. Ini bukan marketplace yang Anda tambahkan dengan /plugin marketplace add.

Claude Code menambahkan marketplace resmi Anthropic pertama kali Anda memulai sesi terminal interaktif, kecuali kebijakan terkelola memblokir. Claude Code tidak menambahkan marketplace komunitas dan demo Anthropic sendiri. Untuk membedakan tiga marketplace Anthropic, baca Anthropic's marketplaces. Untuk melihat apa yang dicantumkan marketplace resmi, buka tab Discover dari /plugin dalam sesi atau jelajahi Claude Marketplace.

Diagram ini menunjukkan jalur dari marketplace ke sesi Anda. Marketplace mencantumkan plugin, Anda memasang plugin itu, dan Claude Code memuat komponen-komponennya.

Diagram jalur marketplace dalam tiga kotak, kiri ke kanan. Marketplace, katalog plugin, mencantumkan plugin. Plugin adalah satu direktori yang dipasang sebagai unit, menyimpan skill, agent, hooks, server MCP, dan komponen lainnya. Anda memasang plugin ke Claude Code, yang memuat komponen-komponennya.

Install and manage plugins memiliki langkah pemasangan untuk setiap tempat Anda menjalankan Claude Code. Saat Anda mengembangkan plugin, Anda tidak memerlukan marketplace: muat langsung dari foldernya dengan --plugin-dir, seperti yang ditunjukkan Develop without a marketplace.

Buat plugin yang dipasang tersedia dalam sesi Anda

Sebelum plugin yang Anda pasang memberikan Anda skill yang dapat Anda jalankan, plugin harus ada di setiap lapisan ini:

  • Settings: pengaturan Anda mencantumkan marketplace yang telah Anda tambahkan dan plugin yang diaktifkan.
  • Disk: ~/.claude/plugins/ menyimpan apa yang telah diambil dan dipasang Claude Code.
  • Session: plugin dimuat saat startup, atau ketika Anda reload plugins.

Baca Plugin loading reference untuk aturan di setiap lapisan, termasuk file pengaturan mana yang memiliki prioritas dan di mana file berada di disk.

Bedakan marketplace Anthropic dari yang pihak ketiga

Nama marketplace menempatkannya di salah satu dari tiga tingkat. Claude Code menerima nama resmi dan komunitas hanya untuk marketplace yang bersumber dari repositori github.com/anthropics/:

  • Official: marketplace dengan salah satu nama marketplace resmi Anthropic, termasuk claude-plugins-official dan marketplace demo claude-code-plugins.
  • Community: marketplace dengan salah satu nama komunitas Anthropic, seperti claude-community. Identify Anthropic's marketplaces by name mencantumkan mereka.
  • Third-party: setiap marketplace lainnya. Marketplace yang diterbitkan rekan kerja atau organisasi Anda adalah pihak ketiga.

Apa pun tingkatnya, plugin yang Anda pasang dapat menjalankan kode dengan hak istimewa pengguna Anda. Baca Plugin security and trust untuk cara meninjau plugin sebelum Anda memasangnya.

Melalui pengaturan terkelola, organisasi dapat membuat daftar putih atau memblokir marketplace, memaksa pemasangan plugin, dan mematikan pemuatan hanya-sesi. Baca Manage plugins for your organization untuk kontrol tersebut.

Pahami cakupan pemasangan

Ketika Anda memasang plugin, Anda memilih cakupan, dan cakupan menentukan siapa plugin diaktifkan untuk:

  • User scope: diaktifkan untuk Anda di setiap proyek di komputer ini
  • Project scope: diaktifkan untuk semua orang yang bekerja di repositori ini, melalui .claude/settings.json yang berkomitmen. Setiap kolaborator masih memasangnya di mesin mereka sendiri
  • Local scope: diaktifkan untuk Anda di repositori ini saja

Plugin yang Anda pasang di cakupan pengguna di terminal, sesi lokal aplikasi desktop, atau ekstensi VS Code tersedia di dua lainnya di komputer itu, karena ketiganya membaca file pengaturan yang sama. Lihat Choose an install scope untuk cara memilih satu.

Sesi cloud, termasuk satu di browser di claude.ai/code, tidak memuat plugin dalam pengaturan lokal Anda. Untuk langkah pemasangan di terminal, VS Code, dan aplikasi desktop, dan untuk apa yang dimuat sesi cloud, lihat Install a plugin.

[!NOTE]

Format plugin yang sama juga dipasang di claude.ai dan di Cowork, di mana set komponen yang berbeda dimuat. Untuk permukaan tersebut, lihat Plugins on claude.ai and in Cowork di claude.com dan tabel dukungan komponennya.

Langkah berikutnya

Sebagian besar orang mulai dengan memasang plugin dari marketplace resmi Anthropic, yang ditambahkan Claude Code pertama kali Anda memulai sesi terminal interaktif. Jalankan /plugin dalam sesi terminal untuk menjelajahinya, atau ikuti Install and manage plugins, yang juga mencakup aplikasi desktop dan VS Code. Untuk melihat apa yang ada di marketplace itu sebelum Anda membuka Claude Code, jelajahi Claude Marketplace di web.

Untuk membangun plugin Anda sendiri, Create a plugin dimulai dengan direktori kosong dan berakhir dengan plugin yang berfungsi.

Setelah Anda memasang atau membangun plugin, halaman-halaman ini mencakup apa yang akan datang: