原典: Plugins overview ／ 日本語版
一行要約
plugin は skill / agent / hook / MCP サーバなどを1つの単位としてインストールして読み込むディレクトリで、部品はどれも plugin 無しで単体で動く。plugin にするのは「束ねて配る・受け取る」ときだけで、有効にした plugin は使わないセッションでも毎ターン context を消費し、自分の権限でコードを走らせる。
要点
plugin とは何か
A Claude Code plugin is a directory of skills, agents, hooks, MCP servers, or other components that Claude Code installs and loads as one unit. Most plugins come from a marketplace, which is a catalog that lists plugins and where to fetch each one.
Claude Code の plugin は、skill・agent・hook・MCP サーバなどの部品をまとめたディレクトリで、Claude Code はそれを1つの単位としてインストールし、読み込む。plugin の多くは marketplace から来る。marketplace とは、plugin の一覧と、それぞれをどこから取得するかを載せたカタログである。
マニフェスト（.claude-plugin/plugin.json）が plugin の名前を与え、バージョンや説明などのメタデータを足せる。作り方は plugins-create。
部品には「hooks module」もある（以前の取得で追加）—— JavaScript の関数として書いた hook で、ペインを描いたりコマンドを足したりもできる。これを持つ plugin を mod と呼ぶ。
plugin が要るかどうか
Skills, subagents, hooks, and MCP servers all work on their own, without a plugin.
skill・subagent・hook・MCP サーバは、どれも plugin 無しで単体で動く。
Use a plugin when you want several skills, subagents, hooks, or MCP servers packaged as one unit. Install one to get a setup someone else built, with one command and updates from its marketplace. Make one to give your own setup to teammates, install it in many projects, or publish versioned releases.
複数の skill・subagent・hook・MCP サーバを1つの単位にまとめたいときに plugin を使う。入れるのは、他人が作った構成を1コマンドで手に入れ、その marketplace から更新を受け取るため。作るのは、自分の構成をチームメイトに渡す、多くのプロジェクトに入れる、バージョン付きで公開するため。
たとえば ~/.claude/skills/ に置いた skill は、plugin にしなくても手元の全プロジェクトで使える。
有効にした plugin は、使わないセッションにも載る
An enabled plugin is part of every session, not only the sessions where you use it.
有効にした plugin は、それを使うセッションだけでなく、すべてのセッションの一部になる。
- context と使用量 —— Claude が自分で呼べる skill・agent・command は、名前と説明が毎ターン context に入る。plugin の何も動かないセッションでも、その分のトークンが使用量に数えられ、context window の余地が減る。全文が読み込まれるのは使われたときだけ。MCP サーバの毎ターンの分は MCP tool search の規則に従う（mcp）
- プロセス —— plugin が定義する MCP サーバは、有効なセッションごとに並走し、hook はそのイベントで発火する
- 権限 —— plugin が走らせるものは、あなたとして走る
重さを確かめる場面は3つ:
| いつ | どこで |
|---|---|
| 入れる前 | /plugin の Marketplaces タブで plugin を開く。Anthropic の公式 marketplace の plugin には Context cost の見積もりが出る |
| 入れた後 | Installed タブの Not used recently に、止めてよさそうな plugin が並ぶ |
| 消さずに止める | /plugin、またはシェルで claude plugin disable |
marketplace
marketplace は .claude-plugin/marketplace.json を持つリポジトリかディレクトリで、ホストされたストアではなくカタログ。一度追加すれば commit-commands@claude-plugins-official のように名前で入れられる。
- 公式 marketplace は、対話的なターミナルセッションを初めて起動したときに自動で追加される（managed policy で止められていなければ）。Anthropic のコミュニティ用・デモ用の marketplace は自動では追加されない
- plugin marketplace と Claude Marketplace（claude.com/marketplace のウェブサイト）は別物。後者は
/plugin marketplace addで足すものではない - 開発中の plugin に marketplace は要らない ——
--plugin-dirでフォルダから直接読む（plugins-create）
入れた plugin の skill が使えるようになるまでに、3つの層を通る: 設定（追加した marketplace と有効な plugin の一覧）→ ディスク（~/.claude/plugins/ に取得・インストール済みのもの）→ セッション（起動時か再読み込み時に読む）。
marketplace の3段階と、どれでも変わらないこと
marketplace は名前で3段階に分かれる。公式・コミュニティの名前は、github.com/anthropics/ のリポジトリから来る marketplace にしか認められない。
| 段階 | 該当するもの |
|---|---|
| Official | Anthropic の公式名を持つもの（claude-plugins-official、デモ用の claude-code-plugins など） |
| Community | Anthropic のコミュニティ名を持つもの（claude-community など） |
| Third-party | それ以外すべて。同僚や自分の組織が公開する marketplace もここ |
Whatever the tier, a plugin you install can run code with your user privileges.
段階がどれであっても、入れた plugin はあなたのユーザー権限でコードを実行できる。
組織は managed settings で、marketplace の許可リスト・ブロック、plugin の強制インストール、セッション限りの読み込みの無効化ができる。
インストールの scope
| scope | 誰に有効か |
|---|---|
| User | 自分に、このコンピュータの全プロジェクトで |
| Project | このリポジトリで作業する全員に（コミットされる .claude/settings.json 経由）。ただし各自が自分のマシンでインストールする必要はある |
| Local | 自分に、このリポジトリでだけ |
- ターミナル・デスクトップアプリのローカルセッション・VS Code 拡張は同じ設定ファイルを読むので、どれかで user scope に入れれば他の2つでも使える
- クラウドセッション（ブラウザの claude.ai/code を含む）は、ローカル設定の plugin を読み込まない
- 同じ plugin の形式は claude.ai と Cowork にも入るが、読み込まれる部品の組み合わせが違う
そのまま使える具体例
/plugin # Discover タブ（追加済みの marketplace の plugin）から入れる。Marketplaces タブで Context cost を見るclaude plugin disable <plugin> # アンインストールせずに止める原典で言及されている関連文書
- mods-overview — mod（JavaScript の hooks module を持つ plugin）
- plugins-create — 自分で作る
- skills — 単体の skill。Claude が自分で呼べる skill の制御
- sub-agents — 単体の subagent
- hooks-guide — 単体の hook
- mcp — 単体の MCP サーバ。MCP tool search
- context-window — 毎ターン載る名前と説明が減らす余地
- settings — managed settings で組織が締める