AIエージェント講座 →
Claude Code

Claude Code Subagentの作成・使い方

📌 検索キーワード: claude code サブエージェント 使い方

【結論】Subagentへ専門作業を委譲する

Subagentは独立したContext、System prompt、Tool、Model、Permission、Memoryを持つ専門Agentで、調査やReviewをMain sessionから分離できます。

並列化すれば必ず速くなるわけではなく、重複探索、Cost、Git競合を避けるため、読み取り専用Taskや明確に分離できる領域へ使います。

Project共有のSubagentは.claude/agents/へ定義し、個人用とTeam用のScopeを分けます。

# ターミナルで実行:Project用Agent Directoryを作成
mkdir -p .claude/agents
# ターミナルで実行:Claude Codeを開始
claude
# 起動後のセッション内で実行:Agent管理画面を開く
/agents
# 起動後のセッション内で実行:ContextとCostを確認
/context

具体的な手順・設定方法

  1. 一つの責務、入力、出力、禁止事項、完了条件を定義します。

  2. 読み取り専用ReviewerやTest調査Agentから始めます。

  3. Main agentが結果を統合し、重複や矛盾を人間へ提示します。

  4. 編集Agentを並列に使う場合は別worktreeと担当Fileを割り当てます。

実践プロンプト / 活用テクニック

# 起動後のセッション内で入力
security-reviewer Subagentへ現在の差分の読み取り専用Reviewを委譲してください。
認証、認可、Secret、入力検証だけを対象にし、File編集とCommand実行は禁止してください。
Main sessionでは指摘を重大度順に統合してください。

注意点・よくあるエラーと対処法

Subagentへ広いBashやNetwork権限を無条件に与えないでください。

背景AgentはGit状態を変える場合があるため、同じ作業ツリーでの並列編集を避けます。

Agentの結論はMain agentや人間が根拠とTestで検証します。

1日1時間 × 7日間で学ぶ「自作AIエージェント構築講座」

ツールの設定で消耗する側から、自分専用のAI自動化システムを作る側へ。
実践カリキュラムの全貌はこちらから確認できます。

公式カリキュラムを見る →

おすすめの関連記事

Claude Code

Claude Codeの使い方を徹底解説!基本コマンドと安全な実践手順

Claude Code

Claude Codeの料金体系!Pro・Max・API課金の違いと確認方法

Claude Code

Claude Codeとは?CLI・IDE・デスクトップ・Webで使えるAIエージェント

← ポータルTOP(全1000件の検索)へ戻る