Claude Code v2.1.248：制限モード、キャッシュTTL、およびセッション修正

Claude Code v2.1.248 は、新しい制限付き実行モード、エージェントごとのキャッシュTTL設定、プロンプトキャッシュとセッション管理の安定性向上のための一連の修正を同梱してリリースされました。

制限モード

Claude Code を --restricted フラグ（または CLAUDE_CODE_RESTRICTED=1 環境変数）で実行できるようになりました。これにより、コマンドやコードを実行する組み込みツールがすべて削除され、--tools で明示的に指定されない限り WebFetch も削除されます。ファイル操作は作業ディレクトリ内に限定され、bypassPermissions は拒否され、ユーザー/プロジェクト/ローカル設定ファイルは無視されます。これは、信頼できないコードレビューやCI環境に役立ちます。

エージェントごとのキャッシュTTL

エージェントのフロントマターで experimental.cacheTtl を設定して、プロンプトキャッシュのTTLを設定できるようになりました: "5m" や "1h" など。これはサブエージェントのTTLが設定されていない場合に適用され、特定のエージェントのキャッシュ有効期限をより細かく制御できます。

セルフホストランナーと設定診断

claude self-hosted-runner コマンドに --client-label フラグ（または SELF_HOSTED_RUNNER_CLIENT_LABEL）が追加され、デフォルトのラベル（ホスト名）を上書きできるようになりました。起動時にサーバー管理設定の読み込みに失敗した場合の警告が追加され、/doctor と /status で失敗理由が説明されるようになりました。また、/usage-credits により、エンタープライズメンバーは管理者に上限引き上げをリクエストできます（AWS Marketplace、セルフサービス、トライアル）。

セッション間メッセージング

同じマシン上のセッション間メッセージングのための SendMessage と ListAgents が追加され、Bedrock、Vertex、Foundry、およびテレメトリが無効の場合にサポートされるようになりました。

主な修正

• プロンプトキャッシュのミス が長時間のセッション（約1時間ごと）で発生していました。OAuth更新後のツール再レンダリングが原因でしたが、修正されました。
• ScheduleWakeupツール定義 が超過時に変更され、--resume でキャッシュミスが発生していましたが、修正されました。
• Desktop/Coworkセッション が30日後に消える問題が修正され、新しい desktopSessionCleanupPeriodDays 設定で例外期間を制限できるようになりました。
• ログインループ が別のプロセスがトークン更新ロックを保持しているときに発生していましたが、再試行可能なエラーを返すようになりました。
• Windows: エージェントリストが、デタッチ後またはwin32入力モードでキーボードに応答するようになりました。
• /login で ANTHROPIC_API_KEY が設定されている場合、OAuthで失敗する代わりにAPIキーサインインにフォールバックするようになりました。
• /model 内のモデル名がコードとして表示されるようになりました（例: [1m] リテラル）。
• エージェントが CI 設定時にワークスペース信頼プロンプトをスキップしていましたが、表示するように修正されました。
• エージェントビューが古いバックグラウンドセッションを復活させないようになり、停止したセッションは停止済みとして表示されます。
• 再開されたセッションでの重複プロセスが防止されました。
• マージ済みだがプッシュされていないブランチを持つセッションの削除が許可されました。
• 無効なフック応答に、フック名とスキーマエラーが表示されるようになりました。
• フックからの無効なJSONがエラーとして報告され、テキストとして黙って扱われなくなりました。
• /mcp がコネクタエントリを実際のスコープで一覧表示し、headersHelper を持つMCPサーバーはOAuthフォールバックではなく401でヘルパーを再実行します。