MacのClaude Codeでの“Unable to connect to API”
Claude Codeは、リクエストがapi.anthropic.comに届かないと、Unable to connect to APIと表示します。Claude Codeのドキュメントでは、インターネットに接続できないこと、ホストをブロックするVPN、未設定の社内プロキシがよくある原因として挙げられています。
私の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が
Unable to connect to API. Check your internet connectionと表示します。 - メッセージの末尾に、ENOTFOUND、EHOSTUNREACH、ECONNRESETなどのコードが付くことがあります。
- リクエストは失敗しますが、ほかのアプリは動くことがあります。
考えられる原因
- インターネットに接続できない。Macがオフラインか、DNSがありません。
- APIホストをブロックするVPN。Claude Codeのドキュメントは、これをよくある原因として挙げています。
- プロキシが未設定。社内プロキシが必要な場合は、起動前に
HTTPS_PROXYを設定します。 - トンネルを拒否するプロキシ。ERR_PROXY_TUNNELは、プロキシがトンネルを拒否したことを意味します。プロキシの認証情報と、このホストが許可されているかを確認します。
確認方法
同じシェルからAPIホストをテストします。
curl -I https://api.anthropic.comプロキシ環境変数を表示します。
env | grep -i proxyClaude Code内でチェックを実行します。
/doctormacOS経由でホスト名をテストします。
dscacheutil -q host -a name api.anthropic.com
解決方法
DNSが失敗する場合は修正します。MacでDNSが名前解決されないをご覧ください。
社内プロキシの内側にいる場合は、起動前に設定します。
export HTTPS_PROXY=http://proxy.example.com:8080ゲートウェイを使っている場合は、
ANTHROPIC_BASE_URLにそのアドレスを設定します。短いテストのため、VPNをオフにします。終わったらオンに戻します。
Kilobatを使う場合
Kilobatの接続ドクターは、APIホストを層ごとにテストします。ネットワーク、プロキシ、DNS、ルール、IPv4、IPv6、TLS、サーバの順です。
kilobat why https://api.anthropic.comこれらのKilobatのチェックは無料です。AIエージェントはMCPを通じて
diagnose_connectionとdiagnose_networkで実行します。1つのサイトやAPIに接続できない原因を見つけるを参照してください。
よくある質問
かっこ内のコードは重要ですか?
はい。ENOTFOUNDはDNS、EHOSTUNREACHは経路、ECONNRESETはリセット、ERR_PROXY_TUNNELはプロキシを指しています。
変数を設定したら、Claude Codeを再起動しますか?
はい。ネットワーク設定のページには、実行中のセッションは、あとからのシェルの変更を反映しないと書かれています。
出典
2026年10月29日に確認。