
Claude Code で 4 並列の動画オーケストレーター — 1 セッションでは絶対無理だった
1 セッションで動画 1 本作るのに 30 分かかる。タイムアウトもしょっちゅう起きる。並列で 4-5 本同時に走らせたい。
ここに行き着くまで、Claude Code のセッションとサブエージェントの仕様で何度も詰まった。最終的に skill→director→subagent の 3 階層オーケストレーターと、Bash 直叩きフォールバックの組み合わせで、毎晩 4-5 本が 2 時間半で同時完成する状態にたどり着いた。今日はその設計の話をする。
1 セッション 1 タスクの壁
最初は素直に 1 セッションで 1 本ずつ作っていた。
セッションを開いて「nihon-mikaiketsu の slug をひとつ作って」と指示する。台本が出る。サムネが出る。素材集めが走る。ナレーション合成、編集、QA、レビュー…と進んで、1 本に 30-60 分。途中でセッションが context 飽和してタイムアウトしたり、長文ログを読み返した瞬間に応答速度が落ちたりする。
8 チャンネルあって月 240 本作りたい。1 本 30 分でも、直列で回したら 1 日 8 時間動かしっぱなしでも 16 本が限界。そもそも人間が起きて見張っていないと、エラー時にリカバリできない。

並列化したい。複数チャンネルを同時に走らせて、人間は朝レビューだけ。これが目標になった。
子エージェントは Agent ツールを持てなかった
Claude Code には Agent ツールがある。これでサブエージェントを起動できるなら、親 Claude(オーケストレーター)から director を spawn して、director が scriptwriter / scout-broll / editor を spawn して…という再帰構造が組めるはず。
そう思って書いたら、director の中で Agent ツールが使えなかった。frontmatter で `tools: Agent` と宣言しても、function 一覧に出てこない。エラーじゃない、物理的に存在しない。
最初は宣言ミスかと思って何度も書き直した。が、Anthropic SDK のサブエージェント仕様を最小再現で確認したら、これは仕様だった。サブエージェント context で起動された Claude は、再帰 spawn を禁止されている。親セッションだけが Agent ツールを使える。

ドキュメントには明記されていない。最小再現コードを書いて検証して初めて分かった。SDK 制約は読むものじゃなく、踏んでみて確認するものだった。
3 階層オーケストレーターに分けた
制約が分かれば設計はシンプルになる。Agent ツールを持てる「親セッション」を 1 つ用意して、そこに複数の director を直接 spawn させる。director は子エージェントなので Agent を持てない。だから director の下層は別の手段で動かす。
行き着いたのは 3 階層構造だ。
skill 層(親セッション内で実行)が一番上にいて、ここが Agent ツールを保有している。bulk-approve という skill を作って、ここから director を直接 spawn させる。skill は agent と違って親セッション内に展開される仕様で、Agent ツールが常時利用可能だ。
director 層は中間の責任者として、Stage1/Stage3/Stage3.7 の進行管理と、各 subagent への指示出しを担う。Agent ツールは持てないが、各種 src/*.py の Bash 直叩きならできる。
subagent 層(scriptwriter / scout-broll / editor / thumb-qa 等)が末端の実装者で、本来は director から Agent で呼びたかったが、ここを Bash フォールバックに置換した。

skill→director は Agent spawn、director→subagent は Bash 直叩き。階層ごとに使えるツールが違うのが、最初は気持ち悪かったけど、SDK 制約を踏まえると一番素直な解だった。
Bash 直叩きフォールバック表
director から subagent を呼ぶ部分は、すべて「もし Agent が使えなければ Bash で代替する」というフォールバック表に整理した。これを director.md に書いて、director セッションが起動時に必ず読むようにした。
scriptwriter は src/scriptwriter.py を呼ぶか、director 自身が script.json を Write する。scout-broll は dl_stock.py と gen_ai_scenes_v2.py の組み合わせ。editor は synthesize.py + prebuild_layers.py + compose.py。QA 系は qa_*.py をそのまま叩く。thumbnailer は gen_thumb_api.py、video-qa は ffmpeg でフレーム抽出して director が自前で Vision 判定する。

副作用として「Agent が使えない = エラー」じゃなく「Agent が使えない = Bash で動く」と認識を切り替えた瞬間、実装が一気に進んだ。物理的に Agent が無いのは正常状態であって、stop の理由にしてはいけない。これを director の system prompt に明記した。
4-5 並列で 2 時間半に縮んだ
3 階層構造が動き始めてから、bulk-approve 経由で 4-5 director を同時 spawn できるようになった。
実績ベースで書く。RUN4 では 5 director 並列で nihon-mikaiketsu の 013-017 を同時進行させて、5 本完成まで約 2 時間 30 分だった。直列なら 1 本 30 分 × 5 本 = 2 時間 30 分なので、見かけ上同じに見えるが、並列は人間の介入時間がほぼゼロで済む。直列だと「次の slug 起動」を 5 回手動で入れないといけない。
VOICEVOX エンジンも 4 ポート並列で起動して、各 director が空きポートにラウンドロビンで投げる構成にした。並列度の上限は VOICEVOX の空きエンジン数で自然に決まる。

人間の作業は朝の bulk-approve 起動と、夜のレビューだけになった。1 ch 1 セッションの壁を抜けて、ようやく月 240 本のスループットが現実味を帯びてきた。
失敗時の責任分界を明確にした
並列稼働すると失敗パターンも変わる。1 director だけ詰まる、5 director 全員が global lock 待ちで stall、片方の director の retry で synthesize が二重起動、など、直列では起きなかった事故が出てくる。
ここで効いてきたのが「監督役は人間に残す」というルールだった。AI には実装(コード生成・編集・QA 実行)を任せて、戦略判断(rebuild するか、許容投入するか、MD を見直すか)は人間が下す。bulk-approve は事前承認役として Stage1/3/3.7 を自動 PASS させるが、Stage4 の最終アップロード判断だけは人間の `make approve` に固定した。

3 階層オーケストレーターは「AI が AI を呼ぶ」構造に見えるが、最上段は必ず人間で終わる。再帰 spawn 禁止の SDK 制約は、結果的にこの責任分界とも整合的だった。子エージェントが再帰 spawn できたら、人間が知らないうちに 100 director が動き出す世界もあり得る。SDK 側がそれを止めてくれていた、と今は思う。
まとめ — Claude エージェント階層は 3 段が解
1 セッション 1 タスクの壁を超えるには、エージェントを階層化するしかない。だけど Anthropic SDK の制約で、再帰 spawn は禁止されている。だから skill→agent→bash の 3 階層が現実解になる。
学んだのは 3 つ。SDK 制約は明文化されていないので、最小再現で踏んで確認するしかない。Agent ツールが使えない場合のフォールバックは、エラーじゃなく正常動作として設計に組み込む。監督役は人間に残して、AI には実装だけ任せる。
これを 8 ch × 月 240 本の量産パイプラインに組み込んで、いま毎晩 4-5 本が並列で完成している。
設計テンプレをプレゼントします
bulk-approve skill と director の Bash フォールバック表を、エージェント定義テンプレと一緒に PDF にまとめました。実際にうちで動いている設定の抜粋です。明日から自分の制作パイプラインに使えます。

公式LINEに登録してくれた方にお送りします。
法人のご相談はこちら
自社のYouTubeチャンネルを自動化したい、AIで動画運用代行を頼みたい、というご相談は、別途お受けしています。
