2.1.319 で運用に関わる変更

Claude Code 2.1.319 は、公式 changelog に掲載されています。CLI、VS Code、クラウドセッション、self-hosted runner、Claude apps gateway など、複数の領域が変更され、不具合修正は 90 件あります。この記事で取り上げるのは、無人運用、MCP、ゲートウェイに関わる変更です。

変更影響を受ける利用者
MCP サーバーがタスクとして実行する呼び出しを、バックグラウンドへ移すMCP サーバーを使う人・作る人
permissions.denyInsteadOfPrompting で、権限確認を待つツール呼び出しを拒否してターンを続ける無人でツールを実行している人
テレメトリ・フィーチャーフラグを無効にした環境の auto mode が、組み込みの分類器へ戻らないゲートウェイやテレメトリ無効の環境の管理者
claude -p が auto mode の安全確認を利用できず拒否された場合、終了コードを 1 にするclaude -p を CI やバッチで実行している人

内容は、2026 年 11 月 10 日に再確認した Claude Code の公式 changelog と、本文で示す公式ドキュメントに基づきます。1 つ前のバージョンの変更は Claude Code 2.1.317・2.1.318 の記事 にまとめています。

MCP タスクがバックグラウンドで実行される

何が変わったか

2.1.319 の changelog には、端末の Claude Code で MCP タスクに対応した、とあります。MCP サーバーがツール呼び出しをタスクとして実行すると、Claude Code はそれをすぐバックグラウンドへ移し、完了時に結果を Claude へ伝えます。

MCP タスクとは、レポートの書き出しやビルドのような長時間の処理を、MCP サーバー自身が動かす仕組みです。公式の MCP ドキュメントには、サーバーが処理を受け付けた時点で Claude のツール呼び出しが返り、Claude は作業を続ける、と書かれています。実行中、画面の下には 1 MCP task のような件数が出ます。完了すると会話の記録に通知され、Claude には結果が渡されます。結果は記録には出ないため、必要なら Claude に聞きます。

/tasks から止めることもできます。リモートのサーバー上のタスクは、Claude Code を終了しても動き続けます。同じドキュメントによると、MCP タスクは CLI の公開ベータで、v2.1.304 以降が必要です。

2.1.319 では、フィーチャーフラグを取得しない環境でも MCP タスクが端末で実行されるようになりました。対象は Bedrock、Vertex、Foundry、LLM ゲートウェイ、DISABLE_TELEMETRY を設定した環境です。

無効化する環境変数

環境変数は 2 つあり、無効化する範囲が異なります。

環境変数効果
CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND=1即時バックグラウンド移行を無効にし、ツール呼び出し内で待機する
CLAUDE_CODE_DISABLE_MCP_TASKS=1MCP タスクを無効にする

CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND=1 は、完了まで必ず待機する設定ではありません。公式 MCP ドキュメントでは、通常の自動バックグラウンド移行が有効なら、デフォルトでは 2 分後に移行すると説明されています。MCP タスク自体を無効にする場合は CLAUDE_CODE_DISABLE_MCP_TASKS=1 を使います。

FIXITFIXIT

MCP の長い処理が裏に回ると、結果はどうやって受け取るの?

DodaiDodai

終わると Claude に結果が渡ります。結果は記録には出ないので、必要なら Claude に聞きます。

MCP を使う実践の全体は Claude Code の MCP 実践パターンの記事 を参照してください。

権限の確認待ちを拒否に変える

permissions.denyInsteadOfPrompting

2.1.319 で、permissions.denyInsteadOfPrompting が加わりました。権限確認を待つツール呼び出しを、拒否してターンを続ける設定です。changelog では、端末のセッション、サブエージェント、チームメイトが対象とされています。

無人運用では、権限確認の応答待ちで処理が停止することがあります。この設定を有効にすると、承認を待つ呼び出しを拒否してターンを続けます。

利用前に決めておくこと

権限確認を拒否に変える運用では、承認なしの実行を防げますが、一部の作業が未実施のままになることがあります。有効にする前に、次を決めておくと運用しやすくなります。

  1. 拒否される可能性がある呼び出しを permissions.allow に事前登録するか
  2. 拒否された呼び出しを、どこで見つけるか (ログや出力の確認)
  3. 拒否が出たジョブを、失敗として扱うか

権限ルールの書き方は Claude Code の権限と settings.json 設計 を参照してください。

ゲートウェイ・テレメトリ無効の環境の auto mode

組み込みの分類器へ戻らなくなる

2.1.319 で、テレメトリやフィーチャーフラグを無効にした環境の auto mode が変わりました。LLM ゲートウェイ経由の場合も含みます。サーバー側で確認できない呼び出しは、確認を出すか拒否になり、組み込みの分類器へは戻りません。Bedrock、Vertex、Foundry は変わりません。

以前の動きを使い続けたい場合は、CLAUDE_CODE_AUTO_MODE_SERVER=0 を設定します。環境変数の公式一覧では、この変数は、サーバーに auto mode の行動を確認させるかを決めるもので、0 にすると Claude Code 自身の分類器へのリクエストを使う、とされています。

逆に、ゲートウェイ経由でサーバー側の確認を有効にしたい場合は、CLAUDE_CODE_AUTO_MODE_SERVER=1 が、CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS を設定していても有効になりました。管理設定で CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS を設定している場合は、1 も管理設定に書きます。

あわせて、一度プロジェクト外の設定でサーバー側の確認を無効にしたあとは、プロジェクトの設定ファイルやプラグインから再び有効にできなくなりました。

auto mode のデフォルト化の記事も参照してください。

claude -p の終了コード

claude -p は、auto mode で安全確認が使えず行動が拒否されたとき、終了コード 0 で終わる不具合がありました。2.1.319 で修正され、テキスト出力でも JSON 出力でも終了コード 1 になります。終了コードで成否を判定しているスクリプトは、更新後に失敗として扱う場面が増えることがあります。

更新の進め方

  1. 無人で claude -p を実行しているなら、auto mode の安全確認を利用できず拒否された場合に終了コード 1 になることを前提に、ジョブの失敗の扱いを見直す
  2. ゲートウェイやテレメトリ無効の環境なら、同じ作業を更新前後に実行して、確認と拒否が増えないかを比べる。増えるなら CLAUDE_CODE_AUTO_MODE_SERVER=0 を検討する
  3. MCP サーバーを使っているなら、長い呼び出しがバックグラウンドへ移ったときに、後続の手順が結果を待つ前提になっていないかを確認する
  4. permissions.denyInsteadOfPrompting を有効にするなら、拒否された呼び出しを見つける方法と、失敗の扱いを先に決める

更新の確認を運用に組み込む

changelog は 1 バージョンごとに項目が多く、全件を読むより、停止時に影響が生じる領域を先に決めておくほうが、確認を短時間で終えられます。無人で実行するジョブ、ゲートウェイ、MCP サーバーを、チームごとに書き出しておけば、変更履歴の項目と照合できます。

Claude Code の更新を個人の判断ではなくチームの手順にしたい場合は、AI 開発ツール定着支援 をご覧ください。具体的な進め方は お問い合わせ からご相談いただけます。当社は、権限と更新運用の設計から支援しています。

設定リファレンスで確認できることと実機確認

2026 年 11 月 10 日に再確認した設定リファレンスでは、permissions.denyInsteadOfPrompting はデフォルトで未設定です。ユーザー設定・管理設定・--settings で指定でき、プロジェクト設定では指定できません。

同リファレンスには、Claude が受け取る拒否メッセージと、stream-json 出力の decision_reason も掲載されています。設定が有効でも、ワークスペースの信頼確認やプロジェクト MCP サーバーの承認では応答待ちが残ります。無人運用の前に承認を済ませてください。

この記事では、2.1.319 の実機で拒否時の表示や MCP タスクの待機動作を再現していません。現在のドキュメントに記載された動作と、利用中のバージョンでの実際の動作を区別し、更新後に確認してください。

まとめ

  • 2.1.319 は、MCP サーバーがタスクとして実行する呼び出しをバックグラウンドへ移し、完了後に Claude へ結果を伝える。即時バックグラウンド移行を無効にするなら CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND=1、機能を無効にするなら CLAUDE_CODE_DISABLE_MCP_TASKS=1
  • permissions.denyInsteadOfPrompting は、権限確認を待つツール呼び出しを拒否してターンを続ける。有効にする前に、拒否の検出方法と失敗の扱いを決める
  • ゲートウェイやテレメトリ無効の環境の auto mode は、確認できない呼び出しを確認か拒否にする。戻すなら CLAUDE_CODE_AUTO_MODE_SERVER=0
  • claude -p は、auto mode の安全確認を利用できず拒否されたとき終了コード 1 になる