Claude Codeのサブエージェントの使い方(並列作業・分担・統合と、同じファイル・重複・品質差・消費・待機の注意)

参考 AI活用公開・保守・運用 更新 2026-09-26
要点

サブエージェントは独立した作業(小カテゴリごとの原稿、分野ごとの調査・分類・比較)を並列にするのに向く。担当ファイルを分けて同じファイルを触らせない、共通ブリーフを渡す、戻り値は要点だけ、最後にメインで統合と検査をする。大量生成では生成役と検査役を分ける。

記事原稿の並列執筆の具体例は サブエージェントで記事原稿を並列執筆する方法(共通ブリーフ)(confirmed)。

向いている作業

作業分け方の例
大量記事生成小カテゴリ1つ(8記事)=1エージェント
調査分野ごと・サイトごと・資料ごとに担当
分類・整理ファイル群を範囲で分けて分類させ、結果の表だけ返させる
比較候補ごとに同じ観点で評価させる
検査生成とは別のエージェントに、基準表で検査させる

互いの結果に依存する作業(前の結果を見て次を決める)は、並列にせず順番に行う。

注意点

  • 同じファイルを複数エージェントに触らせない: 担当するファイル・フォルダを分ける。共有ファイル(一覧・索引)の更新は最後にメインが1回だけ。
  • 最終統合が必要: 各エージェントの結果をメインで集め、全体の整合(重複・表記・リンク)を確認する。
  • 重複生成: 他のエージェントの内容は見えない。ブリーフに「他の担当が扱う内容」「踏み込まない範囲」を書く。
  • 品質差: エージェントごとに文体・長さがずれる。共通ブリーフ・見本・表記ルール・自己チェック項目を渡す。
  • 大量消費: エージェントごとに読み込み・生成の消費がある。戻り値は「ファイルパスと見出し一覧」など要点だけにし、本文を返させない(Claude消費量を抑える検査・作業ルール)。
  • 待機状態: 結果は完了通知が来るまでない。待っている間に同じ作業を別に始めない。止まったら、どのファイルまでできたかを確認して不足分だけ作り直す(Claude Codeが途中で止まる(APIエラー・応答停止・サブエージェント待機・コンテキスト切れ))。
  • 数は必要な分だけ。細かく分けすぎると統合の手間と消費が増える。

大量ページ制作では生成と検査を分ける

  1. 生成: テンプレート固定で中身だけをサブエージェントに書かせる。
  2. 機械検査: 文字数・禁止タグ・類似度・リンクをスクリプトで確認(AIで大量ページを作るときの品質管理(小さく試す・テンプレート固定・自動検証・抜き取り確認))。
  3. 抜き取り確認: 人(またはメイン)が一部を読む。
  4. 不合格分だけ作り直す。

生成したエージェント自身に「問題ないか」を確認させるだけでは見落としが残る。