Marketplace plugin - Claude Docs

Marketplace plugin adalah katalog plugin yang tersedia yang memudahkan untuk menemukan, menginstal, dan mengelola ekstensi Claude Code. Panduan ini menunjukkan cara menggunakan marketplace yang sudah ada dan membuat marketplace Anda sendiri untuk distribusi tim.

Gambaran Umum

Marketplace adalah file JSON yang mencantumkan plugin yang tersedia dan menjelaskan di mana menemukannya. Marketplace menyediakan:

Penemuan terpusat: Jelajahi plugin dari berbagai sumber di satu tempat
Manajemen versi: Lacak dan perbarui versi plugin secara otomatis
Distribusi tim: Bagikan plugin yang diperlukan di seluruh organisasi Anda
Sumber fleksibel: Dukungan untuk repositori git, repo GitHub, jalur lokal, dan manajer paket

Prasyarat

Claude Code terinstal dan berjalan
Keakraban dasar dengan format file JSON
Untuk membuat marketplace: Repositori Git atau lingkungan pengembangan lokal

Menambahkan dan menggunakan marketplace

Tambahkan marketplace menggunakan perintah /plugin marketplace untuk mengakses plugin dari berbagai sumber:

Menambahkan marketplace GitHub

Tambahkan repositori GitHub yang berisi .claude-plugin/marketplace.json

/plugin marketplace add owner/repo

Menambahkan repositori Git

Tambahkan repositori git apa pun

/plugin marketplace add https://gitlab.com/company/plugins.git

Menambahkan marketplace lokal untuk pengembangan

Tambahkan direktori lokal yang berisi .claude-plugin/marketplace.json

/plugin marketplace add ./my-marketplace

Tambahkan jalur langsung ke file marketplace.json

/plugin marketplace add ./path/to/marketplace.json

Tambahkan marketplace.json remote melalui URL

/plugin marketplace add https://url.of/marketplace.json

Menginstal plugin dari marketplace

Setelah Anda menambahkan marketplace, instal plugin secara langsung:

Instal dari marketplace yang dikenal

/plugin install plugin-name@marketplace-name

Jelajahi plugin yang tersedia secara interaktif

/plugin

Memverifikasi instalasi marketplace

Setelah menambahkan marketplace:

Daftar marketplace: Jalankan /plugin marketplace list untuk mengonfirmasi bahwa marketplace telah ditambahkan
Jelajahi plugin: Gunakan /plugin untuk melihat plugin yang tersedia dari marketplace Anda
Uji instalasi: Coba instal plugin untuk memverifikasi bahwa marketplace berfungsi dengan benar

Mengonfigurasi marketplace tim

Siapkan instalasi marketplace otomatis untuk proyek tim dengan menentukan marketplace yang diperlukan di .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    },
    "project-specific": {
      "source": {
        "source": "git",
        "url": "https://git.company.com/project-plugins.git"
      }
    }
  }
}

Ketika anggota tim mempercayai folder repositori, Claude Code secara otomatis menginstal marketplace ini dan plugin apa pun yang ditentukan dalam field enabledPlugins.

Membuat marketplace Anda sendiri

Bangun dan distribusikan koleksi plugin kustom untuk tim atau komunitas Anda.

Prasyarat untuk pembuatan marketplace

Repositori Git (GitHub, GitLab, atau hosting git lainnya)
Pemahaman format file JSON
Satu atau lebih plugin untuk didistribusikan

Membuat file marketplace

Buat .claude-plugin/marketplace.json di root repositori Anda:

{
  "name": "company-tools",
  "owner": {
    "name": "DevTools Team",
    "email": "[email protected]"
  },
  "plugins": [
    {
      "name": "code-formatter",
      "source": "./plugins/formatter",
      "description": "Pemformatan kode otomatis saat menyimpan",
      "version": "2.1.0",
      "author": {
        "name": "DevTools Team"
      }
    },
    {
      "name": "deployment-tools",
      "source": {
        "source": "github",
        "repo": "company/deploy-plugin"
      },
      "description": "Alat otomasi deployment"
    }
  ]
}

Skema marketplace

Field yang diperlukan

Field	Tipe	Deskripsi
`name`	string	Pengenal marketplace (kebab-case, tanpa spasi)
`owner`	object	Informasi pengelola marketplace
`plugins`	array	Daftar plugin yang tersedia

Metadata opsional

Field	Tipe	Deskripsi
`metadata.description`	string	Deskripsi singkat marketplace
`metadata.version`	string	Versi marketplace
`metadata.pluginRoot`	string	Jalur dasar untuk sumber plugin relatif

Entri plugin

Entri plugin didasarkan pada skema manifes plugin (dengan semua field dibuat opsional) ditambah field khusus marketplace (source, category, tags, strict), dengan name sebagai field yang diperlukan.

Field yang diperlukan:

Field	Tipe	Deskripsi
`name`	string	Pengenal plugin (kebab-case, tanpa spasi)
`source`	string\|object	Dari mana mengambil plugin

Field plugin opsional

Field metadata standar:

Field	Tipe	Deskripsi
`description`	string	Deskripsi singkat plugin
`version`	string	Versi plugin
`author`	object	Informasi penulis plugin
`homepage`	string	URL beranda atau dokumentasi plugin
`repository`	string	URL repositori kode sumber
`license`	string	Pengenal lisensi SPDX (misalnya, MIT, Apache-2.0)
`keywords`	array	Tag untuk penemuan dan kategorisasi plugin
`category`	string	Kategori plugin untuk organisasi
`tags`	array	Tag untuk kemudahan pencarian
`strict`	boolean	Memerlukan plugin.json di folder plugin (default: true) ¹

Field konfigurasi komponen:

Field	Tipe	Deskripsi
`commands`	string\|array	Jalur kustom ke file atau direktori perintah
`agents`	string\|array	Jalur kustom ke file agen
`hooks`	string\|object	Konfigurasi hooks kustom atau jalur ke file hooks
`mcpServers`	string\|object	Konfigurasi server MCP atau jalur ke konfigurasi MCP

^{1 - Ketika strict: true (default), plugin harus menyertakan file manifes plugin.json, dan field marketplace melengkapi nilai-nilai tersebut. Ketika strict: false, plugin.json bersifat opsional. Jika tidak ada, entri marketplace berfungsi sebagai manifes plugin lengkap.}

Sumber plugin

Jalur relatif

Untuk plugin dalam repositori yang sama:

{
  "name": "my-plugin",
  "source": "./plugins/my-plugin"
}

Repositori GitHub

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

Repositori Git

{
  "name": "git-plugin",
  "source": {
    "source": "url",
    "url": "https://gitlab.com/team/plugin.git"
  }
}

Entri plugin lanjutan

Entri plugin dapat mengganti lokasi komponen default dan menyediakan metadata tambahan. Perhatikan bahwa ${CLAUDE_PLUGIN_ROOT} adalah variabel lingkungan yang menyelesaikan ke direktori instalasi plugin (untuk detail lihat Variabel lingkungan):

{
  "name": "enterprise-tools",
  "source": {
    "source": "github",
    "repo": "company/enterprise-plugin"
  },
  "description": "Alat otomasi alur kerja enterprise",
  "version": "2.1.0",
  "author": {
    "name": "Enterprise Team",
    "email": "[email protected]"
  },
  "homepage": "https://docs.company.com/plugins/enterprise-tools",
  "repository": "https://github.com/company/enterprise-plugin",
  "license": "MIT",
  "keywords": ["enterprise", "workflow", "automation"],
  "category": "productivity",
  "commands": [
    "./commands/core/",
    "./commands/enterprise/",
    "./commands/experimental/preview.md"
  ],
  "agents": [
    "./agents/security-reviewer.md",
    "./agents/compliance-checker.md"
  ],
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [{"type": "command", "command": "${CLAUDE_PLUGIN_ROOT}/scripts/validate.sh"}]
      }
    ]
  },
  "mcpServers": {
    "enterprise-db": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"]
    }
  },
  "strict": false
}

Hubungan skema: Entri plugin menggunakan skema manifes plugin dengan semua field dibuat opsional, ditambah field khusus marketplace (source, strict, category, tags). Ini berarti field apa pun yang valid dalam file plugin.json juga dapat digunakan dalam entri marketplace. Ketika strict: false, entri marketplace berfungsi sebagai manifes plugin lengkap jika tidak ada plugin.json. Ketika strict: true (default), field marketplace melengkapi file manifes plugin itu sendiri.

Hosting dan mendistribusikan marketplace

Pilih strategi hosting terbaik untuk kebutuhan distribusi plugin Anda.

Hosting di GitHub (direkomendasikan)

GitHub menyediakan metode distribusi termudah:

Buat repositori: Siapkan repositori baru untuk marketplace Anda
Tambahkan file marketplace: Buat .claude-plugin/marketplace.json dengan definisi plugin Anda
Bagikan dengan tim: Anggota tim menambahkan dengan /plugin marketplace add owner/repo

Keuntungan: Kontrol versi bawaan, pelacakan masalah, dan fitur kolaborasi tim.

Hosting di layanan git lainnya

Layanan hosting git apa pun berfungsi untuk distribusi marketplace, menggunakan URL ke repositori git arbitrer. Misalnya, menggunakan GitLab:

/plugin marketplace add https://gitlab.com/company/plugins.git

Menggunakan marketplace lokal untuk pengembangan

Uji marketplace Anda secara lokal sebelum distribusi:

Tambahkan marketplace lokal untuk pengujian

/plugin marketplace add ./my-local-marketplace

Uji instalasi plugin

/plugin install test-plugin@my-local-marketplace

Mengelola operasi marketplace

Daftar marketplace yang dikenal

Daftar semua marketplace yang dikonfigurasi

/plugin marketplace list

Menampilkan semua marketplace yang dikonfigurasi dengan sumber dan statusnya.

Memperbarui metadata marketplace

Segarkan metadata marketplace

/plugin marketplace update marketplace-name

Menyegarkan daftar plugin dan metadata dari sumber marketplace.

Menghapus marketplace

Hapus marketplace

/plugin marketplace remove marketplace-name

Menghapus marketplace dari konfigurasi Anda.

Menghapus marketplace akan menghapus instalasi plugin apa pun yang Anda instal darinya.

Pemecahan masalah marketplace

Masalah marketplace umum

Marketplace tidak memuat

Gejala: Tidak dapat menambahkan marketplace atau melihat plugin darinya Solusi:

Verifikasi bahwa URL marketplace dapat diakses
Periksa bahwa .claude-plugin/marketplace.json ada di jalur yang ditentukan
Pastikan sintaks JSON valid menggunakan claude plugin validate
Untuk repositori pribadi, konfirmasi Anda memiliki izin akses

Kegagalan instalasi plugin

Gejala: Marketplace muncul tetapi instalasi plugin gagal Solusi:

Verifikasi URL sumber plugin dapat diakses
Periksa bahwa direktori plugin berisi file yang diperlukan
Untuk sumber GitHub, pastikan repositori bersifat publik atau Anda memiliki akses
Uji sumber plugin secara manual dengan mengkloning/mengunduh

Validasi dan pengujian

Uji marketplace Anda sebelum dibagikan:

Validasi sintaks JSON marketplace

claude plugin validate .

Tambahkan marketplace untuk pengujian

/plugin marketplace add ./path/to/marketplace

Instal plugin uji

/plugin install test-plugin@marketplace-name

Untuk alur kerja pengujian plugin lengkap, lihat Uji plugin Anda secara lokal. Untuk pemecahan masalah teknis, lihat Referensi plugin.

Langkah selanjutnya

Untuk pengguna marketplace

Temukan marketplace komunitas: Cari GitHub untuk koleksi plugin Claude Code
Berikan umpan balik: Laporkan masalah dan sarankan perbaikan kepada pengelola marketplace
Bagikan marketplace yang berguna: Bantu tim Anda menemukan koleksi plugin yang berharga

Untuk pembuat marketplace

Bangun koleksi plugin: Buat marketplace bertema seputar kasus penggunaan spesifik
Tetapkan versioning: Implementasikan kebijakan versioning dan pembaruan yang jelas
Keterlibatan komunitas: Kumpulkan umpan balik dan pertahankan komunitas marketplace yang aktif
Dokumentasi: Sediakan file README yang jelas menjelaskan konten marketplace Anda

Untuk organisasi

Marketplace pribadi: Siapkan marketplace internal untuk alat proprietary
Kebijakan tata kelola: Tetapkan pedoman untuk persetujuan plugin dan tinjauan keamanan
Sumber daya pelatihan: Bantu tim menemukan dan mengadopsi plugin yang berguna secara efektif

Lihat juga

Plugin - Menginstal dan menggunakan plugin
Referensi plugin - Spesifikasi teknis dan skema lengkap
Pengembangan plugin - Membuat plugin Anda sendiri
Pengaturan - Opsi konfigurasi plugin

Memulai

Bangun dengan Claude Code

Claude Code SDK

Penerapan

Administrasi

Konfigurasi

Referensi

Sumber Daya

​Gambaran Umum

​Prasyarat

​Menambahkan dan menggunakan marketplace

​Menambahkan marketplace GitHub

​Menambahkan repositori Git

​Menambahkan marketplace lokal untuk pengembangan

​Menginstal plugin dari marketplace

​Memverifikasi instalasi marketplace

​Mengonfigurasi marketplace tim

​Membuat marketplace Anda sendiri

​Prasyarat untuk pembuatan marketplace

​Membuat file marketplace

​Skema marketplace

​Field yang diperlukan

​Metadata opsional

​Entri plugin

​Field plugin opsional

​Sumber plugin

​Jalur relatif

​Repositori GitHub

​Repositori Git

​Entri plugin lanjutan

​Hosting dan mendistribusikan marketplace

​Hosting di GitHub (direkomendasikan)

​Hosting di layanan git lainnya

​Menggunakan marketplace lokal untuk pengembangan

​Mengelola operasi marketplace

​Daftar marketplace yang dikenal

​Memperbarui metadata marketplace

​Menghapus marketplace

​Pemecahan masalah marketplace

​Masalah marketplace umum

​Marketplace tidak memuat

​Kegagalan instalasi plugin

​Validasi dan pengujian

​Langkah selanjutnya

​Untuk pengguna marketplace

​Untuk pembuat marketplace

​Untuk organisasi

​Lihat juga

Gambaran Umum

Prasyarat

Menambahkan dan menggunakan marketplace

Menambahkan marketplace GitHub

Menambahkan repositori Git

Menambahkan marketplace lokal untuk pengembangan

Menginstal plugin dari marketplace

Memverifikasi instalasi marketplace

Mengonfigurasi marketplace tim

Membuat marketplace Anda sendiri

Prasyarat untuk pembuatan marketplace

Membuat file marketplace

Skema marketplace

Field yang diperlukan

Metadata opsional

Entri plugin

Field plugin opsional

Sumber plugin

Jalur relatif

Repositori GitHub

Repositori Git

Entri plugin lanjutan

Hosting dan mendistribusikan marketplace

Hosting di GitHub (direkomendasikan)

Hosting di layanan git lainnya

Menggunakan marketplace lokal untuk pengembangan

Mengelola operasi marketplace

Daftar marketplace yang dikenal

Memperbarui metadata marketplace

Menghapus marketplace

Pemecahan masalah marketplace

Masalah marketplace umum

Marketplace tidak memuat

Kegagalan instalasi plugin

Validasi dan pengujian

Langkah selanjutnya

Untuk pengguna marketplace

Untuk pembuat marketplace

Untuk organisasi

Lihat juga