アイドルタイムアウトでMCP/Vertex接続が切れるのを防ぎたい
16. トラブルシューティングコマンド / 機能
API_FORCE_IDLE_TIMEOUT=0 / CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT5分アイドルタイムアウトの調整
概要
Vertex AI / Microsoft Foundry 経由の利用では、5分間の無通信でコネクションが切断されるアイドルタイムアウトが存在します。API_FORCE_IDLE_TIMEOUT=0 で回避できます。また、MCP ツール呼び出し自体にも既定5分のアイドルタイムアウトがあり、CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT で上書きできます。長時間かかるMCPツールやVertex/Foundry環境でタイムアウトエラーが出る場合に有効です。
設定例
# Vertex/Foundry の5分アイドルタイムアウトを無効化
export API_FORCE_IDLE_TIMEOUT=0
claude
# MCPツール呼び出しのアイドルタイムアウトを延長（ミリ秒単位）
export CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT=600000 # 10分
claude
# 両方設定する例
API_FORCE_IDLE_TIMEOUT=0 CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT=600000 claude -p "長時間かかる分析をして"こんな時に使う
- Vertex AI / Foundry 経由で長時間の処理中に接続が切れる時
- 時間のかかるMCPツールの実行が途中でタイムアウトする時
使い方
- 1Vertex/Foundryのタイムアウトには API_FORCE_IDLE_TIMEOUT=0 を設定
- 2MCPツールのタイムアウトには CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT にミリ秒で値を設定
- 3環境変数として設定してから claude を起動
Tips
- 既定のMCPツールアイドルタイムアウトは5分
- Anthropic APIを直接使う場合はこのタイムアウト問題は基本的に発生しない
- ts-timeout の全体的なタイムアウト設定と合わせて調整すると良い