本稿は、Claude Code のプラグインを「最小構成を自分で組み立てる」観点から整理した仕様解説です。記述はすべて公式ドキュメント（https://code.claude.com/docs/en/plugins ）と逐語照合した範囲に限ります。検証日は 2026-10-10（JST）です。バージョン番号はドキュメントに明記がないため、本稿では特定しません。
プラグインとマニフェスト
プラグインは、通常マニフェストを伴うコンポーネントのディレクトリです。
A plugin is a directory of components, usually with a manifest.
マニフェストは .claude-plugin/plugin.json に置かれる JSON ファイルで、プラグインに名前を与え、バージョン・説明・その他のメタデータを追加できます。
コンポーネントの種類
ドキュメントが挙げるコンポーネントのうち、本稿で扱うのは次の 3 種です。
- Skills：
SKILL.md形式の指示ファイル。Claude が関連時にロードし、コマンドとしても実行できます。 - Hooks：Claude Code がライフサイクルの特定ポイント（例：編集のたび）に実行するコマンドです。
- hooks モジュール：JavaScript 関数として書かれた hooks で、ペインの描画やコマンド追加も可能です。これを持つプラグインは mod と呼ばれます。
開発中のロード
開発中はマーケットプレイスを用意する必要はなく、フォルダから直接ロードできます。
load it straight from its folder with --plugin-dir
有効化とコンテキストコスト
有効化されたプラグインは、実際に使うセッションだけでなく、すべてのセッションの一部になります。各スキル・エージェントの名前と説明は毎ターンのコンテキストに含まれ、そのトークンは使用量としてカウントされ、コンテキストウィンドウを消費します。一方で、フルテキストは実際に使われるときのみロードされます。
The full text of a skill or agent loads only when it's used.
インストールスコープ
スコープは user・project・local の 3 種です。user スコープはそのコンピュータ上のすべてのプロジェクトで有効になります。project スコープはコミットされた .claude/settings.json を通じて、そのリポジトリで作業する全員に有効になります。local スコープはそのリポジトリ内の自分のみに有効です。
ファイルの保存場所
~/.claude/plugins/ には Claude Code が取得・インストールしたものが保存されます。スキル単体を ~/.claude/skills/ に保存した場合、その機器上のすべてのプロジェクトで利用可能になります。
マーケットプレイス
マーケットプレイスは .claude-plugin/marketplace.json ファイルを持つリポジトリまたはディレクトリで、プラグインの一覧とフェッチ先を記述するカタログです。ホスト型ストアではありません。Claude Code は、管理ポリシーでブロックされていない限り、初回のインタラクティブなターミナルセッション起動時に Anthropic の公式マーケットプレイスを自動追加します。
無効化
アンインストールせずに止めるには、/plugin コマンド、またはシェルから claude plugin disable を実行します。