마이그레이션 예상 읽기 시간 17분

ClashX 사용법: 구독 추가부터 노드 변경까지 초보자 가이드

ClashX를 설치했지만 구독 링크를 어디에 넣고 사용할 노드를 어떻게 바꾸는지 모르겠다면 이 가이드를 확인하세요. macOS 기준으로 구독 URL 등록, 프로필 갱신, 노드 선택, 지연 시간 확인, 시스템 프록시 켜기까지 초보자도 따라 할 수 있게 순서대로 설명합니다.

ClashX를 처음 실행하기 전에 알아둘 것

ClashX는 macOS에서 Clash 계열 코어를 그래픽 화면으로 관리하는 클라이언트입니다. 구독 링크에 포함된 서버 정보와 규칙을 읽어 로컬 프록시 포트를 열고, macOS의 시스템 프록시가 그 포트를 사용하도록 연결하는 방식입니다. 따라서 ClashX 앱을 설치했다고 해서 바로 인터넷 경로가 바뀌는 것은 아닙니다. 구독 또는 YAML 설정을 추가하고, 코어를 실행한 뒤, 사용할 노드를 선택하고, 시스템 프록시를 켜는 순서가 필요합니다.

ClashX와 구독 서비스는 서로 다른 구성 요소입니다. ClashX는 설정을 실행하는 프로그램이고, 구독 URL은 프록시 노드와 정책 그룹을 내려받는 주소입니다. 구독 서비스가 제공하는 설정은 일반 Clash 형식일 수도 있고, Clash Meta 또는 mihomo 확장 필드를 포함할 수도 있습니다. 최신 프로토콜이나 TUN 기능이 필요한 설정이라면 사용 중인 ClashX 패키지와 코어가 해당 기능을 지원하는지 먼저 확인해야 합니다.

구성 요소 역할 문제가 생겼을 때 확인할 항목
ClashX 앱 설정 가져오기, 노드 선택, 시스템 프록시 전환 앱 실행 상태와 macOS 권한
Clash 코어 규칙 매칭, DNS 처리, 프록시 연결과 포트 수신 코어 로그, 포트 충돌, 지원 프로토콜
구독 URL 노드와 정책 그룹이 포함된 설정 제공 주소 만료, 응답 상태 코드, 설정 형식
macOS 시스템 프록시 다른 앱의 HTTP·HTTPS 트래픽을 로컬 포트로 전달 프록시 활성화 여부와 수신 포트

ClashX 설치와 첫 실행 설정

macOS 버전에 맞는 ClashX 설치 파일을 받은 뒤 앱을 「응용 프로그램」 폴더로 이동하는 것이 좋습니다. 다운로드 폴더나 DMG 내부에서 계속 실행하면 업데이트와 권한 확인 과정에서 다른 앱 복사본으로 인식될 수 있습니다. 기존 Clash 계열 클라이언트가 실행 중이라면 먼저 시스템 프록시와 TUN을 끄고 종료하세요. 여러 클라이언트가 같은 포트인 7890을 동시에 사용하려 하면 포트 바인딩 오류가 발생할 수 있습니다.

  1. 다운로드한 설치 파일을 열고 ClashX를 「응용 프로그램」 폴더로 드래그합니다.
  2. Finder의 「응용 프로그램」에서 ClashX를 실행합니다.
  3. 처음 실행할 때 macOS가 네트워크 또는 VPN 관련 승인을 요청하면 실제로 TUN을 사용할 때만 필요한 권한인지 확인합니다.
  4. 화면 오른쪽 상단 메뉴 막대에 ClashX 아이콘이 나타나는지 확인합니다.
  5. 기존 프록시 앱이 실행 중인지 확인한 뒤 ClashX에서 사용할 코어와 로컬 포트를 점검합니다.

“개발자를 확인할 수 없음” 또는 실행 차단 메시지가 표시되면 Finder에서 앱을 Control 키를 누른 채 클릭하고 「열기」를 선택해 보세요. 그래도 차단되면 「시스템 설정」→「개인정보 보호 및 보안」에서 방금 차단된 앱에 대한 「그래도 열기」 항목을 확인할 수 있습니다. 설치 파일이 불완전하거나 Intel과 Apple Silicon용 패키지를 잘못 선택한 경우에도 실행되지 않을 수 있으므로, 권한 문제로 단정하기 전에 Mac의 칩 유형과 설치 파일을 함께 확인해야 합니다.

ClashX를 처음 사용할 때는 TUN보다 시스템 프록시 모드부터 시작하는 편이 안전합니다. 브라우저와 대부분의 프록시 인식 앱은 시스템 프록시만으로 테스트할 수 있습니다. TUN은 시스템 프록시를 읽지 않는 프로그램까지 처리할 수 있지만 네트워크 확장 권한, 라우팅과 DNS 설정이 추가되어 문제 범위가 넓어집니다.

구독 URL 추가하고 프로필 업데이트하기

구독 URL은 프록시 제공업체의 관리 페이지에서 Clash 또는 Clash Meta용으로 복사해야 합니다. 일반적인 vmess://, ss:// 공유 링크 여러 개를 단순히 붙여 넣는 것과 완성된 Clash 설정을 추가하는 것은 다릅니다. ClashX의 프로필 메뉴에서 URL 기반 설정을 추가할 때는 YAML 설정 또는 서비스가 Clash 형식으로 변환한 주소를 사용하세요.

  1. macOS 메뉴 막대에서 ClashX 아이콘을 클릭합니다.
  2. 프로필 또는 설정 가져오기 메뉴에서 URL을 사용한 프로필 추가 항목을 선택합니다.
  3. 구독 URL을 붙여 넣고 알아보기 쉬운 이름을 지정합니다.
  4. 추가된 프로필을 선택한 뒤 다운로드 또는 업데이트를 실행합니다.
  5. 프로필 목록에서 노드와 정책 그룹이 표시되는지 확인합니다.

업데이트가 성공하면 설정 안의 proxies, proxy-groups, rules 등이 코어에서 읽힙니다. 노드 목록이 비어 있거나 프로필이 추가되지 않는다면 단순히 노드가 없는 것이 아니라 응답 형식이 잘못되었을 가능성도 있습니다. 브라우저에서 URL을 열었을 때 로그인 페이지, HTML 오류 화면, 캡차 페이지가 표시된다면 ClashX가 사용할 수 있는 설정을 받은 것이 아닙니다.

mode: rule
mixed-port: 7890
allow-lan: false
external-controller: 127.0.0.1:9090
log-level: info

위 설정은 구조를 이해하기 위한 예시입니다. 실제 구독 파일에는 노드와 정책 그룹이 더 많이 포함됩니다. allow-lan: false는 같은 네트워크의 다른 기기가 로컬 프록시 포트에 접근하지 못하게 하는 기본적인 보안 설정입니다. 공유기 내부의 다른 기기에서 사용해야 하는 특별한 이유가 없다면 LAN 공개를 켜지 않는 편이 좋습니다.

정책 그룹에서 사용할 노드 변경하기

구독을 추가한 뒤에는 노드 하나를 직접 고르는 것보다 먼저 정책 그룹의 구조를 이해하는 것이 좋습니다. “노드 선택”, “Proxy”, “自动”, “Fallback”과 같은 항목은 실제 서버가 아니라 여러 노드를 묶은 정책 그룹일 수 있습니다. 규칙이 이 그룹을 참조하고 있다면 그룹 안에서 선택한 노드가 웹 트래픽에 사용됩니다.

메뉴 항목 유형 의미 초보자 사용법
노드 선택 사용자가 직접 특정 노드를 고르는 그룹 연결할 서버를 클릭
자동 선택 또는 URL 테스트 측정 결과에 따라 지연 시간이 낮은 노드를 선택 속도보다 안정성이 중요하면 결과를 함께 확인
Fallback 현재 노드가 실패할 때 다른 노드로 전환 장시간 연결이 필요한 경우 활용
DIRECT 프록시를 거치지 않고 직접 연결 국내 서비스나 우회가 필요 없는 주소에 사용

노드를 바꾸는 기본 순서는 다음과 같습니다. 먼저 ClashX 메뉴에서 현재 활성 프로필을 선택하고, 정책 그룹 메뉴로 이동합니다. 그다음 “노드 선택” 또는 구독 서비스가 만든 대표 정책 그룹을 열어 원하는 노드를 클릭합니다. 선택 표시가 바뀐 뒤 브라우저에서 새로고침하면 됩니다. 일부 클라이언트는 정책 선택을 즉시 코어에 반영하지만, 화면에 반영되지 않는다면 프로필을 다시 적용하거나 코어를 재시작하세요.

지연 시간만으로 노드를 고르지 않기

노드 옆에 표시되는 지연 시간은 특정 테스트 주소까지의 왕복 시간을 의미합니다. 예를 들어 한 노드가 58 ms이고 다른 노드가 120 ms라고 해도 실제 영상 재생이나 대용량 다운로드 결과가 항상 같은 순서로 나타나는 것은 아닙니다. 서버의 혼잡도, 패킷 손실, 국제 회선 품질과 UDP 지원 여부가 함께 영향을 줍니다.

연결되지 않을 때 직접 점검하는 순서

노드가 선택되었는데 웹사이트가 열리지 않는다면 한 번에 여러 설정을 바꾸지 말고 아래 순서대로 확인하세요. 먼저 ClashX가 실행 중이고 메뉴 막대 아이콘이 정상적으로 표시되는지 확인합니다. 다음으로 현재 프로필이 활성화되어 있으며 정책 그룹에서 실제 노드가 선택되었는지 봅니다. 마지막으로 시스템 프록시가 켜져 있고 프록시 포트가 코어의 mixed-port와 일치하는지 확인합니다.

  1. 코어 상태 확인: ClashX 메뉴에서 시작 또는 실행 상태를 확인하고 로그에 포트 점유 오류가 없는지 봅니다.
  2. 프로필 확인: 마지막 업데이트 시간이 최신인지, 노드와 정책 그룹이 목록에 나타나는지 확인합니다.
  3. 노드 확인: 한 노드만 고집하지 말고 같은 그룹의 다른 노드를 선택해 비교합니다.
  4. 시스템 프록시 확인: ClashX의 시스템 프록시 항목을 켜고 macOS 네트워크 설정의 프록시 주소와 포트를 확인합니다.
  5. DNS 확인: IP 주소는 연결되지만 도메인만 열리지 않는다면 DNS 설정 또는 DNS 오염 가능성을 점검합니다.
  6. 사이트별 규칙 확인: 특정 사이트만 실패하면 해당 도메인이 DIRECT 또는 잘못된 정책 그룹으로 분류되는지 확인합니다.

macOS의 「시스템 설정」→「네트워크」→현재 연결 중인 네트워크→「세부사항」→「프록시」에서 HTTP와 HTTPS 프록시 항목을 확인할 수 있습니다. ClashX가 실행 중인데도 해당 항목이 꺼져 있으면 브라우저는 로컬 코어를 사용하지 않습니다. 반대로 ClashX를 종료한 뒤에도 프록시 항목이 켜져 있으면 인터넷이 전혀 열리지 않을 수 있으므로, 앱을 종료할 때 시스템 프록시를 함께 끄는 습관을 들이는 것이 좋습니다.

증상 가능성이 높은 원인 첫 번째 조치
프로필 업데이트가 401 또는 403으로 실패 토큰 만료, 접근 제한, User-Agent 정책 관리 페이지에서 URL을 다시 복사하고 주소 유효 기간 확인
노드 목록이 비어 있음 HTML 오류 페이지 또는 잘못된 구독 형식 응답 내용을 확인하고 Clash용 구독으로 재발급
포트가 이미 사용 중이라는 로그 다른 Clash 클라이언트 또는 중복 프로세스 다른 프록시 앱을 종료하거나 포트를 변경
브라우저만 연결되지 않음 시스템 프록시 미적용 또는 브라우저 자체 설정 macOS 프록시 항목과 브라우저의 별도 프록시 설정 확인
모든 사이트에서 DNS 오류 DNS 서버, 규칙 또는 TUN 충돌 시스템 프록시 모드로 되돌려 원인을 분리

ClashX 초보자 FAQ

구독 URL을 추가했는데 노드가 보이지 않으면 어떻게 하나요?

먼저 URL이 만료되지 않았는지 확인하고, 서비스 관리 페이지에서 Clash 또는 Clash Meta용 주소를 다시 복사하세요. 브라우저에서 HTML 로그인 화면이나 오류 문서가 반환되면 ClashX가 읽을 수 있는 설정이 아닙니다. 구독 업데이트 로그의 HTTP 상태 코드와 응답 크기도 함께 확인하면 원인을 좁히기 쉽습니다.

노드를 바꿨는데 인터넷 속도가 그대로인 이유는 무엇인가요?

현재 트래픽이 선택한 그룹을 거치지 않고 DIRECT로 처리되고 있거나, 브라우저가 시스템 프록시를 사용하지 않을 수 있습니다. 정책 그룹에서 실제 선택 상태를 확인하고 macOS 네트워크 설정의 프록시 항목을 점검하세요. 특정 도메인만 규칙에 의해 다른 정책으로 분기되는 경우도 있습니다.

ClashX를 종료한 뒤 인터넷이 끊기면 어떻게 복구하나요?

macOS 「시스템 설정」의 네트워크 프록시 메뉴에서 HTTP와 HTTPS 프록시를 끄면 됩니다. ClashX가 종료되어 127.0.0.1:7890을 수신하지 않는 상태에서 시스템 프록시만 남아 있으면 연결이 실패할 수 있습니다. 다시 ClashX를 실행해 프록시를 켜거나, 사용하지 않을 때는 해당 항목을 꺼 두세요.

초보자도 TUN을 바로 켜야 하나요?

일반적인 브라우저와 시스템 프록시를 지원하는 앱만 사용할 때는 TUN이 필수는 아닙니다. 먼저 시스템 프록시 모드에서 구독, 노드 선택과 DNS가 정상인지 확인한 뒤 시스템 프록시를 사용하지 않는 프로그램이 필요할 때 TUN을 검토하세요. TUN을 켤 때는 macOS 네트워크 확장 권한과 라우팅 충돌을 함께 점검해야 합니다.

FlClash 다운로드 플랫폼별 클라이언트 보기