본문으로 건너뛰기
ClashX · macOS 클라이언트 · mihomo 코어

ClashX 공식 사이트 · Clash 클라이언트
다운로드 및 설정

Clash 다운로드 가이드 보기

모든 플랫폼의 클라이언트를 모아 소개하고 구독 가져오기와 규칙 라우팅을 안내합니다. 설치부터 연결 확인까지 살펴보세요.

  • 오픈 소스 코드 · 프로젝트별 구현 확인
  • 공통 설정 · 코어 호환 범위 확인
  • 한국어 문서 · 단계별 설정 안내
Supported platforms Windows Android iOS macOS Linux

Client selection / 01

운영체제에 맞는 Clash 클라이언트 선택

ClashX는 macOS용입니다. 다른 운영체제에서는 해당 플랫폼용 Clash 클라이언트를 선택하세요. 처음 설치할 때는 CPU 아키텍처와 시스템 요구 사항을 먼저 확인하세요. GUI와 권한 요청, 설정 덮어쓰기 방식은 클라이언트마다 다르므로 다른 플랫폼의 메뉴 경로를 그대로 따라서는 안 됩니다.

Windows

먼저 Clash Plus를 살펴보고 Clash Verge Rev, FlClash, Clash Nyanpasu와 비교해 보세요. 기존 설정을 옮기기 전에는 사용 중인 클라이언트를 종료하고 남아 있는 시스템 프록시를 끄세요. 두 프로세스가 같은 포트를 사용하면 충돌할 수 있습니다.

다운로드 페이지로 이동 →

macOS

Apple Silicon용과 Intel용 설치 파일을 구분한 뒤 메뉴 막대 사용 방식에 맞는 클라이언트를 선택하세요. ClashX Meta는 지원이 중단된 아카이브 버전입니다. 새로 설치한다면 Clash Plus, Clash Verge Rev, FlClash를 비교해 보세요.

다운로드 페이지로 이동 →

Android

기기 아키텍처에 맞는 설치 파일을 선택하고 구독을 가져온 다음 VPN 연결을 허용하세요. 백그라운드에서 연결이 끊기면 배터리 최적화와 백그라운드 실행 권한을 확인하세요. 다른 VPN을 사용 중이라면 어느 연결을 유지할지 먼저 정해야 합니다.

다운로드 페이지로 이동 →

iOS

다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동하세요. 공식 사이트는 clashplus.io입니다. 설치 후 신뢰할 수 있는 구독을 가져오고 VPN 구성을 허용하세요. 데스크톱 클라이언트의 시스템 프록시 설정은 이 절차에 해당하지 않습니다.

다운로드 페이지로 이동 →

Linux

데스크톱에서는 Clash Verge Rev 또는 FlClash를 선택하고 배포판에 맞는 패키지 형식을 사용하세요. 서버나 라우터에서는 mihomo 코어를 별도로 배포할 수 있지만, 설정 디렉터리와 서비스 권한, 수신 주소를 직접 관리해야 합니다.

다운로드 페이지로 이동 →
모든 클라이언트 보기 → 클라이언트별 인터페이스와 사용 사례 비교

Configuration workflow / 02

구독, 규칙 및 네트워크 트래픽 처리 설정

먼저 설정을 정상적으로 불러온 다음 트래픽이 코어로 전달되는 방식과 규칙이 적용되는 과정을 확인하세요. 아래 항목은 사용 순서대로 정리했습니다. 항목을 선택하면 설정 위치와 클라이언트별 차이를 볼 수 있으며, 직접 전환하면 자동 재생이 중지됩니다.

구독 가져오기: 응답 내용부터 확인

구독은 노드와 정책 그룹, 규칙을 제공하며 클라이언트를 설치한다고 연결이 자동으로 만들어지지는 않습니다. 클라이언트의 ‘설정’ 또는 ‘구독’ 페이지에서 URL 가져오기를 선택하세요. 저장한 뒤 직접 업데이트하고 현재 설정으로 지정합니다. 파싱 오류가 나면 응답 내용이 호환되는 YAML인지, 로그인 페이지가 아닌지 먼저 확인하세요. 구독 변환, 요청 식별 정보, 업데이트 주기는 클라이언트마다 다릅니다. 같은 URL을 가져올 수 있는지는 현재 코어의 파싱 결과를 기준으로 판단하세요. 구독 URL에는 보통 인증 정보가 포함되므로 공개 로그에 올리지 마세요.

규칙 및 포트 설정 전체 안내 보기 →

First connection / 03

Clash 빠른 시작: 설치, 가져오기, 연결 확인

신뢰할 수 있는 구독 URL을 준비하고 현재 시스템 프록시 상태를 확인하세요. 처음 연결할 때는 필요한 설정만 변경합니다. 먼저 규칙 모드와 시스템 프록시를 사용해 웹사이트에 접속되는지 확인한 다음 앱에 필요한 경우 TUN이나 LAN 공유를 검토하세요.

Step 01 / Install

플랫폼과 아키텍처 선택

다운로드 페이지에서 시스템 요구 사항을 확인하고 CPU 아키텍처에 맞춰 설치하세요. 처음 실행할 때 설정 디렉터리에 쓰기 권한이 있는지 확인하고 다른 프록시 클라이언트는 종료하세요. 시스템에서 권한을 요청하면 용도를 먼저 확인하세요. 일반적인 가져오기 오류를 해결하려고 시스템 권한을 불필요하게 늘리지 마세요.

Step 02 / Import

설정 가져오기 및 활성화

설정 페이지에 구독 URL을 붙여 넣고 업데이트가 끝날 때까지 기다린 다음 현재 설정으로 선택하세요. 정책 그룹이 표시되는지, 그룹에 선택할 노드가 있는지 확인합니다. 목록이 비어 있으면 시스템 프록시를 켜도 설정 내용이 복구되지 않으므로 구독 업데이트 결과를 확인하세요.

Step 03 / Verify

프록시 켜고 규칙 적용 확인

규칙 모드를 선택하고 프록시 정책 그룹에 노드를 지정한 다음 시스템 프록시를 켜세요. 대상 사이트에 접속해 연결 상세 정보에서 적용된 규칙과 경로를 확인하고 직접 연결되어야 하는 대상도 테스트하세요. 브라우저 연결이 확인된 뒤 터미널이나 다른 앱의 프록시 설정을 별도로 점검하세요.

전체 가이드 보기 → 운영체제별 권한 및 설치 방법은 사용 문서에서 확인할 수 있습니다.

Source & maintenance / 04

ClashX, GUI 클라이언트와 mihomo 코어

클라이언트와 코어의 역할은 다릅니다

ClashX는 macOS 메뉴 막대용 클라이언트이며 Clash 생태계에는 다른 운영체제용 GUI도 있습니다. 클라이언트는 설정 가져오기, 시스템 프록시, 권한 요청, 인터페이스를 담당합니다. mihomo 코어는 프로토콜 연결, 규칙 매칭, 네트워크 처리를 담당합니다. Clash라는 이름이 붙은 구형 클라이언트가 모두 mihomo를 내장하는 것은 아니며, 화면만 보고 지원 프로토콜을 판단할 수도 없습니다.

Clash Meta는 이 코어 계열에서 과거에 사용한 이름이며 이후 mihomo라는 이름으로 개발이 이어졌습니다. 오래된 가이드의 프로젝트 이름, 설정 필드, 메뉴 화면은 현재 클라이언트와 다를 수 있습니다. 정보를 확인할 때는 실제로 실행 중인 코어와 클라이언트의 유지보수 상태를 기준으로 삼으세요. 특히 보관된 프로젝트의 과거 동작과 현재 유지보수 중인 프로젝트의 기능을 구분해야 합니다.

오픈 소스 코드와 라이선스 범위

mihomo 소스 저장소에서는 구현 코드와 이슈, 릴리스 정보를 공개하며 GPL-3.0 라이선스를 적용합니다. 이 라이선스 안내는 코어 프로젝트에 관한 것이며 모든 서드파티 클라이언트의 라이선스까지 보장하지는 않습니다. 개발자는 소스 코드와 설정 문서에서 동작을 확인할 수 있습니다. 일반 사용자는 클라이언트를 고를 때 해당 프로젝트의 시스템 요구 사항과 유지보수 안내도 확인해야 합니다.

코드가 공개되어 있어 구현을 확인할 수 있지만 구독 서비스에 대한 판단을 대신하지는 않습니다. 클라이언트 자체는 노드를 제공하지 않으며 노드 운영자, 구독 내용, 로컬 앱은 각각 다른 신뢰 경계를 가집니다. 원격 규칙 모음, 스크립트 또는 외부 제어 설정이 포함된 구성은 용도를 먼저 확인하세요. 관리 인터페이스는 필요한 범위에서만 열고 인증 정보를 공개 스크린샷에 포함하지 마세요.

업데이트 전 복구 가능한 상태 기록

클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 작업입니다. 구독을 업데이트하면 노드와 규칙이 바뀌지만 클라이언트가 업그레이드되는 것은 아닙니다. 클라이언트를 업그레이드해도 기존 로컬 덮어쓰기 설정은 남을 수 있습니다. 업데이트 전 설정과 확장 규칙을 백업하고 혼합 포트, 수신 주소, TUN, DNS 설정을 기록한 뒤 변경 사항을 확인하세요. 완료 후 설정 불러오기, 시스템 프록시, 직접 연결 대상 하나와 프록시 대상 하나를 다시 점검하세요.

다운로드 페이지에서 클라이언트 선택지와 유지보수 상태를 한눈에 확인할 수 있습니다. 홈페이지에는 소프트웨어 릴리스 정보를 고정해 두지 않습니다. 기능 차이가 있으면 먼저 해당 기능이 인터페이스와 코어 중 어디에서 구현되는지 확인한 뒤 클라이언트 안내나 코어 문서를 살펴보세요. 지원이 중단된 클라이언트는 기존 설정을 확인하는 용도로 참고하고, 과거 호환성을 새 시스템에서도 보장된다고 여겨서는 안 됩니다. 이전할 때는 기존 프로그램 폴더 전체를 복사하기보다 구독 출처와 로컬 규칙을 우선 보존하세요.

Configuration notes / 05

Clash 설정 및 문제 해결 가이드

구체적인 문제에 맞는 사용 안내를 확인하세요. 한 번에 한 항목만 조정하고 변경 전 설정을 보관한 뒤 같은 대상으로 다시 테스트하면 포트, 규칙, 상위 연결 중 어디에서 문제가 생겼는지 파악하기 쉽습니다.

전체 글 보기 →

Clash 다운로드