完全な技術仕様とスキーマについては、プラグインリファレンスをご覧ください。マーケットプレイス管理については、プラグインマーケットプレイスをご覧ください。
プラグインを使用すると、プロジェクトやチーム間で共有できるカスタム機能でClaude Codeを拡張できます。マーケットプレイスからプラグインをインストールして、事前に構築されたコマンド、エージェント、フック、MCPサーバーを追加したり、独自のプラグインを作成してワークフローを自動化したりできます。

​
クイックスタート

プラグインシステムに慣れるために、シンプルな挨拶プラグインを作成しましょう。カスタムコマンドを追加する動作するプラグインを構築し、ローカルでテストし、コアコンセプトを理解します。

​
前提条件

  • マシンにClaude Codeがインストールされていること
  • コマンドラインツールの基本的な知識

​
最初のプラグインを作成する

1

マーケットプレイス構造を作成する

mkdir test-marketplace
cd test-marketplace
2

プラグインディレクトリを作成する

mkdir my-first-plugin
cd my-first-plugin
3

プラグインマニフェストを作成する

.claude-plugin/plugin.jsonを作成
mkdir .claude-plugin
cat > .claude-plugin/plugin.json << 'EOF'
{
"name": "my-first-plugin",
"description": "A simple greeting plugin to learn the basics",
"version": "1.0.0",
"author": {
"name": "Your Name"
}
}
EOF
4

カスタムコマンドを追加する

commands/hello.mdを作成
mkdir commands
cat > commands/hello.md << 'EOF'
---
description: Greet the user with a personalized message
---

# Hello Command

Greet the user warmly and ask how you can help them today. Make the greeting personal and encouraging.
EOF
5

マーケットプレイスマニフェストを作成する

marketplace.jsonを作成
cd ..
mkdir .claude-plugin
cat > .claude-plugin/marketplace.json << 'EOF'
{
"name": "test-marketplace",
"owner": {
"name": "Test User"
},
"plugins": [
{
  "name": "my-first-plugin",
  "source": "./my-first-plugin",
  "description": "My first test plugin"
}
]
}
EOF
6

プラグインをインストールしてテストする

親ディレクトリからClaude Codeを開始
cd ..
claude
テストマーケットプレイスを追加
/plugin marketplace add ./test-marketplace
プラグインをインストール
/plugin install my-first-plugin@test-marketplace
「今すぐインストール」を選択します。新しいプラグインを使用するには、Claude Codeを再起動する必要があります。
新しいコマンドを試す
/hello
Claudeが挨拶コマンドを使用するのが見えるでしょう！/helpをチェックして、新しいコマンドがリストされているのを確認してください。
これらの主要コンポーネントでプラグインを正常に作成してテストしました：
  • プラグインマニフェスト (.claude-plugin/plugin.json) - プラグインのメタデータを記述
  • コマンドディレクトリ (commands/) - カスタムスラッシュコマンドを含む
  • テストマーケットプレイス - プラグインをローカルでテストできる

​
プラグイン構造の概要

プラグインは次の基本構造に従います： 
my-first-plugin/
├── .claude-plugin/
│   └── plugin.json          # プラグインメタデータ
├── commands/                 # カスタムスラッシュコマンド（オプション）
│   └── hello.md
├── agents/                   # カスタムエージェント（オプション）
│   └── helper.md
└── hooks/                    # イベントハンドラー（オプション）
    └── hooks.json
追加できる追加コンポーネント：
  • コマンド: commands/ディレクトリにマークダウンファイルを作成
  • エージェント: agents/ディレクトリにエージェント定義を作成
  • フック: イベント処理用にhooks/hooks.jsonを作成
  • MCPサーバー: 外部ツール統合用に.mcp.jsonを作成
次のステップ: より多くの機能を追加する準備はできましたか？エージェント、フック、MCPサーバーを追加するには、より複雑なプラグインを開発するにジャンプしてください。すべてのプラグインコンポーネントの完全な技術仕様については、プラグインリファレンスをご覧ください。

​
プラグインのインストールと管理

プラグインを発見、インストール、管理してClaude Codeの機能を拡張する方法を学びます。

​
前提条件

  • Claude Codeがインストールされ実行されていること
  • コマンドラインインターフェースの基本的な知識

​
マーケットプレイスを追加する

マーケットプレイスは利用可能なプラグインのカタログです。プラグインを発見してインストールするために追加します：
マーケットプレイスを追加
/plugin marketplace add your-org/claude-plugins
利用可能なプラグインを閲覧
/plugin
Gitリポジトリ、ローカル開発、チーム配布を含む詳細なマーケットプレイス管理については、プラグインマーケットプレイスをご覧ください。

​
プラグインをインストールする

​
インタラクティブメニュー経由（発見に推奨）

プラグイン管理インターフェースを開く
/plugin
「プラグインを閲覧」を選択して、説明、機能、インストールオプション付きの利用可能なオプションを表示します。

​
直接コマンド経由（迅速なインストール用）

特定のプラグインをインストール
/plugin install formatter@your-org
無効化されたプラグインを有効化
/plugin enable plugin-name@marketplace-name
アンインストールせずに無効化
/plugin disable plugin-name@marketplace-name
プラグインを完全に削除
/plugin uninstall plugin-name@marketplace-name

​
インストールを確認する

プラグインをインストールした後：
  1. 利用可能なコマンドを確認: /helpを実行して新しいコマンドを表示
  2. プラグイン機能をテスト: プラグインのコマンドと機能を試す
  3. プラグインの詳細を確認: /plugin → 「プラグインを管理」を使用してプラグインが提供するものを表示

​
チームプラグインワークフローを設定する

リポジトリレベルでプラグインを設定して、チーム全体で一貫したツールを確保します。チームメンバーがリポジトリフォルダーを信頼すると、Claude Codeは指定されたマーケットプレイスとプラグインを自動的にインストールします。 チームプラグインを設定するには：
  1. リポジトリの.claude/settings.jsonにマーケットプレイスとプラグイン設定を追加
  2. チームメンバーがリポジトリフォルダーを信頼
  3. すべてのチームメンバーに対してプラグインが自動的にインストール
設定例、マーケットプレイス設定、ロールアウトのベストプラクティスを含む完全な手順については、チームマーケットプレイスを設定するをご覧ください。

​
より複雑なプラグインを開発する

基本的なプラグインに慣れたら、より洗練された拡張機能を作成できます。

​
複雑なプラグインを整理する

多くのコンポーネントを持つプラグインの場合、機能別にディレクトリ構造を整理します。完全なディレクトリレイアウトと整理パターンについては、プラグインディレクトリ構造をご覧ください。

​
プラグインをローカルでテストする

プラグインを開発する際は、ローカルマーケットプレイスを使用して変更を反復的にテストします。このワークフローはクイックスタートパターンに基づいており、あらゆる複雑さのプラグインで機能します。
1

開発構造を設定する

テスト用にプラグインとマーケットプレイスを整理します：
ディレクトリ構造を作成
mkdir dev-marketplace
cd dev-marketplace
mkdir my-plugin
これにより作成されます：
dev-marketplace/
├── .claude-plugin/marketplace.json  (これを作成します)
└── my-plugin/                        (開発中のプラグイン)
    ├── .claude-plugin/plugin.json
    ├── commands/
    ├── agents/
    └── hooks/
2

マーケットプレイスマニフェストを作成する

marketplace.jsonを作成
mkdir .claude-plugin
cat > .claude-plugin/marketplace.json << 'EOF'
{
"name": "dev-marketplace",
"owner": {
"name": "Developer"
},
"plugins": [
{
  "name": "my-plugin",
  "source": "./my-plugin",
  "description": "Plugin under development"
}
]
}
EOF
3

インストールしてテストする

親ディレクトリからClaude Codeを開始
cd ..
claude
開発マーケットプレイスを追加
/plugin marketplace add ./dev-marketplace
プラグインをインストール
/plugin install my-plugin@dev-marketplace
プラグインコンポーネントをテストします：
  • /command-nameでコマンドを試す
  • エージェントが/agentsに表示されることを確認
  • フックが期待通りに動作することを確認
4

プラグインを反復する

プラグインコードに変更を加えた後：
現在のバージョンをアンインストール
/plugin uninstall my-plugin@dev-marketplace
変更をテストするために再インストール
/plugin install my-plugin@dev-marketplace
プラグインを開発・改良する際にこのサイクルを繰り返します。
複数のプラグインの場合: ./plugins/plugin-nameのようなサブディレクトリでプラグインを整理し、それに応じてmarketplace.jsonを更新してください。整理パターンについては、プラグインソースをご覧ください。

​
プラグインの問題をデバッグする

プラグインが期待通りに動作しない場合：
  1. 構造を確認: ディレクトリが.claude-plugin/内ではなく、プラグインルートにあることを確認
  2. コンポーネントを個別にテスト: 各コマンド、エージェント、フックを個別に確認
  3. 検証とデバッグツールを使用: CLIコマンドとトラブルシューティング技術については、デバッグと開発ツールをご覧ください

​
プラグインを共有する

プラグインを共有する準備ができたら：
  1. ドキュメントを追加: インストールと使用方法を含むREADME.mdを含める
  2. プラグインをバージョン管理: plugin.jsonでセマンティックバージョニングを使用
  3. マーケットプレイスを作成または使用: 簡単なインストールのためにプラグインマーケットプレイスを通じて配布
  4. 他の人とテスト: より広い配布の前にチームメンバーにプラグインをテストしてもらう
完全な技術仕様、デバッグ技術、配布戦略については、プラグインリファレンスをご覧ください。

​
次のステップ

Claude Codeのプラグインシステムを理解したので、異なる目標に対する推奨パスは次のとおりです：

​
プラグインユーザー向け

  • プラグインを発見: 有用なツールのためにコミュニティマーケットプレイスを閲覧
  • チーム採用: プロジェクト用にリポジトリレベルのプラグインを設定
  • マーケットプレイス管理: 複数のプラグインソースの管理方法を学ぶ
  • 高度な使用法: プラグインの組み合わせとワークフローを探索

​
プラグイン開発者向け

  • 最初のマーケットプレイスを作成: プラグインマーケットプレイスガイド
  • 高度なコンポーネント: 特定のプラグインコンポーネントをより深く掘り下げる：
  • 配布戦略: プラグインを効果的にパッケージ化して共有
  • コミュニティ貢献: コミュニティプラグインコレクションへの貢献を検討

​
チームリーダーと管理者向け

  • リポジトリ設定: チームプロジェクト用の自動プラグインインストールを設定
  • プラグインガバナンス: プラグイン承認とセキュリティレビューのガイドラインを確立
  • マーケットプレイス保守: 組織固有のプラグインカタログを作成・維持
  • トレーニングとドキュメント: チームメンバーがプラグインワークフローを効果的に採用できるよう支援

​
関連項目