Clash 자주 묻는 질문 및 문제 해결 가이드
기본 개념, 설치 설정, 사용 팁, 문제 해결 네 가지로 정리한 Clash 사용 중 고빈도 질문과 바로 따라 할 수 있는 해결 단계입니다. 구독 만료, 노드 타임아웃, TUN 권한, 시스템 프록시 미적용, UWP 루프백 등의 상황을 모두 다룹니다. 이 문서로 해결되지 않으면 사용 문서와 고급 사용법을 참고하세요.
기본 개념
Clash Verge, mihomo 코어, 다양한 프록시 방식의 관계를 먼저 이해한 뒤 설정을 시작하면 헛수고를 줄일 수 있습니다.
Clash Verge와 Clash for Windows, ClashX는 어떤 관계인가요?
Clash Verge는 mihomo 코어 기반으로 Windows, macOS, Linux를 지원하며 계속 업데이트되는 그래픽 클라이언트입니다. Clash for Windows는 2023년에 유지보수가 중단되었고, ClashX의 Meta 브랜치도 보관 처리되었습니다. 세 클라이언트의 설정 형식과 구독 형식은 호환되므로, 기존 클라이언트에서 마이그레이션할 때 구독 링크와 기존 config.yaml을 Clash Verge로 가져오기만 하면 됩니다. 학습 비용이 매우 낮습니다.
mihomo 코어와 원본 Clash 코어는 어떤 차이가 있나요?
mihomo는 Clash 코어의 커뮤니티 후속 버전으로, 초기에는 Clash Meta로 불렸습니다. 원본 설정 형식을 유지하면서 규칙 집합, Fake-IP 강화, 도메인 스니핑, TCP 동시 연결 등의 기능이 추가되었습니다. Clash Verge에는 기본적으로 mihomo 코어가 내장되어 있으며, 기존 설정 파일의 필드는 대부분 하위 호환되므로 수정 없이 실행할 수 있습니다.
시스템 프록시, TUN 모드, 수동 프록시 설정은 어떤 차이가 있나요?
시스템 프록시는 운영체제 네트워크 설정에 프록시 주소를 기록하여 브라우저와 대부분의 데스크톱 프로그램이 자동으로 읽어 적용합니다. TUN 모드는 시스템에 가상 네트워크 어댑터를 생성해 UDP와 명령줄 도구를 포함한 모든 IP 트래픽을 가로채며, 앱이 프록시를 자체 지원할 필요가 없습니다. 수동 프록시 설정은 개별 앱에서 127.0.0.1:7890을 입력하는 방식으로 해당 앱에만 적용됩니다. 일상적인 브라우징은 시스템 프록시, 게임과 명령줄 환경은 TUN 모드를 사용하세요.
Clash Verge를 사용하려면 노드를 직접 준비해야 하나요?
네, 필요합니다. Clash는 클라이언트 소프트웨어로 자체적으로 노드나 트래픽을 제공하지 않습니다. 노드는 구독하는 프록시 서비스나 직접 구축한 서버에서 오며, 서비스 제공자가 제공한 구독 링크를 클라이언트로 가져오면 사용할 수 있습니다. 구독 링크는 보통 https://로 시작하며, 제공자가 Clash 전용 링크도 함께 제공한다면 해당 형식을 우선 사용하세요.
Clash Verge는 유료인가요?
아니요, 무료입니다. Clash Verge는 오픈소스 프로젝트로 코드가 GPL-3.0 라이선스로 공개되어 있으며 클라이언트 자체는 영구 무료입니다. 비용이 드는 것은 노드 트래픽뿐이며, 요금은 선택한 프록시 서비스나 서버 제공자가 부과하고 클라이언트 자체와는 무관합니다.
설치 설정
Windows와 macOS 설치, 구독 가져오기, 시스템 프록시 및 TUN 활성화 과정에서 자주 발생하는 문제를 다룹니다.
Windows 설치 시 WebView2 런타임이 없다고 나오면 어떻게 하나요?
Clash Verge의 Windows 버전은 WebView2 런타임을 사용해 인터페이스를 렌더링합니다. 시스템에 미리 설치되어 있지 않으면 설치 프로그램이 온라인 다운로드를 시도하지만, 네트워크가 제한된 환경에서는 실패할 수 있습니다. 해결 방법: Microsoft 공식 사이트에서 WebView2 Evergreen 독립 설치 패키지를 내려받아 설치한 후 Clash Verge 설치 프로그램을 다시 실행하고 클라이언트를 시작하세요.
설치 시 '서비스 설치 실패' 또는 관리자 권한 요구가 나오면 어떻게 하나요?
설치 프로그램이 시스템 서비스를 기록하려면 관리자 권한이 필요하므로 UAC 프롬프트가 표시되면 '예'를 선택하세요. 서비스 설치가 실패하는 흔한 원인은 보안 소프트웨어의 차단이나 이전 버전 잔재입니다. 먼저 백신과 보안 프로그램을 종료한 뒤 관리자 권한으로 설치 프로그램을 다시 실행하세요. 이전 버전을 설치한 적이 있다면 제거 후 설치 디렉터리를 정리하고 다시 설치하세요.
구독 링크 가져오기에서 오류가 나면 어떻게 확인하나요?
세 단계로 확인하세요. 첫째, 링크가 끝까지 복사되었는지 확인합니다. 채팅 도구는 긴 링크를 자주 잘라내기 때문입니다. 둘째, 브라우저로 링크를 직접 열어 정상적으로 YAML 텍스트가 표시되는지 확인합니다. 오류 페이지나 빈 내용이 반환되면 구독 주소 자체에 문제가 있는 것이므로 서비스 제공자 백엔드에서 다시 복사하세요. 셋째, 링크가 만료되지 않았는지 확인합니다. 브라우저에서는 열리지만 클라이언트에서 구문 분석 실패가 나면 아래 '문제 해결' 섹션의 구독 구문 분석 실패 항목을 참고하세요.
Windows에서 시스템 프록시를 어떻게 켜나요?
클라이언트의 '설정' 페이지에서 '시스템 프록시' 스위치를 켜면 됩니다. 기본 프록시 주소는 127.0.0.1:7890입니다. 켠 뒤에는 브라우저를 따로 설정할 필요가 없습니다. 그래도 브라우저에서 접속이 안 된다면 다른 프록시 소프트웨어가 7890 포트를 점유하고 있는지, 또는 브라우저에 설치된 프록시 플러그인이 시스템 프록시와 충돌하는지 확인하고 플러그인을 '시스템 프록시 사용'으로 전환하세요.
macOS에서 TUN 모드를 켜려면 어떤 권한이 필요한가요?
TUN 모드를 처음 켜면 macOS가 네트워크 확장 권한 프롬프트를 표시합니다. '시스템 설정 → 개인정보 보호 및 보안'에서 Clash Verge가 네트워크 확장을 설치하도록 허용해야 합니다. 동시에 손쉬운 사용 권한이 요청되면 함께 허용하세요. 앱 실행 시 '손상되어 열 수 없음' 메시지가 나오면 Gatekeeper 격리 때문이므로 '개인정보 보호 및 보안' 페이지에서 '그래도 열기'를 클릭하거나, 내려받은 .app에 xattr -d com.apple.quarantine 명령을 실행한 뒤 다시 시도하세요.
사용 팁
명령줄 프록시, UWP 루프백, UDP 트래픽, 규칙 분기는 기본 설정에서 한 단계가 더 필요합니다.
구독을 업데이트했는데 노드 목록이 변하지 않았어요.
구독 업데이트는 설정 파일을 다시 가져올 뿐이며, 현재 선택된 노드가 자동으로 전환되지는 않습니다. 먼저 노드를 하나 다시 선택한 뒤 지연 시간을 측정해 사용 가능한지 확인하세요. 목록이 실제로 갱신되지 않았다면 서비스 제공자가 캐시된 내용을 반환했거나 구독 링크가 이전 설정 파일을 가리키는 것일 수 있으므로, 해당 구독을 삭제하고 다시 가져오세요.
터미널, git, curl 같은 명령줄 도구가 프록시를 사용하게 하려면 어떻게 하나요?
가장 간단한 방법은 TUN 모드를 켜는 것입니다. 명령줄 트래픽이 자동으로 가상 네트워크 어댑터를 통과합니다. 터미널에서 환경 변수를 설정할 수도 있습니다:export http_proxy=http://127.0.0.1:7890 와 export https_proxy=http://127.0.0.1:7890. 포트는 클라이언트의 실제 설정에 맞게 조정하세요. git은 별도로 git config --global http.proxy http://127.0.0.1:7890 을 실행해 설정할 수 있습니다.
Microsoft Store 앱(UWP)이 프록시를 사용하지 않으면 어떻게 하나요?
UWP 앱은 기본적으로 로컬 루프백 주소 접근이 금지되어 시스템 프록시가 적용되지 않습니다. TUN 모드를 켜면 모든 UWP 트래픽을 한 번에 처리할 수 있습니다. 또는 관리자 권한으로 CheckNetIsolation LoopbackExempt -a -n=패키지명 을 실행해 지정한 앱의 루프백 제한을 해제할 수 있으며, 패키지명은 PowerShell에서 Get-AppxPackage 로 조회할 수 있습니다. 일상적인 사용에서는 TUN 모드를 바로 사용하는 것이 좋습니다.
게임, 음성 통화 같은 UDP 트래픽이 프록시를 사용하지 않나요?
시스템 프록시는 TCP만 처리하므로 게임과 일부 음성 앱이 의존하는 UDP는 TUN 모드를 켜야 합니다. TUN은 가상 네트워크 어댑터 계층에서 모든 IP 트래픽을 가로채므로 UDP도 전달됩니다. 켠 뒤에도 게임이 연결되지 않으면 노드 프로토콜에서 UDP 지원이 활성화되었는지 확인하세요. 일부 서비스의 Shadowsocks, VMess 노드는 기본적으로 UDP가 꺼져 있으므로 서비스 제공자에게 확인해야 합니다.
국내 직결, 해외 프록시 분기를 어떻게 구현하나요?
Clash 기본 규칙에는 보통 GEOIP 분기가 포함되어 중국 본토 IP는 직결, 나머지는 프록시로 처리됩니다. 구독에 내장 규칙이 없다면 '규칙' 페이지에서 규칙 집합을 추가하거나, 구독 변환 서비스로 규칙 집합이 포함된 구독을 먼저 생성하세요. 자주 쓰는 규칙 작성법: DOMAIN-SUFFIX,github.com,PROXY 는 GitHub가 프록시를 사용하고, GEOIP,CN,DIRECT 는 중국 본토 IP가 직결된다는 뜻입니다.
문제 해결
증상별로 원인을 찾아보세요. 각 항목에 실행 가능한 확인 순서가 포함되어 있으니 먼저 클라이언트 로그를 확인한 뒤 진행하는 것이 좋습니다.
노드가 전부 타임아웃되거나 연결에 실패하면 어떻게 확인하나요?
순서대로 확인하세요. ① 시스템 시간이 정확한지 확인합니다. 시간 오차가 크면 TLS 핸드셰이크가 실패할 수 있습니다. ② 구독을 업데이트해 노드가 만료되지 않았는지 확인합니다. ③ 클라이언트에서 노드 지연 시간을 측정해 개별 노드 장애를 배제합니다. ④ 다른 프록시 소프트웨어를 종료해 포트 충돌을 피합니다. ⑤ 프로토콜을 변경합니다. 일부 프로토콜은 통신사가 차단하므로 변경하면 복구될 수 있습니다. ⑥ 컴퓨터 자체가 네트워크에 정상적으로 접속되는지 확인합니다.
시스템 프록시를 켰는데 브라우저에서 여전히 접속이 안 돼요.
흔한 원인을 가능성 순으로 정리하면 다음과 같습니다. ① 프록시 포트가 점유되어 클라이언트 로그에 listen 실패가 표시되면 설정에서 포트를 변경하세요. ② 브라우저 프록시 플러그인이 시스템 프록시와 충돌하므로 플러그인을 '시스템 프록시 사용'으로 전환하거나 일시적으로 비활성화하세요. ③ 시스템 프록시가 다른 소프트웨어에 의해 원래대로 되돌려졌다면 스위치를 다시 켜세요. ④ 방화벽이 클라이언트의 인바운드 연결을 차단하고 있다면 방화벽 설정에서 프로그램을 허용하세요.
TUN 모드 켜기가 실패하거나 권한 부족이 표시되면 어떻게 하나요?
Windows: 클라이언트를 관리자 권한으로 실행하고 서비스 모드가 설치되었는지 확인한 뒤 백신 소프트웨어에서 관련 프로세스를 허용하세요. macOS: '개인정보 보호 및 보안'에서 네트워크 확장과 손쉬운 사용 권한을 확인하고, 허용한 뒤 클라이언트를 재시작하세요. Linux: 현재 사용자가 권한 그룹에 포함되어 있는지 확인하거나 systemd 서비스 방식으로 실행하세요. 그래도 실패하면 클라이언트 로그를 열어 구체적인 오류 메시지로 원인을 파악하세요.
구독에서 '구문 분석 실패' 또는 '형식 불일치'가 표시되면 어떻게 하나요?
네 가지 원인을 하나씩 확인하세요. ① 링크에 접근할 수 없는 경우 브라우저로 링크를 열어 반환 내용을 확인합니다. ② 반환 내용이 YAML이 아닌 경우 일부 서비스 제공자는 기본적으로 base64 인코딩을 출력하므로 먼저 구독 변환 서비스로 Clash 형식으로 변환하세요. ③ YAML 구문 오류인 경우 내용을 .yaml 파일로 저장해 편집기에서 들여쓰기를 확인합니다. ④ 필드가 호환되지 않는 경우 이전 구독이 폐기된 필드를 사용하는 것이므로 서비스 제공자에게 mihomo/Clash Meta 형식 구독을 요청하세요.
일부 사이트는 접속되는데 일부 사이트가 열리지 않아요.
먼저 DNS 설정을 확인하세요. Fake-IP 모드를 사용할 때 dns 섹션의 nameserver와 fallback이 올바르게 입력되었는지 확인합니다. 클라이언트 로그를 열어 대상 도메인이 어떤 규칙에 매칭되었는지 보고, 잘못 DIRECT로 분기되었다면 규칙 페이지에서 해당 도메인을 프록시 정책 그룹에 추가하세요. 열리지 않는 사이트가 QUIC을 사용한다면 브라우저에서 QUIC을 끄거나 TUN 모드를 바로 켜 보세요.
클라이언트 시작 후 CPU 점유율이 높거나 메모리가 계속 증가하면 어떻게 하나요?
구독 노드 수가 너무 많거나, 규칙 집합을 과도하게 활성화했거나, 로그 레벨이 debug로 설정된 경우가 흔합니다. 로그 레벨을 info로 되돌리고 더 이상 사용하지 않는 규칙 집합과 오래된 구독을 정리하며, GEO 데이터 자동 업데이트 빈도를 적절히 낮추세요. '구독 자동 업데이트' 간격이 너무 짧아도 주기적인 점유율이 발생하므로 간격을 6시간 이상으로 조정하세요.