How and when to use subagents in Claude Code¶

概要¶

Claude Code の subagents をいつ使うべきか、どう指示すべきか、チームで標準化するかを説明する記事。長いセッションではコンテキストが重くなるため、subagents でコンテキストを分離できる。

使うべき場面	使わない方がよい場面
Research-heavy な調査（大量ファイル読み取り）	step 2 が step 1 の完全な出力に依存する逐次作業
独立した複数タスク（並列で短縮できる）	同じファイルを複数 subagent が並列編集する作業
新鮮な視点が必要なレビュー（会話履歴に引きずられない）	すぐ終わる小さな修正
—	人間が密に判断し続ける必要がある作業

subagent は明示的に依頼した方が安定する。scope・並列実行の有無・期待する出力形式を指定する。

繰り返し使う専門家は Custom subagent にできる（例: security reviewer）
description は委譲判断に使われるため、「security expert」より「commit 前に security issues を review する」のようにトリガー条件を書く方がよい

仕組み	用途
Custom subagents	「専門家が誰か」を定義
`CLAUDE.md`	「いつ使うか」のポリシーを定義（チーム標準）
Skills	テンプレート・出力例・スクリプトを含む専門知識セット
Hooks	ライフサイクル上の特定タイミングで自動実行（commit 前など）

Security / Performance / Style を 3 つの並列 subagent でレビューし、まとめて出力する。