클라이언트가 정상적으로 시작됨
홈 화면에 들어갔을 때 설정, 프록시, 연결 또는 설정과 같은 기본 메뉴가 보이고 초기화 상태에 계속 머물지 않아야 합니다.
10 minute setup
Clash 사용 가이드: 가져오기·연결·확인
Clash 클라이언트를 처음 설정하는 연속 작업 안내입니다. 구독, 모드, 연결, 확인의 네 단계로 진행하면 보통 10분 안에 기본 설정을 마칠 수 있습니다.
- 데스크톱 및 모바일 지원
- 규칙 모드를 기본 경로로 사용
- 연결 실패 점검 순서 포함
Before setup
시작 전: 사용 가능한 설정과 시스템 권한 준비
작업을 시작하기 전에 클라이언트가 설치되어 정상적으로 실행되는지 확인합니다. 데스크톱에서 처음 실행하면 네트워크 접근, 방화벽 또는 백그라운드 실행 권한을 요청할 수 있습니다. 모바일에서는 실제 연결을 설정할 때 VPN 구성 생성을 요청하는 경우가 많습니다. 시스템 안내에 따라 연결에 필요한 권한을 허용해야 합니다. 그렇지 않으면 클라이언트 화면에 설정이 불러와졌다고 표시되어도 기기 트래픽을 처리하지 못할 수 있습니다.
이 가이드는 설정 서비스 제공업체에서 유효한 구독 주소를 받은 상태를 전제로 합니다. 구독 주소는 Clash 클라이언트가 자동으로 생성하는 값이 아니며, 일반적으로 노드, 정책 그룹, 분할 규칙 및 DNS 설정을 포함합니다. 출처에 따라 설정 구조가 다를 수 있으므로 가져온 뒤 표시되는 정책 그룹 이름이 항상 같지는 않습니다. 설정이 정상적으로 파싱되고 정책 그룹이 표시되며 뚜렷한 오류가 없다면 다음 단계로 진행할 수 있습니다.
기기에 다른 설정이 저장되어 있다면 먼저 현재 활성 항목을 확인하고, 용도를 모르는 기존 설정은 삭제하지 않는 것이 좋습니다. 처음 연습할 때는 별도의 구독 항목을 만들고 원본 주소를 보관하세요. 규칙을 수정하거나 다른 모드를 테스트한 뒤에도 구독을 다시 업데이트해 서비스 제공업체의 원본 내용으로 복구할 수 있습니다.
구독 주소가 아직 유효함
주소를 공백이나 줄바꿈 없이 완전히 복사할 수 있어야 합니다. 서비스 제공업체가 웹 콘솔을 제공한다면 먼저 구독 상태가 정상인지 확인하세요.
시스템 시간이 정확함
날짜, 시간 및 시간대 자동 설정을 켜세요. 시스템 시간 오차가 크면 일부 보안 연결이 정상적으로 설정되지 않을 수 있습니다.
준비가 끝났다고 바로 시스템 프록시를 켜는 것은 아닙니다. 먼저 구독을 클라이언트에 정확히 가져와야 합니다. 트래픽을 넘기기 전에 설정을 완료하면 사용 가능한 정책이 없는 상태에서 프록시가 켜져 브라우저와 다른 앱이 일시적으로 인터넷에 연결되지 않는 문제를 피할 수 있습니다.
구독 가져오기 및 현재 설정 활성화
Clash 클라이언트를 연 뒤 “설정”, “구독”, “Profiles” 또는 “프로필”이라는 메뉴를 찾습니다. 데스크톱 클라이언트는 보통 왼쪽 탐색 메뉴에 있고, 모바일 클라이언트는 홈 화면의 설정 영역에 있을 수 있습니다. 메뉴에 들어가 새 구독, URL에서 가져오기 또는 원격 설정 추가를 선택하고 전체 구독 주소를 입력란에 붙여 넣습니다. 이름도 입력해야 한다면 알아보기 쉬운 짧은 이름을 사용하세요. 이름은 기기에서 항목을 구분하기 위한 것일 뿐 구독 내용은 바꾸지 않습니다.
저장한 뒤 한 번 업데이트를 실행합니다. 클라이언트가 구독 주소에 요청을 보내고 YAML 설정을 파싱합니다. 정상이라면 목록에 설정 이름, 업데이트 시간 또는 업데이트 버튼이 표시됩니다. 일부 클라이언트는 프록시 그룹 수를 바로 보여주기도 합니다. “다운로드 완료” 메시지만 보지 말고 새 설정이 실제로 목록에 나타났는지 확인하세요. 목록이 계속 비어 있으면 주소가 잘리지 않았는지, 앞뒤에 공백이 섞이지 않았는지 확인한 뒤 다시 붙여 넣습니다.
가져온 항목을 현재 사용 설정으로 지정
가져오기에 성공했다고 해서 설정이 활성화된 것은 아닙니다. 많은 클라이언트가 로컬 설정과 여러 원격 구독을 동시에 저장하므로 새 설정 옆의 선택 버튼, 라디오 표시 또는 활성화 메뉴를 눌러야 합니다. 선택하면 보통 클라이언트 홈에 현재 설정 이름이 표시되고 프록시 페이지에도 여러 정책 그룹이 나타납니다. 이러한 변화가 있어야 이후 모드 선택이 방금 가져온 설정을 기준으로 진행된다는 뜻입니다.
클라이언트에서 설정 파싱 실패가 표시되면 시스템 프록시를 반복해서 켜지 마세요. 구독 내용이 불완전하거나, 주소가 로그인 페이지를 반환하거나, 설정 필드가 호환되지 않거나, 로컬 편집 중 들여쓰기가 깨진 경우에 흔히 발생합니다. 생성된 설정을 직접 수정하기보다 서비스 제공업체가 제공한 원본 구독 주소로 다시 업데이트하는 편이 안전합니다. 그래도 실패하면 오류 메시지에 표시된 필드 이름과 줄 번호를 기록한 뒤 문제 해결에서 구독 업데이트 및 설정 불러오기 문제를 확인하세요.
가져오기 완료를 확인하는 세 가지 화면 신호
- 설정 목록에 방금 추가한 항목이 보이고 최근 업데이트 시간이 이번 작업 시각과 일치합니다.
- 해당 항목이 선택됨, 활성화됨 또는 현재 설정으로 표시되어야 하며 목록에 저장만 된 상태여서는 안 됩니다.
- 프록시 페이지에 들어갔을 때 정책 그룹과 선택 가능한 항목이 보이고 빈 목록이나 로드 실패가 계속 표시되지 않아야 합니다.
위의 확인을 마치면 설정을 실행할 준비가 된 것입니다. 이제 트래픽이 Clash를 어떻게 통과할지 결정해야 합니다. 처음에는 모든 규칙을 하나씩 이해하기보다 확인에 적합한 프록시 모드를 선택하고 주요 정책 그룹이 사용할 수 없는 항목을 가리키지 않도록 하는 것이 중요합니다.
NEXT / 02
프록시 모드 선택 계속 →
프록시 모드 선택 및 정책 그룹 확인
클라이언트의 “모드”, “실행 모드” 또는 “Mode” 영역으로 이동합니다. 일반적인 선택지는 규칙 모드, 글로벌 모드, 직접 연결 모드입니다. 처음 설정할 때는 규칙 모드를 권장합니다. 클라이언트가 설정에 포함된 도메인, IP 및 규칙 세트에 따라 프록시를 사용할 요청과 직접 연결할 요청을 결정하기 때문입니다. 규칙 모드는 대부분의 구독 설정이 일상적인 실행 방식으로 예상하는 모드이며, 로컬 네트워크와 일반적인 직접 연결 서비스의 정상적인 접근 경로도 유지합니다.
글로벌 모드는 대부분의 트래픽을 하나의 전역 정책으로 처리하므로 특정 연결 항목이 작동하는지 잠시 확인할 때 유용합니다. 하지만 모든 문제를 진단하는 유일한 방법으로 사용해서는 안 됩니다. 직접 연결 모드는 프록시 정책을 우회하며 프록시를 일시 중지하거나 비교 테스트할 때 사용합니다. 모드를 직접 연결로 잘못 선택하면 클라이언트 코어가 실행 중이어도 외부 접근 결과에 프록시 설정이 반영되지 않습니다.
규칙 모드
설정 규칙에 따라 트래픽을 분류합니다. 처음 설정할 때와 일상적인 사용에 우선 권장합니다.
글로벌 모드
전역 정책으로 트래픽을 일괄 처리하며 연결 결과를 잠시 비교할 때 사용할 수 있습니다.
직접 연결 모드
트래픽이 프록시 정책을 거치지 않으며 프록시를 중지하거나 네트워크 차이를 비교할 때 적합합니다.
주요 정책 그룹에서 사용 가능한 항목 선택
모드를 정한 뒤 “프록시”, “Proxies” 또는 정책 그룹 페이지로 이동합니다. 구독에는 보통 “노드 선택”, “자동 선택”, “장애 조치”와 같은 정책 그룹이 포함되지만 서비스 제공업체가 지정한 이름을 사용할 수도 있습니다. 먼저 주요 출구를 선택하는 정책 그룹을 찾고 현재 선택된 항목을 확인합니다. 그룹에 자동 선택 정책이 있다면 먼저 사용해도 됩니다. 수동 선택이 필요하다면 상태가 정상이고 현재 목적에 맞는 지역과 용도의 항목을 선택하세요.
일부 클라이언트는 지연 시간 테스트 버튼을 제공합니다. 테스트 결과는 현재 시점에 기기에서 대상까지 응답하는 상황만 보여주며 전체 다운로드 속도나 장기 안정성을 단독으로 나타내지는 않습니다. 처음 연결할 때는 명백히 연결되지 않는 항목을 걸러내는 용도로 활용하고, 가장 작은 수치를 계속 추구할 필요는 없습니다. 모든 항목이 시간 초과로 표시되면 모드를 자주 바꾸기보다 먼저 구독 업데이트 성공 여부와 기기의 기본 네트워크 상태를 확인하세요.
정책 그룹 사이에는 참조 관계가 있을 수 있습니다. 예를 들어 한 규칙 그룹이 “자동 선택”을 가리키고, “자동 선택”이 다시 여러 항목 중 출구를 결정하는 방식입니다. 이 경우 가장 바깥쪽 그룹만 바꿔도 최종 결과가 달라지지 않을 수 있습니다. 복잡한 정책 구조에서는 우선 구독 기본 설정을 유지하고 주요 선택 그룹에 사용 가능한 항목이 있는지만 확인하세요. 코어, 정책 그룹 및 프로토콜 유형의 관계는 프로토콜 및 코어 기술 참고에서 확인할 수 있으며, 이 페이지에서는 고급 필드를 다루지 않습니다.
실행 모드가 규칙 모드이고 주요 정책 그룹도 사용 가능한 항목을 가리키면 클라이언트 내부의 결정 경로가 준비된 것입니다. 이제 코어를 시작하고 운영체제가 처리할 네트워크 요청을 클라이언트로 보내도록 설정합니다.
NEXT / 03
연결 설정 계속 →
코어 시작 및 시스템 연결 설정
클라이언트 홈으로 돌아가 시작, 실행 또는 서비스 스위치를 찾습니다. 데스크톱 클라이언트는 보통 “코어 시작”과 “시스템 프록시”를 별도 상태로 관리합니다. 코어는 설정을 읽고 로컬 프록시 포트를 제공하며, 시스템 프록시는 브라우저와 시스템 설정을 따르는 앱이 해당 포트로 요청을 보내도록 합니다. 따라서 코어만 시작하고 시스템 프록시를 켜지 않으면 클라이언트는 정상 실행으로 표시되어도 웹 트래픽이 연결 기록에 들어오지 않을 수 있습니다.
먼저 코어를 시작하고 상태가 실행 중으로 바뀔 때까지 기다린 다음 시스템 프록시를 켜는 것이 좋습니다. 클라이언트가 시작 시 자동 실행을 제공하더라도 첫 확인이 성공한 뒤 활성화 여부를 결정하세요. 문제를 점검하는 단계에서 백그라운드 실행 변수를 미리 추가할 필요는 없습니다. 일부 Windows 클라이언트는 시스템 프록시 설정이나 서비스 설치에 관리자 권한이 필요할 수 있습니다. macOS에서는 네트워크 확장, 보조 도구 또는 관리자 승인을 요청할 수 있습니다. 시스템 대화상자의 안내에 따라 승인한 뒤 클라이언트로 돌아와 스위치가 자동으로 꺼지지 않았는지 확인하세요.
모바일에서는 VPN 구성으로 트래픽 전환
Android와 iOS 클라이언트는 보통 시스템 VPN 인터페이스를 사용해 로컬 연결을 설정합니다. 시작을 누르면 시스템에 VPN 연결 생성 확인 창이 표시됩니다. 허용하면 상태 표시줄에 VPN 아이콘이 나타나고 클라이언트 홈에도 연결됨 또는 실행 중 상태가 표시됩니다. 이 VPN 구성은 기기 트래픽을 로컬 클라이언트에 전달하기 위한 것입니다. 시스템이 권한을 거부하거나 다른 VPN 앱이 연결을 사용 중이면 Clash 클라이언트가 트래픽 전환을 완료할 수 없습니다.
모바일 기기에서는 일반적으로 이런 유형의 연결을 한 번에 하나만 유지할 수 있습니다. 시작하자마자 중지된다면 시스템 설정에서 다른 VPN이나 네트워크 필터 도구가 연결되어 있는지 먼저 확인하세요. 충돌하는 연결을 종료한 뒤 클라이언트로 돌아가 다시 시작합니다. Android에서는 배터리 절전 정책 때문에 백그라운드로 전환한 뒤 연결이 종료될 수도 있습니다. 처음 확인할 때는 클라이언트를 전면에 유지해 기본 연결을 확인한 다음 기기 설정에서 필요한 백그라운드 실행을 허용하세요.
데스크톱에서 시스템 프록시 상태 확인
Windows와 macOS에서는 시스템 프록시를 켠 뒤 운영체제의 네트워크 또는 프록시 설정 페이지에서 교차 확인할 수 있습니다. 정상이라면 시스템에 클라이언트가 설정한 로컬 프록시 주소와 포트가 표시됩니다. 클라이언트의 관리 방식을 모르는 상태에서 이 값을 직접 수정하지 마세요. 클라이언트를 종료한 뒤 설정이 일치하지 않을 수 있습니다. 사용을 중지할 때는 클라이언트에서 시스템 프록시를 끄고 클라이언트가 관련 정리 작업을 수행하도록 하는 것이 좋습니다.
Linux 그래픽 클라이언트의 처리 방식은 데스크톱 환경과 클라이언트 구현에 따라 달라집니다. 일부 클라이언트는 시스템 프록시를 직접 설정하지만, 일부는 로컬 HTTP, SOCKS 또는 mixed 포트만 제공하므로 데스크톱 네트워크 설정이나 대상 앱에서 직접 지정해야 합니다. 다운로드 페이지에서 선택한 클라이언트에 시스템 프록시 스위치가 명시되어 있다면 내장 기능을 우선 사용하세요. 서버와 순수 명령줄 환경은 코어 배포 영역이므로 기술 참고에서 설정 호환성과 실행 범위를 확인하세요.
시스템 프록시 또는 VPN 연결을 완료한 뒤 항목을 연속해서 바꾸지 마세요. 현재 설정과 규칙 모드를 유지한 채 마지막 단계로 이동해 일반 웹페이지와 클라이언트 연결 기록을 통해 요청이 실제로 예상 경로를 거치는지 확인합니다.
NEXT / 04
연결 확인 계속 →
웹페이지 접속 및 연결 기록 확인
브라우저에 기존에 열어 둔 테스트 페이지를 먼저 닫고 평소 정상적으로 열리는 웹사이트를 새 창에서 방문합니다. 이 단계에서는 프록시 설정으로 기본 네트워크가 끊기지 않았는지 확인합니다. 이어서 구독 규칙에 따라 처리되어야 하는 다른 웹사이트를 열고 페이지가 정상적으로 로드되는지 확인하세요. 테스트 중에는 클라이언트를 계속 실행하고 브라우저 확장 프록시, 다른 VPN 또는 중복된 시스템 프록시 도구를 동시에 사용하지 마세요. 요청 경로가 여러 설정으로 바뀔 수 있습니다.
웹페이지가 열리는 것은 첫 번째 결과일 뿐입니다. 클라이언트의 “연결”, “로그” 또는 “Connections” 페이지로 돌아가야 합니다. 웹페이지를 새로 고치면 연결 목록에 새 도메인, 규칙 일치 결과 또는 정책 이름이 나타나야 합니다. 해당 요청이 보이면 시스템 트래픽이 Clash로 들어온 것입니다. 목록에 새 기록이 전혀 없다면 구독 항목 자체보다 시스템 프록시 또는 VPN 전환 상태를 먼저 확인하세요.
기록으로 구분하는 세 가지 일반적인 결과
첫 번째는 웹페이지가 열리고 연결 기록도 계속 나타나며 예상한 정책이 적용된 경우입니다. 가져오기, 모드, 코어 및 시스템 전환이 완전한 경로를 구성했으므로 기본 설정이 완료된 상태입니다. 두 번째는 웹페이지가 열리지 않지만 연결 기록에 요청과 오류가 표시되는 경우입니다. 트래픽은 이미 클라이언트에 들어온 것이므로 현재 항목, DNS, 규칙 또는 대상 연결 단계에 문제가 있을 가능성이 큽니다. 세 번째는 웹페이지가 열리지 않고 연결 기록도 전혀 변하지 않는 경우입니다. 이때는 시스템 프록시, VPN 권한 및 다른 네트워크 도구와의 충돌을 확인해야 합니다.
웹페이지 정상, 새 기록 표시
연결 경로가 설정되었습니다. 규칙 적용 결과와 일상적인 사용 상태를 계속 확인할 수 있습니다.
웹페이지 실패, 요청 기록 있음
현재 정책 항목, DNS 상태, 규칙 결과 및 로그의 구체적인 오류를 확인합니다.
웹페이지 실패, 기록 없음
시스템 프록시, VPN 승인, 브라우저의 독립 프록시 설정 및 다른 연결 도구를 확인합니다.
연결 실패 시 정해진 순서로 점검
확인에 실패했다면 먼저 Clash의 시스템 프록시 또는 VPN을 끈 상태에서 기기가 기본 네트워크에 정상적으로 연결되는지 확인합니다. 기본 네트워크 자체에 문제가 있다면 Wi-Fi, 모바일 네트워크 또는 유선 연결을 먼저 복구하세요. 기본 네트워크가 정상화되면 클라이언트를 다시 열고 현재 설정이 방금 가져온 구독인지 확인한 다음, 모드가 규칙 모드인지와 주요 정책 그룹에 명확한 선택 항목이 있는지 점검합니다.
그다음 코어와 시스템 프록시를 다시 시작합니다. 데스크톱에서는 시스템 프록시를 끄고 몇 초 기다린 뒤 다시 켤 수 있습니다. 모바일에서는 VPN 연결을 끊은 후 클라이언트에서 다시 연결을 시작하세요. 다시 작업한 직후 웹페이지를 새로 고치면서 연결 기록을 확인합니다. 한 번에 하나의 단계만 조정해야 어떤 변경으로 연결이 복구되었는지 판단할 수 있습니다.
요청이 이미 연결 기록에 들어왔지만 로그에 이름 확인 실패, 규칙 일치 실패 또는 설정 필드 오류가 표시된다면 처음부터 설정 전체를 다시 작성하지 마세요. 먼저 구독을 업데이트하고 사용 가능한 정책 항목으로 바꿔 재테스트합니다. 그래도 실패하면 문제 해결에서 “Clash 인터넷 연결 안 됨”과 “구독 업데이트 실패” 항목에 따라 계속 점검하세요. DNS 요청 경로, fallback 조건 및 코어 호환성은 고급 설정에 해당하므로 기술 참고에서 확인할 수 있습니다.
일반 웹페이지에 접속할 수 있고 처리 대상 요청도 연결 목록에 표시되며 정책 적용 결과가 현재 설정과 일치한다면 네 단계가 완료된 것입니다. 이제 실제 사용 습관에 따라 시작 시 자동 실행, 백그라운드 실행 또는 구독 자동 업데이트를 설정하세요. 기본 경로를 확인하기 전에 추가 설정을 늘리지 않는 것이 좋습니다.
After setup
완료 후 관리 순서
기본 연결을 확인한 뒤에는 업데이트와 문제 해결 습관만 명확히 유지하면 됩니다. 고급 매개변수를 자주 조정할 필요는 없습니다.
정기적으로 구독 업데이트
구독의 항목과 규칙은 변경될 수 있습니다. 업데이트하기 전에 현재 네트워크가 사용 가능한지 확인하고, 업데이트 후 설정이 계속 선택되어 있는지와 주요 정책 그룹에 적절한 선택 항목이 남아 있는지 확인하세요. 클라이언트가 자동 업데이트를 지원한다면 적절한 간격으로 설정하면 됩니다. 짧은 시간 안에 반복해서 새로 고칠 필요는 없습니다.
먼저 연결 기록 확인
특정 웹사이트에 접속할 수 없을 때는 요청이 클라이언트에 들어왔는지, 어떤 규칙이 적용되었는지, 어떤 정책을 사용했는지 먼저 확인하세요. 연결 기록을 보면 시스템 전환 문제, 규칙 문제, 대상 연결 문제를 구분할 수 있어 모든 스위치를 순서 없이 바꾸는 것보다 효과적입니다.
원본 설정 보관
사용자 지정 규칙을 시험하려면 설정을 복사한 뒤 수정하고, 원격 구독은 복구용으로 보관하세요. 설정 파싱 오류가 발생하면 먼저 원본 버전으로 되돌린 다음 변경 사항을 하나씩 추가해 여러 문제가 같은 파일에 겹치지 않도록 합니다.
문제별 심화 안내
ROUTE COMPLETE
기본 설정 완료
클라이언트나 플랫폼을 바꾸려면 다운로드 페이지로 돌아가고, 구체적인 오류가 발생하면 증상에 맞춰 문제 해결로 이동하세요.