プラグインを作成する

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​

プラグインとスタンドアロン設定を使い分ける

• 単一のプロジェクト用に Claude Code をカスタマイズしている
• 設定が個人的で共有する必要がない
• スキルやフックをパッケージ化する前に実験している
• /hello や /deploy のような短いスキル名が必要

• 機能をチームまたはコミュニティと共有したい
• 複数のプロジェクト全体で同じスキル/エージェントが必要
• 拡張機能のバージョン管理と簡単な更新が必要
• マーケットプレイスを通じて配布している
• /my-plugin:hello のような名前空間付きスキルで問題ない（名前空間はプラグイン間の競合を防ぎます）

​

クイックスタート

​

前提条件

• Claude Code インストール済みで認証済み

​

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

mkdir my-first-plugin

mkdir my-first-plugin/.claude-plugin

{
  "name": "my-first-plugin",
  "description": "A greeting plugin to learn the basics",
  "version": "1.0.0",
  "author": {
    "name": "Your Name"
  }
}

mkdir -p my-first-plugin/skills/hello

---
description: Greet the user with a friendly message
disable-model-invocation: true
---

Greet the user warmly and ask how you can help them today.

claude --plugin-dir ./my-first-plugin

/my-first-plugin:hello

---
description: Greet the user with a personalized message
---

# Hello Skill

Greet the user named "$ARGUMENTS" warmly and ask how you can help them today. Make the greeting personal and encouraging.

/my-first-plugin:hello Alex

• プラグインマニフェスト（.claude-plugin/plugin.json）：プラグインのメタデータを説明します
• スキルディレクトリ（skills/）：カスタムスキルを含みます
• スキル引数（$ARGUMENTS）：動的な動作のためにユーザー入力をキャプチャします

​

スキルディレクトリでプラグインを開発する

claude plugin init my-tool

​

プラグイン構造の概要

​

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

​

プラグインにスキルを追加する

my-plugin/
├── .claude-plugin/
│   └── plugin.json
└── skills/
    └── code-review/
        └── SKILL.md

---
description: Reviews code for best practices and potential issues. Use when reviewing code, checking PRs, or analyzing code quality.
---

When reviewing code, check for:
1. Code organization and structure
2. Error handling
3. Security concerns
4. Test coverage

​

プラグインに LSP サーバーを追加する

{
  "go": {
    "command": "gopls",
    "args": ["serve"],
    "extensionToLanguage": {
      ".go": "go"
    }
  }
}

​

プラグインにバックグラウンドモニターを追加する

[
  {
    "name": "error-log",
    "command": "tail -F ./logs/error.log",
    "description": "Application error log"
  }
]

​

プラグインでデフォルト設定を配布する

{
  "agent": "security-reviewer"
}

​

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

​

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

claude --plugin-dir ./my-plugin

claude --plugin-dir ./my-plugin.zip

• /plugin-name:skill-name でスキルを試す
• /agents でエージェントが表示されることを確認する
• フックが期待どおりに機能することを確認する

claude --plugin-dir ./plugin-one --plugin-dir ./plugin-two

claude --plugin-url https://example.com/my-plugin.zip --plugin-url https://example.com/other.zip

claude --plugin-url "https://example.com/my-plugin.zip https://example.com/other.zip"

​

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

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

​

プラグインを共有する

1. ドキュメントを追加する：インストールと使用方法の指示を含む README.md を含めます
2. バージョン管理戦略を選択する：明示的な version を設定するか、git コミット SHA に依存するかを決定してください。バージョン管理を参照してください
3. マーケットプレイスを作成または使用する：プラグインマーケットプレイスを通じて配布してインストールします
4. 他のユーザーでテストする：より広い配布の前に、チームメンバーにプラグインをテストしてもらいます

​

プラグインをコミュニティマーケットプレイスに送信する

• claude-plugins-official：Anthropic によって管理されているキュレーションされたプラグインセット。すべての Claude Code インストールで自動的に利用可能です。
• claude-community：レビュー後にサードパーティの送信が登録される公開コミュニティマーケットプレイス。ユーザーは /plugin marketplace add anthropics/claude-plugins-community で追加し、@claude-community としてインストールします。

• Claude.ai：claude.ai/settings/plugins/submit
• Console：platform.claude.com/plugins/submit

​

既存の設定をプラグインに変換する

​

移行手順

mkdir -p my-plugin/.claude-plugin

{
  "name": "my-plugin",
  "description": "Migrated from standalone configuration",
  "version": "1.0.0"
}

# Copy commands
cp -r .claude/commands my-plugin/

# Copy agents (if any)
cp -r .claude/agents my-plugin/

# Copy skills (if any)
cp -r .claude/skills my-plugin/

mkdir my-plugin/hooks

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix" }]
      }
    ]
  }
}

claude --plugin-dir ./my-plugin

​

移行時の変更点

​

次のステップ

​

プラグインユーザー向け

• プラグインを検出してインストールする：マーケットプレイスを参照してプラグインをインストール
• チームマーケットプレイスを設定する：チーム用のリポジトリレベルプラグインを設定

​

プラグイン開発者向け

• マーケットプレイスを作成して配布する：プラグインをパッケージ化して共有
• プラグインリファレンス：完全な技術仕様
• 特定のプラグインコンポーネントをさらに詳しく調べる：
  • スキル：スキル開発の詳細
  • サブエージェント：エージェント設定と機能
  • フック：イベント処理と自動化
  • MCP：外部ツール統合