시작 전 확인
클라이언트와 구독 주소 준비
시작하기 전에 기기에 사용 가능한 Clash GUI 클라이언트가 설치되어 있고, 서비스 제공업체로부터 구독 주소를 받은 상태인지 확인하세요. 클라이언트는 설정을 읽고 트래픽을 전달하며, 구독 주소는 노드·프록시 그룹·규칙·DNS 등의 설정을 가져오는 데 사용됩니다. 둘은 서로 다른 것입니다. 클라이언트만 설치하고 설정을 가져오지 않으면 프록시 화면이 비어 있고 연결할 노드도 자동으로 생성되지 않습니다.
구독 주소는 대개 HTTPS로 시작하는 링크입니다. 복사할 때는 서비스 제공업체의 관리 페이지에서 전체 복사 기능을 사용해 끝부분이 누락되지 않도록 하세요. 구독 주소에는 계정을 식별할 수 있는 접근 정보가 포함될 수 있으므로 포럼, 스크린샷 또는 공유 문서에 공개해서는 안 됩니다. 서비스 제공업체가 일반 구독, Clash 구독, 단일 노드 링크를 함께 제공한다면 Clash 또는 Clash 호환 설정이라고 명확히 표시된 구독을 우선 선택하세요.
처음 설정할 때는 네트워크를 가로채고 있는 다른 프록시, VPN, 가속기 또는 이전 버전 Clash 클라이언트를 잠시 종료하세요. 여러 시스템 프록시, VPN 설정 또는 가상 네트워크 어댑터가 동시에 작동하면 트래픽이 중복으로 처리될 수 있습니다. 그 결과 클라이언트에는 연결됨으로 표시되지만 웹페이지가 시간 초과되거나 일부 앱의 네트워크가 끊기고 외부 IP가 바뀌지 않을 수 있습니다. 충돌하는 프로그램을 종료한 뒤 시작하면 이후 문제 해결이 훨씬 수월합니다.
- 정상적으로 실행 중인 Clash 클라이언트 1개;
- 완전하며 현재도 접속 가능한 Clash 구독 주소 1개;
- 시스템에서 다른 프록시 또는 VPN 도구가 연결을 사용하고 있지 않은 상태.
설정 로드
구독 가져오기
클라이언트를 연 뒤 구독, 설정, Profiles 또는 설정 파일이라는 이름의 페이지를 찾으세요. 데스크톱 클라이언트는 보통 왼쪽 탐색 메뉴에 있으며, 모바일 클라이언트는 홈 화면의 설정 영역이나 오른쪽 상단 메뉴에 있을 수 있습니다. 페이지에서 새로 추가, 구독 추가 또는 URL에서 가져오기를 선택하고 주소 입력란에 전체 구독 링크를 붙여 넣으세요. 이름에는 서비스 제공업체명이나 일상 설정 같은 용도를 입력하면 여러 설정을 관리할 때 편리합니다.
저장한 뒤 다운로드, 업데이트 또는 동기화를 실행하세요. 클라이언트가 구독 내용을 요청하고 설정 파일을 분석하면 새 설정 항목이 나타납니다. 항목이 존재하는지만 보지 말고 현재 설정으로 선택되었는지도 확인하세요. 가져온 뒤 자동으로 활성화하는 클라이언트도 있지만, 이전 로컬 설정을 계속 사용하는 경우에는 설정 이름을 클릭하거나 활성화를 체크하거나 현재 설정으로 지정해야 합니다. 현재 설정에는 보통 선택 표시, 강조 색상 테두리 또는 활성화 상태가 표시됩니다.
이어서 프록시 또는 프록시 그룹 페이지에서 노드와 프록시 그룹이 표시되는지 확인하세요. 프록시 그룹 이름은 서비스 제공업체가 직접 정할 수 있으므로 다른 튜토리얼의 스크린샷과 다를 수 있습니다. 여러 프록시 그룹이 보이고 펼쳤을 때 노드, 자동 선택 또는 직접 연결 같은 항목이 있으면 설정이 정상적으로 분석된 것입니다. 화면이 계속 비어 있다면 시스템 프록시를 켜기보다 먼저 설정 페이지로 돌아가 업데이트 결과를 확인하세요.
구독 업데이트에 실패하면 먼저 클라이언트가 표시한 오류 유형을 확인하세요. 시간 초과나 네트워크에 연결할 수 없다는 메시지는 현재 네트워크에서 구독 주소에 접근할 수 없다는 뜻인 경우가 많습니다. 형식, 파싱 또는 YAML 오류는 반환된 내용이 클라이언트가 읽을 수 있는 Clash 설정이 아니라는 의미입니다. 인증되지 않음이나 비정상 상태 코드가 표시되면 서비스 제공업체 페이지에서 구독 만료, 초기화 여부 또는 재생성 필요 여부를 확인하세요. 업데이트를 반복해서 클릭해도 형식이나 권한 문제는 해결되지 않습니다.
현재 네트워크에서 기존 프록시를 거쳐야 구독에 접근할 수 있다면, 먼저 구독을 다운로드할 수 있는 네트워크 환경을 유지한 채 첫 다운로드를 완료한 다음 새 설정으로 전환하세요. 일부 클라이언트는 프록시를 통해 구독을 업데이트하는 옵션을 제공하지만 위치와 동작이 크게 다르므로 처음에는 함께 조정하지 않는 것이 좋습니다. 로컬 YAML 파일을 옮기거나 구독 업데이트 주기를 변경하거나 여러 설정을 병합해야 한다면 전체 플랫폼 설정 문서의 준비 및 설정 섹션을 계속 참고하세요.
트래픽 분기 방식 결정
프록시 모드 선택
설정이 로드된 것을 확인한 뒤 설정, 프록시 모드 또는 Mode 영역으로 이동하세요. 일반적인 옵션으로 규칙 모드, 전체 모드, 직접 연결 모드가 있습니다. 처음 사용하는 경우 규칙 모드를 권장합니다. 규칙 모드는 설정의 도메인·IP·앱 프로세스·지역 규칙을 위에서부터 매칭한 뒤 트래픽을 지정된 프록시 그룹으로 보내거나 직접 연결하거나 차단합니다. 구독에 포함된 트래픽 분기 로직을 유지할 수 있어 일상적인 사용에 가장 적합한 선택입니다.
전체 모드는 가로챌 수 있는 대부분의 트래픽을 하나의 전체 프록시 정책으로 보내므로 특정 접속 문제가 분기 규칙 때문인지 임시로 확인할 때 유용합니다. 하지만 모든 문제의 기본 해결책으로 사용하기에는 적합하지 않습니다. 규칙 모드에서 특정 대상에 접속할 수 없는데 전체 모드에서 해결된다면 클라이언트를 계속 바꾸기보다 규칙 매칭 결과나 해당 프록시 그룹을 확인해야 합니다. 직접 연결 모드는 프록시를 우회하므로 네트워크 끊김이 프록시 경로와 관련 있는지 빠르게 확인할 때 사용할 수 있습니다.
| 모드 | 트래픽 처리 방식 | 사용 상황 |
|---|---|---|
| 규칙 모드 | 설정 규칙에 따라 프록시, 직접 연결 또는 기타 정책을 선택합니다 | 일상적인 사용과 대상별 분기, 처음 설정할 때 우선 선택 |
| 전체 모드 | 가로챌 수 있는 트래픽을 하나의 전체 정책으로 보냅니다 | 노드를 임시로 테스트하거나 규칙 매칭 문제를 제외할 때 |
| 직접 연결 모드 | 프록시 노드를 거치지 않고 트래픽을 직접 연결합니다 | 로컬 네트워크를 복구하거나 프록시로 인한 이상 여부를 판단할 때 |
규칙 모드를 선택한 뒤 프록시 페이지에서 주요 프록시 트래픽을 담당하는 프록시 그룹을 찾으세요. 프록시, 노드 선택, Proxy, 수동 선택 또는 서비스 제공업체가 정한 이름일 수 있습니다. 프록시 그룹을 펼쳐 사용 가능한 노드를 선택하세요. 지연 시간 테스트를 제공한다면 한 번 실행해도 되지만, 지연 시간은 탐색 요청의 응답 상태만 보여 줄 뿐 모든 웹사이트와 앱의 사용 가능 여부를 단독으로 증명하지는 못합니다. 연결 후 실제 접속으로 최종 확인해야 합니다.
자동 선택, 장애 조치, 부하 분산과 같은 프록시 그룹의 내부 구조는 당분간 임의로 수정하지 마세요. 구독 설정은 여러 프록시 그룹을 서로 참조하도록 구성되는 경우가 많아, 겉으로는 자동 정책을 선택해도 실제 외부 연결은 다음 단계의 노드 상태에 따라 달라집니다. 처음 설정할 때의 목표는 이해하고 확인할 수 있는 연결 경로를 만드는 것이므로 구독의 기본 정책이나 명확한 노드 하나를 선택하면 충분합니다. 기본 연결이 정상임을 확인한 뒤 필요에 따라 자동 전환과 사용자 지정 규칙을 살펴보세요.
모드와 노드 선택을 완료했다고 해서 시스템 트래픽이 이미 Clash로 들어오는 것은 아닙니다. 이는 클라이언트가 트래픽을 받은 뒤 처리할 방식을 정한 것일 뿐입니다. 다음 단계에서 시스템 프록시, 시스템 VPN 또는 TUN을 켜야 대상 앱이 실제로 트래픽을 클라이언트에 전달합니다.
시스템 트래픽 가로채기
프록시 연결 설정
Windows, macOS 및 일반적인 Linux 데스크톱 환경에서는 먼저 시스템 프록시, System Proxy 또는 시스템 프록시로 설정이라는 스위치를 찾으세요. 켜면 클라이언트가 컴퓨터의 프록시 주소를 운영체제 설정에 기록하고, 브라우저와 시스템 프록시를 따르는 대부분의 앱이 HTTP 및 HTTPS 요청을 Clash에 전달합니다. 처음에는 시스템 프록시만 켜고 여러 연결 방식을 동시에 활성화하지 않는 것이 각 스위치의 역할을 확인하기 쉽습니다.
Android와 iOS 클라이언트는 보통 시스템 VPN 인터페이스로 트래픽을 가로챕니다. 시작, 연결 또는 홈 화면의 스위치를 누르면 시스템에서 VPN 설정 권한을 요청합니다. 앱 이름이 현재 설치한 클라이언트와 일치하는지 확인한 뒤 연결 생성을 허용하세요. 권한이 승인되면 상태 표시줄에 VPN 아이콘이 나타나고 클라이언트 홈 화면에도 실행 중 또는 연결됨 상태가 표시됩니다. 권한을 거부한 적이 있다면 시스템 VPN 설정으로 이동하거나 연결을 다시 눌러 권한을 재승인해야 합니다.
일부 클라이언트는 TUN 모드도 제공합니다. TUN은 가상 네트워크 인터페이스를 생성해 시스템 프록시를 따르지 않는 앱, 일부 명령줄 프로그램 또는 더 광범위한 트래픽 가로채기가 필요한 상황에 적합합니다. 다만 관리자 권한, 드라이버, 라우팅 및 DNS 설정이 필요할 수 있습니다. 처음부터 켤 필요는 없습니다. 먼저 시스템 프록시로 브라우저를 확인하고, 특정 앱이 시스템 프록시를 읽지 않는 것이 분명할 때만 TUN 모드 설정 섹션에 따라 처리하세요.
트래픽 가로채기 스위치를 켠 뒤 클라이언트의 실행 상태와 로그 영역을 확인하세요. 정상이라면 웹 요청이 발생할 때 로그에 연결 기록이 추가되고 프록시 페이지의 프록시 그룹은 방금 선택한 상태로 유지됩니다. 시스템 프록시를 켠 직후 전체 네트워크가 끊기면 먼저 스위치를 꺼서 네트워크를 복구한 다음 현재 설정의 유효성, 클라이언트 코어 실행 여부, 프록시 포트의 다른 프로그램 사용 여부를 확인하세요. 네트워크가 끊긴 상태에서 익숙하지 않은 옵션을 여러 개 연속으로 바꾸면 원인 파악이 더 어려워집니다.
데스크톱에서는 종료 동작에도 유의해야 합니다. 일부 클라이언트는 창을 닫아도 알림 영역에서 계속 실행되며 시스템 프록시도 켜진 상태로 유지합니다. 다른 클라이언트는 종료할 때 시스템 설정을 자동으로 복원합니다. 테스트가 끝나기 전에 프로세스를 강제 종료하지 마세요. 종료한 클라이언트를 가리키는 시스템 프록시가 남아 있으면 브라우저가 프록시 포트를 찾지 못해 인터넷에 연결할 수 없습니다. 이 경우 클라이언트를 다시 시작한 뒤 시스템 프록시를 끄거나 운영체제 네트워크 설정에서 자동 프록시와 수동 프록시 상태를 복구하세요.
연결이 설정된 뒤에는 DNS, 혼합 포트, LAN 공유 또는 우회 목록을 서둘러 수정하지 마세요. 현재 설정을 그대로 유지하고 새 브라우저 창을 열어 다음 단계의 확인을 진행하세요. 결과가 이상할 때 문제 범위를 구독, 정책 선택, 시스템 프록시의 세 단계로 제한할 수 있어 많은 고급 설정을 동시에 점검하는 일을 피할 수 있습니다.
실제 결과 확인
프록시 작동 여부 확인
확인은 클라이언트 스위치만 봐서는 안 됩니다. 켜짐 상태는 프로그램이 실행 중이라는 뜻일 뿐 브라우저가 프록시를 사용하거나 규칙이 예상 정책에 매칭되거나 현재 노드가 대상에 접속할 수 있다는 뜻은 아닙니다. 가장 확실한 방법은 연결 전에 기기의 외부 네트워크 정보를 기록하고, 연결 후 조회 페이지를 새로 열어 외부 IP 또는 네트워크 위치가 바뀌었는지 비교하는 것입니다. 브라우저 캐시의 영향을 피하려면 새 시크릿 창을 사용하거나 페이지를 강력 새로고침하세요.
이어서 직접 연결되어야 하는 일반 사이트와 프록시를 거쳐야 하는 대상을 각각 방문하세요. 규칙 모드에서 두 요청이 서로 다른 정책을 사용하는 것은 정상적인 분기 결과입니다. 클라이언트의 연결 기록이나 로그로 돌아가 대상 도메인에 적용된 규칙과 정책 이름을 확인하세요. 프록시 대상이 직접 연결로 매칭되었다면 문제는 대개 규칙 또는 설정에 있습니다. 프록시 정책에 매칭되었는데도 요청이 실패한다면 현재 노드, 네트워크 경로 또는 대상 서비스 상태를 확인해야 합니다.
실제로 사용할 앱도 테스트해야 합니다. 브라우저가 접속된다고 해서 모든 프로그램이 시스템 프록시를 따른다는 의미는 아닙니다. 명령줄 도구, 게임, 스토어 앱 및 일부 데스크톱 소프트웨어는 자체 네트워크 설정을 사용할 수 있습니다. 브라우저는 정상인데 특정 앱만 직접 연결된다면 먼저 해당 앱에 별도 프록시 옵션이 있는지 확인한 뒤 TUN이 필요한지 판단하세요. 하나의 앱만 작동하지 않는다고 전체 Clash 설정이 실패했다고 단정하지 마세요.
확인 과정에서는 동일한 노드를 유지한 채 규칙 모드와 전체 모드를 한 번만 통제된 방식으로 비교해 보세요. 모드만 바꾼 뒤 같은 대상에 다시 접속합니다. 전체 모드에서는 되지만 규칙 모드에서는 되지 않는다면 해당 도메인에 매칭된 규칙과 프록시 그룹을 우선 확인하세요. 두 모드 모두 되지 않는다면 확실히 사용 가능한 다른 노드로 바꾸어 비교합니다. 한 번에 하나의 조건만 바꿔야 어떤 설정이 결과에 영향을 주었는지 알 수 있습니다.
확인이 끝나면 일상적인 사용에 적합한 규칙 모드로 되돌리고 시스템 프록시 또는 VPN 상태가 예상대로인지 확인하세요. 임시로 사용한 경우 클라이언트에서 먼저 연결을 끈 뒤 프로그램을 종료합니다. 데스크톱에서는 시스템 네트워크 설정을 열어 로컬 포트를 가리키는 수동 프록시가 남아 있지 않은지 추가로 확인하세요. 모바일에서는 상태 표시줄의 VPN 아이콘이 사라졌는지 확인합니다.
브라우저 확인
새 창을 열어 연결 전후의 외부 네트워크 정보를 비교하고 프록시가 필요한 대상에 다시 접속하세요. 이미 열어 둔 이전 페이지에만 의존하지 마세요.
로그 확인
대상 요청이 클라이언트로 들어왔는지, 어떤 규칙에 매칭되었는지, 어떤 정책을 사용했는지 확인하세요. 로그에 요청이 없다면 먼저 시스템 프록시 또는 앱의 프록시 설정을 점검해야 합니다.
앱 확인
실제로 사용할 앱에서 다시 테스트하세요. 브라우저는 정상인데 앱에 문제가 있다면 별도 프록시 설정과 TUN 필요 여부를 중점적으로 확인합니다.
한 번에 하나씩 확인하기
막혔을 때 순서대로 복구
문제가 발생하면 구독, 노드, 모드, DNS, TUN을 동시에 바꾸기보다 설정이 로드되었는지부터 순서대로 확인하세요. Clash의 요청 흐름은 앱이 트래픽을 클라이언트에 전달하고, 클라이언트가 현재 설정을 읽으며, 규칙이 정책을 선택하고, 정책이 노드를 선택하는 과정으로 단순화할 수 있습니다. 어느 한 단계라도 완료되지 않으면 웹페이지가 열리지 않을 수 있으므로 스위치를 반복해서 누르는 것보다 점검 순서가 중요합니다.
구독을 가져온 뒤 노드 또는 프록시 그룹이 없음
먼저 새 구독이 현재 설정으로 지정되었는지 확인한 뒤 한 번 업데이트하고 오류 메시지를 확인하세요. 반환된 내용이 웹페이지, 로그인 안내 또는 형식 오류라면 클라이언트가 분석 가능한 Clash 설정을 받지 못한 것입니다. 서비스 제공업체로 돌아가 해당 Clash 구독 주소를 다시 복사하고, 빈 설정으로 시스템 프록시를 계속 테스트하지 마세요.
클라이언트에는 연결됨으로 표시되지만 브라우저의 외부 IP가 바뀌지 않음
데스크톱에서는 시스템 프록시가 실제로 켜졌는지, 모바일에서는 시스템 VPN 권한이 승인되었는지 확인하세요. 그런 다음 웹페이지에 접속할 때 클라이언트 로그에 요청이 나타나는지 확인합니다. 로그가 전혀 없다면 트래픽이 클라이언트에 들어오지 않은 경우가 많습니다. 로그는 있지만 직접 연결로 매칭된다면 규칙 모드와 대상 도메인의 매칭 결과를 확인해야 합니다.
시스템 프록시를 켠 뒤 모든 웹페이지에 접속할 수 없음
먼저 시스템 프록시를 꺼서 네트워크를 복구하고 클라이언트 코어가 실행 중인지, 현재 설정이 정상적으로 분석되는지 확인하세요. 그런 다음 다른 사용 가능한 노드를 선택해 다시 테스트합니다. 클라이언트를 종료한 뒤에도 네트워크가 끊긴다면 시스템 네트워크 설정에서 수동 프록시가 남아 있는지 확인하고 로컬 프록시 포트를 가리키는 이전 설정을 끄세요.
브라우저는 정상인데 다른 앱이 프록시를 사용하지 않음
해당 앱이 운영체제 프록시를 따르지 않을 수 있습니다. 먼저 앱 자체에 HTTP, SOCKS 또는 시스템 설정을 따르는 옵션이 있는지 확인하세요. 별도 설정이 없다면 TUN 사용을 검토할 수 있습니다. TUN을 켜기 전에는 해당 플랫폼의 권한, 가상 네트워크 어댑터 및 DNS 안내를 읽어 기존 VPN 또는 보안 소프트웨어와 충돌하지 않도록 하세요.
규칙 모드는 작동하지 않지만 전체 모드에서는 접속 가능
노드는 그대로 유지한 채 연결 로그에서 대상 도메인을 찾아 규칙 모드에서 어떤 규칙과 프록시 그룹에 매칭되었는지 확인하세요. 직접 연결이나 잘못된 정책에 매칭되었다면 구독 규칙을 업데이트하거나 적절한 사용자 지정 규칙을 추가해야 합니다. 규칙은 위에서부터 순서대로 매칭되므로 앞의 규칙이 뒤의 일반 규칙보다 우선 적용될 수 있습니다. 자세한 수정 방법은 체계적인 설정 문서를 참고하세요.
위 순서대로 확인해도 원인을 찾을 수 없다면 오류가 발생한 시점의 클라이언트 로그, 운영체제 버전, 클라이언트 이름, 현재 트래픽 가로채기 방식, 문제를 재현할 수 있는 단계를 저장한 뒤 설정 자주 묻는 질문 섹션에서 계속 확인하세요. 로그를 공유하기 전에는 구독 주소, 계정 정보 및 기타 민감한 내용을 삭제해야 합니다.
기본 설정 완료
필요한 항목부터 더 자세히 알아보기
기본 연결이 안정된 뒤 실제 문제에 따라 TUN, DNS, 규칙 우선순위 및 플랫폼 권한을 학습하세요. 명확한 요구가 없다면 구독의 기본 설정을 유지하는 편이 업데이트와 문제 해결에 유리합니다.
클라이언트 교체 또는 추가 설치
운영체제별로 사용 가능한 클라이언트, 시스템 요구 사항 및 다운로드 경로를 확인한 뒤 이 튜토리얼로 돌아와 동일한 4단계 설정을 진행하세요.
다운로드 페이지로 이동 →체계적인 설정 알아보기
Windows, macOS, Android, iOS 및 Linux의 설치 세부 정보와 시스템 프록시, TUN, DNS, 문제 해결 섹션을 계속 읽어 보세요.
설정 문서 열기 →