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에 연결되지 않는 이유 찾기를 참조하세요.

질문

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

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

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

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

출처

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