agent

変更前

新しい作業ツリー(worktree)を作成する際、ブランチの起点となるリファレンスがバージョンによって異なり、未プッシュのコミットが含まれない場合がありました。

変更後

worktree.baseRef 設定により、fresh(デフォルトのブランチ)または head(現在のローカルコミット)のどちらを起点にするか明示的に指定できます。

ユーザーへの恩恵

未プッシュの変更を作業ツリーに引き継ぎたい場合に head を指定することで、作業の中断や隔離をスムーズに行えるようになります。

変更前

Windows ユーザーがバックグラウンドで動作させていたエージェントの操作に戻ろうとすると、入力が受け付けられずセッションが続行できないことがありました。

変更後

セッション再開時のフォーカスと入力制御が修正され、Windows でも正常に入力を継続できます。

ユーザーへの恩恵

バックグラウンドでの並列作業が Windows 環境でも安定して行えるようになります。

変更前

エージェントの数が多いリストにおいて、キーボード操作で下の方を選択しても、画面が自動でスクロールせず選択中の項目が見えなくなることがありました。

変更後

矢印キーでの操作に合わせてビューポートが適切に追従し、常にハイライトされているエージェントが表示されるようになります。

ユーザーへの恩恵

多数のカスタムエージェントを使い分けている環境でも、キーボードだけでスムーズに目的のものを選択・管理できます。

変更前

メインセッションから起動されたサブエージェントが状況を報告する際、内部的なキャッシュが効率的に利用されておらず、毎回不要なトークン生成コストが発生していました。

変更後

進捗サマリーの送信時にプロンプトキャッシュが適切に効くようになり、キャッシュ作成にかかるコストが大幅に抑制されます。

ユーザーへの恩恵

サブエージェントを多用する複雑なタスクにおいて、API 使用コストの削減とレスポンスの高速化が期待できます。

変更前

スキルを context: fork (フォークされたコンテキスト) で実行したり、新しいサブエージェントを起動したりした際、その最初のターンで Web 検索などの一部のツールが認識されず、呼び出しに失敗することがありました。

変更後

サブエージェントやスキルの実行開始直後から、WebSearch や WebFetch を含むすべての遅延ロードツールが正しく利用可能になります。

ユーザーへの恩恵

複雑な調査タスクをサブエージェントに任せる際、最初からスムーズに外部情報の検索を開始できるため、作業の停滞がなくなります。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

SubagentStart などのイベントに対してエージェント型フックを適用しようとすると、必要なデータ構造が不足しているというエラーで動作しませんでした。

変更後

より多くのイベントに対してエージェント型フックを正しく設定・実行できるようになりました。

ユーザーへの恩恵

特定のライフサイクルイベントにおいて、エージェントによる高度な自動検証を柔軟に組み込めるようになります。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

GitHub CLI (gh) を使用して PR 作成などを行う際、レート制限に達するとエージェントがエラーの原因を正しく理解できず、リトライを繰り返して制限をさらに悪化させることがありました。

変更後

レート制限エラーが発生した際、Bash ツールがエージェントに対して「レート制限に達した」という具体的なヒントを返すようになりました。これにより、AI は賢く「待機」を選択できるようになります。

ユーザーへの恩恵

API 制限による予期せぬエラーで作業が中断されるのを防ぎ、AI が自律的に適切なタイミングでリトライを行うため、GitHub 連携の信頼性が向上します。

変更前

サブエージェントの設定ファイルで定義したフック (hooks:) は、サブエージェントとして呼び出された時しか機能せず、--agent で直接起動した場合には実行されませんでした。

変更後

--agent を使って特定のロールでセッションを開始した場合でも、そのエージェントの定義に含まれるフックが正しくトリガーされるようになりました。

ユーザーへの恩恵

特定の役割（セキュリティ担当やレビュアーなど）を担うエージェントを直接起動した際も、自動フォーマットなどのカスタムワークフローが期待通りに動作します。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

プラグインの管理やカスタムスキルの実行において、特定の高度な設定が正しく反映されなかったり、更新処理がOSの制限に抵触することがありました。

変更後

プラグイン・スキルの読み込みと実行エンジンが刷新され、複雑なカスタマイズも意図通りに動作するようになります。

ユーザーへの恩恵

独自のワークフローをプラグインとして構築・配布する際の信頼性と柔軟性が大幅に向上しました。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

リーダー（親エージェント）を全許可モードにしても、チームメイト（子エージェント）が毎回許可を求めてきてしまい、並行作業の自動化が妨げられていました。

変更後

チーム全体で一貫したパーミッション設定が適用されるようになり、完全な自動実行が可能になりました。

ユーザーへの恩恵

大規模なリファクタリングなど、エージェントチームを活用した自動化ワークフローが途切れることなく完了します。

変更前

会話が長くなるとフックが動かなくなったり、エラーが発生しても原因が分からず「JSONバリデーション失敗」という曖昧な表示が出るだけでした。

変更後

長時間のセッションでもフックが安定して動作し、エラー発生時には API からの実際のメッセージが表示されるため、自己診断が可能になりました。

ユーザーへの恩恵

ワークフローの自動化や検証をフックで行っている場合、その信頼性とメンテナンス性が大幅に向上します。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

セッションが長くなると終了時の自動処理（フック）が動かなくなったり、フックの不具合時に原因が分からないエラーメッセージが表示されることがありました。

変更後

長大セッションでもフックが安定動作し、エラー発生時も具体的な原因が表示されるようになったため、デバッグが容易になりました。

ユーザーへの恩恵

自動化された後処理や通知が確実に実行されるようになり、開発ワークフローの信頼性が向上します。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

/claude-api スキルで提供される情報は基本的なAPIリファレンスが中心で、高度なエージェントを構築するための具体的な設計ノウハウまではカバーしきれていませんでした。

変更後

最新のAgent SDKを最大限に活用するための、ツール設計やキャッシュ効率化といった実践的なベストプラクティスが提供されるようになりました。

ユーザーへの恩恵

Anthropicのモデル特性を活かした、より高性能でコスト効率の良いAIエージェントを迅速に開発できるようになります。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

Ctrl+F がエージェントの停止に割り当てられていたため、多くのターミナルで標準的な「一文字右に移動」というReadline操作が使えませんでした。

変更後

キーバインドが Ctrl+X Ctrl+K に変更され、標準的なカーソル移動操作を妨げることなくバックグラウンドタスクを管理できるようになりました。

ユーザーへの恩恵

ターミナルの操作感がより標準的なUNIXシェルに近づき、入力時のストレスが軽減されます。

変更前

バックグラウンドで動かしていたエージェントが終了処理を行う際、Git の通信エラーなどで処理が止まると、実際には動いていないのに UI 上は「実行中」と表示され続け、強制終了も困難になることがありました。

変更後

終了時のタイムアウト処理や状態監視が強化され、ハングアップが発生しても正しくエラーとして終了状態に移行するようになりました。

ユーザーへの恩恵

不具合でスタックしたエージェントにリソースを占有されることがなくなり、複数のタスクを並行して進める際の信頼性が向上します。

変更前

Claudeが回答を出力している最中に /btw でちょっとした質問を投げると、期待した回答ではなくメインの回答内容が混ざって表示されることがありました。

変更後

メインの処理と並行して /btw の回答が正しく独立して処理・表示されるようになりました。

ユーザーへの恩恵

Claudeの作業を中断させることなく、現在のコンテキストに基づいたちょっとした確認をいつでも正確に行えます。

変更前

プラグインに含まれるサブエージェントの思考レベルや最大ターン数、使用禁止ツールの制限を詳細に制御することが困難でした。

変更後

サブエージェントの定義ファイル（frontmatter）から、これら高度なパラメーターを直接指定できるようになりました。

ユーザーへの恩恵

開発者はエージェントの挙動をより精密にチューニングしたプラグインを配布・利用できるようになります。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

プラグイン開発時に YAML のパースエラーやスキーマ違反があっても、実行するまで気づけないことがありました。

変更後

バリデーションコマンドで事前に構文エラーや設定の誤りを網羅的にチェックできるようになりました。

ユーザーへの恩恵

プラグイン開発のデバッグ効率が上がり、より高品質な拡張機能を短時間で作成できます。

変更前

Claude がバックグラウンドで動作している最中に設定ダイアログを操作しようとすると、入力待ちが重なり操作不能になることがありました。

変更後

UI のスレッド制御が改善され、エージェントの動作状況に関わらずダイアログ操作が安定して行えるようになりました。

ユーザーへの恩恵

Claude の作業を待つことなく、いつでも設定確認や MCP サーバーの管理を安全に行えます。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

会話履歴を消去する際、まだ完了していないバックグラウンドタスクまで強制終了されてしまい、作業が中断される不便がありました。

変更後

/clear はフォアグラウンドの会話のみを対象とし、バックグラウンドで動作するタスクには干渉しないようになりました。

ユーザーへの恩恵

コンテキスト整理のための履歴消去と、長時間実行されるタスクの管理を切り離して行えるようになります。

変更前

レジュームしたセッションで履歴パスが誤っていたり、非同期フックで read -r が動作しないなど、高度なカスタマイズを行うフック機能においていくつかの不安定な挙動がありました。

変更後

セッション管理とフック実行エンジンの修正により、自作の自動化スクリプトがより正確に動作するようになりました。

ユーザーへの恩恵

自作のフックを用いた高度なワークフロー自動化を、予期せぬエラーに悩まされることなく構築できます。

変更前

チームメイトエージェントを利用してスクリプト出力を行う際、バックグラウンドタスクが終了しないためにコマンド全体が応答しなくなることがありました。

変更後

出力が完了した時点で適切に終了処理が行われるようになり、自動化ワークフロー内での実行が安定しました。

ユーザーへの恩恵

CI/CD などの非対話的な自動化処理において、Claude Code を確実に終了させることができ、パイプラインの停止を防げます。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

複数のターミナルウィンドウで異なる専門エージェントを実行している場合、ウィンドウを見ただけではどのエージェントがアクティブなのかを即座に判断できませんでした。

変更後

起動中のエージェント名がターミナルのタイトルに反映されるため、ウィンドウを切り替える際に現在どの役割の AI と対話しているのかが一目でわかります。

ユーザーへの恩恵

多数のウィンドウを使い分ける複雑なマルチタスク環境において、作業ミスを防ぎ、コンテキストの把握が容易になります。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

ワークツリーの作成・削除時にカスタムVCSのセットアップ/ティアダウンを行う機能がありませんでした。VCSの初期化やクリーンアップを自動化したい場合に、手動での対応が必要でした。

変更後

ワークツリーの作成・削除時にカスタムVCSのセットアップ/ティアダウンを行えるようになりました。これにより、VCSの初期化やクリーンアップといった定型作業を自動化できます。

ユーザーへの恩恵

VCSのセットアップとティアダウンを自動化することで、開発者はワークツリーのライフサイクル管理にかかる手間を省き、より効率的に開発を進めることができます。

変更前

エージェントが実行される環境を宣言的に指定する手段がなく、各エージェントの実行環境を個別に管理する必要がありました。

変更後

エージェント定義内で isolation: worktree を指定することで、エージェントを独立したGitワークツリーで実行できるようになりました。これにより、プロジェクトの分離が容易になります。

ユーザーへの恩恵

エージェントごとに独立した実行環境を用意できるため、依存関係の競合を防ぎ、よりクリーンで予測可能な開発フローを実現できます。

変更前

設定されているエージェントを一覧表示するコマンドがなく、どのエージェントが利用可能か確認するのが困難でした。

変更後

claude agents コマンドで、設定済みの全エージェントを簡単に一覧表示できるようになりました。

ユーザーへの恩恵

ユーザーは現在利用可能なエージェントを容易に把握でき、目的に合ったエージェントを迅速に選択・活用できるようになります。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

バックグラウンドでエージェントが動作している間、開発者がCtrl+CやESCを押しても、それらの入力が無視され、エージェントを停止させることができませんでした。これにより、エージェントが予期せず動作し続けたり、ユーザーがコントロールを取り戻せなくなったりする不便さがありました。

変更後

今回の修正により、Ctrl+CまたはESCを3秒以内に2回連続して押すことで、すべてのバックグラウンドエージェントが強制終了されるようになりました。これにより、ユーザーはより確実に、そして直感的にバックグラウンドプロセスを停止させることができるようになります。

ユーザーへの恩恵

開発者は、意図しないバックグラウンドエージェントの実行を迅速かつ簡単に停止できるようになります。これにより、システムリソースの無駄な消費を防ぎ、予期せぬ動作を回避できるため、より安定した開発環境で作業を行えます。

変更前

StopおよびSubagentStopフックでは、アシスタントの最終応答テキストにアクセスするためにトランスクリプトファイルを解析する必要がありました。これは手間がかかるだけでなく、エラーが発生しやすいプロセスでした。

変更後

StopおよびSubagentStopフック入力に last_assistant_message フィールドが追加されました。これにより、フックはトランスクリプトファイルを解析することなく、アシスタントの最終応答テキストに直接アクセスできます。

ユーザーへの恩恵

フック開発者がアシスタントの最終応答に簡単にアクセスできるようになり、より効率的で堅牢なフックの作成が可能になりました。

変更前

長期間実行されるセッションでは、APIストリームバッファ、エージェントコンテキスト、スキル状態などのリソースが解放されずに蓄積され、メモリ使用量が増加する問題がありました。

変更後

長期間実行されるセッションにおけるメモリ使用量が改善されました。APIストリームバッファ、エージェントコンテキスト、スキル状態などのリソースが、使用後に適切に解放されるようになりました。

ユーザーへの恩恵

長時間のセッションでもメモリ使用量が抑えられるため、Claude Codeのパフォーマンスが安定し、メモリ不足による予期せぬ終了や遅延を防ぐことができます。これにより、ユーザーはより快適に長時間の作業に取り組めます。

変更前

長期間実行されるエージェントセッションにおいて、プログレスアップデートの処理でメッセージがO(n²)で蓄積され、メモリ使用量が増大していました。

変更後

長期間実行されるエージェントセッションのメモリ使用量が改善されました。プログレスアップデートにおけるメッセージのO(n²)での蓄積がなくなり、メモリ効率が向上しました。

ユーザーへの恩恵

長時間のセッションでもメモリ使用量が最適化され、Claude Codeの安定性とパフォーマンスが向上しました。これにより、複雑なタスクや長時間の分析でも、メモリ不足による影響を受けにくくなりました。

変更前

バックグラウンドエージェントを終了するには、ESCキーを2回押す必要がありました。また、ESCキーでメインスレッドをキャンセルすると、バックグラウンドエージェントも停止してしまうことがありました。

変更後

Ctrl+Fショートカットキーでバックグラウンドエージェントを簡単に終了できるようになりました。ESCキーでのメインスレッドキャンセル時にもバックグラウンドエージェントは継続実行されるようになり、エージェントのライフサイクル管理がより柔軟になりました。

ユーザーへの恩恵

バックグラウンドエージェントの制御が容易になり、開発者は意図した通りにエージェントの実行を管理できるようになりました。これにより、作業効率と柔軟性が向上します。

変更前

NFSやFUSEといった特定のファイルシステム(inode数がゼロと報告するもの)上で、ユーザー定義エージェントが複数のファイルではなく、1つのファイルしか正しくロードできない問題がありました。

変更後

NFS/FUSEファイルシステム(inode数がゼロのものを報告)上でのユーザー定義エージェントのファイルロードに関する問題が修正されました。これにより、これらのファイルシステム上でも、エージェントが複数のファイルを正しくロードできるようになりました。

ユーザーへの恩恵

NFS/FUSEファイルシステムを利用する環境でのエージェントの利用が改善され、より多くのプロジェクトでカスタムエージェントが期待通りに動作するようになりました。

変更前

プラグインに含まれるエージェントスキルが、完全なプラグイン名ではなく、単純なスキル名(ベア名)で参照された場合、エラーなくロードに失敗し、スキルが利用できない状態になっていました。

変更後

プラグインエージェントスキルのロードに関する問題が修正されました。ベア名で参照された場合でも、サイレントなロード失敗がなくなり、スキルが正しくロードされるようになりました。

ユーザーへの恩恵

プラグイン内のエージェントスキルが、より柔軟な参照方法で利用できるようになり、開発者はプラグインの連携を容易にしました。

変更前

複数のエージェントが同時に動作するセッションにおいて、ストリーミングコンテンツブロックがインターリーブ(混在)し、メッセージのマージ処理を妨げた結果、APIから「thinking blocks cannot be modified」という400エラーが発生していました。

変更後

同時実行エージェントがいるセッションでのAPI 400エラー(「thinking blocks cannot be modified」)が修正されました。ストリーミングコンテンツブロックのインターリーブ問題が解決され、メッセージのマージが正しく行われるようになりました。

ユーザーへの恩恵

複数のエージェントを同時に使用する際のAPIエラーが解消され、Claude Codeの安定性が向上しました。これにより、複雑なタスクでも安心して実行できるようになります。

変更前

エージェントの進捗状況を示すインジケータが、実際よりも多くのツール使用回数を表示してしまうバグがありました。

変更後

エージェントのプログレスインジケータのツール使用回数カウントが修正されました。これにより、表示される回数が実際の使用回数と一致するようになりました。

ユーザーへの恩恵

エージェントの進捗状況の表示が正確になり、ユーザーはエージェントの動作をより正確に把握できるようになりました。

変更前

バックグラウンドエージェントがタスクを完了した際、その結果としてエージェントの最終的な回答ではなく、生のトランスクリプトデータが返却される問題がありました。

変更後

バックグラウンドエージェントの結果が、生のトランスクリプトデータではなく、エージェントの最終的な回答として返却されるようになりました。

ユーザーへの恩恵

バックグラウンドエージェントの出力がより有用になり、開発者はエージェントの最終結果を直接確認できるようになりました。これにより、タスクの管理と理解が容易になります。

変更前

チームメイトをスポーンする際、.claude/agents/*.md に定義されたカスタムエージェントの model フィールドが無視され、意図したモデルが使用されない問題がありました。

変更後

チームメイトスポーン時にカスタムエージェントの model フィールドが正しく適用されるようになりました。

ユーザーへの恩恵

カスタムエージェントのモデル設定がチームメイトのスポーン時に反映されるようになり、エージェントチームの挙動をより細かく制御できるようになりました。

変更前

gitワークツリーからClaude Codeを実行する際、プロジェクトレベルの.claude/agents/および.claude/skills/ディレクトリにあるカスタムエージェントやスキルが検出されない問題がありました。

変更後

gitワークツリーから実行した場合でも、プロジェクトレベルの.claude/agents/および.claude/skills/が正しく検出されるようになりました。

ユーザーへの恩恵

gitワークツリー環境でのカスタムエージェントとスキルの利用が改善され、開発者はワークツリー内でもプロジェクト固有の設定を正しく利用できるようになりました。

変更前

プラグインをインストールしても、そのプラグインが提供するコマンド、エージェント、フックがすぐに利用できず、Claude Code の再起動が必要でした。

変更後

プラグインのインストール後、再起動することなく、提供されたコマンド、エージェント、フックが即座に利用可能になりました。

ユーザーへの恩恵

プラグインの追加や更新がよりスムーズになり、開発者はツールのセットアップ時間を短縮して、すぐに作業を開始できます。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

以前は、エージェントチームのメンバーがアイドル状態になる前や、タスクが完了とマークされる前に、カスタムロジックを挿入してワークフローを制御する仕組みがありませんでした。これにより、特定の条件下でチームメイトの作業を継続させたり、タスクの完了を阻止してフィードバックを提供したりするなどの、高度なワークフローの自動化が困難でした。

変更後

TeammateIdleとTaskCompletedフックイベントが追加されたことで、エージェントチームのメンバーがアイドル状態になる直前や、タスクが完了とマークされる直前に、カスタムスクリプトやHTTPエンドポイントを実行できるようになりました。これにより、例えば、チームメイトがアイドル状態になるのを防ぎ作業を継続させたり、特定の条件が満たされない限りタスクの完了を阻止して詳細なフィードバックを要求したりすることが可能になります。

ユーザーへの恩恵

これらの新しいフックイベントにより、マルチエージェントワークフローの自動化と制御が大幅に強化されます。チームメイトの振る舞いやタスクの完了プロセスをより細かくカスタマイズできるため、複雑なプロジェクト管理や品質保証のシナリオにおいて、より堅牢でインテリジェントなエージェントチームを構築できます。これにより、開発者はワークフローの柔軟性が向上し、生産性が高まることを実感できます。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

以前のClaude Codeでは、エージェントのセッション間で特定の情報を永続的に記憶させる標準的なメカニズムが不足していました。特に、サブエージェントは親会話からスキルを継承せず、セッション終了後に学習内容を保持する機能がなかったため、同じタスクを繰り返す際に過去のコンテキストを失うという非効率性がありました。

変更後

エージェントのフロントマターにmemoryフィールドが追加され、user、project、localの3つのスコープでエージェントに永続的な記憶機能を持たせることが可能になりました。これにより、エージェントはセッションを跨いで学習し、過去の経験に基づいて振る舞いを改善できるようになります。例えば、projectスコープを設定すれば、そのプロジェクト固有の知識をエージェントが長期的に保持できます。

ユーザーへの恩恵

この改善により、エージェントはより賢く、より効率的に作業できるようになります。セッションを跨いで知識やコンテキストを保持できるため、反復的なタスクや長期にわたるプロジェクトにおいて、エージェントが毎回ゼロから学習し直す必要がなくなります。これにより、開発者はエージェントのパフォーマンスと生産性の向上を享受できます。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

フックの実行時にどのエージェントが使用されているかの情報が不足しており、特定のカスタムエージェントが起動した際に連動した処理を行うことが困難でした。

変更後

SessionStart イベントの JSON コンテキストに agent_type フィールドが含まれるようになり、--agent フラグで指定されたエージェント名をフック内で識別できるようになります。

ユーザーへの恩恵

カスタムエージェントの種類に応じた初期化処理や環境設定をフックで自動化できるようになり、ワークフローの柔軟性が向上します。

変更前

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

変更後

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

ユーザーへの恩恵

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

変更前

フォークされたコンテキストでスキルを実行する際、どの方針(読み取り専用か、書き込み許可かなど)を持つエージェントが担当するかを詳細に制御できませんでした。

変更後

タスクの性質に合わせて適切なビルトインエージェントやカスタムエージェントを選択し、スキルを実行できるようになります。

ユーザーへの恩恵

例えば、調査タスクには Explore エージェントを、複雑な修正には Bash エージェントを割り当てるなど、安全かつ効率的な役割分担が可能です。

変更前

特定のサブエージェント(例：Explore や Plan)の使用を制限したい場合、ツール全体の実行を止めるしかなく、個別に禁止することができませんでした。

変更後

特定の性質を持つエージェント(エージェントがエージェントを呼ぶ挙動など)を名前指定で明示的に禁止できるようになりました。

ユーザーへの恩恵

企業ポリシーに合わせた制約の適用や、コスト管理のために特定の高負荷なサブタスクを制限するといった制御が可能です。

変更前

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

変更後

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

ユーザーへの恩恵

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