Claude Code Sub-agents

変更前

会話から fork したバックグラウンドワーカーが、セッション途中に会話のツールブロックへ EnterWorktree を追加していました。fork は本来、親会話と完全に同じツールプールを受け取るため、この追加によってツール構成が途中で変わり、プロンプトキャッシュの再利用が壊れていました。

変更後

EnterWorktree を会話のツールブロックに途中で追加する処理がなくなり、fork が親会話と同一のツールセットを維持するようになりました。その結果、プロンプトキャッシュの再利用が壊れなくなりました。

ユーザーへの恩恵

会話から fork したバックグラウンドワーカーでもプロンプトキャッシュが親会話と共有され続け、コストと応答のオーバーヘッドが抑えられるようになります。

変更前

フォアグラウンドで起動した subagent を再開すると、ツールリストと system prompt の prefix が変わり、その agent 用に確保された prompt cache が再利用されずキャッシュミスが発生していた

変更後

フォアグラウンドで起動した subagent を再開した際も、ツールリストと system prompt の prefix が最初の起動時と同一に保たれるようになった

ユーザーへの恩恵

subagent を再開しても prompt cache が再利用されるため、再開時のコストとレイテンシが増えなくなった

変更前

コマンドやスキルの frontmatter で指定されたモデルが Claude Code がサポートしていない場合、自動モードがそのモデルでターンを実行しようとしていた。その結果、意図しないモデルで処理が進んでしまうことがあった。

変更後

コマンドやスキルの frontmatter で指定されたモデルがサポートされていない場合、自動モードはそのモデルでのターン実行を避け、セッションで設定されているモデルを維持してターンを開始するようになった。

ユーザーへの恩恵

ユーザーは意図しないモデルで処理が走ることを防ぎ、セッション設定されたモデルで確実に作業を進められるようになる。

変更前

リモート制御セッションでバックグラウンドエージェントやワークフローを停止しようとしても、実際には停止されずプロセスがそのまま実行され続けていました。停止操作を行ってもタスクが消えず、再停止しようとしても反応しない状態でした。

変更後

リモート制御セッションでバックグラウンドエージェントやワークフローを停止した場合、プロセスが終了するまでそのタスクが画面上に表示され、再度停止操作を行うことが可能になりました。停止したタスクは削除されず、プロセス終了まで管理可能な状態になります。

ユーザーへの恩恵

停止したバックグラウンドタスクが画面上に残るため、意図せず実行が継続しているプロセスを確認し、プロセス終了まで再停止操作を行えるようになります。

変更前

作業ツリー分離セッションでは、メインチェックアウトに到達できない一般的な Bash ループや xargs パイプライン、ラッパー付きコマンドなどが実行されると、セッションがそれらを拒否してエラーとなっていました。

変更後

作業ツリー分離セッションは、メインチェックアウトに到達できない一般的な Bash ループ、xargs パイプライン、およびラッパー付きコマンドを正常に実行できるようになりました。

ユーザーへの恩恵

作業ツリー分離セッションであっても、一般的なシェル構文やパイプラインを含むコマンドを安全に実行できるようになります。

変更前

JSON の結果は整形されておらず、1行で表示される場合がありました。また、長い結果は折りたたまれておらず、画面外に表示されることもありました。

変更後

JSON の結果はシンタックスハイライトと改行を適用して整形され、可読性が向上しました。長い結果は展開ボタンで折りたたまれるため、画面の見やすさが改善されました。

ユーザーへの恩恵

JSON の結果を整形して表示するため、エラーの原因を素早く特定できるようになります。

変更前

ネストされたバックグラウンドサブエージェントの結果は親サブエージェントのトランスクリプトに保存されず、サブエージェントが再開された際に結果が失われたり、共有トランスクリプトに表示されなかったりする問題があった。

変更後

ネストされたバックグラウンドサブエージェントの結果が親サブエージェントのトランスクリプトに保存されるようになり、サブエージェントが再開された際に結果が維持され、共有トランスクリプトに配信内容が表示されるようになった。

ユーザーへの恩恵

サブエージェントの再開や共有時でも結果が維持されるため、一貫した作業履歴を確認できるようになる。

変更前

権限承認を再送したものの適用に失敗した後、リモートセッションやスケジュールされたセッションで「ユーザーメッセージは空であってはならない」というエラーが発生してセッションが失敗する状態がありました。

変更後

権限承認を再送した後も、リモートセッションやスケジュールされたセッションが正常に動作するようになりました。

ユーザーへの恩恵

権限承認の再送後もリモートセッションやスケジュールされたセッションが正常に動作するようになります。

変更前

サブエージェントのモデルは、個別の起動時の指定やエージェント定義の model フィールドによって上書きされることがありました。

変更後

この環境変数を設定すると、サブエージェント、チームメイト、ワークフローエージェントすべてに対して、個別の起動時の指定やエージェント定義のモデル設定を無視して、指定されたモデルが適用されるようになります。

ユーザーへの恩恵

プロジェクト全体で一貫したモデルをサブエージェントに適用できるようになり、設定の管理が容易になります。

変更前

バックグラウンドセッションがスケジュールされた起床を行うと、state.json ファイル内の detail フィールドに、セッションの起動時に使用された元のディスパッチプロンプトが再び記録されていました。

変更後

スケジュールされた起床後、state.json の detail フィールドには、正しくはセッションの状態詳細が記録されるべきところ、起動時のプロンプトが重複して保存されていました。

ユーザーへの恩恵

バックグラウンドセッションの履歴や状態詳細を確認する際、不要なプロンプトの重複が表示されなくなり、正確な情報を把握できるようになります。

変更前

バックグラウンドセッションで再プロンプトした後、そのセッションが完了すると「完了」タブの一番下に埋もれて表示されていました。また、完了したセッションの並び順が固定されていました。

変更後

バックグラウンドセッションで再プロンプトした後、そのセッションが完了しても「完了」タブに最新の終了時刻順で表示されるようになりました。

ユーザーへの恩恵

完了したセッションを最新の終了時刻順で確認できるようになり、再プロンプトしたセッションを見つけやすくなります。

変更前

バックグラウンドセッションで別のセッションからのメッセージが届いた際、承認待ちであることや誰からのメッセージかを通知しませんでした。

変更後

バックグラウンドセッションで別のセッションからのメッセージが届いた際、承認待ちであることや誰からのメッセージかを通知するようになりました。

ユーザーへの恩恵

ユーザーはバックグラウンドセッションで待機している承認リクエストの内容と送信元を把握できるようになります。

変更前

バックグラウンドセッションで Ctrl+S を押してプロンプトをスタッシュしておいても、セッションがアイドル状態になったり停止して再開されたりすると、スタッシュしたプロンプトが消えてしまい、再開後に再度スタッシュする必要がありました。

変更後

バックグラウンドセッションで Ctrl+S を押してプロンプトをスタッシュしておくと、セッションがアイドル状態になったり停止して再開されたりしても、スタッシュしたプロンプトが保持され、再開後も即座に使用できるようになりました。

ユーザーへの恩恵

バックグラウンドセッション中に Ctrl+S でプロンプトをスタッシュしておくと、セッションの再開時にプロンプトを再入力する手間が省けます。

変更前

サブエージェント間でトランスクリプトを切り替えると、トークンカウンターがフリーズしたり、更新が極端に遅くなったりしていました。応答のストリーミング中も、バックグラウンドで動作しているサブエージェントやチームメイトのトークン使用状況が正しく反映されないことがありました。

変更後

サブエージェントのトランスクリプトを切り替えてもトークンカウンターが正常に動作するようになりました。応答がストリーミングされている間、バックグラウンドで実行中のサブエージェントやチームメイトのトークン使用状況がリアルタイムで更新されます。

ユーザーへの恩恵

ユーザーは、サブエージェント間の切り替えや応答のストリーミング中も、トークン消費状況をリアルタイムで正確に把握できるようになります。

変更前

コンピュータのスリープや通信切断、サーバーエラーが発生すると、サブエージェントは応答が不完全なまま終了していました。

変更後

これらのエラーが発生しても、サブエージェントは完了した部分を保持し、自動的に継続処理を行うようになりました。

ユーザーへの恩恵

ユーザーは手動で継続コマンドを入力する必要がなく、応答の途切れを気にせず作業を継続できます。

変更前

サブエージェントのトランスクリプトビューから停止した後、再開操作を行ってもメインエージェントにはその状態の変化が通知されませんでした。メインエージェントはサブエージェントが再開されたことを認識できず、意図せず新しいセッションとして扱われる可能性がありました。

変更後

サブエージェントのトランスクリプトビューから停止した後、再開操作を行うとメインエージェントにその再開が通知されるようになりました。メインエージェントはサブエージェントの再開を正しく認識し、適切なコンテキストで継続処理を行います。

ユーザーへの恩恵

ユーザーはサブエージェントを停止・再開した際、メインエージェントがその状態を正しく把握できるようになります。

変更前

サブエージェントやツールの実行中にバックグラウンド化を行うと、意図せずツールの実行が拒否されたと判定されることがありました。

変更後

サブエージェントやツールの実行中にバックグラウンド化を行っても、ツールが正しく再実行されるようになりました。

ユーザーへの恩恵

実行中の処理を中断せずにバックグラウンド化できるようになり、作業の継続性が向上します。

変更前

画像を多数読み込むなどの操作でトランスクリプトのサイズが5 MBを超えた場合、サブエージェントの再開やメッセージ送信時に「トランスクリプトが見つかりません」というエラーが発生して失敗していました。

変更後

トランスクリプトのサイズが5 MBを超えていても、サブエージェントの再開やメッセージ送信が正常に動作するようになりました。

ユーザーへの恩恵

画像を大量に処理するようなシナリオでも、サブエージェントの状態を正しく維持・操作できるようになります。

変更前

別の Claude Code プロセスが npm の更新をダウンロードしている間にバックグラウンドセッションを開こうとすると、'バックグラウンドサービスを開始できませんでした'というエラーが発生して開始に失敗していました。

変更後

バックグラウンドセッションを開始する際、別のプロセスが npm の更新をダウンロード中であっても、その更新のダウンロードが完了するまで待機してから開始を行うようになりました。

ユーザーへの恩恵

更新中にバックグラウンドセッションを開始しようとしてもエラーにならず、待機してから開始できるようになります。

変更前

タスクパネルや接続されたクライアントからバックグラウンドコマンドを停止しても、Claude はその停止を認識しませんでした。そのため、停止操作に対して適切な応答や処理を行うことができませんでした。

変更後

タスクパネルや接続されたクライアントからバックグラウンドコマンドを停止すると、Claude は即座にその停止を認識します。停止操作に対して適切な応答や処理を行うことができるようになりました。

ユーザーへの恩恵

ユーザーはバックグラウンドコマンドを停止した後、Claude がその停止を認識していることを確認でき、適切な次のアクションを取ることができます。

変更前

バックグラウンドで実行中のサブエージェントを停止操作を行うと、関連するモニターも同時に停止されずに残存していました。

変更後

バックグラウンドで実行中のサブエージェントを停止操作を行うと、関連するモニターも適切に停止処理が行われるようになりました。

ユーザーへの恩恵

バックグラウンドで実行中のサブエージェントを停止しても、不要なプロセスが残存しないため、システムリソースの無駄遣いを防げます。

変更前

ゲートウェイのキープアライブにより応答が開いたまま保持されている間、SDK ホストへの生きている状態の報告が停止していたため、長い待機時間が発生した際にセッションがハングしたと誤認される可能性があった。

変更後

ゲートウェイのキープアライブにより応答が開いたまま保持されている間も、SDK ホストへの生きている状態の報告が継続されるようになったため、長い待機時間が発生してもセッションがハングしたと誤認されない。

ユーザーへの恩恵

長い待機時間が発生してもセッションがハングしたと誤認されることなく、適切に処理できるようになる。

変更前

元の会話のプロンプトキャッシュは新しいバックグラウンドセッションに継承されませんでした。ワークツリーのブリーフィングはシステムプロンプトの変更として扱われていました。

変更後

元の会話のプロンプトキャッシュが新しいバックグラウンドセッションに継承されます。ワークツリーのブリーフィングはシステムプロンプトの変更ではなく、メッセージとして届きます。

ユーザーへの恩恵

プロンプトキャッシュが維持されるため、セッション間のコンテキストを効率的に引き継げます。

変更前

「/btw」履歴を閲覧する際、左右の矢印キーを使用して過去の回答に戻っていました。これにより、サイド質問の履歴を遡る操作が直感的でない場合がありました。

変更後

「/btw」履歴を閲覧する際、Shift を押しながら左右の矢印キー（または [/]）を使用して、最近のサイド質問を順に遡って確認できるようになりました。さらに、現在の回答に戻る操作も容易になりました。

ユーザーへの恩恵

「/btw」履歴を遡る操作が直感的になり、サイド質問の履歴を効率的に確認できるようになります。

変更前

一部の Mac 環境では、タスクディレクトリが移動またはリンクされている場合に「task output swap refused」というエラーが発生し、Bash コマンドが失敗していました。

変更後

タスクディレクトリの状態に関わらず、Bash コマンドが正常に実行されるよう修正しました。

ユーザーへの恩恵

Mac 環境で Bash コマンドを安定して実行できるようになります。

変更前

非常に大きな失敗出力を持つバックグラウンド タスク通知が会話のコンテキストを API リクエストサイズ制限を超えてしまう問題がありました。

変更後

大きな出力を持つバックグラウンド タスク通知でも、会話が API リクエストサイズ制限を超えないよう修正しました。

ユーザーへの恩恵

大きなエラー出力があっても、会話が正常に維持されるようになります。

変更前

リモートコントロールクライアントはサブエージェントのツール呼び出しや結果をリアルタイムで表示できませんでした。バックグラウンドサブエージェントは常にステータス表示のみでした。

変更後

リモートコントロールクライアントがフォアグラウンドサブエージェントのツール呼び出しと結果をライブストリーミングで表示できるようになりました。バックグラウンドサブエージェントは引き続きステータス表示のみです。

ユーザーへの恩恵

リモートコントロールクライアントを使用するユーザーは、サブエージェントの実行状況をリアルタイムで把握できるようになります。

変更前

Workflow ツールが権限チェック前にセッションが読み取り可能な範囲外の scriptPath を読み取る可能性がありました。

変更後

Workflow ツールが権限チェック前にセッションが読み取り可能な範囲外の scriptPath を読み取らないように修正しました。これにより、セキュリティリスクが軽減されます。

ユーザーへの恩恵

開発者は、意図しないファイルへのアクセスを防ぐことができます。

変更前

思考のみを出力したターン後、会話が「テキストコンテンツブロックは空であってはならない」というエラーで詰まる状態になっていました。

変更後

思考のみを出力したターン後でも、会話がエラーで詰まることはなくなりました。

ユーザーへの恩恵

思考のみの出力後もスムーズに会話を続けられます。

変更前

別のセッションから Claude Desktop によって配信されたメッセージへの返信が失敗していました。そのセッション ID への SendMessage は「not reachable」というエラーで失敗していました。

変更後

別のセッションから Claude Desktop によって配信されたメッセージへの返信ができるようになりました。そのセッション ID への SendMessage は、以前は失敗していましたが、今は Claude Desktop 経由で配信されるようになりました。

ユーザーへの恩恵

別のセッションからのメッセージに対して、スムーズに返信できます。

変更前

多くの並列サブエージェントが存在する場合、TUI が遅延していました。秒単位の進捗ティックは、以前はトランスクリプトに積み上がっていました。

変更後

多くの並列サブエージェントが存在する場合の TUI の遅延が解消されました。秒単位の進捗ティックは、トランスクリプトに積み上がるのではなく、前のティックを置き換えるようになりました。

ユーザーへの恩恵

並列サブエージェントが多数存在する場合でも、TUI がスムーズに表示されます。

変更前

名前のない兄弟または親エージェントからのメッセージに対して、バックグラウンドサブエージェントが返信できませんでした。以前は from がエージェントタイプだったため、これはアドレスではありませんでした。

変更後

名前のない兄弟または親エージェントからのメッセージに対して、バックグラウンドサブエージェントが返信できるようになりました。以前は from がエージェントタイプだったため、これはアドレスではありませんでしたが、修正されました。

ユーザーへの恩恵

バックグラウンドサブエージェントが、適切な宛先からのメッセージに返信できます。

変更前

バックグラウンドセッションとそのサブエージェントは、git worktree add で作成した git worktree 内のファイルを編集できませんでした。

変更後

バックグラウンドセッションとそのサブエージェントは、git worktree add で作成した git worktree 内のファイルを編集できるようになりました。

ユーザーへの恩恵

git worktree 内のファイル編集が可能になり、サブエージェントの作業が正しく実行されます。

変更前

自分のサブエージェントからのメッセージが、無関係な Claude セッションからのものとして表示されていました。

変更後

自分のサブエージェントからのメッセージが、このセッション内のワーカーからのものとして正しく表示されるようになりました。

ユーザーへの恩恵

サブエージェントからのメッセージのコンテキストが明確になり、ユーザーはメッセージの発信元を正しく理解できます。

変更前

サブエージェントパネルまたは /tasks から開いたフォークのトランスクリプトを表示している間、プロンプトのプレースホルダーは以前のままの表示でした。

変更後

サブエージェントパネルまたは /tasks から開いたフォークのトランスクリプトを表示している間、プロンプトのプレースホルダーが「Message @name…」と表示されるようになりました。

ユーザーへの恩恵

ユーザーはトランスクリプトを表示中でも、フォークの名前を含んだメッセージを入力できるようになります。

変更前

サブエージェントのプロンプトキャッシュ TTL は設定されておらず、デフォルトの動作が適用されていました。

変更後

サブエージェントごとに TTL を設定できるようになりました。サブエージェント固有の設定がない場合に使用されます。

ユーザーへの恩恵

サブエージェントごとのキャッシュ有効期間を制御でき、コストやパフォーマンスを最適化できます。

変更前

同じマシン上のセッション間でメッセージングを行う機能はありませんでした。

変更後

セッション間でメッセージを送受信できるようになりました。

ユーザーへの恩恵

複数のセッション間での連携と情報共有が可能になります。

変更前

長時間のセッションで約1時間に1回、OAuth トークンの更新によりプロンプトキャッシュのミスが発生していました。

変更後

OAuth トークンの更新によるキャッシュミスが修正され、コンテキストの喪失が防がれます。

ユーザーへの恩恵

セッションのパフォーマンスとコンテキストの整合性が維持されます。

変更前

使用量超過時にセッション再開時にツール定義が不一致となり、キャッシュミスが発生していました。

変更後

ツール定義の不一致が修正され、キャッシュミスが防がれます。

ユーザーへの恩恵

セッション再開時のパフォーマンスが向上します。

変更前

サブエージェントにメッセージを送信した場合、返信がサブエージェントに届くと思われていました。

変更後

サブエージェントにメッセージを送信した場合、返信は親セッションに届くことを明示するようになりました。

ユーザーへの恩恵

メッセージの送信先を明確にし、意図しないセッションへの返信を防ぎます。

変更前

最初の呼び出しでモデル404が発生するとサブエージェントが終了し、親に適切なエラー情報が返されませんでした。

変更後

サブエージェントはフォールバックモデルチェーンを使用し、詳細なエラー情報が返されるようになりました。

ユーザーへの恩恵

エラーの原因を特定しやすくなり、トラブルシューティングが効率化されます。

変更前

大量のエラー出力が発生すると会話がオーバーフローし、セッションがフリーズすることがありました。

変更後

大量のエラー出力が発生しても会話がオーバーフローしません。

ユーザーへの恩恵

セッションの安定性が向上し、作業の中断が防止されます。

変更前

--agent で開始したセッションの /compact と「ここから要約」は、会話の設定ではなくデフォルトのシステムプロンプトの下で要約されていました。

変更後

--agent で開始したセッションの /compact と「ここから要約」は、会話の設定の下で要約されるよう修正されました。

ユーザーへの恩恵

エージェントセッションのコンテキスト要約が、セッションの設定（拡張思考など）を正しく継承するようになります。

変更前

バックグラウンドセッションのターミナルホストプロセスが終了した後、claude agents で「開始中…」が永遠に表示されていました。

変更後

バックグラウンドセッションのターミナルホストプロセスが終了した後、claude agents で「開始中…」が永遠に表示される問題が修正され、行は数秒以内に失敗とその理由を表示するようになりました。

ユーザーへの恩恵

セッションの状態異常が即座に検知され、ユーザーは Enter キーで簡単に再起動できます。

変更前

フォアグラウンドから引き継がれたシェルコマンドがバックグラウンドセッションで完了したとき、内部エラーをログに出力したり、誤解を招く [exited with code -1] 行を表示したりしていました。

変更後

フォアグラウンドから引き継がれたシェルコマンドがバックグラウンドセッションで完了したとき、内部エラーをログに出力したり、誤解を招く [exited with code -1] 行を表示したりする問題が修正されました。

ユーザーへの恩恵

バックグラウンドセッションの終了状態が正しく表示され、ユーザーはコマンドの実行結果を正しく把握できます。

変更前

/remote-control で開始されたリモートコントロールセッションは、接続されたクライアントに作業ツリーの差分を報告していませんでした。

変更後

/remote-control で開始されたリモートコントロールセッションは、接続されたクライアントに作業ツリーの差分を報告するよう修正されました。

ユーザーへの恩恵

リモートクライアントは、リモートセッションでのコード変更を即座に確認できます。

変更前

動的ワークフローで完了したサブエージェントを再起動する際、←キーを押すか /background を実行すると、即座に再起動していました

変更後

動的ワークフローで完了したサブエージェントを再起動する際、←キーを押すか /background を実行すると、再起動するサブエージェントの数を先に確認するようになりました

ユーザーへの恩恵

意図せずサブエージェントが再起動されるのを防ぎ、再起動の範囲を事前に確認できるようになりました

変更前

すでにフォーク済みまたはバックグラウンド化されたセッションから /fork を実行すると、新しいセッションが空の会話で開始されていました。

変更後

すでにフォーク済みまたはバックグラウンド化されたセッションから /fork を実行しても、新しいセッションが空の会話で開始されなくなりました。

ユーザーへの恩恵

既存の会話コンテキストが正しく継承されるようになります。

変更前

maxTurns 制限で停止したサブエージェントの出力は、完了したように見えていました。

変更後

maxTurns 制限で停止したサブエージェントの出力は、部分出力としてマークされ、SendMessage を使って継続できることを示すヒントが付与されます。

ユーザーへの恩恵

サブエージェントが途中で停止した場合でも、ユーザーは継続できることを明確に知ることができ、適切な対応が可能になります。

変更前

以前は、サブエージェントがどのモデルで実行されたかを確認できませんでした

変更後

現在は /tasks とエージェント詳細ダイアログに、各サブエージェントが実行したモデルと努力レベルが表示されます

ユーザーへの恩恵

開発者はサブエージェントの実行状況を詳細に把握できます

変更前

バックグラウンドサブエージェントは、最後のバックグラウンド Bash タスクが完了しても起動しませんでした。

変更後

バックグラウンドサブエージェントは、最後のバックグラウンド Bash タスクが完了すると正しく起動するようになりました。

ユーザーへの恩恵

バックグラウンド作業が完了した後にサブエージェントが自動的に起動するようになり、待機時間がなくなります。

変更前

サブエージェントがツールを実行している間、ユーザーが展開した Focus ビューのセクションが予期せず折りたたまれていました。

変更後

サブエージェントのツールアクティビティ中でも、展開した Focus ビューのセクションが保持されるようになりました。

ユーザーへの恩恵

サブエージェントの作業中も、ユーザーは Focus ビューの状態を維持できます。

変更前

セッションのタイトル命名で先頭に / を含めて保存すると、スラッシュコマンドや絶対パスの解釈と干渉を起こしてしまい、他のセッションから SendMessage でメッセージを送ろうとしても「エージェントが見つからない」エラーになるか、宛先として正しく選択できない不具合がありました。

変更後

エージェントの一覧取得および配信ルーティングロジックが、特殊文字で始まるタイトル文字列を正規化して適切にルーティングするように修正され、名前の先頭に / が含まれていても確実に他のセッションからアドレス指定して通信できるようになります。

ユーザーへの恩恵

特定のブランチ名など、スラッシュを含む名前を付けたセッション同士でも、問題なくメッセージを送り合って連携させることができます。

変更前

サブエージェントの実行結果が長期間保持され、メモリ消費が増大することがありました。

変更後

不要になったツール結果を自動的に解放することで、メモリ使用量を抑えます。

ユーザーへの恩恵

長時間のセッションでも、メモリ不足によるクラッシュを気にせず利用できます。

変更前

別のセッションで実行中の長時間タスクやバックグラウンド処理がいつ完了したかを知るために、手動でセッションを定期的に確認するかポーリングする必要がありました。

変更後

SendMessage ツールに notify_when_idle を指定して他セッションに要求を送信するだけで、そのセッションがアイドルになった瞬間に一度だけ自動で通知が送られるようになります。

ユーザーへの恩恵

他のセッションが実行中の作業完了を待つために、ターミナル画面を何度も切り替えて進捗を監視し続ける必要がなくなります。

変更前

必要なエージェントが起動できないセッションでAgentツールを呼び出した際、存在しない、または利用できない汎用エージェントを誤って提示し、エラーの根本原因が分かりにくかった

変更後

対象のエージェントが利用できない場合は、省略された subagent_type を検知して、現在有効なエージェントを一覧表示する親切なエラーメッセージを表示するようになる

ユーザーへの恩恵

サブエージェントの設定ミスが発生した際、どのエージェント名を指定すればよいか即座に判断できるようになる

変更前

他の独立したClaude Codeセッションにメッセージを送信する際、上限サイズを超える巨大なデータを送ろうとすると、ツール側で何もエラーを出さずにメッセージが途中で消えてしまっていたため、送信できたかどうかが分からなかった

変更後

送信ボタンを押したりツールを実行したりした段階でサイズ上限チェックが走り、制限を超える大容量メッセージは送信前にエラーとして明示的に弾かれるようになる

ユーザーへの恩恵

相手のセッションにメッセージが届いていないことに気づかないまま、作業の返信を待ち続けてしまう時間をなくすことができる

変更前

メインセッションのバックグラウンドでサブエージェントを実行中にツール許可を求められ、ユーザーが「このセッション中のみ許可/拒否」を選択しても、その決定が適切に保持されずに再度プロンプトが表示されていました。

変更後

バックグラウンドのサブエージェントに対する許可要求であっても、セッション単位で指定した承認や拒否の選択結果が正しく記憶され、セッション終了まで適用され続けます。

ユーザーへの恩恵

同じセッション内でサブエージェントがツールを起動するたびに、同じ承認ダイアログを何度もクリックして答え直す必要がなくなります。

変更前

他セッションにメッセージを送るクロスセッション機能において、宛先のセッション名が極端に長いか絵文字コードを多用していると、文字数制限やエンコーディングパースに引っかかり、メッセージが送信できない不具合がありました。

変更後

セッション名が制限値の上限付近であったり、複雑な絵文字が含まれていたりしても適切に正規化が行われ、SendMessage によるメッセージ送信が安定して動作するようになります。

ユーザーへの恩恵

セッション名の長さを削ったり、送信のために絵文字を消したりする不自然なリネーム作業を行う必要がなくなります。

変更前

以前は、サブエージェントのフォーク機能がデフォルトでオフだったため、新しいコンテキストウィンドウで最初から会話を再開する必要がありました。また、対話型セッションでのサブエージェントがフォアグラウンドで実行され、プロンプトを占有していました。

変更後

フォークされたサブエージェントが親の会話履歴とプロンプトキャッシュをすべて引き継ぎ、バックグラウンドで自動的に自律タスクを実行します。許可プロンプトは必要に応じてメインセッションのターミナルに表示されます。

ユーザーへの恩恵

サブエージェントを起動するたびに前提知識やコンテキストを手動で渡し直したり、作業完了までターミナルを占有されて待機したりする必要がなくなります。

変更前

別のClaudeセッション間で情報を共有したり連携させたりしたい場合、開発者が手動でターミナル間でテキストをコピー＆ペーストして伝える必要がありました。

変更後

プロンプト入力中に「@セッション名」と入力するだけで、Claudeが自動的にSendMessageツールを呼び出し、該当のライブセッションに直接メッセージを届けて連携します。

ユーザーへの恩恵

開発者が画面を行き来して、あるセッションでの調査結果や決定事項をもう一方のセッションにコピーペーストで転記する手間がなくなります。

変更前

SendMessageツールで他のセッションにメッセージを送信する際、名前が一致していても事前に参照情報(ref)を用いた確認の承認手続きが要求され、プロセスが中断していました。

変更後

送信先として指定された名前が1つのアクティブなライブセッションと完全一致する場合、確認プロンプトを表示することなく即座にメッセージが配信されます。

ユーザーへの恩恵

メッセージの送信確認プロンプトに対して毎回手動で承認の応答を返す必要がなくなります。

変更前

異なる開発マシン間やWeb上のRemote Controlセッション同士で通信する際、相手側のセッションから先にメッセージが送られてこなければ、こちらから新規のメッセージを送信して会話を開始することができませんでした。

変更後

ListAgentsツールで他マシンのセッション名を確認した上で、SendMessageツールを用いてこちらから一方的にメッセージを投げて新しい会話や協調タスクをトリガーできます。

ユーザーへの恩恵

別端末で立ち上げたままにしているClaude Codeのセッションに対して、自分の端末からいつでも名前を指定して遠隔タスクや連携指示を直接開始できるようになります。

変更前

クロスセッション通信時にネットワークの瞬断等で相手先リストの取得に失敗すると、意図したリモートマシン側ではなく、同じ名前を持つローカルのセッションが勝手に送信先として誤認されてデータが送られてしまうリスクがありました。

変更後

すでに一度確認が取れているリモート送信先セッションは固定して保持され、リストチェックの失敗時に同名ローカルセッションへ勝手に切り替わる動作を防止します。

ユーザーへの恩恵

ネットワーク環境が不安定な場合でも、リモートでの共同作業メッセージが予期せず自分のマシンの別セッションに誤送信される心配がなくなります。

変更前

セッションのライフサイクル全体で作成できるサブエージェント（Agentツールによって起動されるものやフォークセッションなど）が累計200個に制限されていたため、多数のタスクを1つの長い会話セッションで繰り返しデバッグしていると、上限に達して新しいタスクの委譲が拒否されていました。

変更後

セッション中の累計サブエージェント作成数の上限が取り払われました。これにより、同じ会話の中で何回でも新しいサブエージェントを利用できるようになります。ただし、同時に並行して走らせる数や、エージェントの中にエージェントを作るネストの深さの制限はこれまで通り維持されます。

ユーザーへの恩恵

長大な開発プロジェクトのデバッグを1つのセッションで続けていても、途中でエージェント作成エラーに突き当たることがなくなります。

変更前

サブエージェントとして実行したいモデルの選択が組織のポリシーなどで制限されている場合、警告なしに黙って親モデルへとフォールバックして処理が実行されていたため、どのモデルでタスクが実行されているかを正確に把握できませんでした。

変更後

指定したサブエージェントモデルが制限されて親モデルで代わりに実行される際、ターミナル上で明確に警告が表示されるようになります。

ユーザーへの恩恵

意図しないモデルの利用や制限による挙動の変化に、警告メッセージを見るだけですぐに気づけるようになります。

変更前

バックグラウンドで会話履歴を丸ごと引き継いだ（フォークした）サブエージェントの処理をレジュームする際、親プロンプトの読み込みエラーや構成失敗が起きると、状態がデッドロックに陥り再起動もアタッチもできなくなっていました。

変更後

プロンプトの構築失敗時でもセッション状態が正しくリセットされるようになり、再開処理がスタックする問題が解消されます。

ユーザーへの恩恵

再開プロセスのエラーによってターミナル全体のセッション操作が操作不能になり、最初からやり直す必要がなくなります。

変更前

ワークツリーによる隔離セッションやサブエージェントが、意図せずメインの作業ツリーに対して破壊的なgit操作を行ってしまう可能性があり、並列実行時の安全性が不完全でした。

変更後

隔離設定が強化され、すべてのセッションタイプにおけるファイル編集やBashの実行に対して完全にワークツリーが適用され、メインリポジトリが保護されます。

ユーザーへの恩恵

並列セッションを実行する際に、メインのソースコードを破壊される心配をすることなく並行して安全に作業を進めることができます。

変更前

サブエージェントが独自の低負荷設定などで動作していても、画面上はメインセッションの effort レベルが表示され、動作状態が誤認されやすかったです。

変更後

サブエージェントに実際に設定されて適用されている effort レベルがビューに正確に反映されます。

ユーザーへの恩恵

各サブエージェントがどのリソース・思考レベルで動いているかを正しく把握できるようになります。

変更前

ネストされたサブエージェントの処理内容を JSON ストリームで追跡できませんでした。

変更後

--forward-subagent-text オプションで、サブエージェントが生成したテキストを親の Agent ID に紐付けて出力できるようになりました。

ユーザーへの恩恵

深い階層で動作するエージェントの挙動をログから詳細に追いかけられます。

変更前

ネスト可能な深さが 1 に制限されており、複雑な委譲構造を持つタスクの実行が困難でした。

変更後

デフォルトで 3 階層までサブエージェントを生成できるようになりました。

ユーザーへの恩恵

より多段階で複雑なタスクの分解・実行を自動化できます。

変更前

レビュー作業がメインの会話履歴を埋め尽くし、スラッシュコマンドのスタック管理が複雑になっていました。

変更後

バックグラウンドで独立して実行され、会話のメインスレッドを汚さずにレビュー結果を確認できるようになりました。

ユーザーへの恩恵

レビュー中も会話を遮られず、自分の作業に集中し続けられます。

変更前

会話を要約すると、フォークしたセッションの親との関係性が途切れていました。

変更後

要約後もフォーク元の系列が正しく維持されるようになりました。

ユーザーへの恩恵

セッション履歴を要約しても、並列作業の親子関係を把握し続けられます。

変更前

フォークしたタスクがフォアグラウンドで待機されることが多く、メイン作業を圧迫していました。

変更後

バックグラウンドがデフォルトになり、個別にfalse指定で変更可能になりました。

ユーザーへの恩恵

重いサブタスクを裏側で実行し、自身のメイン作業を中断させずに並行作業ができます。

変更前

ユーザーが指示を出しても、Claude が意図を汲み取れず強制的に次のアクションへ進んでしまうことがありました。

変更後

回答に対する表現を中立化し、ユーザーの意図を正確に反映して一時停止するように変更されました。

ユーザーへの恩恵

Claude の強引な進捗に対して毎回注意しなくても、意図したタイミングで対話が停滞するようになります。

変更前

セッションを再開した際、過去のプロンプトやツール制限といった設定がクリアされてデフォルトに戻ることがありました。

変更後

前回のセッション終了時のプロンプトとツール制限設定が維持されるようになりました。

ユーザーへの恩恵

長時間の中断後に再開した際、毎回再設定の手順を踏まずに作業を継続できます。

変更前

サブエージェントが作業する際に、メインのリポジトリ環境の Git 設定を誤って参照し、競合の原因となっていました。

変更後

サブエージェントの作業は隔離された worktree に厳密に制限され、メインディレクトリへの干渉がなくなりました。

ユーザーへの恩恵

並行して複数のブランチで作業しても、Git の操作対象を間違える不安がなくなります。

変更前

プロジェクトの場所と作業ディレクトリが乖離していると、不適切な場所にセッション用 worktree が生成されていました。

変更後

プロジェクトの構成を正確に判定し、正しい場所に worktree が作成されるようになりました。

ユーザーへの恩恵

セッション開始時に毎回、正しいディレクトリに作成されたか確認する必要がなくなります。

変更前

サブエージェント行に設定されている推論の努力レベルが表示されず、現在の実行状況が把握しにくい状態でした。

変更後

カスタムエージェントのステータス表示において、適用されている努力レベル（effort）を確認できるようになりました。

ユーザーへの恩恵

エージェントが現在どの程度のコストと深さで思考しているかを一目で確認できます。

変更前

デフォルトではサブエージェントによるツール使用(tool_use)とツール実行結果(tool_result)のブロックのみが出力されていました。サブエージェントが何を考え、どのようなテキストを出力したかの詳細はストリーム出力に含まれていませんでした。

変更後

フラグまたは環境変数を有効にすることで、サブエージェントの思考プロセスやテキスト生成内容もJSONストリームに含まれるようになります。これにより、外部ツールなどでサブエージェントを含む会話の完全なログを再現できるようになります。

ユーザーへの恩恵

ストリーム出力を解析してサブエージェントの動作を詳細に追跡したり、会話の書き起こしを完全に再現したりできるようになる。

変更前

サブエージェント起動時に個別のモデルを指定しても、そのサブエージェントをレジューム(再開)すると指定が失われていました。その結果、意図せず親セッションと同じ高コストなモデルや異なるモデルに切り替わっていました。

変更後

個別のモデル指定が再開時やフォローアップメッセージ送信時にも維持されるようになりました。サブエージェントは一貫して最初に指定されたモデルで動作し続けます。

ユーザーへの恩恵

サブエージェントを再開するたびに、モデルを再指定したりコストの高いモデルに切り替わったりするのを気にしなくて済む。

変更前

バックグラウンドで動作しているエージェントについて尋ねた際、実際にはまだ終わっていないのに、終わったかのような不正確な結果をAIが捏造して報告してしまうことがありました。

変更後

エージェントが実行中の場合は「実行中」であることを正しく報告し、完了通知を受け取ってから結果を伝えるように厳密化されました。AIは完了を待ってから正確な成果を報告します。

ユーザーへの恩恵

バックグラウンドに任せた作業が本当に終わったのかどうか、AIの嘘に惑わされずに正確に把握できるようになる。

変更前

isolation: 'worktree' を設定したサブエージェントが、隔離された環境内ではなく、誤ってメインのチェックアウトディレクトリに対して git 操作を行ってしまうリスクがあった。

変更後

サブエージェントが実行する git コマンドが、必ず自身に割り当てられた隔離ワークツリー内で動作するように厳格化された。

ユーザーへの恩恵

並列作業中のサブエージェントがメイン作業中のファイルを誤って書き換えてしまう心配がなくなります。

変更前

サブエージェントが信頼できないファイル（README やウェブページなど）を読み取った際、その中に含まれる悪意ある指示に従ってしまう可能性があった。

変更後

Agent ツールにおいて、読み取ったデータと元の指示をより厳格に分離して処理するよう内部処理を堅牢化した。

ユーザーへの恩恵

外部のコードベースやドキュメントを調査させる際のセキュリティ上の安全性が高まります。

変更前

claude agents によるバックグラウンドセッションにおいて、ガード条件が広すぎたため、モデル変更の /model コマンドなどのユーザー入力を必要とする対話型ダイアログがブロックされていました。

変更後

過剰なガードが解除され、バックグラウンドで動作中のセッションに attach した後、モデルの切り替えやその他の対話的な設定変更を正常に行えるようになります。

ユーザーへの恩恵

バックグラウンドで実行中のエージェントを中断することなく、必要に応じて使用モデルなどの設定を柔軟に変更できるようになります。

変更前

バックグラウンドで動作しているエージェントにエージェントビューから返信を送った際、ネットワークエラー等で配信に失敗すると、入力した内容が消えてしまい再入力が必要だった。

変更後

送信に失敗したテキストは内部的に保持される。次にエージェントセッションが再開されたタイミングで、保存されていた返信が自動的にエージェントに届けられる。

ユーザーへの恩恵

一時的なエラーで返信が届かなくても、長い指示を書き直す手間が省けるようになります。

変更前

Claude Code の自動更新により実行バイナリが置換されると、古いバイナリから起動していた管理プロセス（デーモン）との整合性が崩れ、進行中のセッションへの接続ができなくなることがあった。

変更後

バイナリ置換後も、アタッチ時に新しいプロセスの起動を待機し、新しいバイナリ上でセッションを再開できるように修正された。セッションの継続性が強化されている。

ユーザーへの恩恵

ツールのアップデートを跨いでも、作業中のバックグラウンドエージェントを見失わずに済みます。

変更前

Web やモバイルアプリからターミナルのセッションを覗いている際、バックグラウンドで動いているエージェントの状態が同期されず、最新の状況を知るために何かイベントが起きるのを待つ必要があった。

変更後

アタッチした瞬間に現在のバックグラウンドタスクとワークフローの状態が即座にプッシュされるようになり、リアルタイムで進捗を確認できるようになった。

ユーザーへの恩恵

外出先からモバイルアプリで進捗を確認した際に、現在のステータスを即座に把握できるようになります。

変更前

設定ミスなどで利用可能なツールがゼロになった場合でも、サブエージェントが「手足をもがれた」状態で起動してしまい、その後のタスク遂行に失敗していた。

変更後

起動前にツールリストの有効性がチェックされる。ツールが正しく設定されていない場合は起動を中止し、どの指定が間違っていたのかをユーザーや親エージェントに通知する。

ユーザーへの恩恵

サブエージェントが何もできずに立ち上がるのを防ぎ、設定の誤りにすぐ気づけるようになります。

変更前

SDK を介したセッション開始直後にプラグインの自動読み込みが重なると、プログラムから渡したカスタムエージェントの定義が上書きされて消えてしまうことがあった。

変更後

初期化時のリクエストパラメータとプラグインからの情報を正しくマージして管理するように修正された。カスタム構成が予期せずリセットされることはない。

ユーザーへの恩恵

SDK を利用した高度なカスタマイズを行っている際に、原因不明のエージェント消失に悩まされることがなくなります。

変更前

バックグラウンドで動作するエージェントのステータスやタスクリストが更新されるたびに、UI全体が再描画されていた。

変更後

タスク更新時にUI全体を再描画しないよう最適化され、バックグラウンド処理中の入力の遅延が軽減される。

ユーザーへの恩恵

バックグラウンドでエージェントを動かしながらでも、ストレスなく自身のプロンプト入力に集中できるようになる。

変更前

大規模な会話履歴を持つセッションからフォークやバックグラウンドエージェントを開始・再開する際、メモリ消費が非常に大きくなっていた。

変更後

セッション再開時のメモリ管理が最適化され、長大な履歴を継承したエージェントの動作が軽量化される。

ユーザーへの恩恵

複雑なタスクを並列化したり、過去の長いセッションを再開したりする際の動作が安定するようになる。

変更前

バックグラウンドで動かしていたエージェントがタスクを完了すると、すぐにタスクリストから消えてしまい、結果の確認が難しかった。

変更後

タスク完了後もクリーンアップ期間が来るまではリストに残り続けるため、いつでも後から完了した内容を参照できる。

ユーザーへの恩恵

完了したタスクを見失うことがなくなり、自分のタイミングで結果を確認できるようになる。

変更前

停止していたエージェントに再接続（attach）する際、起動が完了するまで「Session is starting」という空白画面を待たされていた。

変更後

起動処理（ウォームアップ）の最中でも、即座にこれまでの会話履歴が表示されるようになる。

ユーザーへの恩恵

エージェントの準備が整うのを待つ間も、過去の経緯を読み返してすぐに次の指示を考えられるようになる。

変更前

Claude Code のアップデート後、古いバージョンのデーモンが新しいバージョンのワーカーを古いバイナリで勝手に再起動してしまうことがあった。

変更後

デーモンが自分より新しいバージョンのワーカーを古い環境で再起動しないよう、バージョンの不一致を適切に制御する。

ユーザーへの恩恵

アップデート後にバックグラウンドタスクが古い挙動に戻ったり不安定になったりする心配がなくなる。

変更前

エージェントを削除すると、プッシュしていないコミットが含まれるワークツリーが意図せず消えたり、再利用時に不整合が起きたりすることがあった。

変更後

未プッシュのコミットがある場合は削除を回避し、ワークツリー再利用時はベースブランチをリセットして安全性を確保する。

ユーザーへの恩恵

エージェントが作成したコード変更を誤って失うリスクがなくなり、安心して並列作業を行えるようになる。

変更前

バックグラウンドで自律動作しているエージェント内で、インタラクティブな設定メニューなどが誤って開かれ、処理が停止することがあった。

変更後

バックグラウンド実行時は /install-github-app や /mcp メニューが開かないよう制限され、不要な停止を回避する。

ユーザーへの恩恵

バックグラウンドエージェントがユーザー対話待ちで無期限にストップしてしまう状況を回避できるようになる。

変更前

特定のフェーズやエージェントの詳細を確認した後、キーボード操作で一覧に戻ることができませんでした。

変更後

左矢印キーで直感的かつスムーズに階層を戻れるようになります。

ユーザーへの恩恵

大規模なワークフローの進捗確認がより快適に行えるようになります。

変更前

SendMessageツールを使ってバックグラウンドエージェントを再開させても、エージェントリスト上のステータスが「失敗」または「完了」のまま更新されない状態でした。

変更後

再開処理とエージェント状態の同期が改善され、正確なステータスが表示されるようになりました。

ユーザーへの恩恵

進行中のバックグラウンド作業状況を正しく把握できるようになり、運用効率が向上します。

変更前

エージェントの一覧に戻ると、実行中だったサブエージェントの作業状態が破棄されることがありました。

変更後

エージェントの作業状態が適切に引き継がれ、中断地点から継続されるようになりました。

ユーザーへの恩恵

長時間の並列タスクを安心して管理でき、無駄な再計算が発生しません。

変更前

サブエージェントが適切な作業ディレクトリではなく、親リポジトリでシェルを実行してしまうことがありました。

変更後

サブエージェントの作業コンテキストを分離されたWorktreeに強制するように修正しました。

ユーザーへの恩恵

並列作業中に意図しないファイル変更やコマンド実行が起こるリスクが低減されます。

変更前

深い階層のリポジトリ構成でWorktreeの作成が拒否されることがありました。

変更後

階層構造を適切にハンドリングするように修正しました。

ユーザーへの恩恵

複雑なディレクトリ構成でも、問題なくエージェントの並列化が利用できます。

変更前

エージェントの委譲チェーンが深くなりすぎて、推論効率が低下する傾向がありました。

変更後

自律的な判断基準を調整し、適切な粒度でタスクをこなすようにしました。

ユーザーへの恩恵

無駄なエージェント生成が減り、タスク完了までの速度と信頼性が向上します。

変更前

ワークフローに関連するエージェントのアクティビティを、外部のOpenTelemetry（OTel）バックエンド側で関連付けることが困難でした。

変更後

OTelデータにワークフローの実行IDと名前が付与されるようになったため、収集されたデータからワークフロー全体の活動を正確に再構築できます。

ユーザーへの恩恵

大規模な開発組織において、ワークフロー実行のパフォーマンス監視やトラブルシューティングがより詳細に行えるようになります。

変更前

エージェントの一覧画面において、タイトルの表示幅が狭く、各セッションの実行時間や詳細なステータスを直感的に把握しにくいレイアウトでした。

変更後

レイアウトが最適化され、タイトルの視認性が向上するとともに、実行時間が独立した列で確認できるようになりました。また、冗長だったモデル名やツール呼び出し回数が整理されました。

ユーザーへの恩恵

複数のバックグラウンドタスクを並行して実行している際に、どのタスクがどの程度時間を要しているかを一目で比較・管理しやすくなります。

変更前

/review コマンドがマルチエージェントによる詳細なレビューに統合されていたため、迅速なフィードバックが欲しい場面でも完了まで時間がかかっていました。

変更後

/review は本来の軽快な動作に戻り、一方で /code-review を通じてより深い分析や検証を伴う高度なレビューを使い分けられるようになりました。

ユーザーへの恩恵

作業のフェーズに合わせて、速度重視のクイックな確認と、時間をかけた徹底的なバグ探索を柔軟に選択できるようになります。

変更前

特定のコマンド引数の順序によって、プラグインのコンポーネントが正しく読み込まれない場合がありました。

変更後

フラグの指定順序に関わらず、プラグインが正しく認識され一覧に表示されます。

ユーザーへの恩恵

コマンド入力時の柔軟性が向上し、期待通りにプラグインを読み込めるようになります。

変更前

サブエージェントがエラーを返した際、それが成功として処理され、親エージェントが状況を把握できないケースがありました。

変更後

APIエラーが親エージェントへ適切に通知されるようになりました。

ユーザーへの恩恵

デバッグやタスク追跡において、どこで問題が発生したかを即座に特定しやすくなります。

変更前

サブエージェントを確認中にコマンドを打つと、意図せずメインの対話設定を上書きしてしまう恐れがありました。

変更後

現在の操作対象がメインエージェントである旨の補足メッセージが表示されるようになりました。

ユーザーへの恩恵

操作ミスによる設定変更を防ぎ、誤ったモデルでタスクが進むリスクを低減できます。

変更前

エージェント名が再利用されると、メッセージの送信先が古いエージェントと混同されるリスクがありました。

変更後

ツール側で名前の不一致を自動検出し、呼び出し元に送信先の再設定を求めるようになりました。

ユーザーへの恩恵

メッセージの誤送信によるタスクの混乱を防ぎ、確実に意図したサブエージェントに命令を届けられます。

変更前

エージェントが作業を終えるたびにユーザーに確認を求め、停止してしまうことがありました。

変更後

ワークツリーでの作業完了後、ユーザーの手を介さずに自動で一連のGit操作とPR作成を行うようになりました。

ユーザーへの恩恵

定型的なプルリクエスト作成プロセスが自動化され、作業のリードタイムが短縮されます。

変更前

進捗カウンターは正しいものの、リストに表示されるはずのエージェントが消えてしまうことがありました。

変更後

リストの同期が適切に保たれるようになり、進行中のすべてのエージェントを視認できます。

ユーザーへの恩恵

並行処理を行っているタスク全体の把握が容易になり、ワークフローの管理が正確に行えます。

変更前

対話的なウィザードメニューを通じてサブエージェントの設定を行う機能がありましたが、操作が限定的でした。

変更後

ウィザードを廃止し、Claudeに対して直接指示を出すか、設定ファイルを直接編集するスタイルに集約されました。

ユーザーへの恩恵

より柔軟で直感的なサブエージェントの管理が可能になり、CLIの構成を整理することでメンテナンス性が向上します。

変更前

サイドパネルを開くとキーボードフォーカスがスタックしたり、バックグラウンドのジョブでサブエージェントの設定が引き継がれなかったりする不具合がありました。

変更後

サイドパネルの動作が安定し、エージェントの設定やステータスが正しく維持されるようになりました。

ユーザーへの恩恵

エージェント管理時のストレスが軽減され、複数の作業をより正確に追跡・管理できるようになります。

変更前

特定フラグを付けて起動しても設定が正しく反映されず、意図せず安全モードで動作することがありました。

変更後

指定したパーミッション回避モードが正確に適用されるようになりました。

ユーザーへの恩恵

パーミッション設定を回避して作業したい場合に、意図通りの制御で確実にエージェントを起動できます。

変更前

リサーチ結果の検証失敗が過度に否定的な内容で誤報告されていました。

変更後

検証状況が正確にレポートされるようになりました。

ユーザーへの恩恵

調査結果の信頼性が向上し、不正確な判定に基づいた誤判断を回避できます。

変更前

エージェントのステータス表示が不安定で、状況把握に手間がかかっていました。

変更後

各セッションの状況が直感的に判別可能になり、関連PRへのアクセスも容易になりました。

ユーザーへの恩恵

エージェントが現在どの状態にあるかを即座に把握でき、対応が必要なPRへ迅速に遷移できます。

変更前

複数のエージェントが稼働する大規模なワークフローにおいて、特定のエージェントの状態(実行中、待機中、完了など)を素早く絞り込む手段がありませんでした。

変更後

詳細ビューで f キーを押すことでステータスフィルタリングが可能になり、多数のエージェントの中から確認が必要なものだけを抽出できます。

ユーザーへの恩恵

複雑な並列タスクの進行状況を管理する際、注意が必要なエージェントを即座に見つけられるため、デバッグや監視の効率が向上します。

変更前

エージェントビューから特定のセッションにアタッチする際、画面の描画更新が不完全で、元のUIの一部が重なって表示されることがありました。

変更後

セッションへの切り替え時に画面全体が正しく再描画され、クリアなUIで操作できるようになりました。

ユーザーへの恩恵

視覚的な混乱がなくなり、バックグラウンドで動かしていたタスクの確認に集中できます。

変更前

管理者やユーザーが設定したサブエージェントの使用制限ルールが、特定の名前を指定して起動されたサブエージェントに対して機能しない場合がありました。

変更後

あらゆるサブエージェントの起動において、設定された権限ルールが厳格にチェックされるようになりました。

ユーザーへの恩恵

組織のポリシーに基づいた安全なエージェント利用が保証され、意図しないツールの実行を確実に防止できます。

変更前

役目を終えたサブエージェントがエージェントパネルに残り続け、手動で削除しようとしてもUIが反応しないことがありました。

変更後

x キーの操作が正しく処理され、完了したサブエージェントをパネルから即座に破棄できるようになりました。

ユーザーへの恩恵

進行中のタスクだけにパネルを整理でき、画面領域を効率的に活用できます。

変更前

モデルがスキーマに適合しない出力を出し続けた場合、制限なく試行が繰り返され、トークンの浪費やプロセスのハングアップを引き起こしていました。

変更後

試行回数に上限(5回)が設けられ、解決不能なエラーが発生した場合には適切にエラーを報告して停止するようになりました。

ユーザーへの恩恵

予期せぬ無限ループによるコスト発生を防ぎ、問題がある場合に迅速に気づくことができます。

変更前

使用しているモデルが非推奨になった際や、内部で新しいモデルに切り替わった際に、ユーザーがそれに気付きにくい状態でした。

変更後

標準エラー出力(stderr)やエージェントのfrontmatter設定において、モデルのステータスに関する警告が明示的に表示されるようになります。

ユーザーへの恩恵

常に最新かつ最適なモデルを使用しているかを把握でき、モデルの更新に伴う挙動の変化に素早く対応できます。

変更前

特定の環境設定において、モデルが「Extra inputs are not permitted」というエラーを返し、サブエージェントの作成やタイトルの自動生成が失敗することがありました。

変更後

思考ブロックの表示に関連する内部パラメータの扱いを修正し、モデルとの通信エラーを解消しました。

ユーザーへの恩恵

サブエージェントを多用する複雑なタスクや、自動タイトル生成機能が安定して動作するようになります。

変更前

Windowsにおいて git コマンドが直接解決できない環境で、不要になったワークツリーを削除しようとすると「ワークツリーの状態を確認できません」というエラーが出て削除に失敗していました。

変更後

ワークツリーの削除ロジックが改善され、依存関係の解決が困難な状況でも安全にクリーンアップを実行できるようになりました。

ユーザーへの恩恵

不要なファイルやディレクトリが残ることを防ぎ、開発環境を常に整理された状態に保てます。

変更前

サブエージェントの定義ファイルで disallowedTools を使用して特定のMCPサーバー全体(例：mcp__github)を拒否しようとしても、その設定が静かに無視されていました。その結果、サブエージェントが本来禁止されるべきMCPツールにアクセスできてしまう可能性がありました。

変更後

サブエージェントのフロントマターにおける disallowedTools フィールドで、mcp__* 形式のワイルドカードやサーバー名による指定が正しく認識されるようになりました。

ユーザーへの恩恵

サブエージェントに許可するツールの制限をより確実に、かつサーバー単位で一括して行えるようになり、セキュリティと制御の精度が向上します。

変更前

動的なワークフローで複数のサブエージェントを動かした際、どのリクエストがどのエージェントによるものかの識別情報が欠落しており、ログの追跡や分析が困難でした。

変更後

各サブエージェントのリクエストに適切な属性ヘッダーが付与されるようになり、呼び出し元の識別が可能になりました。

ユーザーへの恩恵

複雑なマルチエージェント構成での開発において、デバッグやリソース使用量の内訳把握が容易になります。

変更前

使用状況の表示が大まかな合計値に限られており、どのスキルや MCP サーバーがどれだけのトークンを消費しているのか詳細を把握することが困難でした。

変更後

時間枠ごとの内訳や、キャッシュ効率、さらには特定のカスタムツールごとの消費量が視覚化され、詳細なコスト分析が可能になりました。

ユーザーへの恩恵

使用量の多い要因を特定してプロンプトを最適化したり、特定のツールのコスト対効果を評価したりすることが可能になります。

変更前

管理者が availableModels 設定で使用可能なモデルを制限していても、一部の機能経由では制限対象外のモデルが指定できてしまう漏れがありました。

変更後

サブエージェントやアドバイザー機能を含むすべての箇所で allowlist が厳格に適用されるようになり、ポリシー遵守が徹底されます。

ユーザーへの恩恵

企業のコンプライアンスやコスト管理の観点から特定のモデルに限定して利用させたい場合、設定が確実に機能するようになります。

変更前

非インタラクティブモードで構造化データ(JSONなど)を出力させたい場合に、サブエージェントのログが混入して出力が壊れてしまうことがありました。

変更後

メインプロセスの標準出力がサブエージェントのメッセージから分離され、指定したフォーマットのデータのみが正しく出力されるようになりました。

ユーザーへの恩恵

Claude Code をスクリプトや CI パイプラインに組み込んで JSON 出力をパースして利用している場合に、サブエージェントの動作に影響されず安定して動作するようになります。

変更前

隔離された環境で作業させるためのワークツリー設定が、逆にエージェント自身の書き込み権限まで制限してしまい、エラーが発生していました。

変更後

ワークツリーによる隔離を維持しつつ、エージェントが割り当てられた範囲内で自由にファイルを編集・保存できるようになりました。

ユーザーへの恩恵

メインの作業ブランチを汚さずにエージェントに並列作業を任せる「隔離ワークツリー」機能が、安定して動作するようになります。

変更前

エージェントビューでタスクを並列実行する際、設定ファイルで指定したエージェント設定が正しく適用されない場合がありました。

変更後

グローバルまたはプロジェクト設定のデフォルトエージェントが適用され、必要に応じてコマンドラインから個別に変更できるようになります。

ユーザーへの恩恵

プロジェクトごとに最適なサブエージェントの設定を自動適用しつつ、柔軟な切り替えも可能になります。

変更前

大規模なコードベースの監査や大量のファイル移行など、非常に複雑なタスクを実行する場合、通常のサブエージェントでは管理しきれなかったり、メインの会話履歴が大量の情報で埋まってしまったりしていました。

変更後

ClaudeがJavaScriptベースのスクリプトを記述して実行する「動的ワークフロー」が利用可能になりました。多数のエージェントをバックグラウンドで並列実行し、最終的なレポートのみを受け取ることができます。

ユーザーへの恩恵

メインセッションの応答性を維持したまま、数百ファイルに及ぶ移行や深層調査などの重いタスクをClaudeに丸投げできるようになり、開発効率が劇的に向上します。

変更前

定期実行などを設定している場合、途中で自動実行されるコマンドの影響で、Claudeが「本来何を達成しようとしていたのか」という文脈を忘れてしまい、一貫性のない応答をすることがありました。

変更後

スケジュール実行されたタスクの後でも、元のメインタスクの目標が正しく保持・継承されるよう内部ロジックが改善されました。

ユーザーへの恩恵

長時間にわたる自動化タスクや、複数のステップを跨ぐ複雑な作業をClaudeに任せた際の安定性と精度が向上します。

変更前

既にワークツリーで作業している最中に「さらに別のワークツリー(サブエージェント用)」を作ると、現在の作業内容(コミット前の変更など)が含まれず、古いマスターの状態に戻ってしまうことがありました。

変更後

設定が"head"の場合、現在の作業コンテキストである現在のワークツリーのHEADを正しくベースとして新しいワークツリーが作られます。

ユーザーへの恩恵

複雑な機能を複数のブランチに分けて並行開発している際も、現在の修正内容を維持したままサブエージェントに作業を依頼できるようになります。

変更前

メインセッションで厳格な制限(--bare等)をかけていても、サブエージェント経由で未許可のツールが読み込まれる可能性がありました。

変更後

すべてのサブエージェントが、親セッションのセキュリティポリシーと管理者の設定を正しく継承するようになります。

ユーザーへの恩恵

組織全体のセキュリティコンプライアンスが強化され、AIの自律的な動作をより安全に管理できます。

変更前

厳格モードを有効にすると、開発者が意図して指定したエージェント用のツールまで一律に削除されてしまい、利便性が損なわれていました。

変更後

安全性を保ちつつ、明示的な定義は尊重されるようになり、問題がある場合は沈黙せずユーザーに警告します。

ユーザーへの恩恵

「なぜツールが動かないのか」という混乱を防ぎつつ、柔軟なツールのカスタマイズと安全性の両立が可能になります。

変更前

AIが生成したファイル(ビルド成果物など)が、保存したはずなのに見つからないという混乱が生じていました。

変更後

出力先が正しく管理され、意図した場所にファイルが確実に書き込まれるようになります。

ユーザーへの恩恵

AIが作成したファイルが見失われることがなくなり、作業結果の信頼性が向上します。

変更前

最小構成モード(bare モード)で動作している際、存在しないリストを前提とした不正確なツールの説明がモデルに提供されていました。

変更後

実行モードに合わせてツールの説明が最適化されるため、モデルが現在の環境で不可能な操作を試みようとすることがなくなります。

ユーザーへの恩恵

CI やスクリプト実行などの特殊な環境において、モデルの誤判断によるエラーや混乱を回避できます。

変更前

利用制限の使用状況を確認する際、セッション全体のトークン消費量しか分からず、どの機能がコストを押し上げているのか特定が困難でした。

変更後

/usageコマンドの結果にカテゴリー別の詳細な内訳が追加され、スキルやプラグイン、特定のMCPサーバーが消費したコストを個別に把握できるようになりました。

ユーザーへの恩恵

どのツールが予算を消費しているかを正確に把握できるため、効率的なコスト管理や不要なMCPサーバーの停止などの最適化が容易になります。

変更前

カスタムエージェントが複数の種類のサブエージェントを使い分けるように定義しても、実際に呼び出せる種類が制限されてしまっていました。

変更後

定義したすべてのサブエージェントをエージェントが正しく認識し、タスクに応じて適切なエージェントを使い分けることが可能になります。

ユーザーへの恩恵

複雑なワークフローをプラグイン化する際、エージェント間の連携をより柔軟かつ高度に設計できるようになります。

変更前

サブエージェント用のモデルを環境変数で一括指定していても、チーム機能を使用した場合にだけデフォルトのモデルが使用されてしまうという不整合がありました。

変更後

エージェントチームの各メンバーに対しても、設定したモデルが正しく適用されます。

ユーザーへの恩恵

チーム全体で特定のモデル(安価なモデルや高性能なモデルなど)を強制的に使い分けることができ、コスト管理や精度の制御が確実になります。

変更前

サブエージェントに特定のモデル(例：Haiku)を使用するよう環境変数で指定していても、その内部で実行される子プロセスや再帰的な呼び出しにその設定が引き継がれないことがありました。

変更後

環境変数が子プロセスまで確実に伝播するようになり、セッション全体で一貫して指定したモデルがサブエージェントに使用されるようになりました。

ユーザーへの恩恵

サブエージェントに安価なモデルを指定することでコストを抑えるといった、モデルの使い分け設定が確実に反映されるようになります。

変更前

実行中のClaudeセッション一覧をプログラムから読み取りやすい形式で取得する標準的な手段がなく、外部スクリプトやステータスバーとの連携が困難でした。

変更後

claude agents --json コマンドにより、すべてのセッション情報が構造化されたJSONとして出力されます。

ユーザーへの恩恵

tmuxのセッション復元や、ターミナルのステータスバーへの実行状況表示など、独自の開発ワークフローをスクリプトで自動化しやすくなります。

変更前

分散トレーシングにおいて、サブエージェントによるツール実行が親エージェントのツールスパンと正しく紐付いておらず、複雑なエージェント間の呼び出し構造を追跡するのが困難でした。

変更後

各ツール呼び出しのスパンにエージェントIDと親エージェントIDが付与され、バックグラウンドのサブエージェントのスパンが呼び出し元のエージェントツールの配下に正しくネストされるようになりました。

ユーザーへの恩恵

監視ダッシュボード上で、どのエージェントがどのツールを起動したのかを正確に可視化でき、デバッグやコスト分析の精度が向上します。

変更前

セッション終了時のフックにおいて、そのセッションで実行されていたバックグラウンドタスクや定期実行タスクの状態にアクセスする手段がありませんでした。

変更後

フックに渡されるJSONコンテキストに、バックグラウンドタスクとスケジュールドタスク(cron)の情報が含まれるようになりました。

ユーザーへの恩恵

セッション終了時に未完了のタスクを確認して通知を送ったり、クリーンアップ処理を自動化したりするなど、より高度な自動化スクリプトが作成可能になります。

変更前

特定の条件下でスキルが自分自身をフォークされたコンテキストで呼び出すと、意図せず無限ループが発生し、リソースを過剰に消費してしまうことがありました。

変更後

スキルが自分自身を無限に再invokeしないように制御が追加されました。

ユーザーへの恩恵

スキルの実行が安定し、予期せぬ無限ループによるトークンの浪費や動作のフリーズを防ぐことができます。

変更前

これまでは、バックグラウンドで開始したセッションを再開する場合、/resume コマンドのリストに対話型セッションと区別して表示されず、特定のセッションを見つけて再開するのが困難でした。

変更後

/resume のリストにバックグラウンドセッション(bg マーク付き)が表示されるようになり、エージェントビューなどからシームレスにセッションを切り替えたり、中断した作業に戻ったりできるようになりました。

ユーザーへの恩恵

並列で実行している複数のタスクの状態を把握しやすくなり、バックグラウンドで完了したタスクのセッションへ素早く移動して結果を確認できるため、開発の生産性が向上します。