Claude Code のサブエージェント機能、使い始めたらタスク並列化がかなり楽になった話
Claude Code の Agent ツールを使ってサブエージェントに作業を分担させた体験談です。並列調査や独立した実装タスクへの活用方法と、使い始めてからの変化をまとめました。
🎯 結論から
Claude Code のサブエージェント機能、使い始めてから複数タスクの並列処理がかなり楽になりました!
サブエージェントとは、Claude Code のメインセッションが別の小さなエージェントを立ち上げて、独立したタスクを委ねる仕組みです。
「複数のファイルを同時に調査したい」「フロントとバックの実装を分担させたい」といった場面で本当に助かっています(^o^)/
👀 サブエージェントとはなにか
Claude Code にはセッション内でサブエージェントを起動できる「Agent ツール」が用意されています。
メインのエージェントが Agent ツールを呼ぶと、新しいエージェントが指定されたタスクを独立して実行し、完了後に結果を返してきます。
通常の Claude Code は一つのコンテキスト内で順番に作業しますが、サブエージェントを使うと複数の調査や実装を並列で進められます!
サブエージェントの特徴をまとめると、以下のようになります。
- 独立したコンテキスト: それぞれのサブエージェントが独立した思考空間で動く
- 並列実行: 複数のサブエージェントを同時に立ち上げて並列処理できる
- worktree isolation: ファイルシステムを独立させて、他の作業と干渉しない環境で動かせる
💡 実際にどう使うか
私が実際に試して便利だと感じた使い方を紹介します(^^)
① 複数ファイルへの並列調査
大きなコードベースの調査を依頼するとき、「認証周りを調べるエージェント」と「API 設計を調べるエージェント」に分けて並列で動かすイメージです。
それぞれが独立して調査してくれるので、メインエージェントが順番に調べるより結果が早く揃います!
② 独立した機能の実装分担
「ユーザー一覧ページのフロント実装」と「ユーザー一覧 API の実装」のように、依存関係が薄い2つの実装タスクをそれぞれのサブエージェントに渡せます。
メインエージェントは両方の結果を受け取って統合する役割に集中できるので、大きめのタスクがかなりスッキリ進みます(`・ω・´)
③ worktree isolation で安全に動かす
サブエージェントに isolation: "worktree" を指定すると、独立した Git ワークツリー上で作業させられます。
実験的な変更を試したいときや、複数の実装案を並列で試したいときに重宝しています!
🙌 使い始めてからの変化
サブエージェントを使い始めてから、大きなタスクへの向き合い方が変わりました。
以前は「順番にやるしかない」と思って、細かい調査を積み重ねていく方法しか頭にありませんでした。
並列で走らせられるとわかってから、タスクを「独立して進めるもの」と「結果を待って進めるもの」に分けて考えるクセがつきました(^^)
特に、既存コードの広範な調査をするときに効果を感じます。
関係しそうなファイルを複数のサブエージェントにそれぞれ調べさせて、最後にメインエージェントがまとめるという流れにするだけで、調査の時間がかなり短くなった感覚があります!
(・_・;) 気になった点
サブエージェントを使ってみて気になった点もあります。
まず、サブエージェントを多く立ち上げるとその分コンテキスト消費とコストが増えます。
細かいタスクを全部サブエージェントに渡すと逆効率になることもあるので、「並列化する価値があるタスクかどうか」を判断してから使うのがよさそうです(´・ω・`)
また、サブエージェントの結果をメインエージェントが受け取るとき、コンテキストが増えてきます。
調査結果が大量のとき、要約してもらってからメインに返す形にすると、コンテキストの無駄遣いを抑えやすいです。
worktree isolation は便利な一方、作業後に不要なワークツリーが残るケースもあるので、定期的に掃除する癖をつけておくとよいと思います!
💰 サブエージェントごとにモデルを変えてコスト最適化する
気になった点で書いた「コストが増える」問題、実はサブエージェントごとに使うモデルを変えることでかなり緩和できると知りました。
サブエージェントの設定には model という項目があって、デフォルトは inherit(メインの会話と同じモデルを引き継ぐ)になっています。
ここを明示的に指定すると、タスクの重さに応じてモデルを使い分けられます。
---
name: file-explorer
description: リポジトリ内のファイルを探索して関連箇所をリストアップする
model: haiku
---
指定されたキーワードに関連するファイルを探し、該当箇所を一覧で報告してください。
私は「大量のファイルを流し読みして関連箇所を探す」ような探索系のタスクは軽量な Haikuに、「見つかった候補から最終的な実装方針を決める」ような判断が重いタスクはメインの Opus のまま、という分担にしています。
この使い分けをしてから、体感でトークンコストがかなり抑えられるようになりました(・∀・)
全部を高性能モデルに頼らなくても、「探すのはHaiku、決めるのはOpus」のように役割で割り振るだけで、精度を落とさずコストだけ下げられるのは新しい発見でした。
サブエージェントの数が増えてきたら、まず一番よく呼ばれる探索系のエージェントから軽量モデルに変えてみるのがおすすめです!
パパ系Webエンジニア〜愛用ガジェット一覧 🛍️
AI開発・執筆に使っている作業デスク環境を楽天ROOMにまとめています ✨ デスク周りの参考にどうぞ 🙌
✅ まとめ
Claude Code のサブエージェント機能は、大きなタスクを並列で進めたいときにかなり力を発揮します!
特に「独立した調査を複数同時にしたい」「依存関係が少ない機能を並列実装したい」という場面では、一人で順番にやるより明らかに速く進められます。
コストとコンテキストの消費を意識しながら使うとより効果的です。
大きめのタスクを依頼するときに一度試してみてください(^o^)/
※ サブエージェントの仕様やモデルのラインナップは今後変わる可能性があります。最新の情報は Claude Code 公式ドキュメント をご確認ください👀