---
title: "Macの“curl: (7) Failed to connect” · Kilobatガイド"
url: "https://kilobat.app/ja/guides/curl-7-failed-to-connect"
description: "MacのcurlがFailed to connect (7)で止まります。ポート、サービス、ファイアウォール、プロキシ、curlが試したアドレスを確認してください。"
---

# 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に接続できない原因を見つける](https://kilobat.app/ja/guides/recipes/why-cant-it-connect)を参照してください。

## よくある質問

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

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

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

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

## 出典

- [curl：libcurl error codes](https://curl.se/libcurl/c/libcurl-errors.html)

2026年10月29日に確認。

## 関連ガイド

- [Macで「curl: (6) Could not resolve host」と表示される](https://kilobat.app/ja/guides/curl-could-not-resolve-host): curlの終了コード6は、curlがホスト名のアドレスを取得できなかったことを示します。
- [MacのChromeでのERR_CONNECTION_REFUSED](https://kilobat.app/ja/guides/err-connection-refused): ERR_CONNECTION_REFUSEDは、Chromeのネットワークエラーです。
- [MacでHomebrewが「curl: (28)」で失敗する](https://kilobat.app/ja/guides/homebrew-curl-28-timed-out): Homebrewはcurlでダウンロードします。
- [Macでプロキシ設定のせいでアプリが接続できない](https://kilobat.app/ja/guides/proxy-settings-breaking-apps): プロキシ設定は、通信を別のサーバ経由で送ります。
