Claude Code には Plugin（プラグイン） という拡張機能の仕組みがあります。スキル・コマンド・エージェントをひとまとめにしたパッケージとして配布・管理でき、公式マーケットプレイスから一行で追加することも、自分で作ってチームに配布することもできます。

この記事では、プラグインの概念から実際のインストール手順・ディレクトリ構成・自作の方法まで、実践的に解説します。

スポンサーリンク

目次

1. Pluginとは何か
2. プラグインに含められるもの
3. 公式マーケットプレイスから追加する
4. 手動でプラグインを追加する
5. プラグインのディレクトリ構成
6. 自分でプラグインを作る
7. おすすめ公式プラグイン7選
8. 活用のコツ
9. まとめ

1. Pluginとは何か

Claude Code のプラグインは、スキル・コマンド・エージェント・設定などをひとつのディレクトリにまとめた拡張パッケージです。

たとえば「コードレビュー専用プラグイン」を入れると、/code-review というスラッシュコマンドが使えるようになったり、レビュー専用のエージェントが追加されたりします。

2. プラグインに含められるもの

プラグインには以下の要素を自由に組み合わせて含められます。

3. 公式マーケットプレイスから追加する

Claude Code には公式のプラグインマーケットプレイスがあり、コマンド一行でプラグインを追加できます。

マーケットプレイスの追加

まず公式マーケットプレイスをClaude Codeに登録します。

# Claude Code の設定画面（/config）から追加するか、
# settings.json に直接記述する方法もある

# Claude Code のプロンプトで実行
/config

または ~/.claude/settings.json に以下を追記します。

{
  "plugins": {
    "marketplaces": [
      {
        "name": "claude-plugins-official",
        "url": "https://github.com/anthropics/claude-code-plugins"
      }
    ]
  }
}

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

マーケットプレイスを登録したあとは、Claude Code のプロンプトから直接インストールできます。

# プラグイン一覧を表示
/plugins list

# プラグインをインストール
/plugins install code-review

# インストール済みプラグインを確認
/plugins list --installed

4. 手動でプラグインを追加する

GitHubからクローンしたり、チームメンバーから受け取ったプラグインは手動で配置します。

ユーザー共通プラグイン（全プロジェクトで使う場合）

# プラグインディレクトリを作成
mkdir -p ~/.claude/plugins

# GitHubからクローン
git clone https://github.com/example/my-plugin ~/.claude/plugins/my-plugin

# またはディレクトリをそのままコピー
cp -r /path/to/plugin ~/.claude/plugins/my-plugin

プロジェクト固有プラグイン（そのプロジェクトだけで使う場合）

# プロジェクトルートで実行
mkdir -p .claude/plugins

git clone https://github.com/example/my-plugin .claude/plugins/my-plugin

5. プラグインのディレクトリ構成

プラグインのディレクトリ構成を理解しておくと、既存プラグインの読み方・自作のときに役立ちます。

スキルファイル（SKILL.md）の構造

---
name: my-skill
description: このスキルが何をするかの説明（Claude が判断に使う）
trigger: このスキルを使うべき場面の説明
---

# スキルのタイトル

ここにClaudeへの指示を書く。

## 手順

1. まず〇〇を確認する
2. 次に〇〇を実行する
3. 結果を〇〇形式で報告する

エージェントファイルの構造

---
name: my-agent
description: このエージェントの役割・専門領域
---

# エージェント名

このエージェントが担当する役割と、どのような場面で使うかを記述する。

## 専門領域

- 〇〇の分析
- 〇〇の生成
- 〇〇のレビュー

## 行動指針

- 常に〇〇を優先する
- 〇〇の場合は〇〇する

6. 自分でプラグインを作る

mkdir -p ~/.claude/plugins/my-awesome-plugin
cd ~/.claude/plugins/my-awesome-plugin

# my-awesome-plugin

〇〇を自動化するプラグインです。

## 含まれる機能

- `/my-command` - 〇〇を実行する
- `my-agent` - 〇〇に特化したエージェント

## 使い方

1. プラグインをインストールする
2. `/my-command` で実行する

mkdir -p skills/auto-review
cat > skills/auto-review/SKILL.md << 'EOF'
---
name: auto-review
description: 変更されたコードを自動でレビューする
trigger: コードレビューを依頼されたとき
---

# 自動コードレビュー

git diff で変更内容を確認し、以下の観点でレビューしてください。

1. バグ・ロジックエラーの有無
2. セキュリティの問題
3. パフォーマンスの問題
4. 可読性・命名の適切さ

問題点は重要度（高・中・低）付きでリストアップし、
改善案のコード例を示してください。
EOF

mkdir -p agents
cat > agents/reviewer.md << 'EOF'
---
name: reviewer
description: コードレビューに特化したエージェント
---

# コードレビュー専門エージェント

あなたはシニアエンジニアとしてコードレビューを担当します。

## 専門領域
- セキュリティ脆弱性の検出
- パフォーマンスのボトルネック特定
- アーキテクチャの問題指摘

## レビュースタイル
- 批判ではなく改善提案として伝える
- コード例を必ず示す
- 良い点も必ず1〜3つ挙げる
EOF

# プラグインが認識されているか確認
/auto-review

チームへの配布

作成したプラグインはGitリポジトリとして管理・共有できます。

# プラグインをGitリポジトリとして初期化
cd ~/.claude/plugins/my-awesome-plugin
git init
git add .
git commit -m "Initial plugin setup"

# GitHubにpushしてチームで共有
git remote add origin https://github.com/your-org/my-awesome-plugin
git push -u origin main

# チームメンバーの追加方法
git clone https://github.com/your-org/my-awesome-plugin ~/.claude/plugins/my-awesome-plugin

7. おすすめ公式プラグイン7選

Claude Code の公式マーケットプレイスには実用的なプラグインが揃っています。特に使いやすいものを紹介します。

8. 活用のコツ

ユーザー共通 vs プロジェクト固有を使い分ける

コードレビューやコミット系などどのプロジェクトでも使う汎用プラグインは ~/.claude/plugins/ へ。そのプロジェクト専用の投稿フロー・デプロイ手順などは .claude/plugins/ に入れてGit管理するのがベストです。

プラグインは必要なものだけ入れる

プラグインが増えるとスラッシュコマンドのサジェスト一覧が長くなり、使いにくくなります。実際に使うものだけを厳選しましょう。

チームのナレッジをプラグイン化する

コードレビューのチェックリスト・デプロイ手順・インシデント対応フローなど、チーム独自のナレッジをプラグインに落とし込むと、新メンバーでも即戦力になれます。

Claude Code のプラグインを活用することで、繰り返す操作を自動化するだけでなく、チームの開発文化そのものをコード化して継承できるようになります。まずは公式マーケットプレイスのプラグインを試して、使いやすいものから取り入れてみてください。