Clash 사용 가이드

네트워크 기술 지식이 필요하지 않습니다. 본 가이드는 구독 가져오기, 모드 선택, 시스템 프록시, 동작 확인의 네 단계를 순서대로 자세히 설명하며, 각 단계마다 플랫폼별 구체적인 작업 방법과 자주 발생하는 문제 해결법을 함께 다룹니다. 순서대로 따라 하면 설정이 완료됩니다.

초보자도 이해하기 쉬움 전 플랫폼 지원 분기 규칙 상세 해설 포함 문제 해결 방법 포함
step by step

상세 설정 가이드

각 단계마다 원리, 구체적인 작업 방법, 자주 겪는 실수까지 명확하게 설명합니다. 한 줄로 대충 넘어가지 않습니다.

$ tips: 아직 클라이언트를 다운로드하지 않으셨나요? 먼저 다운로드 페이지에서 사용 중인 플랫폼의 설치 파일을 받으신 후, 아래 설정을 진행해 주세요.
1

구독 링크 가져오기SUBSCRIBE

구독 링크는 본질적으로 서비스 제공자가 제공하는 URL로, 클라이언트가 요청하면 노드 목록과 분기 규칙이 포함된 설정을 반환합니다. 클라이언트의 「프로필」 페이지를 열고 구독 URL을 붙여넣어 다운로드를 클릭하면, 노드와 규칙이 자동으로 로컬 설정에 기록되며 YAML 파일을 수동으로 편집할 필요가 전혀 없습니다. 링크가 아니라 config.yaml 파일을 받은 경우, 같은 페이지에서 「파일에서 가져오기」를 선택하면 동일한 효과를 얻을 수 있지만 자동 업데이트는 되지 않습니다.

클라이언트는 보통 「자동 업데이트 주기」 설정을 제공합니다(예: 24시간마다 갱신). 시간이 되면 자동으로 최신 노드를 다시 가져오며, 언제든지 수동으로 「업데이트」를 클릭해 즉시 반영할 수 있어 링크를 다시 붙여넣을 필요가 없습니다.

$ clash profile add "https://your-provider.com/sub?token=***"
✓ 128 proxies, 8642 rules imported
자주 겪는 실수:① 구독 URL 자체가 현재 네트워크에서 접속되지 않는다면, 이른바 "닭이 먼저냐 달걀이 먼저냐"의 문제입니다. 먼저 모바일 데이터나 다른 네트워크로 최초 가져오기를 완료하세요. ② 링크를 복사할 때 앞뒤에 공백이나 줄바꿈이 포함되기 쉬우니, 가져오기가 실패하면 먼저 이 부분을 확인하세요. ③ 일부 구독은 특정 User-Agent를 요구하지만, 대부분의 Clash 클라이언트는 이미 위장 기능이 내장되어 있어 일반적으로 수동으로 처리할 필요가 없습니다.
2

동작 모드를 이해하고 선택하기MODE

클라이언트는 세 가지 트래픽 처리 모드를 제공합니다:규칙 모드는 config.yaml의 규칙과 하나씩 대조하여 자동으로 분기합니다. 중국 본토는 직접 연결, 그 외는 프록시 경유, 광고는 차단이 모두 자동으로 판단되며, 일상적인 사용에 권장되는 모드입니다. 글로벌 모드는 규칙을 무시하고 모든 트래픽을 동일한 프록시 노드로 강제 전송하며, 보통 특정 노드가 실제로 사용 가능한지 잠시 전환해서 테스트할 때 사용됩니다. 다이렉트 모드는 프록시를 완전히 비활성화해, Clash를 설치하기 전의 네트워크 상태로 잠시 돌아가는 것과 같으며, 비교 테스트나 일시적인 데이터 절약에 사용됩니다.

혼동하기 쉬운 또 다른 개념은 TUN 모드입니다——이는 위의 세 가지 모드와는 다른 차원의 개념으로, 「트래픽을 가로채는 방식」에 대한 선택입니다. 시스템 프록시는 시스템 프록시 설정을 따르는 앱(브라우저, 대부분의 일반 소프트웨어)에만 적용되지만, 일부 명령줄 도구, 게임 클라이언트, 백그라운드 서비스는 시스템 프록시 설정을 읽지 않습니다. 이 경우 TUN 모드를 활성화해야 합니다. 클라이언트가 가상 네트워크 어댑터를 생성해 네트워크 계층에서 모든 트래픽을 가로채므로 더 확실하게 작동하지만, 처음 활성화할 때는 추가 권한 부여가 필요합니다(아래 「시스템 프록시 활성화」 섹션에서 플랫폼별로 설명합니다). 초보자는 먼저 시스템 프록시만 사용해 보고, 특정 앱이 계속 프록시를 통하지 않을 때 TUN 활성화를 고려하는 것을 권장합니다.

$ clash mode rule # rule / global / direct 중 하나 선택
✓ Mode switched to rule
3

시스템 프록시 활성화CONNECT

시스템 프록시의 기본 동작 원리는 모든 플랫폼에서 동일합니다——시스템이나 앱에서 발생하는 네트워크 요청을 Clash가 로컬에서 대기 중인 포트(기본값 127.0.0.1:7890)로 전달합니다. 다만 전환 방법과 설정 파일 위치는 플랫폼마다 다르므로 아래에서 각각 설명합니다.

Windows 작업 표시줄 트레이 아이콘을 마우스 오른쪽 버튼으로 클릭하고, 메뉴에서 「System Proxy」를 체크하면 활성화되고 체크를 해제하면 비활성화됩니다. TUN 모드를 사용하려면 처음 활성화할 때 관리자 권한으로 한 번 실행하라는 안내가 표시됩니다(가상 네트워크 어댑터 드라이버 등록을 위함). 이후에는 일반적으로 실행하면 자동으로 적용됩니다. 설정 파일은 기본적으로 %USERPROFILE%\.config\clash\config.yaml에 저장되며, 텍스트 편집기로 직접 확인하거나 백업할 수 있습니다.

macOS 상단 메뉴바 아이콘을 클릭하고 「Set as System Proxy」를 선택해 시스템 프록시를 활성화합니다. TUN 모드를 사용하려면 「시스템 설정 → 개인정보 보호 및 보안 → VPN 및 네트워크 확장 프로그램」에서 해당 확장 프로그램을 찾아 권한을 허용해야 하며, 허용 후 클라이언트를 재시작해야 TUN이 적용됩니다——이는 macOS 자체의 보안 제한으로, 처음에 이 설정 위치를 찾지 못하는 것이 가장 흔한 문제입니다. 설정 파일 경로는 ~/.config/clash/config.yaml입니다.

Android 앱을 열어 먼저 「프로필」 페이지에서 구독 링크를 가져온 다음, 홈 화면의 플로팅 「연결」 버튼을 탭하세요. 표준 VPN 권한 확인 대화상자가 표시되며 「확인」을 탭하면 로컬 VPN 터널이 구축되고 트래픽 전달이 시작됩니다. 일부 중국 제조사 스마트폰(특히 Xiaomi, OPPO, vivo 등 커스텀 시스템)의 절전 기능은 백그라운드 VPN 프로세스를 강제 종료할 수 있으므로, 시스템 설정의 배터리 최적화 목록에서 Clash를 화이트리스트에 추가하는 것을 권장합니다. 그렇지 않으면 "사용 중 자동으로 연결이 끊기는" 현상이 발생하기 쉽습니다.

iOS App Store 심사 정책의 제한으로 iOS용 공식 네이티브 Clash 앱은 없으며, 일반적으로 Clash 규칙 형식과 호환되는 서드파티 클라이언트(Stash, Shadowrocket 등)를 사용합니다. 앱의 「프로필」 페이지에서 구독 링크를 추가한 후 연결을 활성화하면, 「설정 → 일반 → VPN 및 기기 관리」에서 설치된 VPN 설정을 확인할 수 있으며 그곳에서 연결 상태를 확인하거나 수동으로 끊을 수 있습니다. 앱마다 화면 문구는 약간 다를 수 있지만, 구독 가져오기와 연결 켜기/끄기의 동작 방식은 대체로 동일합니다.

Linux GUI 버전(clash-verge 등)은 Windows / macOS와 동일한 방식으로, 트레이 아이콘을 마우스 오른쪽 버튼으로 클릭해 시스템 프록시를 활성화할 수 있습니다. 명령줄만 사용하거나 데스크톱 환경이 없는 경우(클라우드 서버 등)에는 트레이가 없으므로 설정 파일을 직접 수정하고 systemd로 서비스를 백그라운드에서 관리해야 합니다. 동시에 셸에서 프록시 환경 변수를 설정하면 명령줄 도구도 프록시를 경유합니다:

$ export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890
안내:데스크톱 환경이 없는 서버 상황에서는, config.yaml을 수정한 후 systemctl enable --now clash를 실행해 부팅 시 자동으로 시작되는 백그라운드 서비스로 설정하는 것을 권장합니다. 이렇게 하면 재부팅할 때마다 수동으로 실행할 필요가 없습니다. 브라우저에서 계속 프록시가 적용되지 않는다고 표시되면, 다른 VPN이나 프록시 소프트웨어가 동시에 실행되어 충돌하고 있는지 먼저 확인하세요.
4

설정이 적용되었는지 확인VERIFY

위 세 단계를 마쳤다면, 설정이 완료되었다고 짐작하기 전에 1분 정도 시간을 들여 프록시가 실제로 작동하는지 확인해 보시기 바랍니다:

방법 1 · IP 확인:브라우저로 임의의 IP 확인 사이트에 접속해, 표시되는 출구 IP의 위치가 접속한 노드의 위치와 일치한다면(예: 홍콩 노드에 연결했는데 홍콩 IP로 표시됨), 시스템 프록시가 정상적으로 작동하고 있는 것입니다.

$ curl https://ifconfig.me
✓ 출구 IP가 전환되었습니다, 설정 성공

방법 2 · 연결 패널:클라이언트의 「연결」 패널을 열면, 각 네트워크 연결이 어떤 규칙에 일치했고 어떤 프록시 노드를 사용하는지 실시간으로 확인할 수 있습니다. 분기가 예상대로 작동하는지 확인하는 가장 직접적인 방법입니다.

방법 3 · 연결됐는데 특정 사이트가 열리지 않음:이는 「효과가 없는 것처럼 보이는」 가장 흔한 경우로, 실제로 프록시가 작동하지 않는 것이 아니라 해당 도메인이 규칙에 의해 DIRECT로 판정되었기 때문인 경우가 많습니다(비교적 새롭거나 잘 알려지지 않은 도메인이 규칙 세트에 아직 포함되지 않은 경우 흔히 발생). 연결 패널에서 해당 요청이 어떤 규칙에 일치했는지 확인할 수 있습니다. 실제로 직접 연결로 잘못 판정된 것이라면, 커스텀 규칙에 DOMAIN-SUFFIX 규칙을 수동으로 추가해 프록시 정책을 강제로 지정할 수 있습니다(아래 규칙 문법 참고). 이미 프록시 규칙에 일치했는데도 열리지 않는다면 노드 자체의 장애나 지연이 너무 높을 가능성이 크므로 「글로벌 모드」로 전환해 다른 노드를 테스트해 보세요.

rule syntax

분기 규칙의 원리와 문법 자세히 알아보기

규칙 모드가 "지능적"인 이유는 설정 파일 안의 rules 목록에 있습니다. 매칭 원리를 이해해 두면, 분기가 예상대로 작동하지 않을 때 어디를 고쳐야 할지 알 수 있습니다. 프록시 그룹, GEOIP 등의 용어가 익숙하지 않다면 먼저 용어집을 확인해 보세요.

rules는 위에서 아래로 순서대로 처리되는 목록으로, 각 줄의 형식은 대략 유형,매칭 내용,정책입니다. 클라이언트가 네트워크 요청을 받으면 첫 번째 규칙부터 순서대로 대조하며, 규칙에 일치하는 순간 해당 정책이 적용되고 매칭이 즉시 중단됩니다——그 이후에 작성된 규칙은 내용이 일치해도 절대 적용되지 않습니다. 정책은 DIRECT(직접 연결), REJECT(차단 후 폐기), 또는 특정 프록시 그룹의 이름(구독 규칙 세트에서는 보통 PROXY로 표기되며 특정 프록시 그룹을 의미) 중 하나입니다. 대부분의 구독 제공자는 이미 완전한 규칙 세트를 준비해 두었으므로 일반 사용자는 그대로 사용하면 되고 수정이 필요 없습니다. 아래 표는 상급 사용자가 가장 자주 추가하는 6가지 문법 패턴입니다.

문법 예시의미효과
DOMAIN,ad.example.com,REJECT

하나의 완전한 도메인에 정확히 일치(서브도메인 제외)

REJECT
DOMAIN-SUFFIX,google.com,PROXY

해당 도메인과 모든 서브도메인에 일치. 가장 많이 사용되는 방식

PROXY
DOMAIN-KEYWORD,facebook,PROXY

도메인에 해당 키워드가 포함되면 일치. 여러 변형 도메인을 한 번에 처리

PROXY
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve

IP 범위로 일치 여부를 판단합니다. 사설 IP 주소는 프록시를 거치지 않고 직접 연결됩니다. no-resolve는 도메인을 미리 조회하지 않는다는 의미입니다

DIRECT
GEOIP,CN,DIRECT

요청 대상 IP가 속한 국가 / 지역에 따라 분기합니다. 중국 본토 IP는 직접 연결됩니다

DIRECT
MATCH,PROXY

안전망 규칙으로, 위의 어떤 규칙에도 일치하지 않은 모든 트래픽에 일치합니다. 반드시 목록의 맨 마지막 줄에 배치해야 합니다

PROXY

상급자를 위한 보충 설명:rules에 규칙을 직접 하나씩 작성하는 것 외에도, Clash는 rule-providers도 지원합니다——커뮤니티나 서비스 제공자가 관리하며 원격으로 호스팅되는 규칙 모음(예: "중국 본토 도메인 전체", "광고 도메인 전체")을 규칙 목록에 한 줄만 추가해 참조할 수 있습니다. 내용은 원격 소스에 맞춰 자동으로 업데이트되므로 하나씩 직접 관리할 필요가 없습니다. 일상적인 사용에서는 이 부분을 신경 쓰지 않아도 되며, 분기 동작을 커스터마이즈하고 싶은데 기본 규칙 세트로는 요구를 충족할 수 없을 때만 편집이 필요합니다. 편집할 때는 커스텀 규칙을 규칙 세트 참조보다 에 배치해야 합니다. 순서가 앞선 규칙이 우선적으로 일치하기 때문입니다.