Claude CodeのECONNRESET、「接続が失われました」、「APIの応答を待っています · ネットワークを確認してください」、「APIに接続できません」、証明書エラー

メッセージ

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 （未解決：デスクトップアプリとCLIで断続的にECONNRESETが発生。VPNもプロキシも使用しておらず、8月13から発生し、8月21まで複数の人が確認）および #86473 （すべての利用環境でECONNRESETが継続的に発生する一方、APIへの直接のHTTPは動作）。ローカルでの対処では直りません。リトライと時間の経過で解消します。status.claude.comを確認し、トラッカーで複数のユーザーが同じ時間帯の問題を報告している場合は、デバッグを打ち切ってください。

「APIの応答を待っています · ネットワークを確認してください」

このメッセージはネットワークを原因としていますが、実際にはそうでないこともよくあります。 #82155 （未解決、リアクション15件）：正常であることが実証されたネットワークで、一日中、数分間の停止が発生し、リトライのバックオフが数分を超えています。 #76555 （未解決）：モデルを問わず、すべての返信で待ち時間が発生します。 #72059 と #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、2.1.19x）：原因は同梱の信頼ストアであり、時計ではありません。 claude update。解決しない場合、npmビルドはシステムのストアを使用します。
再インストール後のmacOSでの`ConnectionRefused` (#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でアカウントを作成

よくある質問

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キーを取得無制限プランを見る

AI Prime Techは独立したAPIゲートウェイであり、Anthropicとの提携関係はなく、同社の推奨や支援も受けていません。「Claude」と「Claude Code」はAnthropicの商標です。ここで説明するClaude Codeの機能は、執筆時点のAnthropicの公開ドキュメントに基づいており、頻繁に変更されます。このページの料金とモデル一覧は、このゲートウェイの現在の設定から取得しています。

Claude Codeの接続エラー：ECONNRESET、応答途中の接続切断、「API応答を待機中」「APIに接続できません」、SSL証明書エラー

TLDR