ヘッドレス運用の 401 ループと会話滞留が一掃。支出制限対応も地味だが enterprise には必須
Claude Code v2.1.225リリース、ゲートウェイ支出制限対応と複数バグ修正
原題: v2.1.225
重要度の根拠: Claude Code ユーザーの安定性と利便性に関わるマイナーバージョンアップで、実装影響は中程度。既存セッション運用に直結する修正が複数含まれる
要約
Anthropicが Claude Code のバージョン 2.1.225 をリリースした。ゲートウェイ側の支出制限（スペンド・リミット）に対応し、制限に達した際のメッセージにキャップ額・リセット時刻・運用者メッセージを表示するようになった。信頼されていないディレクトリに対する Workspace Trust プロンプトの追加、MCP OAuth サーバーのmacOS環境での間欠的な 401 エラー修正、ヘッドレスセッション（UI がない自動実行環境）の cross-session メッセージが期限なく滞留する問題の解決など、複数の利便性・安定性向上が施されている。Remote Control セッションの再開時に大規模会話での不具合も修正された。
要点
- ゲートウェイ支出制限への対応、キャップ額・リセット時刻・運用者メッセージを表示
- MCP OAuth 認証の transient 401 エラーを修正、macOS keychain タイムアウト対策
- ヘッドレスセッションの cross-session メッセージ滞留問題解決
- Remote Control 大規模会話圧縮後の履歴破壊を修正
- SendMessage が Remote Control セッションを名前指定で開始可能に
開発者向け技術解説（API・実装詳細・破壊的変更）を見る
v2.1.225 は複数のセッション管理・認証まわりの修正を含む。主要な修正ポイント: (1) CLAUDE_CODE_OAUTH_TOKEN の更新時に短期トークンが長期トークンを置き換え、ヘッドレスセッションが再起動まで破壊される transient 401 問題を解決。(2) macOS の keychain 読み取りタイムアウト後に MCP OAuth サーバーが 401 バースト（認証されていない状態と同じ）を連射する問題を修正。(3) cross-session メッセージが通知なく滞留し、ヘッドレスセッションと起動時に問題となる件を解決。(4) 大規模会話の圧縮後に Remote Control セッション再開時の会話履歴が破壊される問題を修正。(5) SendMessage が ListAgents で `name [ref]` 形式の Remote Control セッション名前指定での会話開始に対応。(6) ゲートウェイ 2.1.225 必須条件で支出制限メッセージが cap 額・リセット時刻・運用者メッセージを含むように。auto mode で safety-filter による permission 拒否が consecutive-block 上限にカウントされていた問題も修正。
本文の日本語訳（全文）を見る
## 変更内容
- ゲートウェイ支出制限（スペンド・リミット）への対応を Claude Code の使用警告に追加しました。制限に達したメッセージにはキャップ額、リセット時刻、および運用者のメッセージが含まれるようになります（ゲートウェイが 2.1.225 以上である必要があります）。
- 信頼されていないディレクトリに対する workspace trust プロンプトを `claude agents` に追加。`claude` と同じ動作に合わせました。
- 長期間有効な `CLAUDE_CODE_OAUTH_TOKEN` を保存されたログイン情報の短期トークンで置き換える際に発生する transient 401 を修正。このバグはヘッドレスセッションを再起動まで破壊していました。
- macOS 上で MCP OAuth サーバーが keychain 読み取りのタイムアウト後に 401 エラーをバースト状に（認証されたことがないかのように）連発する問題を修正しました。
- auto mode が自身の permission チェック時に safety-filter による拒否を consecutive-block 上限にカウントしていた問題を修正。当該アクションはまだ拒否されますが、モデルは再試行ではなく続行を指示されるようになります。
- ヘッドレスセッションと起動時に cross-session メッセージが通知なく滞留し続ける問題を修正しました。
- 非常に大規模な会話が圧縮された後、Remote Control セッション再開時に会話履歴が破壊される問題を修正しました。
- agents リストで別プロジェクトのセッションにカーソルを合わせると、次に開始するエージェントのディレクトリが変わってしまう問題を修正しました。
- `claude self-hosted-runner` が `--base-dir` を作成または書き込みできない場合に登録しその後すべてのセッションで失敗していた問題を修正。現在は起動時に明確なエラーで終了します。
- Web セッション上の Claude Code がスタック状態として誤報告され、再接続のたびに増え続けるイベントバックログが再送信される問題を修正しました。
- Remote Control の改善: Claude アプリから添付された写真が、ディスクからの読み込みを別のツール呼び出しで行う代わりに、Claude に直接表示されるようになりました。
- [VSCode] Focus view が最新の to-do リスト、保留中の質問のコンテキスト、解決済みの回答を折りたたんでしまう問題を修正。thinking-only フォールドは「Thought for Ns」と表示され、それら の順番が終わるときに再び折りたたまれます。
- SendMessage は Remote Control セッション名による会話開始が可能になりました（`ListAgents` は `name [ref]` と表示）。従来は初回メッセージを受け取った後のみ返信可能でした。
- SendMessage: 既に確認した Remote Control 受信者は、同じ名前のこのマシン上のセッションと入れ替わることはなくなりました（そのセッションのリストが確認できなくても）。
出典: https://github.com/anthropics/claude-code/releases/tag/v2.1.225
媒体: Claude Code Releases
※本記事は Anthropic / OpenAI / Google / Meta / Mistral / DeepSeek / Sakana 等各社の公開情報を基に AI (OpenAI GPT-4o-mini) が日本語で要約・分類した二次的著作物です。著作権法第32条の引用要件に基づき出典 URL を必ず併記しています。要約は AI 生成のため誤訳・誤解釈を含む可能性があります。詳細・正確な情報は必ず出典元の原文をご確認ください。