Claude Code v2.1.248：--restrictedモード、エージェントごとのプロンプトキャッシュTTL、Bedrock・Vertex・Foundryでのセッション間メッセージング

Claude Code v2.1.248は、変更履歴に49件の変更が記載された大規模なリリースです。コマンドを実行するツールを取り除き、ユーザー/プロジェクト/ローカルの設定ファイルを無視する--restrictedモード、エージェントのfrontmatterで指定するエージェントごとのプロンプトキャッシュTTL、サーバー管理設定の診断、Bedrock・Vertex・Foundryでのセッション間メッセージングが追加されました。また、プロンプトキャッシュのミスを引き起こしていた2つの原因が修正され、Claude DesktopとCoworkのセッションが30日後に消える問題が解消されたほか、claude agents、フック、MCP、Remote Controlに関する多くの問題が修正されています。

新機能

`--restricted`モード

新しい--restrictedフラグ（またはCLAUDE_CODE_RESTRICTED=1）は、コマンドやコードを実行する組み込みツールとWebFetchを取り除きます（--toolsで指定されたものを除く）。さらに、ファイルツールを作業ディレクトリ内に限定し、bypassPermissionsを拒否し、ユーザー、プロジェクト、ローカルの設定ファイルを無視します。

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

エージェントのfrontmatterでexperimental.cacheTtl（"5m"または"1h"）を指定できるようになりました。サブエージェントのTTL設定が構成されていない場合に使用される、エージェント単位のプロンプトキャッシュTTLです。

サーバー管理設定の診断

サーバー管理設定の読み込みに失敗すると起動時に警告が表示されるようになり、/doctorと/statusには、読み込み失敗の内容や設定が取得されなかった理由（Bedrock/Vertex/サードパーティのプロバイダー、カスタムのANTHROPIC_BASE_URL）を説明する行が追加されました。

Bedrock、Vertex、Foundryでのセッション間メッセージング

同じマシン上のセッション間でのメッセージング（SendMessage / ListAgents）が、Bedrock、Vertex、Foundry上、およびテレメトリが無効な場合にも利用できるようになりました。

self-hosted runnerのクライアントラベル

claude self-hosted-runner --client-label <label>（またはSELF_HOSTED_RUNNER_CLIENT_LABEL）で、runnerが登録時に使用するラベルを上書きできます。デフォルトはホスト名です。

より多くのEnterprise組織で`/usage-credits`

AWS Marketplace経由で請求されるEnterprise組織、セルフサーブのEnterprise、Enterpriseトライアルでも/usage-creditsが利用できるようになり、メンバーは管理者により高い利用上限をリクエストできます。

Workflowツールのフットプリントを削減

Workflowツールの説明が5.7kトークンから約1kトークンに削減され、スクリプト作成のリファレンスはバンドルされたworkflow-authoringスキルに移されました。

エージェントビューと`/loop`の変更

エージェントビューのディスパッチ入力では、shift+enterで改行が挿入されるようになり（プロンプトと同じ動作）、ctrl+enterでディスパッチしてアタッチします。/loopのセルフペースの動的モードと、プロンプトなしの自律的なデフォルトは、Bedrock/Vertex/Foundryを含め常に利用できるようになりました。

修正と改善

プロンプトキャッシュ：長時間のセッションで約1時間に1回、OAuthトークンの更新後にツール定義が再レンダリングされることでプロンプトキャッシュのミス（と拡張思考のコンテキストの喪失）が発生する問題を修正しました。アカウントが利用超過の状態に入っていると、セッションとその--resumeの間でScheduleWakeupツールの定義が変わり、再開したセッションの最初のターンでプロンプトキャッシュが完全にミスする問題も修正されています。
デスクトップのセッションの保持：Claude DesktopとCoworkのセッションが30日後に消える問題を修正しました。トランスクリプトのクリーンアップでは、アプリ内に存在する間はデスクトップが書き込んだセッションが保持されるようになり（組織のポリシーで保持期間が管理されている場合を除く）、新しいdesktopSessionCleanupPeriodDays設定でこの例外の上限を設定できます。
クラウドへのアップロードとローカルファイル：/ultrareviewとローカルの内容をもとに作成したクラウドセッションが、prod.env形式や*.tfvarsファイルへの未コミットの編集、または認証情報ファイルのエディタのスワップ・一時・バックアップのコピー（key.pem.tmp、id_rsa.swoなど）をアップロードしなくなりました。これらはローカルマシンに残ります。
サインイン：セッショントークンの期限が切れた状態で別のClaude Codeプロセスがトークン更新のロックを保持していた場合に、ログイン画面に移動させられる問題を修正しました。代わりに、リクエストは再試行可能なエラーで失敗します。推奨のConsoleサインインを利用できないマシン（ANTHROPIC_API_KEYやAPIキーヘルパーが設定されている場合など）で、/loginがOAuthエラーで失敗する問題も修正され、APIキーによるサインインにフォールバックするようになりました。
claude agents：CI環境変数が設定されているとclaude agentsがワークスペースの信頼プロンプトを省略してしまう問題と、PRステータスのキャッシュに不正なエントリがあると起動時にクラッシュする問題を修正しました。マシンの電源が切れていた後に、エージェントビューが数週間前のバックグラウンドセッションを復活させてしまう問題も修正され、そうしたセッションは実際に終了した時点で停止したものとして表示され、開く際には保存済みの会話を再開する前に確認されます。
worktree：バックグラウンドで実行されるworktreeセッションがチェックアウトを失う問題を修正しました。バックグラウンドセッションが実行中はworktreeのロックを保持するため、クリーンアップやgit worktree removeの対象になりません。worktreeのブランチがチェックアウト中のデフォルトブランチにマージ済みでまだプッシュされていない場合に、claude agentsとclaude rmがセッションの削除を拒否する（「has commits that are not pushed anywhere」）問題も修正されています。
フック：PermissionRequestまたはPreToolUseフックが無効な応答を出力した場合に、バックグラウンドセッションが黙って待機し続ける問題を修正しました。claude agentsの行にフック名とスキーマエラーが表示されます。また、標準出力の{…}オブジェクトが有効なJSONでない場合に、プレーンテキストとして扱われるのではなく、パースメッセージ付きのフックエラーとして報告されるようになりました。
MCPとゲートウェイ：headersHelperがAuthorizationヘッダーを提供するMCPサーバーで、401が返った際にOAuthディスカバリーに入ってしまうのではなく、ドキュメントどおりヘルパーを再実行して呼び出しを再試行するようになりました。管理設定のセキュリティ承認ダイアログが必要な場合に、Claude apps gatewayへの/loginがハングする問題も修正されています。
Remote Controlとクラウドセッション：CLIが自動的に再接続した後に、Remote Controlセッションで接続先のデバイスに権限プロンプトや最新のメッセージが表示されないことがある問題を修正しました。コンテナのセッション認証情報がまだ読み取れない場合に、クラウドセッションが起動時に失敗することがある問題も修正されています。
セッション間メッセージング：無効なcrossSessionInboundの値が黙って無視される問題を修正しました。修正されるまで、警告を表示したうえでセッション間メッセージを保留する（ユーザー設定の場合）か拒否する（管理設定の場合）ようになりました。
GitHub：GitHub CLIのトークンにworkflowスコープがない場合に、/web-setupが警告を表示するようになりました。このスコープがないと、非常に大きなリポジトリへのプッシュが拒否されることがあるためです。/ultrareview <PR#>は、クラウドセッションの開始後に失敗するのではなく、起動前にClaudeアカウントに接続されたGitHubアカウントがリポジトリにアクセスできるかを確認し、修正方法を説明するようになりました。

このリリースには合計49件の変更が含まれています。すべての変更は、下記リンクの公式変更履歴をご覧ください。

アップデート方法

インストール済みのバージョンを確認：claude --version
その場でアップデート：claude update
エージェントビューのディスパッチ入力では、shift+enterで改行が挿入されるようになりました。ディスパッチしてアタッチするにはctrl+enterを使用してください。

新機能

--restrictedモード