Claude Codeのサブエージェント・スキル・コマンドの違いと使い分け完全ガイド

シェア:
Claude Codeのサブエージェント・スキル・コマンドの違いと使い分け完全ガイドのイメージ

Claude Codeは、Anthropicが提供するターミナルベースのAIコーディングアシスタントです。日々の開発作業を効率化する強力なツールですが、「サブエージェント」「スキル」「コマンド」という3つの重要な概念が存在し、それぞれの違いと適切な使い分けを理解することで、Claude Codeの真価を発揮できます。

本記事では、これら3つの概念の違いを明確にし、実際のユースケースに応じた使い分けを詳しく解説します。

3つの概念の基本的な違い

Claude Codeを使いこなすためには、まず「サブエージェント」「スキル」「コマンド」がそれぞれ何を指すのかを理解する必要があります。

サブエージェント(Sub-agents) は、Claude Codeの中核機能である「Agent tool」を通じて起動される専門的なAIエージェントです。複雑なマルチステップのタスクを自律的に処理し、並列実行も可能です。メインのClaudeセッションとは独立したコンテキストを持ち、専門的なタスクに特化しています。

スキル(Skills) は、.claude/skills/ディレクトリに定義されたMarkdownファイル(SKILL.md)で構成される、再利用可能なプロンプトセットです。スラッシュコマンド(例:/article-writer)で呼び出すことができ、プロジェクト固有のワークフローを標準化・自動化します。

コマンド(Built-in Commands) は、Claude Codeが標準で提供するCLIコマンドです。/help/clear/fastなど、Claude Code自体の操作や設定に関わる機能を提供します。

概念定義起動方法主な用途
サブエージェント独立した専門AIエージェントAgent toolを介して自動/手動起動複雑なタスクの自律処理、並列実行
スキル定義済みプロンプトセット/skill-nameで呼び出しワークフローの標準化・自動化
コマンドビルトインCLI機能/commandで実行Claude Code自体の操作・設定

サブエージェントの詳細

サブエージェントは、Claude Codeの最も強力な機能の一つです。複雑なタスクを分割し、専門的なエージェントに委任することで、効率的かつ高品質な結果を得ることができます。

サブエージェントの仕組み

サブエージェントは、Claude Codeの「Agent tool」を通じて起動されます。メインセッションのClaudeが、タスクの性質を分析し、適切なサブエージェントを選択・起動します。

┌─────────────────────────────────────────────────┐
│                 Main Session                     │
│              (Claude Code CLI)                   │
│                                                  │
│  ユーザー: 「このバグを調査して修正して」        │
│        │                                         │
│        ▼                                         │
│  タスク分析 → サブエージェント選択               │
└─────────────────────────────────────────────────┘
        ┌─────────────┴─────────────┐
        ▼                           ▼
┌───────────────┐           ┌───────────────┐
│   Explore     │           │   general-    │
│   エージェント │           │   purpose     │
│               │           │   エージェント │
│  ・コード検索  │           │               │
│  ・ファイル探索│           │  ・バグ修正    │
│  ・構造理解    │           │  ・テスト実行  │
└───────────────┘           └───────────────┘

サブエージェントの種類

Claude Codeには、さまざまな用途に特化したサブエージェントが用意されています。

general-purpose(汎用エージェント): 複雑な質問への調査、コード検索、マルチステップタスクを処理する最も汎用的なエージェントです。ファイルの検索や読み取り、コードの編集など、ほぼすべてのツールにアクセスできます。

Explore(探索エージェント): コードベースの高速な探索に特化したエージェントです。ファイルパターンの検索(src/components/**/*.tsxなど)、キーワード検索、コードベースに関する質問への回答を得意とします。「quick」「medium」「very thorough」の3つの徹底度レベルを指定できます。

Plan(設計エージェント): 実装戦略の設計に特化したソフトウェアアーキテクトエージェントです。ステップバイステップの計画を返し、重要なファイルを特定し、アーキテクチャ上のトレードオフを考慮します。

特化型エージェント: プロジェクト固有のエージェントとして、frontend-implementation-pro(フロントエンド実装)、refined-design-expert(デザインレビュー)、marketing-psychology-strategist(マーケティング戦略)などを定義できます。

サブエージェントの起動パターン

サブエージェントは、以下のような状況で自動的に起動されます。

自動起動のパターン:

  • 複雑な調査が必要なとき → Exploreエージェント
  • マルチステップの実装タスク → general-purposeエージェント
  • 設計の検討が必要なとき → Planエージェント

明示的な起動:

"Exploreエージェントを使って、認証関連のコードを調査して"
"frontend-implementation-proを使って、このLPを実装して"

Agent Teamsによる並列実行

Claude Codeの「Agent Teams」機能を使用すると、複数のサブエージェントを並列で実行できます。各エージェントは独立したGit worktreeで作業し、メインブランチへの競合を防ぎます。

# Agent Teams有効化
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

Agent Teamsでは、Team Lead(リーダーエージェント)がタスクを分解し、複数のTeammate(サブエージェント)に作業を委任します。

Team Lead: 「新機能を実装」
    ├── Teammate1: フロントエンド実装(worktree: feature/frontend)
    ├── Teammate2: バックエンドAPI実装(worktree: feature/backend)
    └── Teammate3: テスト作成(worktree: feature/tests)

スキルの詳細

スキルは、Claude Codeにプロジェクト固有の専門知識とワークフローを教え込むための仕組みです。繰り返し行う作業を標準化し、一貫した品質を維持できます。

スキルの構造

スキルは.claude/skills/[スキル名]/SKILL.mdというパスに配置されるMarkdownファイルで定義されます。

.claude/
└── skills/
    ├── article-writer/
    │   └── SKILL.md
    ├── design-reviewer/
    │   └── SKILL.md
    └── component-builder/
        └── SKILL.md

SKILL.mdの書き方

スキルファイルは、フロントマター(メタデータ)と本文で構成されます。

---
name: article-writer
description: AI COMMONのブログ記事や導入事例を作成するスキルです。
allowed-tools: Read, Write, Edit, Glob, Grep
---

# Article Writer

ブログ記事を作成するスキルです。

## このスキルを使うとき

- ブログ記事の執筆
- 導入事例の作成
- お客様インタビュー記事の執筆

## ワークフロー

### Phase 1: リサーチ
1. テーマに関する情報収集
2. 競合記事の分析

### Phase 2: 執筆
1. 記事構成の設計
2. 本文の執筆
3. Frontmatterの作成

### Phase 3: 検証
1. ビルドテスト
2. プレビュー確認

スキルの呼び出し方

スキルはスラッシュコマンドで呼び出します。

/article-writer AI倫理に関するブログ記事を書いて
/design-reviewer ホームページのデザインをレビューして
/component-builder Modalコンポーネントを作成して

スキルとサブエージェントの連携

スキルは、必要に応じてサブエージェントを活用します。例えば、記事作成のワークフローでは:

/article-writer
    ├── [内部] Exploreエージェント: 既存記事の調査
    ├── [内部] WebSearchツール: 最新情報の収集
    └── [内部] Writeツール: 記事ファイルの作成

代表的なスキルの例

スキル用途起動方法
article-researcher記事のリサーチ/article-researcher
article-writer記事の執筆/article-writer
design-reviewerデザインレビュー/design-reviewer
component-builderReactコンポーネント作成/component-builder
seo-optimizerSEO最適化/seo-optimizer
deep-research徹底調査/deep-research

コマンドの詳細

コマンドは、Claude Code自体を操作するためのビルトイン機能です。スキルとは異なり、Claude Codeに最初から組み込まれており、カスタマイズの必要なく使用できます。

主要なビルトインコマンド

コマンド機能説明
/helpヘルプ表示利用可能なコマンド一覧と使い方を表示
/clear会話クリア現在の会話履歴をクリア
/fast高速モード切替より高速な応答モードに切り替え
/modelモデル切替使用するClaudeモデルを切り替え
/config設定変更Claude Codeの設定を変更
/costコスト確認現在のセッションのAPI使用コストを表示

コマンドの特徴

ビルトインコマンドには、以下の特徴があります。

即時実行: コマンドは入力後すぐに実行され、Claude AIの処理を介さずに直接機能を実行します。

Claude Code自体への作用: コマンドはプロジェクトのコードではなく、Claude Code自体の動作に影響を与えます。

カスタマイズ不可: スキルとは異なり、ビルトインコマンドの動作をプロジェクト側で変更することはできません。

コマンドの使用例

# ヘルプを表示
> /help

# 会話履歴をクリアして新しいタスクを開始
> /clear

# 高速モードに切り替え(より早い応答が必要なとき)
> /fast

# 現在のAPI使用コストを確認
> /cost

3者の比較表

サブエージェント、スキル、コマンドの違いを一覧表でまとめます。

比較項目サブエージェントスキルコマンド
定義場所.claude/agents/ or 組み込み.claude/skills/組み込み(カスタマイズ不可)
起動方法Agent tool経由(自動/手動)/skill-name/command
独立したコンテキストありなし(メインセッション内)なし
並列実行可能不可不可
カスタマイズプロジェクト固有定義可能プロジェクト固有定義可能不可
主な用途複雑なタスクの自律処理ワークフローの標準化CLI操作・設定
実行時間長い(数分〜数十分)中程度(数分)即時
ツールアクセス全ツール or 制限付き指定されたツールのみ限定的

処理フローの違い

サブエージェント:

ユーザー入力 → メインセッション分析 → サブエージェント起動
    → 独立コンテキストで処理 → 結果をメインセッションに返却

スキル:

/skill-name → SKILL.md読み込み → メインセッション内で処理
    → 結果出力

コマンド:

/command → 即時実行 → 結果表示

ユースケース別の使い分けガイド

複雑なバグ調査・修正

推奨: サブエージェント

複数ファイルにまたがる原因不明のバグを調査する場合、サブエージェントが最適です。Exploreエージェントでコードベースを探索し、general-purposeエージェントで修正を実行します。

"このエラーの原因を調査して修正して"
→ Exploreエージェント(調査)→ general-purpose(修正)

定型的なコンテンツ作成

推奨: スキル

ブログ記事、導入事例、コンポーネントなど、プロジェクトで繰り返し作成するコンテンツには、スキルが最適です。

/article-writer 今週のAIニュースについて記事を書いて
/case-study-creator 製造業のAI導入事例を作成して

大規模リファクタリング

推奨: サブエージェント(Agent Teams)

大規模なコード変更には、複数のサブエージェントを並列で使用するAgent Teamsが効果的です。

"認証システムをOAuth 2.0に移行して"
→ Teammate1: フロントエンド修正
→ Teammate2: バックエンド修正
→ Teammate3: テスト更新

設定変更・モード切替

推奨: コマンド

Claude Code自体の設定変更や動作モードの切り替えには、ビルトインコマンドを使用します。

/fast   # より高速な応答が必要なとき
/clear  # 新しいタスクを開始するとき

デザインレビュー・SEO最適化

推奨: スキル

特定の観点からの評価や最適化には、専門スキルを使用します。

/design-reviewer ホームページのデザインを評価して
/seo-optimizer このページのSEOを改善して

実践的な組み合わせ例

実際の開発では、これら3つの概念を組み合わせて使用することが多いです。

例1: 新機能の実装

1. /clear                          # 会話をクリア(コマンド)
2. 「認証機能を設計して」           # Planエージェントが起動(サブエージェント)
3. 「設計に基づいて実装して」       # general-purposeエージェント(サブエージェント)
4. /design-reviewer 実装をレビュー  # デザインレビュー(スキル)

例2: ブログ記事作成

1. /article-researcher AIトレンドを調査  # リサーチ(スキル)
2. /article-writer リサーチを基に執筆    # 執筆(スキル)
3. /seo-optimizer SEOを最適化            # 最適化(スキル)

例3: バグ修正

1. 「このエラーを調査して」         # Exploreエージェント(サブエージェント)
2. 「修正して」                    # general-purpose(サブエージェント)
3. /cost                           # コスト確認(コマンド)

まとめ

Claude Codeの「サブエージェント」「スキル」「コマンド」は、それぞれ異なる目的と特徴を持つ重要な概念です。

サブエージェントは、複雑なタスクを自律的に処理する専門エージェントです。独立したコンテキストを持ち、並列実行も可能なため、大規模な調査や実装に最適です。

スキルは、プロジェクト固有のワークフローを標準化・自動化するための仕組みです。スラッシュコマンドで簡単に呼び出せ、繰り返し作業の品質を一貫させることができます。

コマンドは、Claude Code自体を操作するためのビルトイン機能です。設定変更やモード切替など、即座に実行したい操作に使用します。

これら3つを適切に使い分けることで、Claude Codeの能力を最大限に引き出し、開発効率を大幅に向上させることができます。


AI COMMONでは、Claude CodeをはじめとするAI開発ツールの導入支援を行っています。 サブエージェントやスキルの設計についてのご相談は、お気軽にお問い合わせください。

お問い合わせはこちら


関連記事

参考文献

  1. Anthropic "Claude Code Overview"
    https://docs.anthropic.com/en/docs/claude-code/overview

  2. Anthropic "Claude Code Skills"
    https://docs.anthropic.com/en/docs/claude-code/skills

  3. Anthropic "Claude Code Slash Commands"
    https://docs.anthropic.com/en/docs/claude-code/slash-commands

  4. Anthropic "Claude Code Agent Teams (Research Preview)"
    https://docs.anthropic.com/en/docs/claude-code/agent-teams


本記事は2026年3月20日時点の情報に基づいています。Claude Codeの機能は継続的にアップデートされているため、最新情報は公式ドキュメントをご確認ください。

📢この記事をシェアしませんか?

おすすめの投稿:

Claude Codeのサブエージェント・スキル・コマンドの違いを完全解説!それぞれの特徴と使い分けを比較表付きで紹介。

引用しやすいフレーズ:

サブエージェントは並列処理と複雑なタスク分解のための専門家

スキルは繰り返し作業を標準化するプロジェクト固有のワークフロー

コマンドはClaude Code自体を操作するビルトイン機能

または自分の言葉で:

シェア: