Source: https://aiprimetech.io/ja/claude-code/errors/connection-lost/ [ホーム](/ja/) › [Claude Code](/ja/claude-code/) › [エラー](/ja/claude-code/errors/) › 接続エラー [概要](/ja/claude-code/)[インストール](/ja/claude-code/install/)[CLIリファレンス](/ja/claude-code/cli/)[料金と制限](/ja/claude-code/pricing/)[Agent SDK](/ja/claude-code/sdk/)[スキルとプラグイン](/ja/claude-code/skills/)[GitHub](/ja/claude-code/github/)[ウェブ、デスクトップ、IDE](/ja/claude-code/web-and-desktop/)[モデル](/ja/claude-code/models/)[エラー](/ja/claude-code/errors/)[オープンソース?](/ja/claude-code/open-source/)[チュートリアル](/ja/claude-code/tutorial/)[学生向け](/ja/claude-code/for-students/)[QA自動化](/ja/claude-code/qa-automation/)[Cursorとの比較](/ja/claude-code/vs-cursor/)[Codex・OpenCodeとの比較](/ja/claude-code/vs-codex/)[サブエージェント](/ja/claude-code/subagents/)[フック](/ja/claude-code/hooks/)[MCP](/ja/claude-code/mcp/)[エコシステム](/ja/claude-code/ecosystem/)[VS Code](/ja/claude-code/vscode/)[OpenRouter](/ja/claude-code/openrouter/)[レート制限](/ja/claude-code/rate-limits/)[中国語ガイド](/claude-code/zh/) 最終更新:2026年10月11日 # Claude Codeの接続エラー:ECONNRESET、応答途中の接続切断、「API応答を待機中」「APIに接続できません」、SSL証明書エラー これらのエラーは、リクエストが完了しなかったことを意味します。TCP接続がリセットされた、TLSハンドシェイクが失敗した、プロキシがホストへの接続を拒否した、またはストリームからデータが届かなくなった可能性があります。Claude Codeは自動でリトライし、その状況が「Ns後にリトライします · 試行x/y」や「APIの応答を待っています」の行に表示されます。トラッカーには大きく異なる種類の事例があり、どちらに該当するかが重要です。プロキシやCAの設定で直るローカルネットワークの問題と、時間の経過を待つしかないAnthropic側の障害です。 ## TLDR - Retrying in 0s · attempt 1/10 / Waiting for API response · will retry in … — 自動リトライ中です。試行するたびに待ち時間が長くなります。 - Connection dropped (ECONNRESET) / Connection lost mid-response — 接続が切断されました。直接の curl が動作し、プロキシもない場合は、通常は上流側の問題です。 - Unable to connect to API / fetch failed / ConnectionRefused — エンドポイントに何も到達していません。DNS、VPN、プロキシ、ファイアウォールを確認してください。 - unable to get local issuer certificate / CERT_HAS_EXPIRED — TLSを検査するプロキシ、または古いCAストアが原因です。次の参照先を、 NODE_EXTRA_CA_CERTS 社内のルート証明書に設定してください。 ## メッセージ ``` API Error: Connection dropped (ECONNRESET) API Error: Connection lost mid-response API Error: fetch failed Unable to connect to API (ConnectionRefused) Retrying in 0s · attempt 1/10 Waiting for API response · will retry in 2m 35s · check your network API Error: Socket is closed SSL certificate verification failed: unable to get local issuer certificate Error: certificate has expired (CERT_HAS_EXPIRED) ``` ## 問題はこちら側、それとも相手側?数分で確認 ``` curl -sS -o /dev/null -w "%{http_code} %{time_total}s\n" https://api.anthropic.com/v1/models -H "x-api-key: x" -H "anthropic-version: 2023-06-01" # 401 in under a second = network path is fine, the problem is upstream or in Claude Code # timeout / SSL error / 000 = the problem is on your side of the wire env | grep -i -E "proxy|anthropic|node_extra|ssl" claude --debug # per-request timing and retry reasons in the log ``` curlがすぐに401を返し、プロキシ変数もない場合は、ほぼ間違いなく上流側の障害です。これは次の事例に該当します: [#87424](https://github.com/anthropics/claude-code/issues/87424) (未解決:デスクトップアプリとCLIで断続的にECONNRESETが発生。VPNもプロキシも使用しておらず、8月13から発生し、8月21まで複数の人が確認)および [#86473](https://github.com/anthropics/claude-code/issues/86473) (すべての利用環境でECONNRESETが継続的に発生する一方、APIへの直接のHTTPは動作)。ローカルでの対処では直りません。リトライと時間の経過で解消します。status.claude.comを確認し、トラッカーで複数のユーザーが同じ時間帯の問題を報告している場合は、デバッグを打ち切ってください。 ## 「APIの応答を待っています · ネットワークを確認してください」 このメッセージはネットワークを原因としていますが、実際にはそうでないこともよくあります。 [#82155](https://github.com/anthropics/claude-code/issues/82155) (未解決、リアクション15件):正常であることが実証されたネットワークで、一日中、数分間の停止が発生し、リトライのバックオフが数分を超えています。 [#76555](https://github.com/anthropics/claude-code/issues/76555) (未解決):モデルを問わず、すべての返信で待ち時間が発生します。 [#72059](https://github.com/anthropics/claude-code/issues/72059) と [#70534](https://github.com/anthropics/claude-code/issues/70534):アドバイザーモデルへの問い合わせ時に限って同じ停止が発生し、タイマーが終わると正常な回答が返ります。バックオフは指数関数的に増えるため、目に見える影響は失敗ではなく待ち時間です。以下の変数で短縮できます。 ## リトライとタイムアウトの変数 ``` export CLAUDE_CODE_MAX_RETRIES=15 # default 10, capped at 15 export CLAUDE_CODE_RETRY_WATCHDOG=1 # keep retrying instead of giving up (unattended runs) export API_TIMEOUT_MS=600000 # per-request timeout, default 10 minutes export CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS=60000 # give up on a silent stream sooner and retry export CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=2 # fewer parallel streams on a flaky link ``` 最初のバイトを受信するまでのタイムアウトを短くすると、不安定な接続での使用感が変わります。応答が返らないストリームで長時間待つ代わりに、クライアントがその接続を諦めてリトライします。複数のストリームを同時に実行すると切断される回線(モバイルホットスポットや一部のVPN)では、ツール使用の同時実行数を下げると改善します。 ## プロキシ、VPN、社内ネットワーク - Claude Codeが読み取るプロキシ変数を設定してください: HTTPS_PROXY (および HTTP_PROXY, NO_PROXY)。ブラウザーやnpmの設定にしか存在しないプロキシは、CLIからは認識されません。 - TLSを検査するプロキシ は、Anthropicの証明書を独自の証明書に置き換えます。それが次のエラーの原因です: unable to get local issuer certificate。社内のルートCAをPEMファイルにエクスポートし、次を設定してください: NODE_EXTRA_CA_CERTS=/path/to/corp-root.pem。検証を無効にしないでください。 - ネイティブビルドでの`CERT_HAS_EXPIRED` ([#71727](https://github.com/anthropics/claude-code/issues/71727)、2.1.19x):原因は同梱の信頼ストアであり、時計ではありません。 claude update。解決しない場合、npmビルドはシステムのストアを使用します。 - 再インストール後のmacOSでの`ConnectionRefused` ([#75897](https://github.com/anthropics/claude-code/issues/75897))— ローカルのプロキシまたはVPNクライアントが停止しているのに、環境には設定が残っています。プロキシ変数とシステムのプロキシ設定を消去してから、再試行してください。 - VPN出口の変更 がセッション中に起こると、開いているすべてのストリームがリセットされます。再接続ごとにECONNRESETが発生すると考えてください。 ## ゲートウェイ経由 Claude Codeの接続先をゲートウェイ(ANTHROPIC_BASE_URL=https://aiprimetech.io)にすると、ネットワーク経路が変わります。クライアントはゲートウェイと通信し、ゲートウェイが上流への接続を維持して、あるアカウントが飽和すると別のアカウントで再試行します。ローカルネットワークの障害を直すものではありませんが、上記の「上流での接続リセット」に該当する場合は、単一アカウントへの依存を解消し、サブスクリプションに障害が発生しても同じキーを使い続けられます。切り替える前に、ゲートウェイのホストに対してcurlチェックを実行し、経路を確認してください。 ``` export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=your_gateway_key claude ``` ## この問題への対処に疲れましたか? 代わりにAI Prime Techのゲートウェイ経由でClaude Codeを実行してください。ゲートウェイ独自のアップストリームアカウントで同じClaudeモデルを利用でき、環境変数を2つ変更するだけで切り替えられます。新規アカウントには $5分の無料APIクレジット を、コード FIXIT が付与されます。カードは不要です。 ``` export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=your_key ``` [コードFIXITでアカウントを作成](/register?promo=FIXIT) ## よくある質問 Claude Codeの「APIエラー:接続が切断されました(ECONNRESET)」を修正するには? APIに対してcurlを実行してください。応答が速く、プロキシを使っていなければ、リセットは上流で発生しています。再試行をそのまま続け、status.claude.com.を確認してください。curlも失敗する場合は、プロキシ変数、VPN、またはCA証明書を修正してください。「APIの応答を待っています · …後に再試行します · ネットワークを確認してください」とはどういう意味ですか? Claude CodeがタイムアウトまでにAPIから応答を受け取れず、再試行まで待機しています。表示内容とは異なり、ネットワークが原因ではない場合もよくあります。CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MSを小さくして、応答のないストリームをクライアントがより早く打ち切るようにしてください。Claude Codeの「ローカルの発行者証明書を取得できません」を修正するには? プロキシがTLSを再署名しています。社内のルート証明書をPEM形式でエクスポートし、NODE_EXTRA_CA_CERTSにそのファイルを設定してください。証明書の検証は絶対に無効にしないでください。「0秒後に再試行します · 試行1/10」とはどういう意味ですか? リクエストが失敗し、Claude Codeが再試行しています。デフォルトでは待機時間を段階的に延ばしながら10回試行します。CLAUDE_CODE_MAX_RETRIESを使うと15回に増え、CLAUDE_CODE_RETRY_WATCHDOG=1にすると無人実行で再試行を続けます。 ## ゲートウェイでClaude Codeを実行 同じモデルを環境変数の設定だけで利用できます。額面の7.69231倍のクレジット、または定額無制限プランを選べます。 新規アカウント:コードFIXITで$5分の無料APIクレジット。[APIキーを取得](/register?promo=FIXIT) [無制限プランを見る](/ja/plans/) AI Prime Techは独立したAPIゲートウェイであり、Anthropicとの提携関係はなく、同社の推奨や支援も受けていません。「Claude」と「Claude Code」はAnthropicの商標です。ここで説明するClaude Codeの機能は、執筆時点のAnthropicの公開ドキュメントに基づいており、頻繁に変更されます。このページの料金とモデル一覧は、このゲートウェイの現在の設定から取得しています。 ## その他のClaude Codeガイド [Claude Codeのエラーと修正方法](/ja/claude-code/errors/)[Claude Code「APIエラー:500」:意味と実際に有効な解決方法](/ja/claude-code/errors/api-error-500/)[Claudeの「過負荷」エラー(APIエラー529):意味と対処方法](/ja/claude-code/errors/overloaded-529/)[Claude Code APIエラー400:プロンプトが長すぎる、ツール使用の並行処理、その他の問題](/ja/claude-code/errors/api-error-400/)[Claude CodeのOAuthエラー:15000msのタイムアウト超過とステータスコード500](/ja/claude-code/errors/oauth-error/)[「Claude Codeプロセスがコード1で終了しました」:実際のエラーの見つけ方と解決方法](/ja/claude-code/errors/process-exited-code-1/)[Claudeの「プロンプトが長すぎる」「指定されたモデルに対して入力が長すぎる」「コンテキスト上限に達しました」:ウィンドウが埋まる原因と空きを取り戻す方法](/ja/claude-code/errors/prompt-too-long/)[Claudeの使用量上限に到達:セッション、週次、Opusの上限、「指定されたAPI使用量上限」「クレジット残高が不足しています」— 対処方法](/ja/claude-code/errors/usage-limit-reached/)[Claude Codeの401と403:無効な認証情報、無効なAPIキー、「ログインしていません」、host_not_allowed](/ja/claude-code/errors/auth-401-403/)[Claude Codeがハングする、処理が進まない、応答しなくなる:停止箇所の特定方法と復旧方法](/ja/claude-code/errors/claude-code-hangs/)[Claude.aiが動作しない:「問題が発生しました」、処理容量の制約、「5時間の上限に達しました」、「ログイン中にエラーが発生しました」、その他の問題](/ja/claude-code/errors/claude-ai-not-working/)