掲載済み (2026-02-14号)
#143 148文字 • 1分

Agent TeamsとHooksの統合で分かったこと

原題: Agent TeamsとHooksの統合で分かったこと

日本語

掲載情報

概要

Claude Codeの実験的機能『Agent Teams』とHooks APIを組み合わせ、LLM任せの挙動に確定的なフロー保証やコスト制御、状態の永続化を付与する検証記録。

詳細内容

Claude Code v2.1.32で追加されたマルチエージェント機能「Agent Teams」を、Hooks APIで高度に制御する手法を検証した記事です。主な発見として、チームメイトの実行は同一プロセス内のシリアライズされたツール呼び出しであり、既存のHookで捕捉可能であることや、`TaskCompleted`や`TeammateIdle`など専用Hookの存在を明らかにしています。特に、Hookタイプごとに「exitコードによるブロック」と「stdoutのJSON decisionによるブロック」が混在している仕様の落とし穴を詳述。これらを活用し、依存タスク未完了時のタスク終了拒否、ツール実行回数制限によるコスト管理、セッション終了時の状態スナップショットと次セッションでの復旧手順注入といった、実用的な自律エージェント制御のアーキテクチャを提案しています。