Claude Code v2.1.319 — MCPタスクのバックグラウンド実行で夜間エージェントが詰まらなくなった
「夜11時にCIから叩いたClaude Codeエージェントが、翌朝見たら許可プロンプトで止まっていた」という経験がある人は少なくないはずだ。Reddit r/ClaudeAIでは「unattended runsで詰まる問題、みんなどう回避してる?」というスレッドが何度も上がり、tmuxでsendkeysして自動でEnterを押す自作スクリプトを書いた、という回答も珍しくなかった(出典:dev.to — Claude Code v2.1.319 unblocks unattended agent runs、2026年11月7日)。
そこに2026年11月6日、Claude Code v2.1.319がリリースされた。メインの変更は2つだ。MCPのツール呼び出しをバックグラウンドに移すMCPタスクバックグラウンド実行と、許可プロンプトを待機ではなく自動拒否で突破するdenyInsteadOfPrompting設定。セットで使えば、夜間の無人実行がかなり現実的になる。
- Claude CodeをCI/CDパイプラインや夜間バッチで走らせているエンジニア
- MCPサーバーの長時間ツール呼び出しでセッションが止まる経験をした人
- LLMゲートウェイやdenyInsteadOfPromptingの実運用を知りたい人
MCPタスクバックグラウンド実行:何が変わったのか
従来のMCPツール呼び出しは同期的だった。サーバーがツールを実行している間、Claude Codeはその応答を待ち続け、次の判断を下せない。DBマイグレーション、コードビルド、外部APIへの長時間リクエストなど、例えば30秒以上かかる処理はセッション全体のボトルネックになっていた。
v2.1.319でMCPタスクバックグラウンド実行が正式化された。仕組みはシンプルだ。MCPサーバーがツール呼び出しを「タスク」として返すと、Claude Codeはその処理をバックグラウンドに移し、Claudeは残りのタスクプランを続行する。タスクが完了したタイミングで結果がClaudeへ届く(出典:ai-tldr.dev — Claude Code 2.1.319、2026年11月6日)。
ターミナルのフッターには「1 MCP task」のようなカウントが表示される。/tasksコマンドで実行中タスクの状態と名前を確認できる(出典:dev.to — Claude Code Now Runs MCP Tasks in the Background、2026年11月7日)。
前提として、MCPサーバー側が2026年7月28日版のMCP仕様に対応している必要がある。同改訂でTasksが正式な拡張として仕様に入った(出典:pasqualepillitteri.it — MCP tasks claude code long jobs run in background)。なお、タスク対応でないサーバーの場合でも、MCPツール呼び出しが2分を超えると自動でバックグラウンドへ移行する。これはサーバー改修なしで恩恵を受けられる安全網として機能する。
無効化したい場合は環境変数で制御できる。
CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND=1 # バックグラウンド移行を完全無効
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS=0 # 自動移行タイマーだけ無効
注意点:サブエージェントのMCP呼び出しはタスクにならない。claude -p "<prompt>"の一発実行モードも対象外だ。Agent SDKセッションでバックグラウンドタスクを使うにはCLAUDE_AUTO_BACKGROUND_TASKS=1が必要になる(出典:dev.to — Claude Code Now Runs MCP Tasks in the Background)。
denyInsteadOfPromptingで詰まりを排除する
MCPタスクがバックグラウンドへ移ったとしても、許可プロンプトは依然として壁になる。ファイル書き込みやシェルコマンドを初めて実行しようとしたとき、Claude Codeは人間の確認を待つ。夜間の無人実行でこれが発生すると、翌朝まで何もしていない状態で残る。
v2.1.319では、permissions.denyInsteadOfPromptingという設定が追加された。有効にすると、許可プロンプトが発生するはずの呼び出しは待機せず自動で拒否され、ターンが継続する。クラッシュや無限待機ではなく「できませんでした」という失敗として処理され、Claudeが次の判断をくだせる。
設定は~/.claude/settings.json(グローバル)またはプロジェクトの.claude/settings.jsonに記述する。
{
"permissions": {
"denyInsteadOfPrompting": true
}
}
注意点がある。この設定はあくまで「プロンプトが発生するはずの呼び出し」に作用する。既存のallowリストやdenyリストに登録済みの操作はそちらの設定が優先され、この設定は上書きしない。また、MCPのElicitation(ツールが途中でユーザーへ質問を挟む仕組み)が来た場合、denyInsteadOfPromptingが有効だとElicitationを処理するフックが別途なければキャンセルされる(出典:clauding.de — Claude Code 2.1.319: denyInsteadOfPrompting Ends the Waiting Prompt、2026年11月8日)。
あるブロガーは実際にtouch /tmp/testコマンドをdenyInsteadOfPromptingのみの状態で試したところ、Claudeが「このコマンドには承認が必要で、自動的に拒否されました」と返答してターンを継続したと報告している(出典:dev.classmethod.jp — Key Updates in Claude Code v2.1.318–v2.1.319、2026年11月8日)。
この設定は永続的なconfig版のオプションだ。以前のv2.1.259で追加された--permission-prompts noneフラグが一時的に使えたが、設定ファイルに書けるようになったことで自動化スクリプトに組み込みやすくなった(出典:developersdigest.tech — Claude Code denyInsteadOfPrompting、2026年11月7日)。
Auto modeとLLMゲートウェイの変更
v2.1.319はauto modeにも手を入れた。これまでauto modeはサーバー側で判断できない呼び出しについて、ローカルの分類器(built-in classifier)にフォールバックして許可・拒否を決めていた。今回の変更でそのフォールバックが廃止され、LLMゲートウェイ環境やテレメトリが無効な環境では、判断できない呼び出しが確認またはdenyになるようになった(出典:dev.classmethod.jp — Key Updates in Claude Code v2.1.318–v2.1.319)。
企業向けのLLMゲートウェイを挟んでいるチームには実際的な影響がある。「これまで自動で通っていた呼び出しが確認を求めてくるようになった」という報告が一部で出ている(出典:meteoraweb.com — Claude Code 2.1.319, Auto Mode and MCP Tasks)。ゲートウェイ経由で運用しているなら、CLAUDE_CODE_AUTO_MODE_SERVER環境変数の設定を確認し、想定外の確認プロンプトが増えていないかリリース後に観察したほうがいい。
v2.1.318:サインイン期限の可視化とセキュリティチェック
前日のv2.1.318にも触れておく。
サインイン期限の早期警告:claude.aiのサインイン有効期限が近づくと、より早い段階で警告が出るようになった。有効期限はclaude auth statusコマンドやclaude -pのJSON出力でも確認できる(出典:Claude Code公式Changelog)。夜間実行の前にセッション有効期限を確認する運用は理にかなっており、CI組み込みへの布石とも読める。
メールアドレス送信の確認:WebツールやShellツールの呼び出しがアカウントのメールアドレスをネットワーク越しに送信しようとする場合、事前に確認を求めるチェックが追加された。自動化スクリプト経由で外部サービスへの接続を使っている人には影響がある可能性がある。
光と影:制限と現実的な注意点
MCPタスクバックグラウンド実行が使えない環境がある。VS Code拡張とデスクトップアプリ(Claude.app)は2026年11月時点で非対応だ。CLI専用の機能として出発した。サブエージェント内のMCP呼び出しも同様に対象外で、エージェントを入れ子で走らせているアーキテクチャでは恩恵が届かない部分が残る(出典:aicatchup.com — Claude Code MCP Tasks Enter Public Beta)。
キャンセルは協調的。タスクをキャンセルしてもサーバーは処理を続けることがある。サーバー側がキャンセルシグナルを無視する実装だった場合、タスクはバックグラウンドで走り続ける。stdioサーバーはClaude Codeが終了した時点でプロセスも止まるため問題は少ないが、リモートサーバーはClaude Codeを閉じた後も動き続ける。長時間の外部処理を起動する設計では、タイムアウトとキャンセル実装をサーバー側で整えておく必要がある(出典:pasqualepillitteri.it — MCP tasks claude code long jobs run in background)。
denyInsteadOfPromptingは諸刃。自動拒否はセッションの詰まりを防ぐが、設計通りに許可が必要な操作まで拒否される。事前のallowリスト整備が不十分だと、エージェントが「できませんでした」の失敗を重ねるだけになる。本番CI投入の前に、ローカルで何が拒否されるかを一度観察してからallowリストを固める流れを踏んだほうがいい。
今すぐ確認すること
Claude Codeのバージョンをclaude --versionで確認し、2.1.319未満ならnpm update -g @anthropic-ai/claude-codeでアップデートしてほしい。夜間自動実行をすでに組んでいるなら、denyInsteadOfPromptingを設定ファイルに追加するだけで詰まりが減る可能性が高い。MCPサーバーを運用しているなら、2026年7月28日版のMCP仕様への対応状況をサーバーのREADMEやリリースノートで確認しよう。
無人実行を組む前にやること
v2.1.319の変更を踏まえた、夜間エージェント実行の準備チェックリストを整理する。
- バージョン確認 —
claude --versionで2.1.319以上を確認 - allowリスト整備 — よく使うファイルパスやシェルコマンドをあらかじめ許可リストへ追加
- denyInsteadOfPrompting追加 — 設定ファイルにフラグを追加
- MCPサーバー確認 — 長時間ツールを使っているなら仕様バージョンを確認
- ローカルドライラン — 本番投入前にdenyInsteadOfPromptingが何を拒否するかを観察
Claude Codeの権限設定について詳しくは過去記事も参照してほしい。MCP周りの設計についてはMCPプロトコルの実践ガイドが参考になる。エージェントの並列実行を検討しているならClaude Code 並列実行の記事も合わせて読んでほしい。
Claude Code v2.1.319のMCPタスクバックグラウンド実行とdenyInsteadOfPromptingは、どちらもCLIのアップデートとconfig1行で今すぐ使える。夜間実行が詰まっていたなら、まずdenyInsteadOfPromptingをローカルで試してみてほしい。設定はsettings.jsonに"denyInsteadOfPrompting": trueを追加するだけだ。
免責事項: 本記事の情報は2026年11月10日時点のものだ。機能の仕様・対応環境・設定項目名は今後変更される可能性がある。各機能の最新情報はClaude Code公式Changelogで確認してほしい。記事中の製品名・サービス名は各社の商標または登録商標である。