MacのClaude Codeでの“Unable to connect to API”

Claude Codeは、リクエストがapi.anthropic.comに届かないと、Unable to connect to APIと表示します。Claude Codeのドキュメントでは、インターネットに接続できないこと、ホストをブロックするVPN、未設定の社内プロキシがよくある原因として挙げられています。

エージェントで解決するClaude Code、Codex、またはターミナルを使えるエージェント向けのプロンプトをコピーします。

私のMacでこの問題が起きています:MacのClaude Codeでの“Unable to connect to API”。https://kilobat.app/ja/guides/claude-code-unable-to-connect-to-api.mdを読んで、一緒に進めてください。Kilobat CLIがなければインストールしてください:brew install seifip/kilobat/kilobat。ガイドにあるターミナルとkilobatのチェックはあなた自身で実行し、わかったことを教えてください。私にしかできない手順は一覧にしてください。設定を変更する前に必ず確認してください。

対象:ターミナルで動くClaude Code、現在のすべてのmacOS。確認日:2026年10月29日

症状

  • Claude CodeがUnable to connect to API. Check your internet connectionと表示します。
  • メッセージの末尾に、ENOTFOUND、EHOSTUNREACH、ECONNRESETなどのコードが付くことがあります。
  • リクエストは失敗しますが、ほかのアプリは動くことがあります。

考えられる原因

  • インターネットに接続できない。Macがオフラインか、DNSがありません。
  • APIホストをブロックするVPN。Claude Codeのドキュメントは、これをよくある原因として挙げています。
  • プロキシが未設定。社内プロキシが必要な場合は、起動前にHTTPS_PROXYを設定します。
  • トンネルを拒否するプロキシ。ERR_PROXY_TUNNELは、プロキシがトンネルを拒否したことを意味します。プロキシの認証情報と、このホストが許可されているかを確認します。

確認方法

  1. 同じシェルからAPIホストをテストします。

    curl -I https://api.anthropic.com
  2. プロキシ環境変数を表示します。

    env | grep -i proxy
  3. Claude Code内でチェックを実行します。

    /doctor
  4. macOS経由でホスト名をテストします。

    dscacheutil -q host -a name api.anthropic.com

解決方法

  1. DNSが失敗する場合は修正します。MacでDNSが名前解決されないをご覧ください。

  2. 社内プロキシの内側にいる場合は、起動前に設定します。

    export HTTPS_PROXY=http://proxy.example.com:8080
  3. ゲートウェイを使っている場合は、ANTHROPIC_BASE_URLにそのアドレスを設定します。

  4. 短いテストのため、VPNをオフにします。終わったらオンに戻します。

Kilobatを使う場合

  1. Kilobatの接続ドクターは、APIホストを層ごとにテストします。ネットワーク、プロキシ、DNS、ルール、IPv4、IPv6、TLS、サーバの順です。

    kilobat why https://api.anthropic.com
  2. これらのKilobatのチェックは無料です。AIエージェントはMCPを通じてdiagnose_connectionとdiagnose_networkで実行します。1つのサイトやAPIに接続できない原因を見つけるを参照してください。

よくある質問

かっこ内のコードは重要ですか?

はい。ENOTFOUNDはDNS、EHOSTUNREACHは経路、ECONNRESETはリセット、ERR_PROXY_TUNNELはプロキシを指しています。

変数を設定したら、Claude Codeを再起動しますか?

はい。ネットワーク設定のページには、実行中のセッションは、あとからのシェルの変更を反映しないと書かれています。

出典

2026年10月29日に確認。