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

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

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

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

Note: Claude Codeのアーキテクチャ変更により、従来「ビルトインコマンド」と呼ばれていた /help/clear などの機能は、現在はスキルシステムに統合されています。本記事ではこの最新の仕様に基づいて解説します。

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

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

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

スキル(Skills) は、スラッシュコマンド(/skill-name)で呼び出す機能の総称です。スキルには2種類あります:

  1. カスタムスキル: .claude/skills/ディレクトリに定義されたMarkdownファイル(SKILL.md)で構成される、プロジェクト固有のワークフローを標準化・自動化するスキル
  2. ビルトインスキル: Claude Codeに標準搭載されている/help/clear/fastなどの機能。従来は「コマンド」と呼ばれていましたが、現在はスキルシステムの一部として統合されています
概念定義起動方法主な用途
サブエージェント独立した専門AIエージェントAgent toolを介して自動/手動起動複雑なタスクの自律処理、並列実行
スキル(カスタム)定義済みプロンプトセット/skill-nameで呼び出しワークフローの標準化・自動化
スキル(ビルトイン)標準搭載のCLI機能/help/clear等で実行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には、システムに標準搭載されたビルトインスキルがあります。これらは従来「コマンド」と呼ばれていましたが、現在はスキルシステムに統合されています。カスタムスキルと同じ /skill-name 形式で呼び出すことができ、一貫したユーザー体験を提供します。

主要なビルトインスキル

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

ビルトインスキルの特徴

ビルトインスキルには、以下の特徴があります。

即時実行: ビルトインスキルは入力後すぐに実行され、Claude AIの処理を介さずに直接機能を実行します。

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

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

スキルシステムとの統合: カスタムスキルとビルトインスキルは同じインターフェース(/で始まるスラッシュコマンド)で呼び出せるため、ユーザーは両者を区別することなくシームレスに利用できます。

ビルトインスキルの使用例

# ヘルプを表示(利用可能なスキル一覧)
> /help

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

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

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

サブエージェントとスキルの比較表

サブエージェントとスキル(カスタム・ビルトイン)の違いを一覧表でまとめます。

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

処理フローの違い

サブエージェント:

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

スキル(カスタム):

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

スキル(ビルトイン):

/help等 → 即時実行 → 結果表示

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

複雑なバグ調査・修正

推奨: サブエージェント

複数ファイルにまたがる原因不明のバグを調査する場合、サブエージェントが最適です。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に標準搭載されたビルトインスキルの2種類があります。カスタムスキルはワークフローの標準化・自動化に、ビルトインスキルは設定変更やモード切替などClaude Code自体の操作に使用します。

従来「コマンド」と呼ばれていた /help/clear などの機能は、現在はスキルシステムに統合されています。これにより、カスタムスキルもビルトインスキルも同じインターフェースで呼び出せるようになり、よりシンプルで一貫性のあるユーザー体験が実現しています。

サブエージェントとスキルを適切に使い分けることで、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 Agent Teams (Research Preview)"
    https://docs.anthropic.com/en/docs/claude-code/agent-teams


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

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

おすすめの投稿:

Claude Codeのサブエージェント・スキルの違いを完全解説!コマンドもスキルに統合された最新仕様で比較。

引用しやすいフレーズ:

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

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

ビルトインコマンドもスキルとして統合され、一貫したインターフェースを実現

または自分の言葉で:

シェア: