T-CREATOR

<div />

【解決方法】Claude Code で出る「API Error: Connection refused」「Can't reach the API server」の原因と対処: 入れ直しても直らない、原因はネットワーク

2026年10月30日
【解決方法】Claude Code で出る「API Error: Connection refused」「Can't reach the API server」の原因と対処: 入れ直しても直らない、原因はネットワーク

プロキシの設定を間違えたまま Claude Code を起動すると、しばらく何の応答もなく、約3分後に Connection refused と出て止まりました。

プロキシの名前を存在しないものにすると、今度は Can't reach the API server に変わります。出る文で、原因の場所が分かれていました。

出たときの表示と、直るまでにしたことを残しておきます。

環境

  • macOS 26.6
  • Claude Code 2.1.309、画面の画像は 2.1.311

発生したエラー

プロキシに接続できないときは、次のように表示されます。

terminal$ HTTPS_PROXY=http://127.0.0.1:9 claude -p "hi"
API Error: Connection refused — a firewall or proxy may be blocking it (ECONNREFUSED)

対話画面では、やり直している間、画面の下に赤い字でエラーの文と、やり直すまでの秒数と回数が出ます。接続先に断られたときは Connection refused です。

Claude Code の対話画面。hi と送ったあと、赤い字で Connection refused — a firewall or proxy may be blocking it と、Retrying in 7s · attempt 7/10 が出ている

接続先の名前を解決できないときは、Can't reach the API server — check your internet or DNS に変わります。

Claude Code の対話画面。Can't reach the API server — check your internet or DNS (ENOTFOUND) · Retrying in 8s · attempt 6/10 と出ている

プロキシの名前を解決できないときは、次の表示です。

terminalAPI Error: Can't reach the API server — check your internet or DNS (ENOTFOUND)

原因

Claude Code が Anthropic のサーバー(api.anthropic.com)に接続できていないことが原因です(ECONNREFUSED は接続を断られたとき、ENOTFOUND はサーバーの名前を解決できないとき)。エラーが出るまでに約3分かかるのは、Claude Code が10回やり直しているためです(Claude Code の再試行(リトライ)の動き)。

公式のエラー一覧の「Unable to connect to API」の節にも、接続できないときの文がまとまっています。

公式のエラー一覧の Unable to connect to API の節。Connection refused、Can't reach the API server など、接続できないときの文が並んでいる

解決方法

関連するエラー

接続まわりでは、ほかにも次の表示が出ます。プロキシや証明書で止まったときは、次のように出ます。

表示される文意味
Couldn't connect through your proxy (ERR_PROXY_TUNNEL)プロキシが通信を通さなかった。プロキシの認証と、許可されている接続先を確かめる
Unable to connect to API (UnsupportedProxyProtocol)SOCKS のプロキシを指定している。HTTP か HTTPS のプロキシにする
Unable to connect to API: SSL certificate verification failed (UNABLE_TO_VERIFY_LEAF_SIGNATURE)社内のプロキシの証明書を信頼していない
Unable to connect to API: SSL certificate verification failed (UNABLE_TO_GET_ISSUER_CERT_LOCALLY)社内のプロキシの証明書を信頼していない
Unable to connect to API: Self-signed certificate detected (SELF_SIGNED_CERT_IN_CHAIN)自己署名の証明書が途中に入っている

接続が切れたときや、返事が届かないときは、次のように出ます。

表示される文意味
Connection dropped (ECONNRESET)接続が途中で切れた
Request timed out決められた時間(設定のままだと10分)内に返事がなかった。API_TIMEOUT_MS で延ばせる
Waiting for API response · will retry in … · check your network20秒以上データが届いていない。まだ失敗ではなく、やり直す前の待ち時間
Connection lost before a response was produced返事が始まる前に接続が切れた
Connection lost while your computer was asleepパソコンがスリープして接続が切れた
Connection lost mid-response返事の途中で接続が切れた
The response stopped arriving接続は開いたままだが、データが届かなくなった
500、503、529 で始まるエラーAnthropic のサーバー側の障害。ステータスページを見て、時間を置く

Connection lost before a response was produced は、古いバージョンでは Connection closed while thinking, before producing a response と出ます。

検索でよく見る API Error (Connection error.) は、2.1.309 では出ませんでした。この表示が出るときは Claude Code が古い可能性があるので、claude --version で確かめて更新します。

注意点

まとめ

Connection refused も Can't reach the API server も、原因はたいていパソコン側のネットワークにあります。Claude Code を入れ直しても直らないので、まずは curl で Anthropic のサーバーに届くかを確かめてみてください。

届くのに直らないときは、プロキシや社内の証明書の設定を見直します。障害かどうか迷ったら、Claude Code の障害の見分け方も参考にしてください。

参考文献

著書

とあるクリエイター

フロントエンドエンジニア Next.js / React / TypeScript / Node.js / Docker / AI Coding

とあるクリエイターのプロフィール