사용 튜토리얼

전 플랫폼 설정 가이드

다운로드·설치부터 구독 가져오기, 자주 발생하는 문제 해결까지 Windows·macOS·Android·iOS 전 플랫폼 사용법을 모두 다룹니다.

Clash Verge Rev 설치 (권장)

설치 파일 다운로드

다운로드 페이지에서 Windows용 Clash Verge Rev를 받으세요. 대부분의 사용자는 x64 아키텍처 버전을 선택하시면 됩니다. 「이 앱은 PC에서 실행할 수 없습니다」라고 표시되면 올바른 아키텍처(x64/arm64) 패키지를 다운로드했는지 확인하세요.

설치 완료

.exe 설치 파일을 더블클릭하고 안내에 따라 설치를 완료하세요. 백신 소프트웨어가 차단하면 일시적으로 비활성화 후 설치하세요.

주의

설치 후 UI가 표시되지 않는 경우(트레이 아이콘만 표시) WebView2 컴포넌트가 누락된 것입니다. Microsoft 공식 사이트에서 WebView2 Runtime을 설치하거나 fixed_webview2가 표기된 설치 파일을 다운로드하세요.

구독 링크 가져오기

Clash Verge Rev를 열고 좌측 「구독(Profiles)」을 클릭한 뒤, 상단 입력란에 제공업체의 구독 URL을 붙여넣고 「가져오기」를 클릭하세요. 가져오기 성공 후 해당 설정을 클릭해 활성화하세요.

시스템 프록시 활성화

좌측 「설정」을 클릭하고 「시스템 프록시」 스위치를 켜세요. 프록시 모드는 「규칙(Rule)」을 권장합니다. 국내 직접 연결, 해외 프록시의 스마트 라우팅이 활성화됩니다.

팁

TUN 모드(가상 NIC)를 사용하면 모든 TCP/UDP 트래픽을 프록시 경유로 처리할 수 있습니다. 시스템 프록시를 지원하지 않는 UWP 앱에도 적용됩니다. 관리자 권한으로 실행해야 합니다.

Windows 자주 발생하는 문제 해결

원인

코어와 프런트엔드 간 통신 실패. 보통 방화벽이 로컬 포트 통신을 차단하여 발생합니다.

해결 방법

Windows 방화벽 설정을 열어 모두 끈 후 다시 켜거나, Clash Verge Rev에 예외 규칙을 추가하세요.

원인

시스템의 여러 NIC 또는 네트워크 세그먼트가 설정 규칙과 충돌하는 경우입니다.

해결 방법

「네트워크 및 인터넷 설정 → 어댑터 옵션 변경」에서 불필요한 가상 NIC를 비활성화 또는 삭제하고 기본 NIC만 남긴 후 재시도하세요.

원인

Clash 종료 시(전원 차단·블루스크린 등 비정상 종료) 시스템 프록시가 제대로 꺼지지 않아 Windows 프록시 스위치가 켜진 상태이지만 실제로는 서비스가 없는 상태입니다.

해결 방법

「Windows 설정 → 네트워크 및 인터넷 → 프록시 → 수동 프록시 설정」에서 「프록시 서버 사용」을 끄세요.

원인

Windows UWP 앱의 샌드박스가 localhost(루프백 주소) 접근을 금지하고, 프록시 프로그램은 로컬 포트에서 대기합니다.

해결 방법

Clash Verge Rev의 「설정 → UWP 도구」에서 대상 UWP 앱을 찾아 체크 후 「Save Changes」를 클릭하세요. 또는 TUN 모드로 전환하면 이 제한을 우회할 수 있습니다.

오류 로그

                    An attempt was made to access a socket in a way forbidden by its access permissions.
                  

해결 방법

관리자 권한으로 PowerShell / 명령 프롬프트를 열고 다음 명령으로 네트워크 서비스를 재시작하세요:

net stop hns
net start hns

원인

OS에 Visual C++ 런타임 라이브러리가 없습니다.

해결 방법

VC++ x64 런타임 라이브러리를 다운로드하여 설치하세요(대부분의 64비트 Windows 사용자에게 적용).

ClashX Pro / Clash Verge Rev 설치

설치 파일 다운로드

다운로드 페이지에서 ClashX Pro(.dmg) 또는 Clash Verge Rev(M 칩은 aarch64, Intel은 x64)를 받으세요.

설치 및 개발자 신뢰 설정

.dmg를 더블클릭해 앱을 Applications로 드래그하세요. 처음 실행 시 「개발자를 확인할 수 없습니다」가 표시되면 「시스템 설정 → 개인 정보 보호 및 보안 → 보안」에서 「그래도 열기」를 클릭하세요.

macOS 15+ 사용자

일부 최신 버전에서는 터미널에서 sudo xattr -rd com.apple.quarantine /Applications/ClashX\ Pro.app을 실행해 격리 속성을 제거해야 할 수 있습니다.

구독 링크 가져오기

메뉴바의 고양이 아이콘 클릭 → 「Config → Remote config → Manage」, 구독 URL을 추가하고 「Download」를 클릭하세요. 다운로드 성공 후 구독 이름을 클릭해 활성화하세요.

시스템 프록시 / 강화 모드 활성화

메뉴바 아이콘 클릭 → 「Set as system proxy」로 시스템 프록시를 활성화하세요. 모든 트래픽(터미널·게임 포함)을 프록시로 처리하려면 「Enhanced Mode(강화 모드)」를 활성화하세요. 관리자 비밀번호 입력이 필요합니다.

macOS 자주 발생하는 문제

방법 1: 시스템 설정 → 개인 정보 보호 및 보안 → 「그래도 열기」 클릭.

방법 2 (권장): 터미널을 열고 실행:

sudo xattr -rd com.apple.quarantine /Applications/ClashX\ Pro.app

메뉴바 우측에 아이콘이 너무 많아 숨겨진 것은 아닌지 확인하세요. Command 키를 누른 채 아이콘을 표시 영역으로 드래그하거나 Bartender 같은 메뉴바 관리 툴을 활용하세요.

강화 모드를 끄고 「시스템 설정 → 네트워크」에서 ClashX가 추가한 가상 네트워크 인터페이스를 삭제한 후 네트워크를 재시작하세요. 최신 버전으로 업데이트도 시도해 보세요.

Clash for Android(CFA) 설치

APK 다운로드 및 설치

다운로드 페이지에서 CFA 설치 파일을 받으세요. 일반 사용자는 Universal 버전을 권장합니다. 64비트 기기는 arm64-v8a도 가능합니다. 파일 관리자에서 설치하세요. 처음에는 「설정 → 보안」에서 「알 수 없는 소스 허용」을 활성화해야 합니다.

구독 가져오기

CFA를 열고 우측 상단 「+」→「URL」을 탭한 뒤 구독 링크를 붙여넣고 「Create」를 탭하세요. 추가 후 「Update」를 탭해 최신 노드를 내려받고 구독 이름을 탭해 활성화하세요.

프록시 시작

메인 화면의 「Start」 버튼을 탭하세요. VPN 연결 요청이 표시되면 「확인」을 탭해 승인하세요. 성공하면 알림 바에 VPN 아이콘이 표시됩니다.

권장 설정

「설정 → Clash → DNS」에서 DNS 확인을 활성화하면 DNS 유출을 방지할 수 있습니다. 「앱별 프록시」에서 앱마다 프록시 또는 직접 연결을 개별 설정할 수 있습니다.

Android 자주 발생하는 문제

APK 파일 다운로드가 불완전합니다. 다시 다운로드하세요. 그래도 발생하면 Universal(전 아키텍처 호환) 버전을 시도해 보세요.

다음을 확인하세요:

• 다른 VPN 앱이 백그라운드에서 실행 중인지 여부(Android는 동시에 하나의 VPN만 허용)
• 구독이 정상적으로 가져와져 활성화되어 있는지(노드 목록이 비어 있지 않은지)
• 「설정 → 네트워크 및 인터넷 → VPN」에서 남아 있는 이전 VPN 설정을 삭제해 보기

프록시 모드가 「규칙(Rule)」인지 확인하세요(「글로벌(Global)」이 아닌). 특정 앱에 문제가 있으면 「앱별 프록시」에서 해당 앱을 「직접 연결」로 설정하세요.

Shadowrocket 설치

중요 안내

Clash에는 iOS 공식 클라이언트가 없습니다. Shadowrocket은 Clash 설정 형식과 호환되는 서드파티 툴($2.99)로, App Store에서 구매·다운로드하려면 한국 외 지역(미국 등) Apple ID가 필요합니다.

해외 Apple ID로 전환

App Store에서 현재 계정을 로그아웃하고 해외(미국 등) Apple ID로 로그인하세요. 해외 계정이 없으면 새로 만들거나(미국 주소 정보 필요), 구매 후 다시 기존 계정으로 전환하면 구매한 앱은 유지됩니다.

Shadowrocket 구매 및 다운로드

해외 App Store에서 「Shadowrocket」을 검색해 $2.99에 구매 후 다운로드하세요. 무료 대안으로 Stash(기능 유사, Clash 규칙 지원)도 고려해 보세요.

구독 링크 가져오기

Shadowrocket을 열고 우측 상단 「+」→ 유형 「Subscribe」 선택 → 구독 URL 붙여넣기 → 완료. 앱이 자동으로 노드 목록을 파싱합니다.

빠른 가져오기

구독 링크를 복사한 후 Shadowrocket을 열면 자동으로 인식하여 가져올지 묻습니다. 「추가」를 탭하면 되며 수동 작업이 필요 없습니다.

프록시 활성화

메인 화면으로 돌아가 상단 「연결 안 됨」 스위치를 켜세요. VPN 설정 인증 요청이 표시되면 「허용」을 탭하세요. 아이콘이 초록색으로 바뀌고 상태 표시줄에 「VPN」이 표시되면 프록시가 성공한 것입니다.

iOS 자주 발생하는 문제

구독 URL이 http:// 또는 https://로 시작하고 만료되지 않았는지 확인하세요. 브라우저에서 URL을 열어 정상 접근(YAML 콘텐츠 반환)이 되는지 확인해 보세요.

확인 사항: ① 상단 스위치가 켜져(초록색) 있는지; ② 선택한 노드가 사용 가능한지(노드 목록에서 속도 테스트 실행); ③ 프록시 모드가 「규칙」 또는 「글로벌」인지. 모든 노드가 타임아웃되면 서비스 제공업체에 문의하세요.

iOS VPN 상시 연결은 어느 정도 배터리를 소모합니다. 프록시가 필요 없을 때는 스위치를 끄세요. 「설정 → 규칙」에서 라우팅 규칙을 설정해 불필요한 트래픽이 프록시를 경유하지 않도록 하세요.

고급 가이드

Clash 더 깊이 이해하기

설정 구문·규칙 작성·자주 발생하는 오류 해결을 마스터해 Clash를 더 잘 활용하세요.

설정 구문 가이드

설정 파일 전체 구조

Clash는 YAML 형식을 사용하며 주요 핵심 필드는 다음과 같습니다:

# 기본 네트워크 설정
port: 7890          # HTTP 프록시 포트
socks-port: 7891    # SOCKS5 프록시 포트
mixed-port: 7892    # 혼합 포트 (HTTP + SOCKS5)
allow-lan: false    # LAN 기기 접속 허용 여부
mode: rule          # 프록시 모드: rule / global / direct
log-level: info     # 로그 레벨: silent / error / warning / info / debug
external-controller: 127.0.0.1:9090  # Web UI 제어 포트

dns:
  enable: true
  enhanced-mode: fake-ip
  nameserver:
    - 223.5.5.5
    - 8.8.8.8

proxies: [...]        # 노드 목록
proxy-groups: [...]   # 프록시 그룹
rules: [...]          # 라우팅 규칙

노드(proxies) 설정 예시

Shadowsocks

proxies:
  - name: "SS-홍콩"
    type: ss
    server: hk.example.com
    port: 8388
    cipher: aes-256-gcm
    password: "your_password"

VMess + WebSocket + TLS

  - name: "VMess-미국"
    type: vmess
    server: us.example.com
    port: 443
    uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    alterId: 0
    cipher: auto
    tls: true
    network: ws
    ws-opts:
      path: /ray

Trojan

  - name: "Trojan-일본"
    type: trojan
    server: jp.example.com
    port: 443
    password: "your_password"
    sni: jp.example.com

프록시 그룹(proxy-groups)

프록시 그룹은 노드 선택 정책을 정의합니다. 수동 선택·자동 테스트·로드 밸런싱 등을 지원합니다:

proxy-groups:
  # 수동 선택
  - name: "🚀 노드 선택"
    type: select
    proxies:
      - "🔄 자동 선택"
      - "SS-홍콩"
      - "VMess-미국"
      - DIRECT

  # 자동 테스트 (최저 레이턴시 노드 선택)
  - name: "🔄 자동 선택"
    type: url-test
    url: http://www.gstatic.com/generate_204
    interval: 300
    tolerance: 50
    proxies:
      - "SS-홍콩"
      - "VMess-미국"
      - "Trojan-일본"

팁

프록시 그룹은 fallback(노드 장애 시 자동 전환)과 load-balance(로드 밸런싱) 타입도 지원합니다. 제공업체 구독에는 보통 프록시 그룹이 이미 설정되어 있습니다.

라우팅 규칙 작성

규칙 타입 빠른 참조

규칙 타입	매칭 대상	예시
`DOMAIN`	전체 도메인 완전 일치	`DOMAIN,www.google.com,PROXY`
`DOMAIN-SUFFIX`	도메인 서픽스 (권장)	`DOMAIN-SUFFIX,google.com,PROXY`
`DOMAIN-KEYWORD`	도메인에 키워드 포함	`DOMAIN-KEYWORD,google,PROXY`
`IP-CIDR`	IP 주소 범위	`IP-CIDR,8.8.8.8/32,PROXY`
`GEOIP`	IP 소속 국가 코드	`GEOIP,CN,DIRECT`
`MATCH`	폴백 규칙 (마지막 1개)	`MATCH,PROXY`

인라인 규칙 예시

규칙은 순서대로 매칭되며 첫 번째로 일치하는 규칙의 액션이 실행됩니다:

rules:
  # 광고 차단
  - DOMAIN-KEYWORD,adservice,REJECT
  - DOMAIN-SUFFIX,doubleclick.net,REJECT

  # 국내 직접 연결
  - DOMAIN-SUFFIX,naver.com,DIRECT
  - DOMAIN-SUFFIX,kakao.com,DIRECT
  - GEOIP,CN,DIRECT

  # 해외 프록시
  - DOMAIN-SUFFIX,google.com,🚀 노드 선택
  - DOMAIN-SUFFIX,youtube.com,🚀 노드 선택
  - DOMAIN-SUFFIX,github.com,🚀 노드 선택

  # 폴백
  - MATCH,🚀 노드 선택

Rule Provider(외부 규칙 세트)

Rule Provider는 원격 URL에서 규칙 세트를 로드할 수 있어 대량의 규칙을 관리하기 적합합니다:

rule-providers:
  reject:
    type: http
    behavior: domain
    url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/reject.txt"
    path: ./ruleset/reject.yaml
    interval: 86400

  proxy:
    type: http
    behavior: domain
    url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/proxy.txt"
    path: ./ruleset/proxy.yaml
    interval: 86400

rules:
  - RULE-SET,reject,REJECT
  - RULE-SET,proxy,🚀 노드 선택
  - GEOIP,CN,DIRECT
  - MATCH,🚀 노드 선택

권장 방법

커뮤니티가 관리하는 규칙 세트(예: Loyalsoldier/clash-rules)를 활용하면 설정 작업을 크게 줄일 수 있고 커버리지가 넓으며 주기적으로 자동 업데이트됩니다.

자주 발생하는 오류 해결

빈도 높은 문제 빠른 참조

순서대로 확인하세요:

로컬 네트워크가 정상인지 확인
시스템 시간이 정확한지 확인(VMess 프로토콜은 시간 오차에 민감하며 90초 초과 시 연결 실패)
구독 업데이트(서비스 제공업체 서버 주소가 변경되었을 수 있음)
제공업체 고객 지원에 연락해 계정 상태와 트래픽 잔량 확인

YAML 형식은 엄격합니다. 주요 원인:

Tab 들여쓰기 사용(YAML은 스페이스만 허용)
문자열에 :가 포함되어 있는데 따옴표로 감싸지 않음
전각 콜론 ：을 반각 콜론 대신 사용

설정 내용을 yamllint.com에 붙여넣으면 형식 오류 줄 번호를 빠르게 찾을 수 있습니다.

일부 앱(게임 클라이언트·UWP 앱·터미널 툴)은 시스템 프록시를 거치지 않으므로 TUN 모드를 활성화해야 합니다:

Windows: Clash Verge에서 「TUN 모드」 활성화(관리자 권한 필요)
macOS: ClashX Pro에서 「강화 모드」 활성화
Android: Clash for Android의 VPN 스위치가 켜져 있는지 확인

기본 포트 7890이 다른 프로그램에서 사용 중일 수 있습니다. 설정 파일에서 포트 번호를 변경하세요:

mixed-port: 7893   # 사용하지 않는 임의의 포트로 변경

Windows에서는 netstat -ano | findstr :7890으로 사용 중인 프로세스 PID를 확인할 수 있습니다.

설정에서 fake-ip 모드를 활성화하고 fallback DNS를 설정하세요:

dns:
  enable: true
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16
  nameserver:
    - 223.5.5.5
    - 119.29.29.29
  fallback:
    - tls://8.8.8.8:853
    - tls://1.1.1.1:853
  fallback-filter:
    geoip: true
    geoip-code: CN