Claude Codeプラグイン完全ガイド:公式プラグインからコミュニティマーケットプレイスまで

Claude Codeプラグイン完全ガイド:公式プラグインからコミュニティマーケットプレイスまで

Claude Codeプラグインシステムを深掘り分析します。公式13プラグインの詳細機能、コミュニティマーケットプレイス100+プラグイン、 実際のplugin.json構造とインストール方法を実践例と共に紹介します。

概要

Claude CodeはAnthropicが開発したエージェンティックコーディングツールです。プラグインシステムを通じて、スラッシュコマンド、専門エージェント、スキル、フックを一つのパッケージとしてインストールできます。

この記事では公式13プラグインの詳細機能、コミュニティマーケットプレイスの100以上のプラグイン、そして実際のプラグイン構造を深く分析します。

★ Insight

  • 公式プラグイン13個: anthropics/claude-codeリポジトリで管理
  • コミュニティマーケットプレイス: 100以上のプラグイン(13カテゴリ)
  • プラグイン構造: commands/, agents/, skills/, hooks/, .mcp.json

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

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

Claude CodeはGitリポジトリベースのマーケットプレイスシステムを使用します。

# コミュニティマーケットプレイスの追加
/plugin marketplace add ccplugins/awesome-claude-code-plugins
/plugin marketplace add kivilaid/plugin-marketplace
/plugin marketplace add ananddtyagi/cc-marketplace

# 登録されたマーケットプレイス一覧の確認
/plugin marketplace list

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

# 基本インストール
/plugin install commit-commands

# 特定マーケットプレイスからインストール
/plugin install ultrathink@cc-marketplace

# インストール済みプラグイン一覧の確認
/plugin list

# 対話型インストール(メニュー方式)
/plugin

★ Insight

  • プラグイン最小要求バージョン: Claude Code 1.0.33以上
  • 保存場所: プロジェクト(.claude/)またはユーザー(~/.claude/)レベル
  • 開発モード: cc --plugin-dir /path/to/plugin でローカルテスト可能

公式プラグイン13個の詳細分析

Anthropicが管理するanthropics/claude-codeリポジトリの公式プラグインです。

1. commit-commands - Gitワークフロー自動化

/plugin install commit-commands

提供コマンド3つ:

コマンド機能
/commit変更を分析し、リポジトリスタイルに合ったコミットメッセージを自動生成
/commit-push-prブランチ作成 → コミット → プッシュ → PR作成まで一度に
/clean_goneリモートで削除されたローカルブランチの整理、worktree含む

/commit の動作方式:

  1. git statusで変更を確認
  2. git diffでstaged/unstaged変更を分析
  3. git logで最近のコミットスタイルを把握
  4. リポジトリのコンベンションに合ったコミットメッセージを生成
  5. .envcredentials.jsonなど機密ファイルを除外

/commit-push-pr の動作方式:

  1. mainブランチなら自動で新しいブランチを作成
  2. ブランチの全コミット履歴を分析(最新コミットだけでなく)
  3. PR説明を自動生成(Summary + Test plan)
  4. GitHub CLI(gh)でPR作成後URLを返す
# 使用例
git add .
/commit
# → "feat(auth): add JWT validation middleware" を提案
# → 承認しますか? [Y/n]

2. feature-dev - 7段階機能開発ワークフロー

/plugin install feature-dev

7段階の構造化されたワークフロー:

graph TD
    A["1. Discovery<br/>要件明確化"] --> B["2. Codebase Exploration<br/>2〜3個のcode-explorerエージェント並列実行"]
    B --> C["3. Clarifying Questions<br/>エッジケース、エラー処理確認"]
    C --> D["4. Architecture Design<br/>2〜3個のcode-architectエージェント並列実行"]
    D --> E["5. Implementation<br/>明示的承認後に実装開始"]
    E --> F["6. Quality Review<br/>3個のcode-reviewerエージェント並列実行"]
    F --> G["7. Summary<br/>変更要約と次のステップ提案"]

専門エージェント3種:

エージェント役割
code-explorer実行パス追跡、アーキテクチャレイヤー分析、必須ファイル一覧生成
code-architect最小変更 / クリーンアーキテクチャ / 実用的バランスなど複数アプローチ設計
code-reviewerシンプルさ/DRY、バグ/正確性、コンベンション/抽象化それぞれに集中レビュー
# 使用例
/feature-dev Add OAuth login with Google
# → 7段階を順次進行、各段階でユーザー確認

いつ使うか?

  • 複数ファイルにまたがる新機能開発
  • アーキテクチャ決定が必要な複雑な作業
  • 要件が不明確な機能

3. code-review - 信頼度ベースの自動PRレビュー

/plugin install code-review

動作方式:

  1. クローズ済み/ドラフト/些細な/レビュー済みPRは自動スキップ
  2. CLAUDE.mdガイドラインファイルを収集
  3. 4つの並列エージェントを実行:
    • Agent #1, #2: CLAUDE.md準拠確認(重複検証)
    • Agent #3: バグ検出(PR変更範囲内のみ)
    • Agent #4: Git blame履歴分析
  4. 各イシューに信頼度スコア(0〜100)を付与
  5. 80点未満をフィルタリング(誤検出除去)

信頼度スコア基準:

スコア意味
0確信なし、誤検出の可能性高い
25ある程度確信、実際かもしれない
50普通の確信、実際だが些細
75高い確信、実際で重要
100絶対確信、確実に問題
# ターミナル出力
/code-review

# PRコメントとして投稿
/code-review --comment

フィルタリングされる誤検出:

  • PR以前から存在した問題
  • リンターで検出できる問題
  • 一般的な品質イシュー(CLAUDE.mdにない場合)
  • lint ignore注釈があるコード

4. hookify - コーディング不要でフック作成

/plugin install hookify

提供コマンド4つ:

コマンド機能
/hookify [説明]自然言語でフック作成
/hookify (引数なし)会話を分析して改善すべきパターンを自動発見
/hookify:list有効なルール一覧
/hookify:configureルールの有効化/無効化

フックファイル形式 (.claude/hookify.*.local.md):

---
name: block-dangerous-rm
enabled: true
event: bash
pattern: rm\s+-rf
action: block  # warn または block
---

⚠️ **危険なrmコマンドを検出!**

このコマンドは重要なファイルを削除する可能性があります。
- パスが正しいか確認してください
- バックアップがあるか確認してください

イベントタイプ:

  • bash: Bashコマンド実行時
  • file: Edit/Writeツール使用時
  • stop: Claudeが作業終了しようとする時
  • prompt: ユーザープロンプト送信時
  • all: すべてのイベント
# 使用例
/hookify TypeScriptファイルでconsole.logを使ったら警告して
# → .claude/hookify.warn-console-log.local.md が作成される

5. plugin-dev - 8段階プラグイン開発ツール

/plugin install plugin-dev

8段階プラグイン作成ワークフロー:

  1. Discovery: プラグインの目的と要件把握
  2. Component Planning: 必要なskills/commands/agents/hooks/MCPを決定
  3. Detailed Design: 各コンポーネントの詳細設計
  4. Structure Creation: ディレクトリとmanifest作成
  5. Component Implementation: AI支援での実装
  6. Validation: plugin-validatorとコンポーネント別検証
  7. Testing: Claude Codeでの実動作テスト
  8. Documentation: README完成と配布準備

7つのコアスキル:

スキルトリガーキーワード内容
Hook Development”create a hook”, “PreToolUse hook”プロンプト/コマンドフック、全イベントタイプ
MCP Integration”add MCP server”, “.mcp.json”stdio/SSE/HTTP/WebSocketサーバー設定
Plugin Structure”plugin.json manifest”標準ディレクトリ構造、auto-discovery
Plugin Settings”.local.md files”プロジェクト別設定、YAML frontmatter
Command Development”create a slash command”コマンド構造、引数処理
Agent Development”create an agent”エージェントfrontmatter、システムプロンプト
Skill Development”create a skill”SKILL.md、progressive disclosure
# 使用例
/plugin-dev:create-plugin データベースマイグレーション管理プラグイン
# → 8段階ガイドが進行

6. frontend-design - 自動起動UIデザインスキル

/plugin install frontend-design

フロントエンド作業時に自動で起動されるスキルです。

コア原則:

  • 大胆な美学的選択: 汎用的なAIスタイルを避ける
  • 独特なタイポグラフィとカラーパレット
  • 高インパクトなアニメーションとビジュアルディテール
  • コンテキスト認識実装
# 自動起動の例
"音楽ストリーミングアプリのダッシュボードを作って"
"AIセキュリティスタートアップのランディングページを作って"
# → frontend-designスキルが自動適用される

7. pr-review-toolkit - 6つの専門レビューエージェント

/plugin install pr-review-toolkit

6つの専門エージェント:

  • コメントレビュアー
  • テストレビュアー
  • エラー処理レビュアー
  • 型レビュアー
  • コード品質レビュアー
  • 総合レビュアー
/pr-review-toolkit:review-pr

8. security-guidance - セキュリティ警告フック

/plugin install security-guidance

9つのセキュリティパターン監視:

  • インジェクション攻撃
  • XSS(クロスサイトスクリプティング)
  • SQLインジェクション
  • コマンドインジェクション
  • パストラバーサル
  • 安全でないデシリアライゼーション
  • 機密データ漏洩
  • 脆弱な暗号化
  • 認証/認可の欠陥

PreToolUseフックでツール実行前にリアルタイム警告。

その他の公式プラグイン

プラグイン説明
agent-sdk-devClaude Agent SDK開発キット (/new-sdk-app)
claude-opus-4-5-migrationOpus 4.5への自動マイグレーション
explanatory-output-style実装選択に関する教育的インサイト提供
learning-output-style5〜10行のコード貢献を求める学習モード
ralph-wiggum反復開発のための自己参照AIループ

コミュニティマーケットプレイス分析

主要マーケットプレイス

マーケットプレイスプラグイン数特徴
ccplugins/awesome-claude-code-plugins100+13カテゴリ、最大規模
kivilaid/plugin-marketplace87+ドキュメント処理ツールに強み
ananddtyagi/cc-marketplace動的更新ライブデータベース連携
ivan-magda/claude-code-marketplaceSwift中心Swift 6マイグレーション、iOS開発

カテゴリ別主要プラグイン(ccplugins基準)

ワークフローオーケストレーション(8個):

  • ultrathink: 4つの専門サブエージェントを指揮するコーディネーター
  • lyra: マスター級AIプロンプト最適化専門家
  • problem-solver-specialist: 体系的問題解決

コード品質&テスト(16個):

  • bug-detective: 段階的体系的デバッグ
  • double-check: 変更の二重検証
  • test-writer-fixer: テスト作成・修正
  • unit-test-generator: ユニットテスト自動生成
  • database-performance-optimizer: DB性能最適化

Gitワークフロー(14個):

  • fix-github-issue: GitHubイシューベースの自動修正
  • create-pr: PR作成自動化
  • update-branch-name: ブランチ名コンベンション適用
  • husky: Gitフック設定

ドキュメンテーション(8個):

  • analyze-codebase: コードベース総合分析
  • changelog-generator: 変更ログ自動生成
  • update-claudemd: CLAUDE.md自動更新
  • openapi-expert: OpenAPIスペック専門家

セキュリティ&コンプライアンス(7個):

  • audit: コードベースセキュリティ監査
  • enterprise-security-reviewer: エンタープライズ級セキュリティレビュー
  • legal-compliance-checker: 法的準拠確認
  • data-privacy-engineer: データプライバシー

開発エンジニアリング(15個):

  • ai-engineer: AI機能開発専門
  • backend-architect: バックエンドアーキテクチャ設計
  • flutter-mobile-app-dev: Flutterモバイルアプリ
  • react-native-dev: React Native開発

kiviladマーケットプレイス特化ツール

ドキュメント処理スイート:

  • xlsx: 数式とデータ可視化を含むExcel生成
  • docx: 変更追跡と書式を含むWord文書
  • pptx: レイアウトとテンプレートを含むPowerPoint
  • pdf: PDF抽出、結合、分割、フォーム処理

クリエイティブ&デザイン:

  • algorithmic-art: p5.jsベースのジェネレーティブアート
  • canvas-design: PNG/PDFビジュアルアート生成
  • slack-gif-creator: Slack用アニメーションGIF

davila7ツールキット(10個):

  • Gitワークフロー、Supabase、Next.js/Vercel
  • テスト、セキュリティ監査、AI/ML、DevOps
  • ドキュメント生成、性能最適化、プロジェクト管理

プラグイン構造詳細

標準ディレクトリ構造

my-plugin/
├── .claude-plugin/
│   └── plugin.json              # プラグインメタデータ(必須)
├── commands/                    # スラッシュコマンド
│   ├── command-name.md
│   └── another-command.md
├── agents/                      # 自律エージェント
│   ├── agent-name.md
│   └── another-agent.md
├── skills/                      # 再利用可能なスキル
│   ├── skill-name/
│   │   ├── SKILL.md
│   │   ├── references/
│   │   ├── examples/
│   │   └── scripts/
├── hooks/                       # イベントフック
│   ├── hooks.json
│   └── my-hook.sh
├── .mcp.json                    # MCPサーバー設定(任意)
└── README.md

plugin.json例

{
  "name": "my-team-plugin",
  "version": "1.0.0",
  "description": "チーム専用開発ワークフロープラグイン",
  "commands": ["commands/"],
  "agents": ["agents/"],
  "skills": ["skills/"],
  "hooks": ["hooks/"]
}

コマンドファイル形式(YAML frontmatter + Markdown)

---
description: "コードレビューを実行します"
argument-hint: "[--comment]"
allowed-tools:
  - Read
  - Grep
  - Bash
---

# コードレビューコマンド

## 指示
1. 現在のブランチの変更を分析します
2. CLAUDE.mdガイドラインを確認します
3. イシューを信頼度スコアと共に報告します
...

エージェントファイル形式

---
name: code-explorer
description: |
  コードベースを深く分析するエージェントです。

  <example>
  ユーザー: "認証フローがどう動作するか追跡して"
  → code-explorerが呼び出される
  </example>
model: sonnet
color: blue
tools:
  - Read
  - Grep
  - Glob
---

# System Prompt

あなたはコードベース探索の専門家です...

スキルSKILL.md形式

---
description: |
  フロントエンドUIデザインスキルです。

  <trigger_phrases>
  - "ダッシュボードを作って"
  - "ランディングページのデザイン"
  - "UIコンポーネント生成"
  </trigger_phrases>
auto_invoke: true
---

# Frontend Design Skill

## コア原則
1. 汎用的なAIスタイルを避ける
2. 大胆な美学的選択
...

.mcp.json MCPサーバー設定

{
  "mcpServers": {
    "postgresql": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    },
    "browser": {
      "type": "sse",
      "url": "https://mcp.example.com/browser",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}

MCPサーバータイプ:

  • stdio: ローカルプロセス(最も一般的)
  • sse: Server-Sent Events(ホスティング/OAuth)
  • http: REST API
  • websocket: リアルタイム双方向

プラグイン管理コマンド

# インストール
/plugin install <name>
/plugin install <name>@<marketplace>

# 削除
/plugin uninstall <name>

# 一覧
/plugin list

# 更新
/plugin update <name>
/plugin update --all

# マーケットプレイス管理
/plugin marketplace add <owner/repo>
/plugin marketplace remove <name>
/plugin marketplace list

# 対話型メニュー
/plugin

状況別おすすめプラグイン組み合わせ

新規プロジェクト開始時

/plugin install commit-commands     # Gitワークフロー
/plugin install hookify             # チームコンベンション強制
/plugin install security-guidance   # セキュリティ警告

機能開発集中時

/plugin install feature-dev         # 7段階ワークフロー
/plugin install frontend-design     # UI自動スキル(フロントエンドなら)

コードレビュー自動化時

/plugin install code-review         # 信頼度ベースレビュー
/plugin install pr-review-toolkit   # 6つの専門エージェント

プラグイン開発時

/plugin install plugin-dev          # 8段階開発ガイド

注意事項

信頼性確認

  • 公式プラグイン: anthropics/claude-codeリポジトリで管理
  • コミュニティプラグイン: コードの直接レビューが必要
  • プラグインはローカルファイルシステムにアクセス可能

バージョン要件

# Claude Code 1.0.33以上が必要
claude --version

MCPサーバー認証

# 環境変数でAPIキーを設定
export DATABASE_URL="postgresql://..."
export API_KEY="sk-..."

まとめ

Claude Codeプラグインシステムは公式13プラグインコミュニティ100以上のプラグインで構成される豊富なエコシステムを提供します。

<strong>要点まとめ</strong>:

目的おすすめプラグイン
Gitワークフロー自動化commit-commands(公式)
機能開発自動化feature-dev(公式、7段階)
コードレビュー自動化code-review(公式、信頼度ベース)
カスタムルール作成hookify(公式、ノーコーディング)
セキュリティ警告security-guidance(公式)
プラグイン開発plugin-dev(公式、8段階)
UIデザインfrontend-design(公式、自動)
ドキュメント処理xlsx, docx, pptx, pdf(kivilaid)
総合オーケストレーションultrathink(ccplugins)

参考資料

他の言語で読む

この記事は役に立ちましたか?

より良いコンテンツを作成するための力になります。コーヒー一杯で応援してください!☕

著者について

JK

Kim Jangwook

AI/LLM専門フルスタック開発者

10年以上のWeb開発経験を活かし、AIエージェントシステム、LLMアプリケーション、自動化ソリューションを構築しています。Claude Code、MCP、RAGシステムの実践的な知見を共有します。