Claude Code Sub-agents

変更前

対話的な会話の文脈を引き継いでバックグラウンドで処理を行う「フォークサブエージェント」機能は、主にインタラクティブな CLI モードでの使用を想定しており、SDK やスクリプト経由の非対話実行では制限がありました。

変更後

非対話型の自動化シナリオでも、現在のコンテキストを維持したままサブエージェントを分岐させることが可能になりました。環境変数でこの機能を有効化できます。

ユーザーへの恩恵

複雑なワークフローの自動化スクリプトにおいて、コンテキストの継承を活用した高度な並列処理が可能になります。

変更前

「パーミッション確認をスキップする」設定にしていても、Claude Code 自身の構成ファイルが格納される特定のディレクトリへの書き込みには、安全上の理由から追加の確認が求められていました。

変更後

スキルやエージェントの定義ディレクトリへの書き込みが自動承認の対象に含まれました。これにより、Claude に自身のスキルを自律的に追加・修正させる際のフローが中断されなくなります。

ユーザーへの恩恵

Claude に自身の機能を拡張させる自動化タスクにおいて、ユーザーが手動で承認ボタンを押す手間が省け、完全な自律動作を実現できます。

変更前

スクリプトなどから -p フラグで実行する際、カスタムエージェントの設定で禁止したツールが無視されて使用されてしまう可能性がありました。

変更後

非対話モードでもフロントマターの設定が厳密に守られ、エージェントが使用できるツールの制限が対話モードと完全に同期されました。

ユーザーへの恩恵

CI/CD パイプラインなどの自動実行環境においても、意図しないツールの実行を防ぎ、セキュリティと動作の予測可能性を高めることができます。

変更前

組み込みエージェント（Explore や Plan など）を明示的に呼び出した際、そのエージェントに定義されている推奨パーミッションモードが反映されないことがありました。

変更後

エージェントごとに設定された最適なパーミッションモード（例：読み取り専用、または自動承認）が自動的に適用されます。

ユーザーへの恩恵

タスクに合わせて最適な安全レベルや自動化レベルが設定済みのエージェントを、手間なく安全に利用開始できます。

変更前

複数の MCP サーバーを接続している場合、一つずつ順番に接続処理が行われていたため、接続完了まで待機時間が発生していました。

変更後

接続処理が並列化され、複数のサーバーを同時に初期化するようになりました。

ユーザーへの恩恵

サブエージェントの起動や大規模なコンテキスト再構成が大幅に高速化され、作業の中断時間が短縮されます。

変更前

エージェントの権限制限によって無効化されているツールが、あたかも存在しないツールであるかのような不正確な表示になっていました。

変更後

制限されたツールであることが正しく表示されるようになります。

ユーザーへの恩恵

設定が正しく反映されているかを正確に確認でき、エージェントの挙動把握が容易になります。

変更前

サブエージェントに git ワークツリーによる分離環境を与えた際、過去のセッションで残っていた古い環境が完全にクリーンアップされず、状態が引き継がれてしまうことがありました。

変更後

各セッションで常にクリーンなワークツリーが作成・使用されるよう、分離の完全性が担保されます。

ユーザーへの恩恵

前の作業の影響を受けない独立した環境でサブエージェントが動作するため、コード生成やテストの再現性が向上し、予期せぬ副作用を防げます。

変更前

現在実行中または予定されているタスクの一覧を取得した際、並び順がバラバラだったため、特定のタスクの進捗を追跡するのが困難でした。

変更後

タスクが生成された ID 順にソートされて表示されるようになります。

ユーザーへの恩恵

タスクの実行順序や依存関係を直感的に把握しやすくなり、複雑なマルチタスクの管理がスムーズになります。

変更前

読み込み中に追記などでサイズが大きくなっているファイルに対して、本来適用されるべきサイズの上限チェックが回避されてしまうリスクがありました。

変更後

動的に成長するファイルに対しても、メモリ保護のためのサイズ制限が厳密に適用されます。

ユーザーへの恩恵

巨大なファイルの読み込みによるメモリ不足やアプリケーションのクラッシュを未然に防ぎ、システムの安定性が向上します。

変更前

フックの中で動くエージェントの動作そのものがフックを再発火させてしまい、無限ループのような不要な処理が発生していました。

変更後

検証用のサブエージェントによるアクションは、外部のフック発火対象から適切に除外されるようになりました。

ユーザーへの恩恵

フックの実行コスト（トークン使用量）が最適化され、意図しないフックの連鎖を防げます。

変更前

中断したサブエージェントを再開した際、カレントディレクトリがリセットされてしまい、相対パスでのファイル操作などが失敗することがありました。

変更後

サブエージェントが起動した際の正しい作業ディレクトリが維持されるようになりました。

ユーザーへの恩恵

複雑なディレクトリ構造を持つプロジェクトでも、サブエージェントを安心して中断・再開できます。

変更前

特定の外部環境やカスタムビルドにおいて、並列タスクを実行するためのフォークされたサブエージェントがデフォルトで制限されていた可能性があります。

変更後

環境変数 CLAUDE_CODE_FORK_SUBAGENT=1 を指定するだけで、メインスレッドのコンテキストを汚さずにサブエージェントを活用した並列処理が実行可能になります。

ユーザーへの恩恵

重い探索やログ解析をサブエージェントに分離できるため、メイン会話のコンテキストを節約し、作業効率を向上させられます。

変更前

カスタムエージェントをメインスレッドとして直接起動した際、そのエージェント専用の MCP サーバー設定が反映されない場合がありました。

変更後

エージェントファイル内に定義された MCP サーバーが自動的に起動するため、エージェントごとに必要な外部ツールへのアクセスが確実に行われます。

ユーザーへの恩恵

特定のタスクに特化したツール（GitHub、Jira など）を持つエージェントを、個別のセッションとして即座に活用できるようになります。

変更前

サブエージェントが実行されている間にユーザーが追記した内容が、履歴上で正しく記録されない不具合がありました。

変更後

実行中の入力を正しくユーザーの発言として分離・記録するように改善されました。

ユーザーへの恩恵

会話の前後関係が正確に保存されるため、後から振り返った際の混乱がなくなります。

変更前

特定のプロバイダーや古いモデルで、新しい機能であるEffort設定が不適切に送信され、通信エラーが発生することがありました。

変更後

接続先のモデルがサポートしている機能を自動判別し、適切なパラメータのみを送信するように改善されました。

ユーザーへの恩恵

Google Vertex AIなどの外部プラットフォーム利用時でも、予期せぬエラーで作業が止まることがなくなります。

変更前

Agent SDKを通じて画像を処理する際、何らかの理由で画像処理に失敗するとCLIセッション全体がクラッシュして中断されていました。

変更後

画像処理に失敗してもセッションは維持され、該当箇所がテキストの代替表示（プレースホルダー）に置き換わることで処理が継続されます。

ユーザーへの恩恵

不安定な画像データや環境に起因するエラーで作業が中断されるリスクが軽減され、長時間の自動化処理などの安定性が向上します。

変更前

これまでのコードレビューは単一のパスで行われることが多く、複雑なバグの発見や誤検知の排除において精度に限界がありました。

変更後

複数のエージェントが「バグハンター」として並列に問題を探索し、さらにお互いの指摘を検証して信頼性の高い問題リストをランク付けして提示します。

ユーザーへの恩恵

PRを作成する前に、人間によるレビューに近い多角的な視点でのチェックを自動で受けられるため、重大なバグの流出を防ぎ、チーム全体のレビュー負荷を軽減できます。

変更前

PRがスカッシュマージされた後、サブエージェントが使用していた一時的なワークツリーが削除されずに残り続け、ディスク容量を圧迫することがありました。

変更後

マージの形式を問わず、役割を終えたワークツリーがより正確に検出・削除されるようになりました。

ユーザーへの恩恵

開発マシンのストレージ容量が無駄な一時ファイルで枯渇するのを防ぎ、環境を常にクリーンに保てます。

変更前

稀に、セッションの復元ロジックが誤って無関係なサブエージェントの会話履歴をメインの会話に繋げてしまうことがありました。

変更後

セッション履歴の復元精度が向上し、会話の文脈が正しく分離・保持されるようになります。

ユーザーへの恩恵

会話が混濁することによるClaudeの混乱を防ぎ、一貫した回答を得られるようになります。

変更前

メインの会話に追加された新しいMCPツールを、サブエージェントが利用できない制約がありました。

変更後

サブエージェントも親セッションと同じMCPサーバーおよびツールに正しくアクセスできるようになります。

ユーザーへの恩恵

サブエージェントに調査や実行を依頼する際、連携している外部ツールの全機能を引き続き利用できます。

変更前

多くのサブエージェントを使い始めると、今どれが動いていて、どのような設定になっているかを一覧で管理するのが困難でした。

変更後

動いているエージェントと利用可能なエージェントが整理され、直感的に管理・呼び出しができるようになりました。

ユーザーへの恩恵

複雑な並行タスクの進捗状況を整理して把握でき、エージェントを司令塔のように操る体験が向上します。

変更前

複数のバックグラウンドタスクやサブエージェントが並行動作している際、どの種類のエージェントがいくつアクティブなのかを一覧で確認する手段が不足していました。

変更後

/agentsコマンドで表示されるリストから、現在どのアビリティを持つエージェントが稼働中であるかが一目で分かるようになりました。

ユーザーへの恩恵

並行処理の進行状況を把握しやすくなり、リソースの管理やタスクの完了待ちを直感的に確認できます。

変更前

サブエージェントが独立した場所で作業していても、その影響でメインセッションのディレクトリ情報が混乱し、後続のコマンドが意図しない場所で実行されるリスクがありました。

変更後

サブエージェントの作業環境が完全に隔離され、親セッションの環境に影響を及ぼさないようになりました。

ユーザーへの恩恵

複数のディレクトリをまたぐ複雑な並行作業を、メイン環境を汚すことなく安全に実行できます。

変更前

特定のエラー条件下で、ディスク容量を無駄に消費する巨大な一時ファイルが生成され、マシンのストレージを圧迫する可能性がありました。

変更後

不要なファイルの重複書き込みが防止され、ディスク使用量が最適化されました。

ユーザーへの恩恵

長時間の利用でもディスク容量を心配する必要がなくなり、ツール全体のクリーンな動作が維持されます。

変更前

以前のセッションを再開する際、特定の構成（MCPなど）を利用しているとキャッシュが効かず、最初の応答に時間がかかったりトークン消費が増えたりしていました。

変更後

セッション再開時の内部的な読み込みフローが改善され、以前のコンテキストが正しくキャッシュから再利用されます。

ユーザーへの恩恵

レジューム直後のレスポンスが高速化され、APIコストの節約にも繋がります。

変更前

@メンションの入力候補には主にファイルやMCPリソースが表示されており、特定の役割を持つサブエージェントを呼び出す際に名前を正確に覚えている必要がありました。

変更後

@を入力した際の候補にサブエージェントも含まれるようになり、プロジェクト固有のカスタムエージェントなどを素早く選択できるようになりました。

ユーザーへの恩恵

タスクの委任がスムーズになり、特定の専門知識を持つサブエージェントをより直感的にワークフローに組み込めます。

変更前

表示されるトークン使用量が実際よりも少なく、正確な利用状況の把握が困難でした。また、アップデートに伴い過去の統計が消えてしまうことがありました。

変更後

サブエージェントの利用分も含めた正確な集計が行われ、かつバージョンアップ時も過去の履歴が適切に維持されるようになりました。

ユーザーへの恩恵

コスト管理や利用傾向の分析を、長期にわたってより信頼性の高いデータに基づいて行えるようになります。

変更前

特定の役割を持つサブエージェントを呼び出す際、名前を正確に覚えている必要があり、入力の手間がかかっていました。

変更後

@ を入力するだけでファイルやMCPリソースと同様にサブエージェントも候補に表示されるようになり、素早く選択できます。

ユーザーへの恩恵

特定のタスクに特化したサブエージェント（コードレビュアーなど）を即座に呼び出せるようになり、マルチエージェントを活用したワークフローがよりスムーズになります。

変更前

メインの会話以外の、サブエージェントが実行したタスクや分岐したセッションでのAI利用量が統計に反映されず、実際の負荷より少なく表示されていました。

変更後

全ての関連セッションのトークン使用量が統合して集計されるようになり、正確な利用統計が表示されます。

ユーザーへの恩恵

プロジェクト全体での正確なAI利用量とコストを把握できるようになり、リソース管理や予算計画が立てやすくなります。

変更前

作業中のちょっとした質問ができる /btw コマンドにおいて、AIの回答が画面に収まらないほど長い場合、末尾が読めず、スクロールもできないことがありました。

変更後

回答エリアがスクロールに対応し、情報量が多い場合でも全文を快適に読み進めることができます。

ユーザーへの恩恵

文脈を壊さずに詳細な解説を求めることができ、AIからの深い洞察を余さず吸収して開発に活かせるようになります。

変更前

起動時に「セットアップ」「スラッシュコマンドのロード」「エージェントのロード」を順番に行っていたため、入力が可能になるまでわずかな待ち時間がありました。

変更後

これらの準備処理を並列で実行するように改善され、起動時間が約30ms短縮されました。

ユーザーへの恩恵

claude と打ち込んでから入力できるようになるまでのレスポンスがより機敏になり、開発のリズムを崩しません。

変更前

メインセッションで --json-schema を使用している際、ワークフロー内で起動されるサブエージェントもスキーマを指定しようとすると、APIリクエストの競合により400エラーが発生していました。

変更後

ネストされたエージェント呼び出しにおけるスキーマの処理が適正化され、エラーなく実行できるようになりました。

ユーザーへの恩恵

構造化出力が必要な複雑なタスクをサブエージェントに分担させる高度な自動化スクリプトが安定して動作します。

変更前

バックグラウンドタスクの結果を確認するために専用の TaskOutput ツールを使用していましたが、これは標準的なファイル読み込みツールとは異なる挙動をするため、管理が複雑でした。

変更後

バックグラウンドタスクの出力が通常のファイルとして扱えるようになり、実績のある Read ツールで透過的にアクセスできるようになりました。

ユーザーへの恩恵

Claude がより一貫した方法でタスク結果を分析できるようになり、実行結果の取得や加工の精度が向上します。

変更前

会話履歴が非常に長いセッションで、以前のやり取りがいつの間にか消えてしまい、コンテキストが失われるリスクがありました。

変更後

大規模なセッションデータの処理が改善され、サブエージェントを含む複雑な履歴も正しく保持・再開できるようになりました。

ユーザーへの恩恵

長期間にわたる複雑な開発タスクでも、Claude が過去の経緯を忘れずにサポートし続けられます。

変更前

サブエージェントの設定で詳細なモデルバージョンを指定しても無視されることがあり、期待した性能のモデルが起動しない場合がありました。

変更後

サブエージェントの設定で、メインセッションと同じように正確なモデルIDを使用して、特定の用途に最適なモデルを確実に割り当てられるようになります。

ユーザーへの恩恵

タスクごとに最適なモデルを確実に使い分けることができ、精度の向上やコストの最適化を正確に制御できるようになります。

変更前

サブエージェントに opus や sonnet を指定しても、クラウドプラットフォームの制約により意図せず古いモデルが使用されることがありました。

変更後

各プロバイダーでのモデルエイリアス解決が修正され、常に最新の Claude 4.6 (Sonnet/Opus) などの指定したスペックが正しく適用されます。

ユーザーへの恩恵

サブエージェントが本来の推論能力をフルに発揮できるため、複雑なタスクの解決精度が向上します。

変更前

サブエージェントを呼び出す際、特定の呼び出しにおいて一時的に異なるモデル（例：推論に優れた Opus など）を使用する柔軟性が欠けていました。

変更後

Agent ツールの引数として model パラメータが再び利用可能になり、呼び出しごとに最適なモデルを指定できるようになりました。

ユーザーへの恩恵

基本は高速な Sonnet を使いつつ、難解なタスクのサブタスクのみ Opus に任せるといった、コストと精度の細かな調整が可能になります。

変更前

元のセッションから分岐して別の解決策を試そうとしても、プランファイル（plan file）が共有されていたため、試行錯誤の内容が混ざってしまう問題がありました。

変更後

フォークされたセッションごとに独立したプランファイルが保持されるようになり、一方の変更が他方に影響を与えることなく並行して作業できます。

ユーザーへの恩恵

複数のアプローチを安全に比較・検討できるようになり、大規模なリファクタリングなどの設計作業がより確実になります。

変更前

特定のエージェントを指定して起動している際、複数のターミナルを開いているとどのアシスタントが稼働中か一目で把握できませんでした。

変更後

ターミナルのタイトルバーにエージェント名が表示されるようになり、コンテキストの識別が容易になりました。

ユーザーへの恩恵

複数の並列タスクを異なるエージェントで実行している場合に、ウィンドウの切り替えミスを防ぎ、作業効率を向上させます。

変更前

フックが実行された際、それがメインセッションによるものか、どの種類のサブエージェントによるものかをプログラムで判断できませんでした。

変更後

エージェントの種類に応じた条件分岐がフック内で可能になり、サブエージェント専用の制御フローを実装できるようになりました。

ユーザーへの恩恵

サブエージェントごとの権限制限や通知内容の変更など、より高度で精緻な自動化が可能になります。

変更前

フック内で、現在実行中のアクションがメインスレッドによるものか、それとも特定のサブエージェントによるものかを判別して処理を分けることが困難でした。

変更後

フックハンドラーに渡される JSON にエージェントの情報が含まれるようになったため、「このエージェントが実行するときだけは特定の処理をスキップする」といったきめ細やかな制御が可能になりました。

ユーザーへの恩恵

サブエージェントを活用した複雑な自動化において、フックの挙動を意図通りに制御できるようになり、より高度な開発支援環境を構築できます。

変更前

サブエージェントを使用する長時間セッションで、プログレスメッセージのペイロードがメモリを圧迫し、メモリ使用量が増加していました。

変更後

コンテキスト圧縮時に重いプログレスメッセージペイロードが除去されるようになり、サブエージェント利用時のメモリ効率が向上しました。

ユーザーへの恩恵

長時間にわたるサブエージェントの使用におけるメモリ効率が大幅に改善され、パフォーマンスが向上します。

変更前

以前は、サブエージェントがコードベースに変更を加える際、メインの作業ディレクトリに直接変更が適用される可能性がありました。これにより、サブエージェントが意図しない変更を加えたり、実験的な作業が他の開発者の作業と衝突したりするリスクがありました。

変更後

サブエージェントの設定でisolation: "worktree"を指定することで、サブエージェントが独立したGitワークツリー内で作業を行うことができるようになりました。これにより、サブエージェントが行うすべての変更はそのワークツリー内に隔離され、メインのコードベースや他のサブエージェントの作業に影響を与えません。

ユーザーへの恩恵

サブエージェントを使用した大規模な変更や実験的なタスクを、より安全かつ独立して実行できるようになります。メインプロジェクトへの意図しない変更のリスクが低減され、サブエージェントは自信を持ってコードを変更・テストできるため、開発者は安心してAIにタスクを任せられるようになります。

変更前

以前は、.claude/agents/ディレクトリにエージェントではない通常のMarkdownファイルを配置すると、不必要な警告が表示されることがありました。これにより、ユーザーはこれらの警告に煩わされ、重要な情報を見落とす可能性がありました。

変更後

今回の修正により、.claude/agents/ディレクトリ内にあるMarkdownファイルがエージェントに関連しない場合でも、誤った警告が表示されなくなりました。システムは正しくエージェント関連ファイルとそれ以外のファイルを区別します。

ユーザーへの恩恵

ユーザーは、.claude/agents/ディレクトリをより柔軟に利用できるようになり、開発環境が警告で煩雑になることがなくなります。これにより、よりクリーンで集中しやすい作業環境が提供され、生産性が向上します。

変更前

以前は、エージェントがサブエージェントを起動する際に、どのサブエージェントタイプでも自由にスポーンできるため、特定のワークフローにおいて意図しないサブエージェントが起動される可能性がありました。これにより、セキュリティポリシーの適用や、特定のタスクに特化したエージェントの利用を強制することが困難でした。

変更後

今回、エージェントのツール設定においてAgent(agent_type)という構文を使用することで、メインスレッドとして実行されているエージェントがスポーンできるサブエージェントの種類を明示的に制限できるようになりました。例えば、tools: Agent(worker, researcher)と設定すれば、workerとresearcherサブエージェントのみが起動可能となり、その他のサブエージェントの起動は失敗します。

ユーザーへの恩恵

この機能により、サブエージェントの利用に関してより厳密な制御が可能になります。特定の役割を持つエージェントが、その役割に必要なサブエージェントのみを起動するように制限できるため、ワークフローの予測可能性とセキュリティが向上します。これにより、開発者はより安全で効率的なマルチエージェントシステムを構築できるようになります。

変更前

サブエージェントからSDK提供のMCPツールを利用しようとすると、ツールが利用できない、または同期されておらずアクセスできない問題が発生していました。

変更後

サブエージェントからSDK提供のMCPツールへアクセスできるよう、共有アプリケーションステートとの同期が修正されました。

ユーザーへの恩恵

サブエージェントがMCPツールをより効果的に利用できるようになり、機能拡張性が向上しました。

変更前

ローカルスラッシュコマンドを実行する際、/model や /theme などで、モデルやテーマの選択 UI が一瞬表示されて消えることがありました。

変更後

ローカルスラッシュコマンド実行時に、モデルやテーマの選択 UI が一瞬表示されて消える現象を修正しました。

ユーザーへの恩恵

コマンド実行時の UI のちらつきがなくなり、よりスムーズで快適な操作感を提供します。

変更前

/tasks でバックグラウンドタスクを管理している際、Web セッションへのリンクが壊れたり、ローカル端末へセッションを引き継ぐ(テレポートする)ことができない場合がありました。

変更後

/tasks コマンド経由でもリモート連携機能が正しく動作するようになり、Web と端末間のシームレスな行き来が可能になります。

ユーザーへの恩恵

複数のタスクを並行して進める際、場所や端末を選ばずスムーズに作業を再開できるようになり、開発の継続性が保たれます。

変更前

スキルやコマンドを実行するとメインの会話コンテキストに履歴が蓄積され、トークン消費の増大や、メインエージェントの思考へのノイズ発生が避けられませんでした。

変更後

実行環境を独立したサブエージェントとして切り出せるようになり、大量のファイル読み込みや複雑な調査をメインの履歴を汚さずに行えます。

ユーザーへの恩恵

メインの会話履歴(コンテキスト)を節約しつつ、特定のタスクのみを専門のワーカーに任せるような高度な自動化フローを構築できます。

変更前

メインセッションで設定したクロスリージョン推論のオプションが、新しく起動したサブエージェントに正しく引き継がれず、特定のリージョンに制限された権限環境でエラーになっていました。

変更後

すべてのサブエージェントが親セッションの推論設定を正しく共有するようになり、分散リージョン環境でも安定して動作します。

ユーザーへの恩恵

グローバルな AWS インフラを利用しているエンタープライズユーザーも、サブエージェント機能を確実に利用できます。