Claude Code のプラグインは、スキル・サブエージェント・フック・MCP サーバーなどを、まとめて入れたり消したりできる仕組みです。
- 入れる：/plugin install 名前@マーケットプレイス、またはシェルで claude plugin install
- 公式のマーケットプレイスは claude-plugins-official
- スコープ：初期値は user（自分の全プロジェクト）。–scope project / local で変える
- 消す：claude plugin uninstall、一時的に止めるなら disable
この記事は、Claude Code の公式ドキュメント（code.claude.com/docs、2026年9月29日に確認）にもとづいています。
手元の確認は、2026年9月29日に Windows 11 の Claude Code 2.1.284 で、練習用のフォルダー（C:\demo\cc-b）を使って行いました。
入っているものを確かめた
claude plugin listNo plugins installed. Use `claude plugin install` to install a plugin.claude plugin marketplace listConfigured marketplaces:
❯ claude-plugins-official
Source: GitHub (anthropics/claude-plugins-official)公式のマーケットプレイスは、初めて対話のセッションを起動したときに自動で追加されます。
入れる・消す
| やりたいこと | セッションの中 | シェル |
|---|---|---|
| 探す | /plugin（Discover タブ） | — |
| 入れる | /plugin install 名前@マーケット | claude plugin install 名前@マーケット |
| 一覧 | /plugin（Installed タブ） | claude plugin list |
| 止める・戻す | Installed タブ | claude plugin disable / enable |
| 更新 | Installed タブの Update now | claude plugin update 名前@マーケット |
| 消す | Installed タブ | claude plugin uninstall 名前@マーケット |
| 増える文脈を見る | — | claude plugin details 名前 |
claude -p のような対話でない実行では /plugin は使えないので、シェルの claude plugin を使います。
スコープ
| スコープ | 書かれる場所 | 使える範囲 |
|---|---|---|
| user（初期値） | ~/.claude/settings.json | 自分の全プロジェクト |
| project | .claude/settings.json | そのプロジェクトの全員 |
| local | .claude/settings.local.json | そのプロジェクトの自分だけ |
同じプラグインが複数のスコープにあるときは、local ＞ project ＞ user の順で優先されます。
project のスコープをコミットしても、各自の手元には自動では入らず、それぞれ一度 install を実行します。
マーケットプレイスを足す
claude plugin marketplace add owner/repo
claude plugin marketplace add owner/repo#v1.2.0GitHub の owner/repo、git の URL、ローカルのフォルダーなどを指定でき、#v1.2.0 のように版を固定できます。
プラグインの中身
my-plugin/
├─ .claude-plugin/plugin.json ← 設定（マニフェスト）
├─ skills/名前/SKILL.md
├─ commands/*.md
├─ agents/*.md
├─ hooks/hooks.json
└─ .mcp.jsonskills/ などは .claude-plugin/ の中ではなく、プラグインの一番上に置きます。
作っている途中のプラグインは、claude –plugin-dir で、入れずにそのセッションだけ読み込めます。
claude plugin validate で、JSON と必須の項目を検査できます。
まとめ
- /plugin で探して入れる。シェルなら claude plugin
- 公式は claude-plugins-official
- スコープは user・project・local
- 文脈を食う量は claude plugin details で確かめる
参考：Claude Code「Discover plugins」「Plugins reference」「Plugin marketplaces」（2026年9月29日に確認）と、Claude Code 2.1.284 での実行結果。
