Macの“curl: (7) Failed to connect”

curlの終了コード7は、ある手順の失敗を示します。curlのドキュメントには、“Failed to connect() to host or proxy.”と書かれています。

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

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

対象:現在のすべてのmacOSバージョンの、macOS付属のcurlとHomebrewのcurl。確認日:2026年10月29日

症状

  • ターミナルにcurl: (7) Failed to connect to host port 443と表示される。
  • テキストには、“Couldn't connect to server”や“Connection refused”が付くことがよくあります。
  • スクリプトやインストーラが、終了コード7で止まります。

考えられる原因

  • ポートで待ち受けているものがない。サービスが停止しているか、別のポートを使っています。
  • ファイアウォールまたはプロキシ。ファイアウォールが接続を拒否することがあります。プロキシが設定されていて到達できない場合も、curlは失敗します。
  • アドレスの誤り。URLのホストまたはポートが違います。スクリプトの変数が空になっていることもあります。
  • IPv6またはVPNの経路。curlが、ネットワークから到達できないアドレスを試している場合があります。

確認方法

  1. URLをそのまま出力し、ホストとポートを確認します。

  2. curlを詳細表示で実行します。最初の数行に、失敗したアドレスが表示されます。

    curl -v https://example.com
  3. ポートをテストします。

    nc -vz example.com 443
  4. プロキシ環境変数を表示します。

    env | grep -i proxy

解決方法

  1. 自分のサービスなら起動します。表示されたポートを使います。

  2. IPv6の不具合を調べるため、IPv4を強制します。

    curl -4 -v https://example.com
  3. 誤ったプロキシの設定を解除します。

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

Kilobatを使う場合

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

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

よくある質問

終了コード7は、ホストが停止しているという意味ですか?

常にそうとは限りません。curlはホストまたはプロキシに接続できませんでした。どちらかをcurl -vで調べます。

(6)との違いは何ですか?

終了コード6は、ホスト名が名前解決されなかったという意味です。コード7は、接続に失敗したという意味です。Macの“curl: (6) Could not resolve host”をご覧ください。

出典

2026年10月29日に確認。