Pasar plugin - Claude Code Docs

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

Ikhtisar

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

Penemuan terpusat: Telusuri 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, repositori GitHub, jalur lokal, dan pengelola paket

Prasyarat

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

Tambahkan dan gunakan pasar

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

Tambahkan pasar GitHub

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

/plugin marketplace add owner/repo

Tambahkan repositori Git

Tambahkan repositori git apa pun

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

Tambahkan pasar 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 jarak jauh melalui URL

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

Pasang plugin dari pasar

Setelah Anda menambahkan pasar, pasang plugin secara langsung:

Pasang dari pasar mana pun yang dikenal

/plugin install plugin-name@marketplace-name

Telusuri plugin yang tersedia secara interaktif

/plugin

Verifikasi instalasi pasar

Setelah menambahkan pasar:

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

Konfigurasikan pasar tim

Atur instalasi pasar otomatis untuk proyek tim dengan menentukan pasar yang diperlukan dalam .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 memasang pasar ini dan plugin apa pun yang ditentukan dalam bidang enabledPlugins.

Buat pasar Anda sendiri

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

Prasyarat untuk pembuatan pasar

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

Buat file pasar

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

{
  "name": "company-tools",
  "owner": {
    "name": "DevTools Team",
    "email": "[email protected]"
  },
  "plugins": [
    {
      "name": "code-formatter",
      "source": "./plugins/formatter",
      "description": "Automatic code formatting on save",
      "version": "2.1.0",
      "author": {
        "name": "DevTools Team"
      }
    },
    {
      "name": "deployment-tools",
      "source": {
        "source": "github",
        "repo": "company/deploy-plugin"
      },
      "description": "Deployment automation tools"
    }
  ]
}

Skema pasar

Bidang yang diperlukan

Bidang	Tipe	Deskripsi
`name`	string	Pengenal pasar (kebab-case, tanpa spasi)
`owner`	object	Informasi pemelihara pasar
`plugins`	array	Daftar plugin yang tersedia

Metadata opsional

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

Entri plugin

Entri plugin didasarkan pada skema manifes plugin (dengan semua bidang dibuat opsional) ditambah bidang khusus pasar (source, category, tags, strict), dengan name menjadi wajib.

Bidang yang diperlukan:

Bidang	Tipe	Deskripsi
`name`	string	Pengenal plugin (kebab-case, tanpa spasi)
`source`	string\|object	Tempat mengambil plugin dari

Bidang plugin opsional

Bidang metadata standar:

Bidang	Tipe	Deskripsi
`description`	string	Deskripsi plugin singkat
`version`	string	Versi plugin
`author`	object	Informasi penulis plugin
`homepage`	string	URL homepage 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 dalam folder plugin (default: true) ¹

Bidang konfigurasi komponen:

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

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

Sumber plugin

Jalur relatif

Untuk plugin di 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 memberikan metadata tambahan. Perhatikan bahwa ${CLAUDE_PLUGIN_ROOT} adalah variabel lingkungan yang diselesaikan ke direktori instalasi plugin (untuk detail lihat Variabel lingkungan):

{
  "name": "enterprise-tools",
  "source": {
    "source": "github",
    "repo": "company/enterprise-plugin"
  },
  "description": "Enterprise workflow automation tools",
  "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 bidang dibuat opsional, ditambah bidang khusus pasar (source, strict, category, tags). Ini berarti bidang apa pun yang valid dalam file plugin.json juga dapat digunakan dalam entri pasar. Ketika strict: false, entri pasar berfungsi sebagai manifes plugin lengkap jika tidak ada plugin.json. Ketika strict: true (default), bidang pasar melengkapi file manifes plugin sendiri.

Host dan distribusikan pasar

Pilih strategi hosting terbaik untuk kebutuhan distribusi plugin Anda.

Host di GitHub (direkomendasikan)

GitHub menyediakan metode distribusi termudah:

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

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

Host di layanan git lainnya

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

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

Gunakan pasar lokal untuk pengembangan

Uji pasar Anda secara lokal sebelum distribusi:

Tambahkan pasar lokal untuk pengujian

/plugin marketplace add ./my-local-marketplace

Uji instalasi plugin

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

Kelola operasi pasar

Daftar pasar yang dikenal

Daftar semua pasar yang dikonfigurasi

/plugin marketplace list

Menampilkan semua pasar yang dikonfigurasi dengan sumber dan statusnya.

Perbarui metadata pasar

Segarkan metadata pasar

/plugin marketplace update marketplace-name

Menyegarkan daftar plugin dan metadata dari sumber pasar.

Hapus pasar

/plugin marketplace remove marketplace-name

Menghapus pasar dari konfigurasi Anda.

Menghapus pasar akan mencopot plugin apa pun yang Anda pasang darinya.

Pemecahan masalah pasar

Masalah pasar umum

Pasar tidak memuat

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

Verifikasi bahwa URL pasar 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 bahwa Anda memiliki izin akses

Kegagalan instalasi plugin

Gejala: Pasar muncul tetapi instalasi plugin gagal Solusi:

Verifikasi bahwa 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 pasar Anda sebelum berbagi:

Validasi sintaks JSON pasar

claude plugin validate .

Tambahkan pasar untuk pengujian

/plugin marketplace add ./path/to/marketplace

Pasang 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 berikutnya

Untuk pengguna pasar

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

Untuk pembuat pasar

Bangun koleksi plugin: Buat pasar bertema di sekitar kasus penggunaan tertentu
Tetapkan versioning: Terapkan kebijakan versioning dan pembaruan yang jelas
Keterlibatan komunitas: Kumpulkan umpan balik dan pertahankan komunitas pasar yang aktif
Dokumentasi: Sediakan file README yang jelas yang menjelaskan konten pasar Anda

Untuk organisasi

Pasar pribadi: Atur pasar 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 - Memasang dan menggunakan plugin
Referensi plugin - Spesifikasi teknis lengkap dan skema
Pengembangan plugin - Membuat plugin Anda sendiri
Pengaturan - Opsi konfigurasi plugin

Administrasi

​Ikhtisar

​Prasyarat

​Tambahkan dan gunakan pasar

​Tambahkan pasar GitHub

​Tambahkan repositori Git

​Tambahkan pasar lokal untuk pengembangan

​Pasang plugin dari pasar

​Verifikasi instalasi pasar

​Konfigurasikan pasar tim

​Buat pasar Anda sendiri

​Prasyarat untuk pembuatan pasar

​Buat file pasar

​Skema pasar

​Bidang yang diperlukan

​Metadata opsional

​Entri plugin

​Bidang plugin opsional

​Sumber plugin

​Jalur relatif

​Repositori GitHub

​Repositori Git

​Entri plugin lanjutan

​Host dan distribusikan pasar

​Host di GitHub (direkomendasikan)

​Host di layanan git lainnya

​Gunakan pasar lokal untuk pengembangan

​Kelola operasi pasar

​Daftar pasar yang dikenal

​Perbarui metadata pasar

​Hapus pasar

​Pemecahan masalah pasar

​Masalah pasar umum

​Pasar tidak memuat

​Kegagalan instalasi plugin

​Validasi dan pengujian

​Langkah berikutnya

​Untuk pengguna pasar

​Untuk pembuat pasar

​Untuk organisasi

​Lihat juga

Ikhtisar

Prasyarat

Tambahkan dan gunakan pasar

Tambahkan pasar GitHub

Tambahkan repositori Git

Tambahkan pasar lokal untuk pengembangan

Pasang plugin dari pasar

Verifikasi instalasi pasar

Konfigurasikan pasar tim

Buat pasar Anda sendiri

Prasyarat untuk pembuatan pasar

Buat file pasar

Skema pasar

Bidang yang diperlukan

Metadata opsional

Entri plugin

Bidang plugin opsional

Sumber plugin

Jalur relatif

Repositori GitHub

Repositori Git

Entri plugin lanjutan

Host dan distribusikan pasar

Host di GitHub (direkomendasikan)

Host di layanan git lainnya

Gunakan pasar lokal untuk pengembangan

Kelola operasi pasar

Daftar pasar yang dikenal

Perbarui metadata pasar

Hapus pasar

Pemecahan masalah pasar

Masalah pasar umum

Pasar tidak memuat

Kegagalan instalasi plugin

Validasi dan pengujian

Langkah berikutnya

Untuk pengguna pasar

Untuk pembuat pasar

Untuk organisasi

Lihat juga