Claude Code Plugins ガイド - 拡張機能で開発を効率化

はじめに

Claude Code を使っている皆さん、Plugins（プラグイン）という拡張機能をご存知でしょうか？

Claude Code Plugins は、カスタムコマンド、専門的なエージェント、ワークフロー自動化などを追加できる拡張システムです。プロジェクトやチーム全体で共有することで、一貫したツールセットと効率的なワークフローを実現できます。

従来の Claude Code でも十分強力ですが、Plugins を活用することで、より特定のユースケースに最適化された開発環境を構築できます。

この記事では、以下の内容を解説します：

• Claude Code Plugins の概要と仕組み
• Plugin と Marketplace の違い
• 基本的な使い方（インストール・管理）
• 公式プラグインの紹介
• 実践的な活用例

Claude Code をさらに強力な開発ツールとして使いたい方は、ぜひ参考にしてください。

Claude Code Plugins とは？

Claude Code Plugins は、Claude Code を拡張する仕組みで、以下のような機能を追加できます：

プラグインで追加できる機能

2025年1月更新: Slash Commands は Skills に統合されました。プラグインで追加されるコマンドも Skills として実装され、/ で呼び出すことも、Claude が自動的に呼び出すこともできます。詳細は 公式発表 を参照してください。

1. スラッシュコマンド（Skills） - カスタムコマンドを追加して定型作業を効率化
2. 専門エージェント - 特定タスクに特化したサブエージェント
3. Hooks - ライフサイクルイベントでの自動処理
4. MCP サーバー - 外部ツールやサービスとの連携

プラグインの主な特徴

• モジュール化: 機能ごとに独立したパッケージとして配布
• 再利用可能: プロジェクトやチーム間で共有可能
• 拡張性: 必要な機能だけを選んでインストール
• 標準化: 統一された構造とインターフェース

Plugin と Marketplace の違い

Claude Code の拡張システムには、Plugin（個別の拡張機能）と Marketplace（プラグインの配布カタログ）という2つの概念があります。

Plugin（プラグイン）

Plugin は、Claude Code に機能を追加する個別の拡張機能です。

• 1つのプラグイン = 1つの機能セット
• 独立してインストール・管理可能
• コマンド、エージェント、スキルなどを含む
• GitHub リポジトリやローカルディレクトリから読み込み可能

例: code-review プラグイン、commit-commands プラグイン

Marketplace（マーケットプレイス）

Marketplace は、複数のプラグインを集めた配布カタログです。

• プラグインの検索・発見が容易
• バージョン管理と更新の一元化
• チーム全体で承認されたプラグインセットを共有
• 一度追加すれば、そこから複数のプラグインをインストール可能

例: Anthropic 公式マーケットプレイス、チーム独自のマーケットプレイス

# 1. マーケットプレイスを追加（カタログの登録）
/plugin marketplace add anthropics/claude-code

# 2. マーケットプレイスからプラグインをインストール
/plugin install code-review@anthropics/claude-code

# 3. インストールしたプラグインを使用
/code-review

このように、Marketplace はプラグインの配布基盤、Plugin は実際の機能 という関係性です。

基本的な使い方

インストール方法

Claude Code Plugins は、コマンドラインから簡単にインストールできます。

1. マーケットプレイスを追加

まず、プラグインを配布しているマーケットプレイスを登録します：

# Anthropic 公式マーケットプレイスを追加
/plugin marketplace add anthropics/claude-code

# カスタムマーケットプレイスを追加
/plugin marketplace add <organization>/<repository>

2. プラグインをインストール

マーケットプレイスから好きなプラグインをインストールします：

# マーケットプレイスからインストール
/plugin install <plugin-name>@<marketplace-name>

# 例: code-review プラグインをインストール
/plugin install code-review@anthropics/claude-code

3. プラグインを使用

インストール後、すぐに使用できます：

# 追加されたコマンドを実行
/code-review

# ヘルプで新しいコマンドを確認
/help

プラグインの管理

インストール済みプラグインの確認

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

マーケットプレイスの更新

# マーケットプレイスのカタログを最新に更新
/plugin marketplace update

プラグインの削除

# プラグインをアンインストール
/plugin uninstall <plugin-name>

設定ファイルでの管理

プラグインは .claude/settings.json で管理することもできます：

{
  "plugins": {
    "marketplaces": [
      "anthropics/claude-code"
    ],
    "installed": [
      "code-review@anthropics/claude-code",
      "commit-commands@anthropics/claude-code"
    ]
  }
}

この設定ファイルを Git で管理することで、チーム全体で同じプラグインセットを共有できます。

公式プラグインの紹介

Anthropic が提供している公式プラグインの中から、特に実用的なものを紹介します。

開発効率化系

1. commit-commands

Git ワークフローを自動化するプラグインです。

提供されるコマンド:

• /commit - ステージング、コミットメッセージ生成、コミット
• /commit-push-pr - コミット、プッシュ、PR 作成を一括実行
• /clean_gone - マージ済みブランチをクリーンアップ

活用例:

# コードを編集後、一発でコミット
/commit

# PR 作成まで一気に実行
/commit-push-pr

2. feature-dev

包括的な機能開発ワークフローを提供します。

提供される機能:

• /feature-dev - 7段階の構造化された開発フロー
• code-explorer エージェント - コードベース分析
• code-architect エージェント - アーキテクチャ設計
• code-reviewer エージェント - コードレビュー

活用例:

# 新機能の開発を開始
/feature-dev

# ガイドに従って段階的に開発を進める
# 1. 要件定義 → 2. 設計 → 3. 実装 → 4. テスト → 5. レビュー

コードレビュー系

3. code-review

自動化された PR レビューシステムです。

特徴:

• 5つの専門エージェントが並列でレビュー
• 信頼度ベースのスコアリングで誤検知を削減
• CLAUDE.md 準拠チェック、バグ検出、履歴分析など

活用例:

# PR の自動レビューを実行
/code-review

4. pr-review-toolkit

より詳細な観点でレビューを実施するツールキットです。

提供される機能:

• comment-analyzer - コメントの質を分析
• pr-test-analyzer - テストカバレッジを確認
• silent-failure-hunter - エラーハンドリングをチェック
• type-design-analyzer - 型設計を評価
• code-simplifier - コード簡潔化の提案

活用例:

# 特定の観点でレビュー
/pr-review-toolkit:review-pr tests errors

# すべての観点でレビュー
/pr-review-toolkit:review-pr all

セキュリティ系

5. security-guidance

セキュリティリスクを自動検出するプラグインです。

監視対象:

• コマンドインジェクション
• XSS（クロスサイトスクリプティング）
• eval の使用
• 危険な HTML 操作
• Pickle デシリアライゼーション
• os.system の呼び出し

動作:

• ファイル編集時に自動でチェック（PreToolUse Hook）
• 潜在的なリスクを警告

カスタマイズ系

6. hookify

会話パターンを分析して、カスタム Hooks を簡単に作成できます。

提供されるコマンド:

• /hookify - 問題のある動作を分析して Hook を作成
• /hookify:list - 作成済み Hook の一覧
• /hookify:configure - Hook の設定変更

活用例:

# 不要な動作を防ぐ Hook を作成
/hookify

# 例: 「不必要にファイルを削除する動作」を防ぐルールを作成

7. plugin-dev

プラグイン開発を支援する包括的なツールキットです。

提供される機能:

• /plugin-dev:create-plugin - 8段階のガイド付きプラグイン作成
• plugin-validator エージェント - プラグインの検証
• 7つの専門スキル（Hook 開発、MCP 連携など）

活用例:

# 新しいプラグインを作成
/plugin-dev:create-plugin

デザイン系

8. frontend-design

独自性のあるフロントエンド UI を作成するためのガイダンスを提供します。

特徴:

• フロントエンド作業時に自動で起動
• 大胆なデザイン選択、タイポグラフィ、アニメーションの提案
• 「AI っぽい」汎用的なデザインを回避

学習・品質向上系

9. learning-output-style

インタラクティブな学習モードを提供します。

特徴:

• 重要な判断ポイントで、ユーザーにコード記述を促す（5-10行程度）
• 実装の選択肢について教育的な洞察を提供
• セッション開始時に自動で起動（SessionStart Hook）

10. explanatory-output-style

実装の選択理由やパターンを教育的に説明します。

特徴:

• コードベースの慣習やパターンについて解説
• 「なぜこの実装を選んだか」を説明
• セッション開始時に自動で起動

プラグインの構造

Claude Code プラグインは、標準的なディレクトリ構造に従います。

基本構造

plugin-name/
├── .claude-plugin/
│   └── plugin.json          # プラグインのメタデータ
├── commands/                # スラッシュコマンド（オプション）※Skills推奨
├── agents/                  # 専門エージェント（オプション）
├── skills/                  # Agent Skills（オプション）
├── hooks/                   # イベントハンドラー（オプション）
├── .mcp.json                # 外部ツール設定（オプション）
└── README.md                # プラグインのドキュメント

plugin.json の例

{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "My custom Claude Code plugin",
  "author": "Your Name",
  "commands": [
    {
      "name": "my-command",
      "description": "Description of the command"
    }
  ],
  "agents": [
    {
      "name": "my-agent",
      "description": "Description of the agent"
    }
  ]
}

実践的な活用例

例1: チーム開発での標準化

チーム全体で同じプラグインセットを使用することで、開発フローを統一できます。

// .claude/settings.json
{
  "plugins": {
    "marketplaces": [
      "our-team/plugins"
    ],
    "installed": [
      "code-review@our-team/plugins",
      "commit-commands@anthropics/claude-code",
      "security-guidance@anthropics/claude-code"
    ]
  }
}

メリット:

• 新メンバーのオンボーディングが簡単
• コードレビュー基準が統一される
• セキュリティチェックが自動化される

例2: PR レビューの自動化

code-review と pr-review-toolkit を組み合わせて、多角的なレビューを実施：

# 全体的なレビュー
/code-review

# 詳細なテストとエラーハンドリングのチェック
/pr-review-toolkit:review-pr tests errors

# コードの簡潔化提案
/pr-review-toolkit:review-pr simplify

例3: セキュアな開発フロー

security-guidance と hookify を組み合わせて、セキュリティを強化：

# security-guidance をインストール（自動でセキュリティチェック）
/plugin install security-guidance@anthropics/claude-code

# 特定の危険なパターンを禁止する Hook を作成
/hookify
# → 「eval の使用を禁止」「未検証の入力を直接使用しない」などのルールを定義

例4: 機能開発の効率化

feature-dev で構造化された開発プロセスを実践：

# 新機能の開発を開始
/feature-dev

# ガイドに従って進行
# 1. 要件の明確化
# 2. 既存コードの分析（code-explorer）
# 3. アーキテクチャ設計（code-architect）
# 4. 実装
# 5. テスト作成
# 6. レビュー（code-reviewer）
# 7. ドキュメント更新

プラグイン開発を始めるには

独自のプラグインを作成したい場合は、plugin-dev プラグインが便利です。

開発の流れ

# plugin-dev をインストール
/plugin install plugin-dev@anthropics/claude-code

# ガイド付きでプラグインを作成
/plugin-dev:create-plugin

# 対話形式で以下を定義
# 1. プラグイン名と説明
# 2. 提供するコマンド
# 3. エージェントの定義
# 4. Hooks の実装
# 5. MCP サーバーの設定
# 6. テストの作成
# 7. ドキュメント作成
# 8. パッケージング

プラグイン開発のベストプラクティス

1. 明確な責務: 1つのプラグインは1つの明確な目的を持つ
2. 包括的なドキュメント: README に使い方を詳しく記載
3. 適切なエラーハンドリング: エラーメッセージをわかりやすく
4. テストの作成: 動作確認用のテストを含める
5. メタデータの整備: plugin.json を正確に記述

Marketplace の作成

チーム独自のマーケットプレイスを作成することもできます。

marketplace.json の例

{
  "name": "My Team Plugins",
  "description": "Custom plugins for our team",
  "plugins": [
    {
      "name": "custom-linter",
      "version": "1.0.0",
      "description": "Our coding style checker",
      "source": "github:our-team/custom-linter"
    },
    {
      "name": "deploy-helper",
      "version": "2.1.0",
      "description": "Deployment automation",
      "source": "github:our-team/deploy-helper"
    }
  ]
}

マーケットプレイスの配布

GitHub リポジトリに .claude-plugin/marketplace.json を配置するだけで、チーム全体で共有できます：

# チームのマーケットプレイスを追加
/plugin marketplace add our-team/marketplace-repo

まとめ

Claude Code Plugins を活用することで、開発環境を自分やチームのニーズに合わせてカスタマイズできます。

この記事で学んだこと

• Plugins の概要: カスタムコマンド、エージェント、Hooks、MCP サーバーを追加できる拡張システム
• Plugin と Marketplace の違い: Marketplace はプラグインの配布カタログ、Plugin は実際の機能
• 基本的な使い方: マーケットプレイスの追加、プラグインのインストール、管理方法
• 公式プラグイン: commit-commands、code-review、feature-dev、security-guidance など
• 実践的な活用: チーム開発の標準化、PR レビュー自動化、セキュアな開発フロー
• プラグイン開発: plugin-dev を使った独自プラグインの作成

次のステップ

1. 公式プラグインを試す: まずは commit-commands や code-review から始めてみる
2. チームで標準化: .claude/settings.json で共有するプラグインを決める
3. カスタムプラグイン: チーム固有のワークフローをプラグイン化する
4. Marketplace を作成: チーム独自のプラグインカタログを整備する

Claude Code Plugins は、開発効率を大幅に向上させる強力な仕組みです。ぜひ活用して、より快適な開発環境を構築してください。

参考リンク

• Claude Code 公式ドキュメント
• Plugin System ドキュメント
• Anthropic Claude Code Plugins (GitHub)
• Plugin Marketplace の作成方法
• Agent SDK ドキュメント
• コミュニティプラグインレジストリ