설치 전 Intel Mac과 macOS 호환성 확인
ClashX Pro를 설치하기 전에 먼저 사용하는 Mac이 Intel 모델인지 확인하세요. 화면 왼쪽 위의 「Apple 메뉴」→「이 Mac에 관하여」를 열었을 때 프로세서 항목에 Intel Core 또는 Intel 프로세서가 표시되면 Intel용 설치 파일을 선택해야 합니다. “칩” 항목에 Apple M1, M2, M3, M4가 표시되는 Apple Silicon Mac용 패키지와 Intel용 패키지는 실행 구조가 다르므로, 파일 이름에 Intel, x86_64 또는 x64가 포함되어 있는지 확인하는 것이 좋습니다.
| 확인 항목 | Intel Mac에서 볼 내용 | 잘못 선택했을 때 |
|---|---|---|
| 프로세서 | Intel Core, Intel 프로세서 | Apple Silicon 전용 앱은 실행되지 않거나 추가 변환이 필요할 수 있음 |
| 설치 파일 | Intel, x86_64, x64 표기 | 앱이 즉시 종료되거나 “이 앱을 열 수 없음” 알림이 표시됨 |
| macOS 버전 | 「이 Mac에 관하여」에서 현재 버전 기록 | 오래된 클라이언트와 최신 macOS 사이에 서명·권한 문제가 생길 수 있음 |
| 기존 프록시 | 다른 Clash 클라이언트의 실행 여부 확인 | 포트 충돌 또는 시스템 프록시가 엉뚱한 앱을 가리킬 수 있음 |
ClashX Pro는 macOS용 구형 클라이언트 계열이므로 최신 macOS에서 모든 기능이 동일하게 동작한다고 보장하기 어렵습니다. 특히 Apple이 앱 서명, 로그인 항목, 시스템 확장과 네트워크 권한 정책을 변경하면 과거에 정상적으로 실행되던 버전도 권한 승인 단계에서 멈출 수 있습니다. 설치 파일을 받기 전에 현재 macOS 버전과 Intel 아키텍처를 기록하고, 문제가 발생했을 때 원인을 추적할 수 있도록 설치 파일 이름도 함께 보관하세요.
설치 파일 다운로드와 응용 프로그램 폴더 이동
설치 파일은 출처가 분명한 배포 페이지에서 받아야 합니다. 파일 이름만 보고 “Pro” 버전인지 판단하지 말고, 압축 파일 안에 실제로 ClashX Pro.app이 포함되어 있는지 확인하세요. 광고가 많은 미러 페이지나 이름이 비슷한 수정 배포본은 원치 않는 구성 요소를 포함할 수 있으므로 피하는 편이 안전합니다. 필요한 경우 다운로드 확인에서 macOS용 항목과 지원 아키텍처를 먼저 확인하세요.
- 다운로드가 끝나면 Finder의 「다운로드」 폴더를 열고 DMG 또는 ZIP 파일을 찾습니다.
- ZIP 파일은 macOS 기본 압축 해제 기능으로 풀고, DMG 파일은 두 번 클릭해 마운트합니다.
ClashX Pro.app을 Finder의 「응용 프로그램」 폴더로 드래그합니다.- DMG 창이 열려 있다면 추출이 끝난 뒤 Finder에서 꺼내기 아이콘을 눌러 마운트를 해제합니다.
- 다운로드 폴더나 DMG 내부에서 계속 실행하지 말고 「응용 프로그램」 안의 앱을 실행합니다.
앱을 매번 다른 위치에서 실행하면 macOS가 서로 다른 앱 복사본으로 인식할 수 있습니다. 그 결과 방화벽, 키체인 또는 시스템 확장 권한을 반복해서 요청할 수 있습니다. 설치 후에는 Finder에서 앱을 선택하고 command + I를 눌러 위치가 /Applications 또는 한국어 macOS의 「응용 프로그램」 폴더인지 확인하세요.
응용 프로그램/
└── ClashX Pro.app
이전에 설치한 ClashX Pro가 있다면 곧바로 새 파일을 덮어쓰지 마세요. 메뉴 막대의 ClashX Pro 아이콘에서 「Quit」 또는 「종료」를 선택하고, 시스템 환경설정의 프록시도 끈 다음 새 앱을 복사하는 순서가 안전합니다. 앱을 교체한 뒤에도 이전 프로세스가 남아 있으면 새 버전이 시작되지 않거나 예전 설정이 계속 적용될 수 있습니다.
처음 실행할 때 Gatekeeper 차단 처리
인터넷에서 다운로드한 앱을 처음 열면 macOS가 개발자 확인, 앱 서명 또는 다운로드 출처를 이유로 실행을 막을 수 있습니다. “개발자를 확인할 수 없습니다”, “확인되지 않은 개발자”와 같은 메시지가 표시되더라도 무작정 보안 기능을 해제하지 마세요. 먼저 파일이 Intel용인지, 앱 이름과 다운로드한 파일이 일치하는지, 압축 해제가 정상적으로 끝났는지 확인해야 합니다.
- Finder의 「응용 프로그램」 폴더에서 ClashX Pro를 찾습니다.
- Control 키를 누른 채 앱을 클릭하고 「열기」를 선택합니다.
- 경고 창에 앱 이름이 정확히 표시되는지 확인한 뒤 다시 「열기」를 누릅니다.
- 차단이 계속되면 「시스템 설정」 또는 구형 macOS의 「시스템 환경설정」을 엽니다.
- 「개인정보 보호 및 보안」으로 이동해 차단된 앱 관련 「그래도 열기」 항목이 있는지 확인합니다.
「그래도 열기」 버튼은 앱을 방금 실행하려고 시도한 뒤에만 표시되는 경우가 있습니다. 버튼이 보이지 않으면 설정 화면을 반복해서 열기보다 Finder에서 응용 프로그램을 다시 실행해 차단 기록을 만든 다음 보안 설정으로 돌아가세요. 회사나 학교에서 관리하는 Intel Mac은 MDM 정책으로 이 버튼이 숨겨져 있을 수 있습니다. 이런 경우에는 관리자 승인 없이 로컬 설정만으로 해결할 수 없습니다.
권한 승인과 메뉴 막대 아이콘 확인
ClashX Pro가 정상적으로 실행되면 일반적인 앱처럼 큰 설정 창만 표시되는 것이 아니라 macOS 메뉴 막대에 아이콘이 나타납니다. 메뉴 막대에 아이콘이 없으면 앱이 실행되지 않았거나, 메뉴 막대 공간 부족으로 숨겨졌거나, 백그라운드 프로세스가 시작 직후 종료된 것일 수 있습니다. 먼저 「응용 프로그램」에서 앱을 다시 열고, 활성 상태가 유지되는지 확인하세요.
| 확인 대상 | 정상적인 상태 | 문제 발생 시 조치 |
|---|---|---|
| 메뉴 막대 아이콘 | ClashX Pro 메뉴가 열리고 상태 항목이 표시됨 | 앱 재실행, 메뉴 막대 공간 확인, 충돌 로그 확인 |
| 시스템 프록시 | 활성 네트워크 서비스에 프록시가 설정됨 | 현재 사용 중인 Wi-Fi 또는 Ethernet 서비스가 맞는지 확인 |
| 로컬 포트 | 설정한 포트에서 HTTP·SOCKS 요청을 수신함 | 다른 프록시 앱과 포트가 겹치는지 확인 |
| 로그 | 코어 시작과 설정 로드 기록이 나타남 | YAML 구문, 포트, 구독 파일 경로를 점검 |
처음부터 TUN이나 투명 프록시를 활성화할 필요는 없습니다. 브라우저와 대부분의 macOS 앱은 시스템 프록시만으로 먼저 연결을 테스트할 수 있습니다. TUN은 시스템 프록시를 사용하지 않는 프로그램까지 처리하기 위한 기능이며, 가상 네트워크 인터페이스와 라우팅 권한이 추가로 필요합니다. 설치가 끝났는지 확인하는 단계에서는 기능을 최소화하는 것이 오류 범위를 줄이는 데 유리합니다.
macOS가 관리자 암호, 네트워크 구성 변경 또는 키체인 접근을 요청하면 팝업의 대상 앱과 요청 내용을 확인하세요. 알 수 없는 다른 앱 이름이 표시되거나, 설치와 관계없는 민감한 권한을 요구한다면 승인하지 말고 앱을 종료한 뒤 설치 파일 출처를 다시 확인해야 합니다. 키체인 승인 창에서는 “항상 허용”을 바로 선택하기보다 한 번 허용으로 동작을 확인하는 편이 안전합니다.
구독 가져오기와 기본 설정 구성
ClashX Pro를 실행한 뒤에는 먼저 사용할 설정 또는 구독을 추가해야 합니다. 구독 URL은 프록시 노드와 정책 그룹을 생성하는 인증 주소이므로 다른 사람에게 공개하지 마세요. 메뉴 막대의 ClashX Pro 메뉴에서 설정 관리 또는 프로필 관련 항목을 찾아 URL을 추가하고, 다운로드가 끝난 뒤 해당 설정을 활성 프로필로 선택합니다. 메뉴 명칭은 앱 빌드와 macOS 언어 설정에 따라 조금 다를 수 있지만, 핵심 순서는 “URL 추가 → 설정 다운로드 → 프로필 선택 → 코어 시작”입니다.
- 서비스 제공자가 발급한 Clash 또는 Clash Meta 호환 구독 URL을 복사합니다.
- ClashX Pro의 설정 또는 프로필 메뉴에서 URL을 추가합니다.
- 다운로드가 끝나면 HTTP 상태 오류나 YAML 파싱 오류가 없는지 확인합니다.
- 가져온 프로필을 현재 사용 설정으로 선택합니다.
- 메뉴에서 코어 또는 프록시 시작 항목을 활성화합니다.
ClashX Pro의 코어가 구독에 포함된 모든 기능을 해석할 수 있는 것은 아닙니다. 구독에 hysteria2, tuic, vless, 복잡한 rule-providers 또는 mihomo 전용 필드가 포함되어 있다면 구형 코어에서 일부 노드가 사라지거나 설정 로드가 실패할 수 있습니다. 설정을 가져온 뒤 노드 목록이 비어 있거나 “unsupported proxy type”이 표시되면 구독 서비스에서 클래식 Clash 형식 또는 호환성이 높은 프로필을 제공하는지 확인하세요.
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
external-controller: 127.0.0.1:9090
7890은 예시 포트일 뿐이며 현재 설정에 실제로 표시된 값을 사용해야 합니다. 시스템 프록시 설정에는 제어 포트인 9090이 아니라 HTTP 또는 mixed 포트를 입력해야 합니다. 제어 인터페이스는 클라이언트와 코어가 상태와 정책을 주고받는 용도이므로 웹 브라우저의 프록시 주소로 사용하면 연결이 되지 않습니다.
시스템 프록시 활성화와 연결 테스트
설정이 선택되고 코어가 실행되었다면 메뉴 막대에서 시스템 프록시 사용 항목을 활성화합니다. macOS의 네트워크 설정에서 직접 확인하려면 「시스템 설정」→「네트워크」→현재 연결 중인 「Wi-Fi」 또는 「Ethernet」→「세부사항」→「프록시」로 이동합니다. 구형 macOS에서는 「시스템 환경설정」→「네트워크」→서비스 선택→「고급」→「프록시」 순서로 접근할 수 있습니다.
일반적으로 HTTP 프록시와 HTTPS 프록시에 같은 로컬 주소와 포트를 입력합니다. ClashX Pro가 SOCKS 프록시도 제공한다면 SOCKS 프록시 항목은 별도의 SOCKS 포트를 사용해야 합니다. 모든 프록시 종류를 무조건 체크하면 일부 앱에서 예상하지 못한 동작이 발생할 수 있으므로, 먼저 클라이언트가 안내하는 포트만 사용하세요.
| 테스트 순서 | 확인 방법 | 판단 기준 |
|---|---|---|
| 코어 상태 | 메뉴 막대에서 실행·활성 상태 확인 | 중지 상태이면 연결 테스트를 진행하지 않음 |
| 노드 상태 | 프록시 목록 또는 지연 시간 테스트 실행 | 모든 노드가 실패하면 구독, DNS, 서버 상태를 점검 |
| 브라우저 접속 | HTTPS 웹사이트 한 곳과 일반 HTTP 사이트 한 곳 접속 | 둘 다 열리는지 확인 |
| 실제 적용 | 시스템 프록시를 끈 뒤 접속 결과 비교 | 꺼졌을 때만 실패하면 시스템 프록시가 적용된 것 |
터미널에서 로컬 포트가 열려 있는지도 확인할 수 있습니다. 아래 명령에서 포트 번호는 실제 설정값으로 바꾸세요.
nc -vz 127.0.0.1 7890
curl -I --proxy http://127.0.0.1:7890 https://example.com
nc가 연결 성공을 표시하면 해당 포트에서 무언가 수신 중이라는 뜻입니다. 이것만으로 원격 프록시가 정상이라는 의미는 아니므로, 이어서 브라우저 접속과 ClashX Pro 로그를 함께 확인해야 합니다. 브라우저는 열리지만 터미널 명령만 실패한다면 터미널 프로그램이 시스템 프록시를 자동으로 사용하지 않는 경우일 수 있습니다. 반대로 모든 프로그램이 실패한다면 노드 연결, DNS 또는 구독 설정을 먼저 점검하세요.
자주 발생하는 문제와 안전한 복구 순서
Intel Mac에서 설치 후 가장 흔한 문제는 아키텍처 불일치, Gatekeeper 차단, 다른 프로그램과의 포트 충돌, 구독 형식 오류입니다. 문제를 해결할 때 여러 설정을 동시에 바꾸면 원인을 찾기 어려우므로, 아래 순서처럼 앱 실행, 코어, 포트, 시스템 프록시, 원격 노드 단계를 분리해서 확인하세요.
- 앱이 열리지 않음: Intel용 파일인지 확인하고 앱을 「응용 프로그램」 폴더로 다시 복사합니다. 다운로드 파일이 손상되었을 가능성도 있으므로 재다운로드 후 비교하세요.
- 메뉴 막대 아이콘이 없음: 앱이 시작 직후 종료되었는지 확인하고, 다른 Clash 클라이언트를 모두 종료한 뒤 다시 실행합니다.
- 포트가 이미 사용 중임: 이전 Clash 프로세스나 다른 프록시 도구를 종료하고, 필요하면 mixed-port를 사용하지 않는 포트로 변경합니다.
- 프로필 다운로드 실패: URL 만료, 토큰 누락, HTTP 403·404·429, DNS 오류를 확인합니다. 브라우저에서 로그인 HTML이 내려오는 주소는 Clash 설정으로 사용할 수 없습니다.
- 노드는 보이지만 연결되지 않음: 구독이 클래식 Clash 코어에서 지원되지 않는 프로토콜을 포함했는지, 서버 인증서와 시간 설정이 올바른지 확인합니다.
- 인터넷이 전부 끊김: 메뉴 막대에서 시스템 프록시를 먼저 끄고, 코어 로그와 현재 활성 프로필을 확인합니다. 복구 후 원인을 하나씩 재현하세요.
설치를 마친 뒤에는 앱의 자동 시작 여부와 자동 업데이트 동작도 확인하세요. 메뉴 막대에 항상 표시되기를 원한다면 로그인 시 실행 항목을 사용할 수 있지만, 먼저 수동 실행과 연결 테스트가 안정적인지 확인하는 것이 좋습니다. ClashX Pro가 오래된 클라이언트라는 점을 고려하면 최신 macOS 보안 정책이나 새로운 구독 프로토콜과의 호환성이 제한될 수 있습니다. 장기적으로 최신 macOS와 새로운 프로토콜을 함께 사용해야 한다면 유지보수되는 클라이언트로 이전하는 것도 검토하세요.