【解決方法】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 です。
接続先の名前を解決できないときは、Can't reach the API server — check your internet or DNS に変わります。
プロキシの名前を解決できないときは、次の表示です。
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」の節にも、接続できないときの文がまとまっています。
解決方法
関連するエラー
接続まわりでは、ほかにも次の表示が出ます。プロキシや証明書で止まったときは、次のように出ます。
| 表示される文 | 意味 |
|---|---|
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 network | 20秒以上データが届いていない。まだ失敗ではなく、やり直す前の待ち時間 |
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 の障害の見分け方も参考にしてください。
参考文献
著書
挙動Codex 画面を閉じても実は動いてた?常駐プロセスの動きについて検証してみた
挙動Homebrew で入れた Claude Code。更新しているつもりが、古いまま使ってませんか?
使い方Claude Code の拡張機能 2.1.312、2.1.313 は偽物。皆さんの Cursor は大丈夫ですか?
使い方知らぬ間に追加された大量のプラグインやフックが、毎回実行され続けていない? 皆さんの Claude Code は大丈夫ですか?
使い方npm のマルウェアが18日で1,753件! 気づいたら、あなたの GitHub に鍵の一覧が公開されているかも
使い方パスワードが GitHub で丸見えに? 原因は、Claude Code の確認で選んだ「Yes, and don't ask again」
使い方その OpenCode、脆弱性の告知がないからと安心してない? 今のままだと乗っ取られるかも
挙動Codex 画面を閉じても実は動いてた?常駐プロセスの動きについて検証してみた
挙動Homebrew で入れた Claude Code。更新しているつもりが、古いまま使ってませんか?
使い方Claude Code の拡張機能 2.1.312、2.1.313 は偽物。皆さんの Cursor は大丈夫ですか?
使い方知らぬ間に追加された大量のプラグインやフックが、毎回実行され続けていない? 皆さんの Claude Code は大丈夫ですか?
使い方npm のマルウェアが18日で1,753件! 気づいたら、あなたの GitHub に鍵の一覧が公開されているかも



