1. 설치 전: 시스템 요구 사항과 WebView2 런타임
Clash Verge Windows 클라이언트는 WebView2로 설정 화면을 렌더링합니다. WebView2 Runtime이 없으면 앱이 실행되지 않거나 빈 창만 표시되는데, 설치 단계에서 가장 먼저 만나는 문제입니다.
문제 1: WebView2 런타임 누락
증상: 앱 아이콘을 더블클릭해도 창이 비어 있거나, WebView2 Runtime 누락 안내가 뜬 뒤 바로 종료됩니다.
원인: Windows 11과 2022년 이후 업데이트된 Windows 10에는 보통 WebView2가 기본 포함되어 있습니다. 그 이전 버전의 Windows 10은 직접 설치해야 합니다.
해결: Microsoft 공식 사이트에서 WebView2 Runtime x64 오프라인 설치 파일을 내려받아 설치한 뒤 Clash Verge를 다시 실행하세요. 시스템 재부팅은 필요 없습니다.
시스템 요구 사항:
- Windows 10 버전 1809(빌드 17763) 이상 또는 Windows 11
- Intel / AMD 기기는 x64 설치 파일, ARM 기기는 arm64 설치 파일 선택
- 실행 시 메모리를 약 200MB 사용하며, 4GB RAM이면 충분히 쓸 수 있습니다
설치 파일은 반드시 공식 다운로드 페이지에서만 받으세요. 서드파티 다운로드 사이트의 파일은 버전이 낮고 출처가 불분명하므로 사용하지 마세요.
2. Clash Verge 설치: 경로, 권한, 서비스 모드
설치 방법:
- 설치 파일을 실행하고 설치 폴더를 선택한 뒤 '바탕 화면 바로 가기 만들기'를 체크합니다
- 설치를 클릭하고 진행 표시줄이 끝날 때까지 기다립니다
- 첫 실행 후 '설정' → '서비스 모드'로 이동해 '설치'를 클릭합니다
문제 2: 설치 경로에 한글이나 공백이 포함된 경우
증상: 서비스 모드 설치가 실패하거나 TUN 모드를 켜도 가상 네트워크 어댑터가 생성되지 않습니다.
원인: Windows 서비스 등록과 가상 네트워크 어댑터 드라이버는 비ASCII 경로를 제대로 지원하지 않습니다.
해결: 기본 경로 C:\Program Files\Clash Verge를 사용하거나, 영문과 공백 없이 구성된 경로로 지정하세요. 이미 한글 경로에 설치했다면 삭제 후 다시 설치해야 합니다.
문제 3: 서비스 모드 설치 실패
증상: '서비스 모드 설치'를 클릭하면 '권한 부족' 또는 '설치 실패' 오류가 표시됩니다.
원인: 현재 계정이 관리자가 아니거나, 보안 소프트웨어가 서비스 등록을 차단하고 있습니다.
해결: Clash Verge 아이콘을 마우스 오른쪽 버튼으로 클릭해 '관리자 권한으로 실행'을 선택한 뒤 '설정' → '서비스 모드'에서 다시 시도하세요. 계속 실패하면 보안 소프트웨어의 시스템 보호를 잠시 끈 다음 설치를 완료하고 다시 켜세요.
서비스 모드는 mihomo 코어를 Windows 서비스로 실행하게 합니다. TUN 모드는 서비스 모드에 의존하며, 켜두면 실행할 때마다 UAC 권한 창이 뜨지 않으니 이 단계를 건너뛰지 마세요.
3. 구독 가져오기: 링크 형식과 파싱 실패 해결
'구독' 페이지에서 '새로 만들기'를 클릭하고 구독 이름을 입력한 뒤 구독 링크를 붙여넣고 '확인'을 누르세요. 클라이언트가 링크 내용을 가져와 노드 목록으로 변환합니다.
문제 4: 구독 파싱 실패
증상: 가져온 뒤 '파싱 실패', '구독이 비어 있음' 오류가 뜨거나 노드 수가 0으로 표시됩니다.
다음 순서로 확인하세요:
- 링크가 만료되지 않았는지: 브라우저로 구독 링크를 직접 열어보세요. 401, 403 또는 '만료됨' 안내가 나오면 공급자 사이트에서 링크를 다시 생성합니다
- 반환 내용이 YAML인지: 브라우저에서 열었을 때
proxies:로 시작하는 텍스트가 보여야 합니다. JSON이나 sing-box 형식이 반환되면 공급자 사이트에서 Clash Meta 구독 형식으로 전환한 뒤 다시 가져오세요 - 구독 도메인에 접속할 수 있는지: 일부 네트워크 환경에서는 구독 서버에 직접 연결할 수 없습니다. 먼저 시스템 프록시를 켠 다음 구독 카드의 '업데이트'를 눌러 다시 시도하세요
구독 링크는 보통 다음과 같은 형식입니다:
https://example.com/api/v1/client/subscribe?token=xxxxxxxx구독 링크는 가져오기와 수동 업데이트 시에만 호출됩니다. 공급자 사이트에서 요금제를 변경하거나 링크를 재설정한 뒤에는 구독 카드의 '업데이트'를 눌러 다시 받아야 노드 목록이 갱신됩니다.
가져오기가 끝나면 '프록시' 페이지에서 노드나 전략 그룹을 선택하세요. Clash Verge는 mihomo 코어를 사용하므로 proxy-providers, rule-providers 같은 Clash Meta 확장 필드도 정상적으로 파싱됩니다.
4. 시스템 프록시 켜기: 포트 충돌과 브라우저 확장 프로그램
Clash Verge의 기본 혼합 포트는 7897이며 HTTP와 SOCKS5 프록시를 동시에 제공합니다. 켜는 방법은 '설정' → '시스템 프록시'에서 스위치를 켜면 됩니다. 시스템 프록시는 Windows '인터넷 옵션'에 기록되므로, 시스템 프록시를 읽는 앱은 모두 프록시를 사용합니다.
문제 5: 시스템 프록시를 켰는데 브라우저가 여전히 직접 연결됨
원인 1: 브라우저에 SwitchyOmega 같은 프록시 확장 프로그램이 설치되어 있어 확장 프로그램이 프록시 설정을 가로채고 시스템 프록시를 무시합니다.
원인 2: 7897 포트를 다른 프로그램이 점유하고 있어 mihomo 코어가 시작되지 않았습니다.
해결 방법:
- 브라우저 프록시 확장 프로그램을 끄거나 삭제해 브라우저가 시스템 프록시를 따르게 합니다
- 명령 프롬프트에서 포트 점유 확인:
netstat -ano | findstr 7897 - 출력 결과가 비어 있지 않고 해당 프로세스가 Clash Verge가 아니라면 '설정' → '포트'에서 혼합 포트를 변경한 뒤 앱을 다시 시작하세요
- 브라우저를 재시작한 뒤 ip.sb에 접속해 출발지 IP를 확인합니다
시스템 프록시 스위치를 켠 뒤 브라우저에서 웹페이지가 열리지 않으면, 스위치를 끄고 위 두 단계를 차례로 확인하세요. 스위치를 계속 켜고 끄지 마세요.
5. TUN 모드로 전환: 가상 네트워크 어댑터와 DNS 덮어쓰기
TUN 모드는 가상 네트워크 어댑터를 통해 시스템의 모든 IP 트래픽을 가로채므로 앱이 프록시 설정을 직접 읽을 필요가 없습니다. 명령줄 도구, 게임, UDP 앱은 시스템 프록시 모드에서 자주 누락되는데, TUN 모드로 전환하면 모두 가로채집니다.
전제 조건: 서비스 모드가 설치되어 있어야 합니다. 켜는 방법은 '설정' → 'TUN 모드'에서 스위치를 켜면 됩니다. 처음 켤 때 Windows에 가상 네트워크 어댑터 설치 안내가 뜨면 '허용'을 클릭하세요.
문제 6: TUN 모드를 켜자마자 꺼지는 경우
원인 1: 서비스 모드가 설치되지 않았거나 설치에 실패했습니다.
원인 2: 가상 네트워크 어댑터 드라이버를 보안 소프트웨어가 격리했습니다.
해결 방법:
- '설정' → '서비스 모드'에 '설치됨'으로 표시되는지 확인합니다
- '장치 관리자' → '네트워크 어댑터'를 열어 Clash Verge 가상 네트워크 어댑터가 있는지 확인합니다
- 보안 소프트웨어의 격리 영역에서 차단된 드라이버 파일을 복원한 뒤 Clash Verge를 다시 시작합니다
TUN 모드를 켠 뒤에도 시스템 프록시 스위치는 켜두거나 꺼두어도 됩니다. 둘 다 켜져 있으면 브라우저는 시스템 프록시를, 나머지 트래픽은 가상 네트워크 어댑터를 사용하므로 충돌하지 않습니다.
TUN 모드에서는 DNS 덮어쓰기도 함께 켜는 것이 좋습니다: '설정' → 'DNS 덮어쓰기' → Fake-IP 켜기. mihomo가 DNS 해석을 담당해 일부 앱의 DNS 요청이 프록시를 우회하는 것으로 인한 누출을 막아줍니다. mihomo의 기본 Fake-IP 대역은 198.18.0.1/16이므로 직접 수정할 필요가 없습니다.
6. 서비스 모드, 자동 시작, 방화벽
서비스 모드 설치가 끝나면 Clash Verge가 시스템 서비스로 실행되므로, 사용자가 로그인하지 않아도 자동으로 시작됩니다.
자동 시작: '설정' → '자동 시작'에서 스위치를 켜세요. 부팅 후 프록시가 적용되지 않으면 작업 관리자의 '시작' 탭에서 Clash Verge가 비활성화되어 있지 않은지 확인하세요.
문제 7: 방화벽 차단
증상: TUN 모드를 켠 뒤 일부 앱이 네트워크에 연결되지 않거나, Windows 보안 센터에 '액세스 허용' 안내가 표시됩니다.
해결 방법:
- 팝업이 뜨면 '개인 네트워크'와 '공용 네트워크'를 모두 체크한 뒤 '액세스 허용'을 클릭하세요
- 실수로 '취소'를 눌렀다면 'Windows 보안 센터' → '방화벽 및 네트워크 보호' → '방화벽을 통해 앱 허용'으로 이동해 Clash Verge를 직접 추가하세요
- 목록에 없으면 '다른 앱 허용'을 클릭해 설치 폴더의 Clash Verge 실행 파일을 찾아 선택하세요
7. 7가지 문제 빠른 정리표
| 문제 | 증상 | 해결 방법 |
|---|---|---|
| 1 WebView2 누락 | 창이 비어 있음, 실행 직후 종료 | WebView2 Runtime 설치 |
| 2 경로에 한글 포함 | 서비스 모드 또는 TUN 설치 실패 | 영문 경로로 다시 설치 |
| 3 서비스 모드 실패 | 권한 부족 오류 표시 | 관리자 권한으로 실행 후 재시도 |
| 4 구독 파싱 실패 | 가져온 뒤 노드 0개 | 링크 유효 기간과 구독 형식 확인 |
| 5 시스템 프록시 미적용 | 브라우저가 여전히 직접 연결 | 프록시 확장 프로그램 끄기, 7897 포트 확인 |
| 6 TUN 켜자마자 꺼짐 | 스위치가 자동으로 되돌아감 | 서비스 모드 먼저 설치, 가상 어댑터 확인 |
| 7 방화벽 차단 | 일부 앱이 연결 안 됨 | 개인·공용 네트워크 허용 |
8. 설정 완료 후 확인 목록
- 시스템 프록시 적용: ip.sb에 접속해 출발지 IP가 노드 지역과 일치하는지 확인
- TUN 적용: 명령 프롬프트에서
curl -I https://www.google.com실행, HTTP/2 200이 반환되면 정상 - 구독 업데이트: 구독 카드에서 '업데이트'를 눌렀을 때 오류가 없어야 함
- 자동 시작: PC를 재부팅한 뒤 앱을 직접 실행하지 않아도 인터넷이 정상적으로 연결되어야 함
7가지 문제를 하나씩 확인했다면 Windows 설정은 끝난 것입니다. 이후 전략 그룹 선택이나 규칙 매칭 문제가 생기면 사용 문서를 계속 참고하세요.