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 の動作方式:
git statusで変更を確認git diffでstaged/unstaged変更を分析git logで最近のコミットスタイルを把握- リポジトリのコンベンションに合ったコミットメッセージを生成
.env、credentials.jsonなど機密ファイルを除外
/commit-push-pr の動作方式:
- mainブランチなら自動で新しいブランチを作成
- ブランチの全コミット履歴を分析(最新コミットだけでなく)
- PR説明を自動生成(Summary + Test plan)
- 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
動作方式:
- クローズ済み/ドラフト/些細な/レビュー済みPRは自動スキップ
- CLAUDE.mdガイドラインファイルを収集
- 4つの並列エージェントを実行:
- Agent #1, #2: CLAUDE.md準拠確認(重複検証)
- Agent #3: バグ検出(PR変更範囲内のみ)
- Agent #4: Git blame履歴分析
- 各イシューに信頼度スコア(0〜100)を付与
- 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段階プラグイン作成ワークフロー:
- Discovery: プラグインの目的と要件把握
- Component Planning: 必要なskills/commands/agents/hooks/MCPを決定
- Detailed Design: 各コンポーネントの詳細設計
- Structure Creation: ディレクトリとmanifest作成
- Component Implementation: AI支援での実装
- Validation: plugin-validatorとコンポーネント別検証
- Testing: Claude Codeでの実動作テスト
- 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-dev | Claude Agent SDK開発キット (/new-sdk-app) |
claude-opus-4-5-migration | Opus 4.5への自動マイグレーション |
explanatory-output-style | 実装選択に関する教育的インサイト提供 |
learning-output-style | 5〜10行のコード貢献を求める学習モード |
ralph-wiggum | 反復開発のための自己参照AIループ |
コミュニティマーケットプレイス分析
主要マーケットプレイス
| マーケットプレイス | プラグイン数 | 特徴 |
|---|---|---|
| ccplugins/awesome-claude-code-plugins | 100+ | 13カテゴリ、最大規模 |
| kivilaid/plugin-marketplace | 87+ | ドキュメント処理ツールに強み |
| ananddtyagi/cc-marketplace | 動的更新 | ライブデータベース連携 |
| ivan-magda/claude-code-marketplace | Swift中心 | 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: レイアウトとテンプレートを含むPowerPointpdf: 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 APIwebsocket: リアルタイム双方向
プラグイン管理コマンド
# インストール
/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) |
参考資料
他の言語で読む
- 🇰🇷 한국어
- 🇯🇵 日本語(現在のページ)
- 🇺🇸 English
- 🇨🇳 中文
この記事は役に立ちましたか?
より良いコンテンツを作成するための力になります。コーヒー一杯で応援してください!☕