Claude Code v2.1.238: メモリ無限増大の修正とMCP認証まわりの破壊的変更

はじめに

2026年8月21日、Claude Code v2.1.238 がリリースされました。今回のアップデートで特に注目すべきは以下の2点です。

1. 長時間セッションでのメモリ無限増大を修正(severity: high) — 長時間 Claude Code を動かし続けるユーザーに直接効いてくる重要な修正
2. MCP headersHelper のセキュリティ強化(severity: medium, action_required: true) — CI/自動化環境で MCP を使っている場合、動作しなくなる可能性がある破壊的変更

このほかにも Remote Control の安定性修正、プラグインマーケットプレイスの新機能、起動高速化など、実務に影響する変更が多数含まれています。本記事では特に影響度の高い変更を中心に、「何が変わったか」「なぜ重要か」「どう対応すべきか」を整理します。

📌 影響を受ける人

• Claude Code を長時間の対話セッション(数時間〜終日)で使い続けている人
• .mcp.json で headersHelper を設定している人、特に CI/CD や非対話モード(claude -p)で MCP を使っている人
• プラグインマーケットプレイスを社内配布などプライベート運用している人

変更の全体像

今回のリリースにおける主要な変更の関係性を図示します。

赤系(B1)は影響度が高い修正、黄系(C1/C2)は破壊的変更を含むセキュリティ強化です。

変更内容

1. 長時間セッションでのメモリ無限増大を修正(severity: high)

長時間の対話セッションで、サブエージェントのツール結果がメモリ上に保持され続け、使用量が際限なく増加していく問題が修正されました。今後はツール結果が最近の表示ウィンドウから外れた時点で解放されるようになります。

長時間の実装タスクやペアプロ的な使い方で Claude Code を稼働させ続けている人ほど、この修正の恩恵は大きいはずです。逆に言えば、これまで数時間〜終日にわたるセッションでメモリ使用量がじわじわ増えていた場合、それはバグであり、v2.1.238 以降では改善が見込めます。

2. MCP headersHelper のセキュリティ強化(severity: medium, ⚠️ Breaking Change)

⚠️ Breaking Change
CI・自動化環境で .mcp.json の headersHelper に依存している場合、アップデート後に動作しなくなる可能性があります。

変更点は大きく2つです。

項目	変更前	変更後
実行条件	プロジェクトの .mcp.json / インライン MCP サーバーの headersHelper はそのまま実行	対象フォルダの信頼ダイアログ承認が必須(claude -p の非対話モードでも同様)
実行環境	呼び出し元の環境変数を継承	プロジェクト .mcp.json・プラグイン・エージェントファイル由来の headersHelper は資格情報系環境変数なしで実行
スコープ差	—	ユーザー/管理/claude.ai スコープのヘルパーは Claude 設定ディレクトリから実行

これは攻撃者が悪意ある .mcp.json を仕込んで、ユーザーの認証情報を盗み出すヘルパーコマンドを実行させる、といったリスクを塞ぐためのセキュリティ強化です。一方で、信頼ダイアログの承認を前提としない CI パイプラインや、意図的に環境変数(トークンなど)を headersHelper 内で参照していた構成は、そのままでは壊れます。

💡 Tips
自動化環境で MCP の headersHelper を使っている場合は、対象フォルダを事前に信頼済みとして登録できるか、また資格情報をヘルパー内の環境変数参照に依存していないかを、アップデート前に確認しておくと安全です。

3. プラグインマーケットプレイスに headersHelper を追加(severity: medium)

URL マーケットプレイスやカタログエントリに headersHelper を設定し、短命トークンなどの HTTP ヘッダーをコマンドで動的発行できるようになりました。カタログエントリの headersHelper はプラグインのインストール・更新時のみ実行され、コマンド内容を表示した上で [y/N] の確認を求めます(-y で省略可)。

プライベートなプラグイン配布(社内限定マーケットプレイスなど)での認証が容易になる機能です。

4. その他の注目すべき修正・機能

変更	種別	概要
self-hosted-runner の猶予付きシャットダウン	新機能	--defer-shutdown-max-min で SIGTERM 後もセッションを維持しつつ終了。--proxy-authorization-command/-file でプロキシ認証ヘッダーを毎接続発行
Remote Control 安定性修正	バグ修正	接続断・メッセージ消失・モデル選択の不同期・クラッシュ後の復帰不能など9項目を修正、HTTP 403 の一時的ブロックも最大3分許容
MCP server/discover 順序修正	バグ修正	stdio MCP サーバーが initialize 前に discover を受け取り、遅延起動型サーバーが不要に起動していた問題を修正。クロスセッションのメッセージ拒否/ドロップも送信側へ通知されるように
起動高速化・Ctrl+L 挙動変更	改善/破壊的変更	macOS での起動高速化。フルスクリーンの Ctrl+L/Cmd+K は常に再描画のみとなり、二度押しでの /clear は廃止
claude-api スキル更新	改善	Managed Agents 2026/8/19 リリース対応(Web search/fetch のドメイン設定、セルフホストサンドボックスのメモリストア)
keybindingFlavor 設定	新機能	"readline" で Ctrl+W が Bash 同様に直前の空白まで削除する挙動に

影響と対応

対応の要否を判断するフローチャートです。

まとめると、以下の3タイプのユーザーは特にリリースノートを確認してください。

• CI/自動化で MCP headersHelper を使っている人: 信頼ダイアログ未承認だと動作しなくなるため要確認(action_required: true)
• 二度押し /clear に慣れている人: v2.1.238 からはショートカットとして機能しなくなる
• プラグインをプライベート配布している人: headersHelper の新設定で認証を簡素化できる可能性がある

それ以外の一般的な使い方であれば、今回のアップデートは基本的にメリットが大きく、特別な移行作業は不要です。

コード例

.mcp.json に headersHelper を設定している場合の Before/After のイメージです。

Before (v2.1.238 未満: 環境変数を継承して動作)

{
  "mcpServers": {
    "internal-api": {
      "url": "https://internal.example.com/mcp",
      "headersHelper": "echo \"{\\\"Authorization\\\": \\\"Bearer $INTERNAL_API_TOKEN\\\"}\""
    }
  }
}

この構成は、$INTERNAL_API_TOKEN が呼び出し元シェルの環境変数として継承されることを前提にしていました。

After (v2.1.238 以降: 資格情報系env変数は遮断される)

{
  "mcpServers": {
    "internal-api": {
      "url": "https://internal.example.com/mcp",
      "headersHelper": "/usr/local/bin/fetch-internal-token.sh"
    }
  }
}

トークン取得ロジックをスクリプト側に完全に内包し、外部の環境変数に依存しない形へ変更するのが安全です。また非対話モードで使う場合は、事前に対象ディレクトリを信頼済みとして扱えるよう設定を確認してください。

まとめ

• 最重要: 長時間セッションでのメモリ無限増大が修正され、サブエージェントのツール結果は表示ウィンドウを外れると解放されるようになった(severity: high)
• 要注意: MCP headersHelper に信頼ダイアログ必須化・資格情報系環境変数の遮断というセキュリティ強化が入り、CI/自動化環境では動作確認が必要(action_required: true)
• プラグインマーケットプレイスの headersHelper 追加、self-hosted-runner の猶予付きシャットダウンなど、運用を柔軟にする新機能も複数追加
• Remote Control や MCP 通信まわりの地道な安定性修正、起動高速化も地味だが実務上ありがたい変更
• 二度押し /clear ショートカットの廃止など、キー操作に慣れているユーザーは軽微な挙動変更に注意

普段使いのユーザーはメリットの大きいアップデートですが、MCP を自動化パイプラインに組み込んでいるチームは、アップデート前に headersHelper の動作確認をしておくことを強くおすすめします。