Claude Code マーケットプレイスの作り方｜社内配布の手順

自作のプラグインをチームで使ってもらうとき、毎回フォルダを送るのは手間です。更新のたびに配り直すことにもなります。

そこで使うのが マーケットプレイス です。公式ドキュメント「Create a marketplace」（2026年11月7日確認）にもとづいて、作り方と配り方を順番に説明します。プラグインそのものが初めての方は、先に Claude Code のプラグインとは を読んでおくと理解しやすくなります。

結論：一覧ファイル1つを置いたフォルダが「配り場」になる

マーケットプレイスは、.claude-plugin/marketplace.json というファイルがあるフォルダ（またはリポジトリ） です。このファイルに「どのプラグインがあり、それぞれをどこから取るか」を書きます。

フォルダを Git の置き場に上げれば、受け取る人は コマンド1つで登録 し、そこからプラグインを入れられます。作った側が更新すれば、使う人にも新しい版が届きます。

リポジトリは非公開でもよく、載せるプラグインの数にも上限はありません。管理者が 全員のパソコンで必ず使う設定 にすることもできます。

作り方：手元で5ステップ

まず自分のパソコンの中だけで「作る→登録→入れる」を1周します。これは、あとで使う人がたどる流れとまったく同じ なので、ここで動けば配っても動きます。例では、スキルが1つだけ入った my-first-plugin を載せます。

1. フォルダを用意する

マーケットプレイス用のフォルダと、その中の .claude-plugin/ フォルダを作り、プラグインを plugins/ の下にコピーします。

mkdir -p my-marketplace/.claude-plugin my-marketplace/plugins
cp -r my-first-plugin my-marketplace/plugins/

この時点で、プラグイン単体が正しいかを先に確かめておく と、あとで出るエラーがマーケットプレイス側の問題だと切り分けられます。

claude plugin validate ./my-marketplace/plugins/my-first-plugin

最後の行に ✔ Validation passed と出れば大丈夫です。

2. 一覧ファイルを書く

my-marketplace/.claude-plugin/marketplace.json を作ります。必須は name（配り場の名前）・owner（持ち主）・plugins（一覧） の3つ。一覧の1件ずつには name と source が要ります。

{
  "name": "my-marketplace",
  "description": "チーム用のプラグイン",
  "owner": { "name": "Your Name" },
  "plugins": [
    {
      "name": "my-first-plugin",
      "source": "./plugins/my-first-plugin",
      "description": "あいさつを返す練習用プラグイン"
    }
  ]
}

source は .claude-plugin/ が入っているフォルダ（ここでは my-marketplace/）から見た位置 で書きます。ここが後で出てくる失敗のいちばん多い原因です。

3. 一覧ファイルを確かめる

claude plugin validate ./my-marketplace

JSON の書き間違い・必須項目の抜け・一覧の中身をまとめて確かめてくれます。

4. 登録して、プラグインを入れる

claude plugin marketplace add ./my-marketplace
claude plugin install my-first-plugin@my-marketplace

入れるときの名前は 「プラグイン名＠配り場の名前」 です。会話の中からなら /plugin marketplace add と /plugin install でも同じことができます。

5. 読み込まれたか確かめる

claude plugin list
claude plugin details my-first-plugin

一覧に Status: ✔ enabled と出て、詳細の中にスキル名が出れば成功です。会話の中で /my-first-plugin:hello のように、プラグイン名を頭につけて スキルを呼べます。

よくある失敗は2つだけ

公式によると、新しく作ったマーケットプレイスで入れられない原因の多くは、次の2つです。

失敗1：相対パスの起点がずれている

起点は .claude-plugin/ の中ではなく、それを含むフォルダ です。.. で上に出る書き方はしません。

2つ目は validate をすり抜けるので、配る前に必ず自分のパソコンで入れてみる ことが大切です。

失敗2：2つの名前がずれている

プラグインには、一覧ファイルに書く名前と、プラグイン自身の plugin.json に書く名前の2つがあります。

• 一覧ファイルの名前：入れるときに打つ名前。claude plugin list に出る名前
• plugin.json の名前：スキルの頭につく名前。claude plugin details で使う名前

ずれていると「〇〇 が見つからない」と言われて入れられません。2つは同じにしておく のが公式のすすめです。

プラグインの取り寄せ先を選ぶ

一覧の source には、プラグインの置き場に合わせて、いくつかの書き方があります。

Git から取るものは、特定の版に固定することもできます。

直しながら試すコツ

手元のフォルダを相対パスで登録している間は、プラグインのファイルを直すと、次の会話の開始時か /reload-plugins で反映 されます。版の番号を上げる必要はありません。

一から作り直したい時は claude plugin marketplace remove my-marketplace で、登録と入れたプラグインをまとめて外せます。

公開して、チームに配る

手元で入れられたら、フォルダを GitHub などに上げます。上げる前に、他の人と重ならない名前を付けておきます。 同じ名前のマーケットプレイスは、1人が2つ登録できないためです。また、公式の配り場と同じ名前（例：claude-plugins-official）は登録の時点で断られます。

受け取る側は、次の1行で登録し、あとは手順4と同じように入れるだけです。

claude plugin marketplace add <持ち主>/<リポジトリ名>

チームで使う決まりや手順をまとめて配る考え方は、Claude Code のスキル や 設定ファイルの考え方 とあわせて考えると整理しやすくなります。

まとめ

• マーケットプレイスは 一覧ファイル（marketplace.json）を置いたフォルダ
• 作る→validate→自分で入れる を1周してから公開する
• 失敗の多くは「相対パスの起点」と「2つの名前のずれ」。install まで試せば防げる

出典

• Claude Code 公式ドキュメント「Create a marketplace」

この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。