Claude Code プラグイン

プラグイン(Plugin)は Claude Code の中で最高レベルの拡張メカニズムであり、コマンド、エージェント、Skills、フック、MCP、LSP などの機能をパッケージ化、バージョン管理、共有、配布するために使用します。

プラグイン = 再利用可能な Claude Code 拡張機能の集合

1つのプラグインには以下を含めることができます:

  • スラッシュコマンド(Slash Commands)
  • サブエージェント(Agents)
  • スキル(機能説明)
  • Hooks(イベントフック)
  • MCP サーバー(外部ツール/サービス)
  • LSP サーバー(コードインテリジェンス)

プラグインの中核的な目標はただ1つ:

Claude Code の機能を工具箱のように再利用できるようにし、プロジェクトごとに設定を繰り返さないこと


プラグイン vs 独立設定(選び方)

Claude Code は2つの拡張方法をサポートしています:

方式 コマンド形式 適したシーン
独立設定(.claude/) /hello 個人利用、単一プロジェクト、迅速な実験
プラグイン(.claude-plugin/) /plugin-name:hello チーム共有、複数プロジェクト、バージョン管理

独立設定はいつ使うのか?

  • 現在のプロジェクトのみでの使用
  • 個人のワークフロー
  • まだ安定していない実験的な設定
  • 短いコマンド名を使いたい場合(例:/review)

プラグインはいつ使うのか?

  • 必要なのは複数のプロジェクトでの再利用
  • 要チームやコミュニティに共有する場合
  • 必要になるのはバージョン管理、アップグレード、ロールバック
  • マーケットプレイス経由での配布を計画している場合
  • 名前空間付きコマンドを受け入れられる(競合を避けるため)

ベストプラクティス:

まず.claude/で反復開発 → 安定したらプラグインとしてパッケージ化


プラグインの最小構成(必ず覚えること)

my-plugin/
├── .claude-plugin/
│   └── plugin.json     # 插件清单(必需)
├── commands/           # 斜杠命令
├── agents/             # 子代理
├── skills/             # Skills
├── hooks/              # 钩子
├── .mcp.json           # MCP 配置
└── .lsp.json           # LSP 配置

重要なルール

  • .claude-plugin/ディレクトリにはのみ配置できるplugin.json
  • その他のディレクトリはプラグインのルートディレクトリに置く必要がある

プラグインマニフェスト(plugin.json)

プラグインの「身分証明書」であり、以下を決定します:

  • プラグイン名
  • コマンドの名前空間
  • バージョン
  • 作者情報

例:

{
  "name": "my-first-plugin",
  "description": "A greeting plugin to learn the basics",
  "version": "1.0.0",
  "author": { "name": "Your Name" }
}

主要フィールドの説明:

フィールド 役割
name 一意の識別子 + コマンドの名前空間
description プラグインマーケットプレイスでの表示
version セマンティックバージョニング
author 任意項目、帰属の説明

スラッシュコマンド(最もよく使われるプラグイン機能)

1、コマンド定義の方法

  • 配置場所:commands/ディレクトリ
  • 各コマンド = 1つの Markdown ファイル
  • ファイル名 = コマンド名

例:

commands/hello.md

対応するコマンド:

/my-first-plugin:hello

2、コマンド内容の例

---
description: Greet the user with a friendly message
---

Greet the user warmly and ask how you can help them today.

3、コマンド引数

を使用して$ARGUMENTSユーザー入力を取得:

Greet the user named "$ARGUMENTS" warmly.

呼び出し:

/my-first-plugin:hello Alex

プラグインのローカルテスト(開発者必携)

を使用して--plugin-dirプラグインディレクトリを直接ロード:

claude --plugin-dir ./my-plugin

特徴:

  • インストール不要
  • 変更後は Claude Code の再起動が必要
  • 複数のプラグインを同時にロード可能
claude --plugin-dir ./plugin-a --plugin-dir ./plugin-b

プラグインで他にできること

機能 用途
Commands カスタムスラッシュコマンド
Agents 専用サブエージェント
Skills Claude に特定の機能を使うタイミングを教える
Hooks 自動化(ファイル作成後にコマンドを実行するなど)
MCP 外部サービスへの接続(GitHub、DB、API)
LSP コードインテリジェンス(ジャンプ、型チェック)

プラグインマーケットプレイス(Plugin Marketplace)

プラグインはマーケットプレイスを通じて配布されます。本質的にはプラグインのカタログリポジトリです。

公式マーケットプレイス

  • デフォルトで追加済み
  • 実行/plugin → Discover

プラグインをインストール:

/plugin install plugin-name@claude-plugins-official

プラグインのインストール範囲

範囲 説明
ユーザー範囲 自分だけ、全プロジェクト
プロジェクト範囲 現在のリポジトリ、チーム共有
ローカル範囲 現在のリポジトリ、自分だけ

推奨:

  • チームツール →プロジェクト範囲
  • 個人向け効率化ツール →ユーザー範囲

代表的なプラグインの分類

1、コードインテリジェンス(LSP)

  • TypeScript、Python、Go、Rust など
  • 定義ジャンプ、参照、型エラーを提供

対応する言語サーバーのローカルインストールが必要

2、外部統合(MCP)

  • GitHub / GitLab
  • Jira / Notion
  • Slack / Figma
  • Vercel / Supabase

本質:プラグイン = MCP サーバー + 設定

3、開発ワークフロー

  • Git コミット、PR
  • コードレビューエージェント
  • プラグイン開発ツール

プラグイン管理のよく使うコマンド

/plugin                # 打开插件管理器
/plugin install         # 安装插件
/plugin uninstall       # 卸载
/plugin enable/disable  # 启用 / 禁用
/plugin marketplace add # 添加市场
/plugin marketplace rm  # 移除市场

から.claude/プラグインへの移行(中核となる考え方)

移行前 移行後
.claude/commands plugin/commands
.claude/agents plugin/agents
settings.json hooks plugin/hooks/hooks.json

移行後:

  • プラグインバージョンが優先的に有効になる
  • 古い設定を削除でき.claude/重複を避けられる

どんなときに絶対にプラグインを使うべきか?

  • すでに安定した Claude ワークフローを持っている
  • あなたが繰り返しコピーしている.claude/
  • チームメンバーが「これ、どう設定するの?」と聞き始めた
  • Claude を IDE プラグインのように制御可能にしたい

プラグインは、Claude Code が「個人向け AI アシスタント」から「エンジニアリングツール」へと進化する分水嶺です

その他の拡張