M1·M2·M3·M4 맥에 ClashX Pro를 설치할 때는 칩 종류만 확인하면 끝나는 것이 아닙니다. 설치 파일이 Apple 실리콘용인지 Intel용인지, 현재 macOS에서 실행 가능한지, 그리고 앱이 프록시 코어와 시스템 프록시를 정상적으로 제어할 수 있는지도 함께 살펴야 합니다. 특히 ClashX Pro는 오래된 설정이나 배포 파일을 안내하는 페이지가 검색 결과에 남아 있을 수 있으므로, 다운로드 출처와 앱의 서명 상태를 확인한 뒤 진행하는 편이 안전합니다.
이 가이드는 애플 실리콘 맥에서 설치 전 호환성을 확인하고, 앱을 실행해 설정을 불러온 다음 실제 연결까지 점검하는 순서로 설명합니다. macOS 버전이나 배포판에 따라 메뉴 이름과 권한 요청은 달라질 수 있습니다. 화면에 표시되는 안내가 이 글과 다르면 현재 설치한 앱의 메뉴와 macOS 설정을 기준으로 판단하세요.
M1·M2·M3·M4 맥에서 ClashX Pro 설치하는 법과 첫 설정 가이드
설치 전에 맥과 앱 호환성 확인
먼저 화면 왼쪽 위 Apple 메뉴에서 이 Mac에 관하여를 열어 칩 이름과 macOS 버전을 확인합니다. M1, M2, M3, M4는 모두 Apple 실리콘 계열이지만, 칩이 같아도 설치된 macOS 버전과 앱 빌드에 따라 실행 결과가 달라질 수 있습니다. 다운로드 파일 설명에 Apple 실리콘 또는 arm64라고 표시되어 있으면 네이티브 실행용이며, Intel 또는 x86_64라고 표시되어 있으면 Intel용 빌드입니다.
| 확인 항목 | 확인 방법 | 판단 기준 |
|---|---|---|
| 칩 종류 | Apple 메뉴 → 이 Mac에 관하여 | M1~M4면 Apple 실리콘 |
| 앱 아키텍처 | 다운로드 페이지의 파일 설명 또는 앱 정보 | arm64/Apple silicon 우선 |
| macOS 지원 범위 | 배포 페이지의 시스템 요구 사항과 릴리스 정보 | 현재 macOS 버전이 지원 목록에 있는지 확인 |
| 배포 파일 | 앱 이름, 게시자, 파일 형식 확인 | 출처와 서명이 확인되는 파일만 사용 |
Apple 실리콘용 빌드가 제공된다면 우선 해당 파일을 선택하세요. Intel용 앱도 Rosetta를 통해 실행될 수 있지만, 이는 앱과 그 안에서 사용하는 구성 요소까지 현재 macOS에서 호환된다는 보장은 아닙니다. macOS가 Rosetta 설치를 제안하면 화면의 절차에 따라 설치할 수 있습니다. 앱이 반복해서 종료되거나 코어를 시작하지 못한다면 Rosetta를 다시 설치하기 전에 지원되는 앱 빌드인지, 코어 파일이 함께 제공되는지부터 확인해야 합니다.
설치 파일 다운로드와 앱 설치
호환성을 확인한 뒤 신뢰할 수 있는 배포 경로에서 macOS용 설치 파일을 받습니다. 일반적으로 다운로드 파일은 .dmg 또는 압축 파일 형태이며, 배포 방식에 따라 설치 과정이 다를 수 있습니다. 설치 페이지에서 파일이 Apple 실리콘용인지 확인하고, 앱 이름이 ClashX Pro인지, 설명에 포함된 요구 사항이 현재 시스템과 맞는지 대조하세요. 클라이언트 선택이 어렵다면 클라이언트 목록에서 macOS용 선택지를 비교할 수 있습니다.
- 다운로드 폴더에서 파일을 엽니다. DMG라면 마운트된 창에서 앱을 확인하고, 압축 파일이라면 먼저 압축을 풉니다.
- 앱을 응용 프로그램으로 옮깁니다. 설치 창에 복사 안내가 있으면 그대로 따릅니다. 앱을 다운로드 폴더에서 직접 실행하는 것보다
/Applications에 복사하는 편이 관리와 권한 확인에 편리합니다. - 복사가 끝난 뒤 설치 파일을 닫습니다. DMG를 사용했다면 Finder 사이드바에서 마운트된 볼륨을 추출해도 됩니다. 응용 프로그램 폴더의 앱을 실행 대상으로 삼으세요.
- 첫 실행을 시도합니다. 앱이 네트워크 설정이나 보조 구성 요소를 요청하면 요청 내용과 게시자 정보를 확인한 다음 필요한 권한만 승인합니다.
macOS에서 앱을 열 수 없다는 경고가 나타날 수 있습니다. 먼저 앱을 응용 프로그램 폴더로 복사했는지, 다운로드한 파일이 손상되지 않았는지 확인하세요. 앱이 확인된 출처에서 받은 것이고 서명 정보도 일치한다고 판단한 경우에만 Finder에서 앱을 보조 클릭한 뒤 열기를 선택해 다시 실행해 볼 수 있습니다. 보조 클릭으로도 열리지 않으면 시스템 설정 → 개인정보 보호 및 보안에서 차단 알림과 허용 옵션을 확인하세요. macOS 버전에 따라 항목 이름이나 위치는 조금 다를 수 있습니다.
정체를 확인하지 못한 앱을 실행하기 위해 Gatekeeper를 전체 해제하거나, 터미널 명령으로 격리 속성을 무조건 제거하지 마세요. 이런 조치는 파일의 출처와 서명을 확인해 주지 않으며 시스템 보호를 약화할 수 있습니다. 경고가 계속되면 원래 배포 경로에서 파일을 다시 받거나, 현재 macOS를 지원하는 다른 클라이언트를 선택하는 것이 낫습니다.
첫 실행 후 설정과 구독 불러오기
ClashX Pro를 실행하면 메뉴 막대에 앱 아이콘이 나타날 수 있습니다. 아이콘을 열어 설정 가져오기, 프록시 그룹, 모드, 시스템 프록시와 연결 상태를 확인합니다. 메뉴 구성은 앱 빌드에 따라 다를 수 있으므로, 메뉴에 없는 기능을 임의로 다른 이름의 설정과 같은 것으로 간주하지 마세요. 먼저 앱 정보에서 버전과 코어 실행 상태를 확인하고, 오류가 있다면 로그에서 설정 파싱이나 코어 시작과 관련된 메시지를 살펴봅니다.
구독 URL 또는 설정 파일 가져오기
서비스 제공자가 구독 주소를 제공한다면 앱의 설정 가져오기 메뉴에서 URL을 추가하고 업데이트를 실행합니다. 구독이 로드된 뒤에는 프록시 목록과 정책 그룹이 표시되는지 확인하세요. 서비스가 완성된 Clash 형식 대신 노드 목록만 제공하는 경우, 클라이언트가 해당 형식을 처리할 수 있는지 또는 별도의 설정 구성이 필요한지 확인해야 합니다. 구독 업데이트가 성공했다는 알림만으로 규칙과 프록시 그룹까지 올바르게 생성되었다고 단정할 수는 없습니다.
로컬 YAML 파일을 사용하는 경우 파일 전체를 불러오고 앱이 설정을 읽었는지 확인합니다. 들여쓰기 오류, 지원되지 않는 필드 또는 존재하지 않는 정책 그룹 이름이 있으면 설정이 적용되지 않을 수 있습니다. 구독 URL에는 계정 접근에 필요한 비밀 값이 들어갈 수 있으므로 다른 사람에게 공유하거나 공개된 로그와 화면 캡처에 포함하지 마세요. 직접 설정을 수정할 때는 원본을 먼저 백업하고, 구독 관리 화면에서 편집한 변경이 다음 업데이트 때 덮어써지는지도 확인합니다.
모드와 프록시 그룹 선택
설정을 불러온 다음 모드가 규칙 모드인지 확인하고, 사용할 정책 그룹에서 접속 가능한 노드나 서비스가 제공하는 선택 항목을 지정합니다. 정책 그룹의 이름과 구성은 구독마다 다릅니다. 예를 들어 국가별 그룹, 자동 선택 그룹, 수동 선택 그룹이 각각 있을 수 있으므로 이름만 보고 동작을 추측하지 말고 그룹 안에 실제 노드가 표시되는지 확인하세요. 특정 사이트만 연결되지 않는 경우에는 전체 모드를 바꾸기 전에 연결 기록에서 해당 요청이 어떤 규칙과 그룹을 통과했는지 살펴보는 것이 좋습니다.
시스템 프록시를 켜고 연결 테스트
다음 절차는 설치 후 직접 확인할 수 있는 기본 테스트입니다. 먼저 구독을 업데이트하고 프록시 그룹에서 사용할 항목을 선택합니다. 이후 메뉴 막대에서 시스템 프록시를 활성화하고, 브라우저에서 새 페이지를 열어 봅니다. 연결이 되지 않는다면 노드 선택, 규칙 모드, 앱 실행 상태를 순서대로 확인하세요. 테스트 중 다른 VPN이나 프록시 앱이 실행 중이면 경로가 겹칠 수 있으므로 하나씩 꺼서 원인을 분리하는 편이 좋습니다.
- 코어와 설정 상태를 확인합니다. 앱 메뉴나 로그에 설정 로드 실패, 코어 시작 실패 또는 포트 사용 중 메시지가 없는지 살펴봅니다.
- 정책 그룹에서 노드를 선택합니다. 노드 지연 시간이나 연결 결과를 확인하고, 실제로 사용할 수 있는 항목을 고릅니다.
- 시스템 프록시를 켭니다. 메뉴에서 시스템 프록시 항목을 활성화하고 macOS가 네트워크 설정 변경을 요청하면 확인합니다.
- 브라우저와 연결 기록을 함께 확인합니다. 테스트 사이트에 접속한 뒤 앱의 연결 목록에 도메인과 적용 규칙이 나타나는지 확인합니다.
- 필요하면 로컬 포트로 별도 테스트합니다. 현재 설정에서 HTTP 또는 혼합 프록시 포트를 확인한 뒤 아래 예시의 포트 번호를 실제 값으로 바꿔 실행합니다.
curl -I -x http://127.0.0.1:7890 https://example.com
위 명령의 7890은 예시일 뿐이며 모든 설치에서 같은 포트가 사용되는 것은 아닙니다. 앱이나 적용 중인 설정에서 로컬 프록시 포트를 확인한 다음 명령을 실행하세요. 이 테스트가 성공하면 curl에서 로컬 포트까지 연결되고 프록시를 통한 요청도 처리된 것입니다. 브라우저만 실패한다면 브라우저의 별도 프록시 설정이나 확장 프로그램을 확인하고, 브라우저는 되지만 터미널은 실패한다면 터미널 도구가 시스템 프록시를 자동으로 사용하지 않는 경우를 고려해야 합니다.
시스템 프록시를 켰는데도 연결 목록에 테스트 요청이 나타나지 않으면 해당 앱이 macOS 프록시 설정을 따르지 않거나 다른 네트워크 도구가 요청을 처리하고 있을 수 있습니다. 요청은 기록에 나타나지만 시간 초과가 발생한다면 노드 상태, 규칙 결과와 원격 연결 상태를 확인합니다. connection refused가 표시되면 먼저 앱이 실행 중인지, 명령에 지정한 포트가 실제 리스닝 포트인지 확인하세요.
실행 및 연결 문제 점검
첫 실행에서 앱이 바로 종료되거나 메뉴 막대에 아이콘이 나타나지 않으면 응용 프로그램 폴더에 앱이 설치되었는지, macOS 버전이 지원 범위에 있는지, 아키텍처가 맞는지 다시 확인합니다. Intel용 앱이라면 Rosetta가 필요한지 확인하고, 코어 파일을 별도로 요구하는 배포판이라면 코어가 설치되어 있는지 살펴보세요. 앱 업데이트 뒤에만 문제가 시작되었다면 기존 설정이 새 코어에서 지원되지 않는 필드를 사용하는지도 로그에서 확인해야 합니다.
| 증상 | 우선 확인할 항목 | 다음 조치 |
|---|---|---|
| 앱이 열리지 않음 | 출처, 서명 경고, macOS 지원 범위, 앱 설치 위치 | 파일을 다시 받고 보안 설정의 차단 안내 확인 |
| 설정 로드 실패 | YAML 들여쓰기, 지원 필드, 그룹 이름 참조 | 로그에서 오류가 난 줄과 필드를 확인하고 백업 후 수정 |
| 브라우저 연결 실패 | 시스템 프록시 상태, 선택한 노드, 규칙 결과 | 다른 네트워크 도구를 잠시 끄고 연결 기록 확인 |
| 터미널만 연결되지 않음 | 실제 로컬 포트와 터미널의 프록시 처리 방식 | curl에 프록시 주소를 명시해 경로를 분리 테스트 |
| 기존 포트 사용 중 | 다른 Clash 계열 앱이나 프록시 프로세스 실행 여부 | 중복 앱을 종료하거나 서로 다른 포트를 사용 |
설정 파일을 바꿀 때는 원본을 보존하고 한 번에 한 항목씩 수정하세요. 여러 필드와 규칙을 동시에 바꾸면 문제가 해결된 원인을 찾기 어렵습니다. 앱 로그를 다른 사람에게 전달해야 한다면 구독 URL, 서버 주소, 비밀번호, 인증 토큰과 컨트롤 키를 반드시 가립니다. 로그에 개인 정보가 남을 수 있으므로 전체 파일을 그대로 공개 게시하는 것은 피하세요.
ClashX Pro가 현재 macOS에서 안정적으로 실행되지 않거나 필요한 기능을 제공하지 않는다면, 구형 앱을 억지로 우회 실행하기보다 유지보수 상태와 Apple 실리콘 지원을 확인해 대안을 선택하는 것이 안전합니다. 클라이언트별 설치 절차와 사용 환경은 설치 안내에서 확인할 수 있습니다.