管理エージェント設定が CLI ネイティブに。セッション名部分一致も地味に効きそう
Claude Code v2.1.290リリース、管理エージェント機能とプラグインAPIを拡張
原題: v2.1.290
重要度の根拠: マイナーバージョンアップで堅牢性向上が主だが、管理エージェント設定・プラグインフック拡張は新規導入者向け影響あり
要約
Claude Codeがv2.1.290にアップデート。管理エージェントパターンの設定コマンド追加、プラグインフック経由でサブエージェントの権限情報を把握できる仕様追加、セッション名の部分一致対応、WebFetchの大容量テキスト処理改善、キャッシュ喪失やプロキシ越しのリクエスト失敗など複数のバグ修正。開発環境の堅牢性向上が主眼。
要点
- Managed Agents パターンの CLI ネイティブ設定が可能に
- プラグインフック経由でサブエージェント権限情報を識別可能
- WebFetch が 100K 超テキストの削落を検出・通知
- セッション参照に名前部分一致対応
- 複数の本番関連バグ修正(キャッシュ喪失、スケジュール実行漏れ等)
開発者向け技術解説(API・実装詳細・破壊的変更)を見る
プラグインフック API拡張: `turn.step`に`serverToolUses`配列追加(API実行のツール呼び出し内訳)、`tool.check`に`agentId`と`ceiling`パラメータ追加で権限判定文脈を識別可能に。管理エージェント:`/claude-api managed-agents-onboard <url|quickstart-name>`コマンド新設で Managed Agents パターンの `ant apply` ファイル生成と Console クイックスタート(deep-researcher等)構築に対応。CLI拡張:`claude attach <name>` / `claude logs <name>` で部分一致によるセッション参照。WebFetch:100K超テキスト削落時に警告表示&`offset`パラメータで続きを読む機能。修正項目多数(キャッシュ喪失、プロキシ互換性、スケジュール済みタスク再開時の実行漏れなど)。
本文の日本語訳(全文)を見る
## 変更内容
- `turn.step` フック結果に `serverToolUses` を追加: API が実行したツール呼び出し(アドバイザー)を id、名前、入力、開始・終了時刻とともに列挙
- プラグインフックの `tool.check` イベントに `agentId` を追加: サブエージェントの権限チェックとメインセッションのものを区別可能に
- mod の `tool.check` フックが読む question と verdict に `ceiling` を追加: ツールに対する組織要求の承認レベルを命名
- プラグインフック typings に `ThemeKey` と `Color` 型を追加: エディタが mod の描画で指定可能なテーマ色を一覧表示できるように
- `claude plugin validate` に機能追加: 各 mod がゲーティングサイトに登録したフックを `.catch` 有無とともに列挙(`--json` 下で `gatingHooks`)
- Claude apps gateway のサインイン承認ページに Deny ボタンを追加: 保留中のサインインを終了し、待機中のターミナルが数秒で停止
- `claude attach <name>` と `claude logs <name>` を追加: セッション名の一部が id に代わって使用可能に
- `/claude-api managed-agents-onboard <url>` を追加: ページが `ant apply` ファイルとして記述する Managed Agents パターン設定用
- `/claude-api managed-agents-onboard <quickstart-name>` を追加: `ant` CLI で Console クイックスタートテンプレート(例: `deep-researcher`)をビルド
- 管理設定ファイルが管理設定フォルダ外のファイルへのリンクの場合、警告を追加
- 管理設定が user-configured sandbox allowRead パスまたは allowed domains を無視する場合、/status と doctor 警告を追加
- プロキシ・ゲートウェイが Claude Code のベータヘッダを 400 以外のステータスで拒否する場合、またはその他のベータとともに拒否する場合、リクエスト失敗を修正
- 数百の画像を含む長セッションで "Request rejected as unprocessable by the model" エラーで止まる問題を修正
- API の出力コンテンツフィルタが Claude の思考中に返信を停止した場合、ターンが即座に終了する問題を修正; 今後はエラー表示前に 1 回リトライ
- 再開されたサブエージェントとティームメイトが mid-run でメッセージ受信後、earlier thinking と prompt cache を喪失する問題を修正
- WebFetch が 100,000 文字超ページテキストを暗黙削落する問題を修正; 削落量を通知し `offset` で読み続け可能に
- レスポンスが数千レベル深くネストされたリスト・引用を含む場合 ("Maximum call stack size exceeded") のクラッシュを修正
- `/rewind` が Claude 処理中に送信されたプロンプトを列挙しない問題を修正
- スケジュール済みタスク(間隔指定の `/loop`、リマインダー)が会話コンパクション後の再開で暗黙的に戻らない問題を修正; このバージョン以降のコンパクションが対象
- フォアグラウンドで設定したスケジュール済みタスクが ← または `/background` ハンドオフ後にまったく実行されず、再現型が再開・リスポーン・フォーク時に毎回追加実行される問題を修正
- headless の `--json-schema` 実行が、構造化出力配信後の接続断で成功結果なのに non-zero 終了・`is_error: true` になる問題を修正
- plan モードが server-pushed ask ポリシーを持つ non-read-only connector ツールの自動承認を許可する問題を修正
- プロジェクト `CLAUDE.md`、ルール、`AGENTS.md` が working directories 外にシンボリックリンクされている場合、`permissions.blockReadsOutsideWorkingDirectories` または Read deny ルール下で読み込まれる問題を修正
- `xn--` ホストラベル内にワイルドカード含むURL allow・deny パターンが process ごとに異なる一致を行う問題を修正
- 組織提供の MCP server がサインイン後または再接続後、own のものとして再列挙される問題を修正。headless・SDK セッションの late result からも含む
- `/ultrareview` が Windows で `git stash create` 失敗時にコミット未実施の変更を警告なく削落し、`git add -N` ファイル削除・移動後にそれらを拒否する問題を修正
- `plansDirectory` 設定の project-root チェックがバックスラッシュ含むパスに対応していない問題を修正(macOS・Linux)
- 非常に長い Remote Control・クラウドセッション内返信がブロック単位で表示されてしまう問題を修正。streaming 復帰
- バックグラウンドデーモンのログが terminal control character を経由する問題を修正
出典: https://github.com/anthropics/claude-code/releases/tag/v2.1.290
媒体: Claude Code Releases
※本記事は Anthropic / Claude 関連の公開情報を基に AI (OpenAI GPT-4o-mini) が日本語で要約・分類した二次的著作物です。著作権法第32条の引用要件に基づき出典 URL を必ず併記しています。要約は AI 生成のため誤訳・誤解釈を含む可能性があります。詳細・正確な情報は必ず出典元の原文をご確認ください。