Claude Code のサブエージェント機能でコードベース調査が格段にラクになった話

👀 結論から

Claude Code はタスクによっては内部でサブエージェントを起動し、複数の処理を並列で実行することがあります！

特に大きなコードベースの調査や、複数ファイルにわたる変更作業でこの恩恵をかなり感じます。

私の場合、「このリポジトリの全コンポーネントを調べて共通パターンを教えて」みたいなタスクを投げたとき、サブエージェントが走り出して調査結果を整理してくれるようになってから、調査の手間が段違いに減りました(^o^)/

大ざっぱな指示を投げるだけで、Claude Code が勝手に作業を分解して処理を進めてくれる体験は、最初はかなり驚きましたね。

Claude Code には内部で別のエージェントを起動して、タスクを分割処理できる仕組みがあります。

Agent ツールと呼ばれるもので、親のエージェントがサブエージェントに特定のタスクを委譲し、その結果を受け取って統合するイメージです。

例えばこんなことが起きます:

ユーザーから見ると「普通に指示しただけなのに複数の調査が同時進行してた」みたいな体験になります！

最近、自社の React アプリのコンポーネント整理をするために、「既存のコンポーネントを全部調べてカテゴリ分けして」と指示したことがあります。

すると Claude Code が勝手にサブエージェントを複数走らせて、フォルダ構成・コンポーネントの依存関係・props の型定義などを並列で調べてきてくれました(・∀・)

「全部探して報告して」と言った記憶しかないのに、気づいたらかなり整理された調査結果が出てきていて、最初は本当に驚きました。

同じことを自分でやろうとしたら半日以上かかっていた作業が、15〜20分くらいで終わったのはかなりインパクトがありましたね！

別の場面では、既存コードのリファクタリングを頼んだとき、変更が必要なファイルをサブエージェントが洗い出しながら順に修正を進めてくれたこともあります。

コードベースが大きくなるほど、この並列処理の恩恵が大きくなる印象です。

一番変わったのは「大きなタスクを投げることへの心理的なハードル」が下がったことですかね。

以前は「このファイルだけ」「このコンポーネントだけ」と範囲を細かく絞ってから指示を分けていました(´･ω･`)

でも今は「このリポジトリ全体を見て最適な設計を提案して」くらいの大ざっぱな指示でも、かなり精度の高い結果が返ってくるようになっています。

作業の分解を自分でしなくてよくなったのは、エンジニアとして体感できる変化の中でもかなり大きい部類だと思います！

また、「調査 → 提案 → 実装」という流れを自分で管理しなくていいのも、さりげなくストレスが減ります。

サブエージェントが動くタスクはトークン消費がかなり増えます(・_・;)

「気づいたらもうかなりトークン使ってた」みたいなことが最初のうちにあったので、大きなタスクを投げるときは意識しておくと安心です。

また、サブエージェントの処理が並列で進むぶん、途中の経過が少し把握しにくくなることがあります。

「今なにやってるの？」という状況が見えにくいときがあるので、複雑なタスクを投げたあとは進捗の確認もちゃんとしながら進めた方がよさそうです。

コンテキストが分散するせいか、サブエージェント間で情報の連携がうまくいかない場面も稀にあります。

そういうときは範囲を少し絞って指示し直すと、スムーズに進むことが多いですね。

パパ系Webエンジニア〜愛用ガジェット一覧 🛍️

AI開発・執筆に使っている作業デスク環境を楽天ROOMにまとめています ✨ デスク周りの参考にどうぞ 🙌

Claude Code のサブエージェント機能は、特に大きなコードベースの調査や広範な修正作業でかなり力を発揮します！

Claude Code をすでに使っている方は、大きめのタスクをあえて細かく分解せずそのまま投げてみるのをおすすめします🙌