---
title: "Mac의 “curl: (7) Failed to connect” · Kilobat 가이드"
url: "https://kilobat.app/ko/guides/curl-7-failed-to-connect"
description: "Mac의 curl이 (7) Failed to connect로 멈춥니다. 포트, 서비스, 방화벽, 프록시, 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/ko/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`(으)로 실행합니다. [특정 사이트나 API에 연결되지 않는 이유 찾기](https://kilobat.app/ko/guides/recipes/why-cant-it-connect)를 참조하세요.

## 질문

**종료 코드 7은 호스트가 꺼져 있다는 뜻인가요?**

항상 그렇지는 않습니다. curl이 호스트 또는 프록시에 연결하지 못했다는 뜻입니다. `curl -v`로 어느 쪽인지 알아보세요.

**(6)과 무엇이 다른가요?**

종료 코드 6은 호스트 이름이 확인되지 않았다는 뜻이고, 코드 7은 연결에 실패했다는 뜻입니다. [Mac의 “curl: (6) Could not resolve host”](https://kilobat.app/ko/guides/curl-could-not-resolve-host)를 참고하세요.

## 출처

- [curl: libcurl 오류 코드](https://curl.se/libcurl/c/libcurl-errors.html)

2026년 10월 29일 확인했습니다.

## 관련 가이드

- [Mac에서 “curl: (6) Could not resolve host”](https://kilobat.app/ko/guides/curl-could-not-resolve-host): curl 종료 코드 6은 curl이 호스트 이름의 주소를 가져오지 못했다는 뜻입니다.
- [Mac의 Chrome에서 ERR_CONNECTION_REFUSED](https://kilobat.app/ko/guides/err-connection-refused): Chrome의 네트워크 오류 ERR_CONNECTION_REFUSED입니다.
- [Mac에서 Homebrew가 “curl: (28)” 오류로 실패합니다](https://kilobat.app/ko/guides/homebrew-curl-28-timed-out): Homebrew는 curl을 사용하여 다운로드합니다.
- [프록시 설정으로 인해 Mac에서 앱이 연결되지 않습니다](https://kilobat.app/ko/guides/proxy-settings-breaking-apps): 프록시 설정은 다른 서버를 통해 트래픽을 전송합니다.
