이 글이 맞는 검색 의도
ClashX 사용법을 처음 검색하는 macOS 사용자는 대개 앱을 실행하는 것보다 그다음 단계에서 막힙니다. 구독 제공자가 보낸 URL을 어디에 넣어야 하는지, 링크를 추가했는데도 노드 목록이 비어 있는 이유는 무엇인지, 여러 노드 중 어떤 서버를 골라야 하는지, 마지막으로 macOS 전체에 프록시를 어떻게 적용하는지가 한꺼번에 헷갈리기 때문입니다. ClashX는 메뉴 막대에서 빠르게 켜고 끌 수 있는 가벼운 클라이언트이지만, 프로필·노드·모드·시스템 프록시의 관계를 이해하지 못하면 “연결은 된 것 같은데 웹사이트가 열리지 않는” 상황을 만들 수 있습니다.
이 문서는 ClashX 구독 링크 추가를 시작으로 프로필 업데이트, 노드 선택, 모드 변경, macOS 프록시 활성화, 연결 확인과 문제 해결까지 실제 사용 순서에 맞춰 설명합니다. 구독 서비스마다 대시보드 이름이나 버튼 문구는 다를 수 있으므로 특정 제공자의 화면을 그대로 전제하지 않고, 대부분의 Clash 호환 구독에서 재사용할 수 있는 원칙을 중심으로 정리합니다. 구독 링크는 계정에 연결된 개인 정보이므로 공개 저장소나 채팅방에 붙여 넣지 않는 기본 보안 습관도 함께 다룹니다.
구독 링크를 넣기 전 확인할 사항
먼저 ClashX가 정상적으로 설치되어 실행 중인지 확인합니다. 앱을 열면 일반적인 창 대신 macOS 상단 메뉴 막대에 ClashX 아이콘이 나타나는 방식이 많습니다. 아이콘이 보이지 않는다면 응용 프로그램 폴더에서 다시 실행하고, 시스템 설정의 일반 → 로그인 항목에서 자동 실행이 차단되어 있지 않은지도 살펴보세요. 회사나 학교에서 관리하는 Mac은 시스템 프록시 변경 또는 네트워크 확장 권한이 제한될 수 있으므로, 권한 경고를 무조건 우회하기보다 관리 정책을 먼저 확인해야 합니다.
다음으로 구독 제공자 페이지에서 Clash 또는 YAML 형식을 지원하는 구독 URL을 복사합니다. 브라우저 주소창에 입력했을 때 사람이 읽는 웹페이지가 아니라 긴 텍스트나 설정 파일이 내려오는 URL이라면 구독 링크일 가능성이 높습니다. 반대로 로그인 화면 주소, 결제 페이지 주소, 일회성 인증 링크를 복사하면 ClashX에서 프로필을 읽지 못합니다. 제공자가 “Clash Meta”, “Mihomo”, “Clash-compatible”처럼 여러 형식을 보여 준다면 현재 ClashX가 사용하는 코어와 호환되는 항목을 고르는 것이 안전합니다.
구독 링크에는 노드 목록과 인증 정보가 포함될 수 있습니다. 따라서 다음과 같은 행동은 피하는 편이 좋습니다.
- 구독 URL을 GitHub 이슈, 공개 문서, SNS 게시물에 그대로 올리지 않습니다.
- URL을 다른 사람에게 전달했다면 제공자 패널에서 구독을 갱신하거나 폐기할 수 있는지 확인합니다.
- 트래픽 사용량과 만료일을 먼저 확인하고, 무료로 배포된 출처 불명의 링크는 사용하지 않습니다.
- 프로필 이름에 계정 이메일이나 실명을 넣기보다 기기와 용도를 구분할 수 있는 일반적인 이름을 사용합니다.
| 항목 | 확인할 내용 | 문제가 있을 때 보이는 증상 |
|---|---|---|
| 구독 형식 | Clash 또는 YAML 호환 여부 | 프로필 추가 실패, YAML 파싱 오류 |
| 주소 상태 | 로그인 페이지가 아닌 실제 구독 URL인지 | 다운로드된 설정이 없거나 HTML 문서가 표시됨 |
| 사용 기간 | 만료일과 남은 트래픽 | 노드는 보이지만 모든 연결이 거부됨 |
| 코어 호환성 | ClashX 버전이 설정 문법을 지원하는지 | 일부 옵션이 무시되거나 코어가 재시작됨 |
1단계: ClashX에 구독 링크와 프로필 추가하기
ClashX 메뉴 막대 아이콘을 클릭한 뒤 프로필 또는 설정에 해당하는 메뉴를 찾습니다. 버전에 따라 Config, Profiles, 설정 파일처럼 표시될 수 있지만, 핵심은 로컬 YAML 파일과 원격 구독 URL을 관리하는 화면입니다. 여기서 원격 프로필 추가, 구독 가져오기 또는 URL 등록과 비슷한 항목을 선택합니다. 입력 상자에 제공자로부터 받은 URL을 붙여 넣고, 구분하기 쉬운 이름을 지정한 뒤 저장합니다.
저장 직후 곧바로 프록시가 작동하는 것은 아닙니다. 구독 URL은 “설정을 가져오는 주소”일 뿐이며, ClashX가 그 주소에서 최신 YAML을 내려받아 로컬 프로필로 만들고 활성 프로필로 선택해야 합니다. 프로필 목록에 이름이 나타나면 해당 항목을 선택하고 Update, Update Profile 또는 새로 고침 아이콘을 눌러 노드와 규칙을 가져옵니다. 처음 업데이트할 때는 노드 수와 규칙 제공자 수에 따라 시간이 걸릴 수 있으므로 버튼을 여러 번 연속해서 누르지 않는 것이 좋습니다.
업데이트가 끝난 뒤에는 프로필 이름 옆에 성공 표시나 마지막 업데이트 시간이 보이는지 확인합니다. 노드 수가 0개이거나 오류 메시지가 나타나면 URL 형식, 구독 만료, 네트워크 연결, 코어 호환성을 차례로 점검합니다. 제공자가 여러 클라이언트용 링크를 제공한다면 “Surge”, “Quantumult”, “sing-box” 전용 URL을 ClashX에 넣은 것은 아닌지 확인하세요. 형식이 맞아 보여도 프록시 그룹과 규칙 문법이 달라 일부 항목이 제대로 로드되지 않을 수 있습니다.
프로필이 여러 개라면 한 번에 하나만 활성화합니다. 테스트용 YAML과 실사용 구독을 동시에 내려받았다고 해서 노드가 합쳐지는 것은 아니며, 현재 선택된 프로필에 들어 있는 규칙과 프록시만 실제 연결에 사용됩니다. 프로필 이름을 Home, Travel, Backup처럼 용도별로 정리하면 나중에 만료된 링크를 찾거나 교체하기가 쉽습니다.
2단계: 사용할 노드와 연결 모드 선택하기
프로필을 활성화하면 ClashX의 프록시 또는 노드 메뉴에서 여러 서버와 그룹을 볼 수 있습니다. 여기서 노드는 단순히 국가 이름만 보고 고르는 것이 아닙니다. 실제 체감 품질은 서버의 현재 부하, 거리, 회선 품질, 시간대별 사용자 수, 구독 제공자의 업스트림 구성에 따라 달라집니다. 같은 지역의 노드라도 이름에 붙은 숫자나 통신사 표기가 다르면 지연 시간과 스트리밍 안정성이 크게 달라질 수 있습니다.
처음에는 자동 선택 그룹이 있다면 그것을 사용해도 됩니다. 다만 자동 그룹이 어떤 기준으로 노드를 고르는지 알기 어렵거나 결과가 자주 바뀐다면, 몇 개의 후보를 직접 비교하는 편이 낫습니다. 메뉴에서 노드를 하나씩 선택한 뒤 연결 로그와 실제 웹페이지 로딩을 함께 확인하세요. 단순한 핑이 빠르더라도 TLS 연결이나 동영상 스트리밍이 불안정할 수 있으므로, 짧은 테스트와 장시간 사용을 나누어 판단해야 합니다.
- 지연 시간이 낮은 노드: 웹페이지, 원격 데스크톱, 실시간 입력처럼 반응성이 중요한 작업에 유리합니다.
- 대역폭이 안정적인 노드: 영상 시청, 대용량 다운로드, 클라우드 동기화에서 순간적인 속도 저하가 적습니다.
- 가까운 지역의 노드: 일반적으로 왕복 시간이 짧지만, 가까운 위치가 항상 가장 안정적이라는 뜻은 아닙니다.
- 백업 노드: 주 노드가 장애를 일으켰을 때 바로 전환할 수 있도록 최소 두 개 이상 기억해 둡니다.
모드도 함께 이해해야 합니다. Rule 모드는 설정 파일의 규칙에 따라 도메인별로 프록시와 직접 연결을 나눕니다. 국내 서비스나 사내 시스템은 직접 연결하고, 규칙에 지정된 사이트만 프록시로 보내고 싶을 때 적합합니다. Global 모드는 대부분의 트래픽을 선택한 프록시로 보내므로 테스트에는 편하지만, 국내 웹사이트·앱·업데이트 서버까지 우회하면서 속도나 로그인 동작에 영향을 줄 수 있습니다. Direct는 모든 연결을 프록시 없이 보내는 상태이므로, 프록시가 작동하지 않는지 비교할 때 유용합니다.
처음 설정할 때는 Rule 모드로 시작하고, 문제가 발생한 특정 사이트만 로그에서 확인하는 순서를 권합니다. Global 모드에서 모든 것이 우연히 열리더라도, 어떤 도메인이 실제로 프록시를 필요로 하는지 알 수 없고 불필요한 트래픽까지 우회하게 됩니다. 반대로 Rule 모드에서 사이트가 열리지 않는다면 잠시 Global로 바꾸어 노드 자체의 연결 문제인지 규칙 매칭 문제인지 분리할 수 있습니다.
3단계: macOS 시스템 프록시 켜기
노드와 모드를 골랐어도 macOS 시스템 프록시가 꺼져 있으면 Safari나 다른 앱이 ClashX를 사용하지 않을 수 있습니다. ClashX 메뉴에서 Set as System Proxy, Set Proxy 또는 시스템 프록시 활성화와 비슷한 항목을 켭니다. 메뉴 항목에 체크 표시가 생겼는지 확인한 뒤 브라우저를 새로 열어 테스트하세요. 앱마다 자체 프록시 설정을 사용하면 시스템 프록시를 따르지 않을 수 있으므로, 개발 도구나 메신저는 별도의 네트워크 설정도 확인해야 합니다.
macOS의 시스템 프록시는 일반적으로 HTTP와 HTTPS 연결에 영향을 줍니다. ClashX의 메뉴 막대 아이콘에 활성 상태가 표시되더라도, 실제로 어떤 포트를 사용하고 있는지와 해당 포트에서 코어가 대기 중인지가 중요합니다. 프로필을 바꾼 뒤 포트가 변경되었거나 코어가 재시작되었다면 시스템 프록시가 예전 포트를 가리킬 수 있습니다. 이때는 시스템 프록시를 한 번 껐다가 다시 켜고, 필요한 경우 ClashX를 재시작합니다.
시스템 프록시를 켠 뒤에는 먼저 일반 웹페이지를 열고, 다음으로 로그인이나 파일 업로드처럼 연결이 오래 유지되는 동작을 확인합니다. 모든 사이트를 한 번에 테스트하기보다 다음처럼 단계적으로 확인하면 원인을 좁히기 쉽습니다.
- ClashX 아이콘과 활성 프로필이 표시되는지 확인합니다.
- 선택한 노드가 프록시 그룹의 현재 항목으로 지정되어 있는지 봅니다.
- Rule 또는 Global 모드가 의도한 상태인지 확인합니다.
- macOS 시스템 프록시가 켜져 있는지 확인합니다.
- 브라우저에서 새 탭을 열고 연결 로그에 요청이 기록되는지 확인합니다.
HTTP_PROXY, HTTPS_PROXY 또는 도구별 프록시 옵션을 별도로 설정해야 합니다.
프로필 업데이트와 자주 발생하는 문제 해결
구독 프로필은 한 번 추가하고 끝나는 정적 파일이 아닙니다. 제공자가 노드를 교체하거나 만료된 서버를 제거할 수 있기 때문에 일정한 주기로 업데이트해야 합니다. 다만 업데이트할 때마다 현재 선택한 노드, 규칙 모드, 시스템 프록시 상태가 모두 초기화되는 것은 아니지만, 프로필 형식에 따라 그룹 이름이나 노드 이름이 바뀔 수 있습니다. 업데이트 후에는 선택된 프록시가 실제로 존재하는지 반드시 확인하세요.
업데이트 실패가 반복된다면 먼저 브라우저에서 구독 URL에 접근할 수 있는지 테스트합니다. 브라우저에서도 연결되지 않으면 링크 만료나 제공자 서버 장애일 수 있습니다. 브라우저에서는 텍스트가 내려오는데 ClashX만 실패한다면 URL에 불필요한 공백이 포함되었거나, ClashX의 코어가 해당 YAML 문법을 지원하지 않을 가능성이 있습니다. 새 버전으로 업데이트하기 전에 현재 프로필을 백업하거나 제공자에게 호환 클라이언트 정보를 문의하면 복구가 쉽습니다.
노드는 보이지만 연결이 되지 않을 때는 다음 세 가지를 분리해서 확인합니다. 첫째, 모든 노드가 실패하는지 특정 노드만 실패하는지 비교합니다. 특정 노드만 실패하면 다른 노드로 바꾸고 제공자의 장애 공지를 확인합니다. 둘째, Global에서는 되지만 Rule에서 실패하는지 봅니다. 이 경우 노드보다 규칙 그룹이나 도메인 매칭이 원인일 가능성이 큽니다. 셋째, ClashX 연결 로그에 요청 자체가 나타나는지 확인합니다. 요청이 보이지 않는다면 브라우저가 다른 프록시를 사용하거나 시스템 프록시가 꺼져 있을 수 있습니다.
DNS 관련 오류도 자주 발생합니다. 도메인 이름을 찾지 못하거나 특정 사이트만 오랫동안 대기한다면 DNS 요청이 직접 연결로 나가거나, 현재 노드가 사용하는 DNS 경로가 불안정할 수 있습니다. 이때 무작정 여러 설정을 동시에 바꾸기보다 먼저 다른 노드와 다른 모드를 비교하고, 최근에 구독 프로필이 변경되었는지 확인하세요. 설정을 수정했다면 한 번에 한 항목만 바꾸고 결과를 기록해야 무엇이 개선되었는지 알 수 있습니다.
보안을 위해 사용이 끝난 뒤에는 시스템 프록시를 계속 켜 둘 필요가 있는지도 판단하세요. 개인 Mac에서 항상 동일한 정책을 사용할 목적이라면 자동 실행과 프록시 유지를 선택할 수 있지만, 회사 네트워크나 사내 VPN을 이용할 때는 ClashX의 프록시와 VPN이 충돌할 수 있습니다. 내부 시스템 접속이 실패하거나 인증서 경고가 나타나면 우선 ClashX를 일시 중지하고 원래 네트워크에서 같은 문제가 재현되는지 비교하는 것이 안전합니다.
매일 사용할 때의 간단한 운영 체크리스트
ClashX를 안정적으로 사용하려면 복잡한 설정을 계속 만지기보다 일정한 확인 순서를 만드는 것이 좋습니다. 하루를 시작할 때 프로필의 마지막 업데이트 시간과 남은 구독 기간을 확인하고, 자주 쓰는 노드가 정상인지 짧은 요청으로 테스트합니다. 노드가 갑자기 느려졌다면 바로 모든 옵션을 변경하지 말고 백업 노드로 전환해 같은 사이트를 비교하세요. 이렇게 하면 제공자 문제인지 macOS 로컬 설정 문제인지 빠르게 나눌 수 있습니다.
프로필을 교체할 때는 기존 프로필을 즉시 삭제하지 않는 편이 좋습니다. 새 구독이 정상적으로 파싱되고 원하는 노드와 규칙이 보이는지 확인한 다음 이전 프로필을 정리하면, 제공자 링크가 잘못되었을 때 되돌아갈 수 있습니다. 또한 여러 구독을 동시에 활성화하려고 하기보다 용도별 프로필을 하나씩 관리하는 것이 좋습니다. 이름이 비슷한 프로필이 많으면 잘못된 링크를 업데이트하거나 오래된 노드를 선택하기 쉽습니다.
특히 공용 Wi-Fi에서는 노드 선택만큼 계정 보안과 HTTPS 사용 여부가 중요합니다. ClashX가 연결되어 있다고 해서 모든 통신이 자동으로 안전해지는 것은 아니며, 출처가 불명확한 구독 서버를 사용하면 트래픽 경로와 개인정보 처리 방식을 알기 어렵습니다. 신뢰할 수 있는 제공자를 선택하고, 중요한 서비스에는 다중 인증을 켜며, 민감한 계정의 로그인 상태를 공용 기기에 남기지 않는 기본 원칙을 지키세요.
단순한 메뉴 막대 프록시 앱은 설정 항목이 적어 처음에는 편하지만, 프로필 업데이트 방식이 제한되거나 노드별 로그와 규칙 분기를 충분히 보여 주지 않는 경우가 있습니다. 반대로 ClashX는 구독 링크를 한 번 등록한 뒤 프로필을 갱신하고, 노드·Rule·Global·시스템 프록시를 같은 흐름에서 조절할 수 있어 macOS에서 문제 원인을 단계적으로 확인하기 좋습니다. 여러 앱을 번갈아 설치해 설정을 다시 배워야 하는 상황보다 현재 연결 상태를 직접 확인하며 관리하고 싶다면, 이 방식이 더 예측 가능하므로 아래에서 플랫폼에 맞는 Clash를 받아 시작해 보세요.