설치 파일 · 플랫폼 및 아키텍처

Clash 다운로드 및 클라이언트 선택

운영체제를 먼저 고른 뒤 설치 파일을 선택하세요. 구독 가져오기와 규칙 설정은 설치 후 진행하면 됩니다.

데스크톱과 모바일에서는 GUI 클라이언트를 사용하고, 서버·라우터·명령줄 환경에서는 Mihomo 커널을 확인하세요. 다운로드 링크는 플랫폼별로 정리했으며, 구형 클라이언트는 유지 관리 상태를 별도로 표시합니다.

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

처음이라면 우선 추천 클라이언트부터 사용해 보세요. 설치 전에 시스템 아키텍처를 확인하고, 클라이언트를 바꾸기 전에는 로컬 설정을 백업하세요. 한 기기에서 테스트할 때는 프록시나 TUN을 제어하는 클라이언트를 하나만 실행하세요.

Windows 설치 파일

이 섹션의 GUI 클라이언트는 x64 설치 파일을 제공합니다. 먼저 「설정 → 시스템 → 시스템 정보」에서 시스템 종류를 확인한 다음 클라이언트를 선택하세요. Windows on ARM 기기에서는 x64 앱 호환 여부를 따로 확인해야 합니다. 시스템 이름만으로 실행 가능 여부를 판단할 수 없습니다.

Clash Verge Rev

구독, 규칙, 데스크톱 프록시 설정을 관리해야 한다면 선택할 수 있습니다. 설치 후 현재 활성화된 설정을 확인하고 시스템 프록시가 켜져 있는지 살펴보세요. 서비스 모드와 TUN은 시스템 권한이 필요하므로 기본 연결이 정상적으로 작동한 뒤 하나씩 활성화하는 것이 문제를 찾기 쉽습니다.

EXE 설치 파일

FlClash

여러 기기에서 비슷한 방식으로 사용하고 싶다면 FlClash를 고려해 보세요. 구독을 가져온 뒤 설정을 선택하고 정책 그룹에서 연결할 노드를 고르세요. 이전할 때는 설정 파일과 클라이언트 옵션을 각각 확인해야 합니다. 시스템 프록시, 시작 시 실행 등의 설정은 보통 다시 점검해야 합니다.

EXE 설치 파일 · amd64와 x64는 같은 계열의 아키텍처 표기입니다

Clash Nyanpasu

데스크톱 클라이언트의 다른 인터페이스를 원하거나 기존 설정 파일을 비교해 사용하려는 경우에 적합합니다. 전환하기 전 기존 클라이언트를 종료해 두 프로그램이 동시에 시스템 프록시를 변경하지 않도록 하세요. 기존 포트가 사용 중이라면 반복해서 재설치하기보다 어떤 프로세스가 포트를 점유했는지 먼저 확인하세요.

EXE 설치 파일

Clash for Windows

유지 관리 중단

기존 환경 이전이나 과거 설정 참고를 위한 보관용 다운로드입니다. 새로 설치할 때는 위쪽의 클라이언트를 우선 선택하세요. 구버전은 새로운 프록시 프로토콜이나 설정 필드를 인식하지 못할 수 있습니다. 구문 분석 오류가 발생하면 지원되는 커널 범위를 확인하고, 오류가 난 필드를 모두 삭제하지 마세요.

구형 클라이언트 · 이전 전에 로컬 설정 내보내기

Windows 시스템 요구 사항 및 설치 확인

확인 항목선택 기준
프로세서이 섹션에서는 x64 GUI 클라이언트를 제공합니다. 32비트 시스템에서는 사용할 수 없습니다.
시스템 버전설치 프로그램의 안내를 따르세요. 구형 Windows에서는 런타임과 클라이언트의 지원 범위를 확인해야 합니다.
권한일반적인 앱 실행과 서비스 설치에는 서로 다른 권한이 필요합니다. 서비스나 TUN을 활성화할 때는 시스템 안내에 따라 권한을 허용하세요.
설치 후먼저 설정을 가져와 규칙 모드를 테스트한 다음 시작 시 자동 실행과 백그라운드 실행을 설정하세요.
서버 / 라우터 / 명령줄

Mihomo 커널 다운로드

커널은 설정을 해석하고 연결을 처리하지만 데스크톱용 전체 조작 화면은 제공하지 않습니다. 일반 사용자는 위의 GUI 클라이언트로 충분합니다. 직접 배포하려면 config.yaml, 실행 옵션, 작업 디렉터리, 서비스 관리 방법을 별도로 준비해야 합니다.

플랫폼아키텍처 / 형식설치 파일
WindowsAMD64 · ZIPAMD64 ZIP 다운로드
WindowsARM64 · ZIPARM64 ZIP 다운로드
macOSIntel AMD64 · GZIntel GZ 다운로드
macOSApple Silicon ARM64 · GZApple Silicon GZ 다운로드
LinuxAMD64 · DEBAMD64 DEB 다운로드
LinuxAMD64 · GZAMD64 GZ 다운로드
LinuxARM64 · GZARM64 GZ 다운로드
LinuxARMv7 · GZARMv7 GZ 다운로드
LinuxMIPS softfloat · GZMIPS softfloat GZ 다운로드

아키텍처를 확인한 뒤 배포하세요

Linux나 라우터에서 uname -m으로 기기 종류를 확인한 다음 기기 문서에서 ABI를 확인하세요. MIPS는 엔디언과 부동소수점 방식도 확인해야 합니다. 표의 MIPS softfloat 패키지가 모든 MIPS 기기에서 작동하는 것은 아닙니다. 아키텍처가 비슷해도 바이너리 호환성이 보장되지는 않으므로 실행 형식 오류가 발생하면 먼저 패키지 선택을 점검하세요.

설정 테스트를 통과한 뒤 트래픽을 넘기세요

ZIP은 압축을 풀고 GZ는 압축 해제하세요. Unix 계열 시스템에서는 실행 권한도 확인해야 합니다. 설정을 준비한 뒤 mihomo -t -f config.yaml으로 구문 분석을 테스트할 수 있습니다. 테스트 통과는 설정을 읽을 수 있다는 뜻일 뿐입니다. DNS, 라우팅, 정책 출구도 확인하세요. 필드 설명은 YAML 구조 참고를 참조하세요.

다운로드 후: 설치, 가져오기 및 확인

최소한의 설정으로 먼저 정상 작동을 확인한 뒤 시작 시 자동 실행, TUN, 사용자 지정 규칙을 추가하세요. 한 번에 한 항목씩 변경하면 문제가 프로그램, 설정, 네트워크 환경 중 어디에서 발생했는지 파악하기 쉽습니다.

  1. 설치 파일과 시스템의 호환성 확인

    다운로드가 끝나면 파일 확장자를 확인하세요. Windows는 이 섹션의 EXE, macOS는 DMG, Android는 APK를 사용하고, Linux는 배포판에 맞춰 DEB 또는 RPM을 선택합니다. 설치 파일 대신 웹페이지가 다운로드됐다면 이 페이지로 돌아와 올바른 링크를 선택하세요. 확장자만 바꿔 억지로 설치하지 마세요. 시스템 차단이나 호환성 안내가 표시되면 전체 문구를 기록한 뒤 아키텍처, 시스템 버전, 권한 중 무엇이 원인인지 확인하세요.

  2. 구독 또는 로컬 설정 가져오기

    설치 파일에는 프로그램만 포함되며 구독과 프록시 노드는 직접 준비해야 합니다. 클라이언트의 설정, 구독 또는 Profile 화면에서 구독 주소 전체를 붙여 넣거나 로컬 YAML을 가져오세요. 완료 후 해당 설정이 선택되어 있는지 확인하세요. 다운로드 완료 메시지만으로 새 설정이 적용된 것은 아닙니다. 자세한 방법은 Clash 구독 링크 가져오기를 참조하세요. 개인 정보가 포함된 링크는 신뢰할 수 있는 곳에 보관하고, 화면을 캡처하거나 도움을 요청할 때는 링크를 가리세요.

  3. 모드를 선택하고 연결 경로를 확인하세요

    일반적으로 먼저 mode: rule을 사용하세요. proxy-groups에 지정된 정책 그룹으로 이동해 수동으로 선택한 노드가 작동하는지 확인한 다음 시스템 프록시나 모바일 연결을 활성화하세요. 규칙은 순서대로 적용되며, 마지막의 MATCH는 다른 규칙에 해당하지 않는 트래픽의 경로를 결정합니다. 연결은 되지만 일부 앱이 프록시를 거치지 않는다면 먼저 해당 앱이 시스템 프록시를 사용하는지 확인하세요. 그다음 TUN을 고려하고, 두 가지 트래픽 처리 방식을 혼동하지 마세요.

  4. 검증을 마친 뒤 장기 사용 설정을 옮기세요

    실제 사용하는 앱으로 연결을 확인하고 로그에서 도메인 매칭과 연결 정책을 살펴보세요. 지연 시간 테스트는 특정 요청의 결과만 보여 줄 뿐 실제 사용 검증을 대신할 수 없습니다. 기본 연결이 정상임을 확인한 뒤 사용자 지정 규칙, 백그라운드 실행, 시작 시 자동 실행을 복원하세요. 클라이언트를 바꿀 때는 구독과 로컬 오버라이드부터 옮기고 데이터 폴더 전체를 그대로 복사하지 마세요. 설정 병합, 캐시, 권한 처리 방식은 클라이언트마다 다릅니다.

다운로드 및 설치 FAQ

이 섹션에서는 패키지 선택과 설치 문제를 다룹니다. 구독 변환, 연결 오류, 규칙 문제는 문제 해결에서 확인할 수 있습니다.

처음 설치한다면 클라이언트와 Mihomo 커널 중 무엇을 선택해야 하나요?

일반적인 데스크톱과 모바일 환경에서는 GUI 클라이언트를 선택하세요. 처음이라면 Clash Plus부터 시작할 수 있습니다. Mihomo 커널은 주로 서버, 라우터 또는 설정 파일을 직접 관리하는 사용자를 위한 것으로, 별도로 설정 파일과 실행 방법을 준비해야 합니다.

arm64, x64, 범용 버전 중 어떤 것을 선택해야 하나요?

먼저 시스템 정보에서 프로세서 아키텍처를 확인하세요. x64와 amd64는 보통 같은 아키텍처를 가리키며, arm64는 64비트 ARM 플랫폼입니다. Android에서 ABI를 모른다면 범용 버전을 고려할 수 있습니다. macOS 일부 다운로드는 현재 x64 파일을 제공합니다. Apple Silicon에서 사용하기 전에 시스템 호환성과 Rosetta 지원 여부를 확인하세요.

클라이언트를 설치한 뒤 구독을 가져와야 하는 이유는 무엇인가요?

설치 파일에는 클라이언트 프로그램만 포함되며, 바로 사용할 수 있는 프록시 설정까지 제공되는 것은 아닙니다. 직접 준비한 구독이나 로컬 YAML을 가져와 해당 설정을 활성화한 다음, 정책 그룹 선택과 실행 모드를 확인해야 합니다. 구독 링크에 개인 접속 정보가 포함되어 있다면 공개적으로 공유하지 마세요.

다운로드가 중단되거나 설치 파일이 열리지 않을 때 무엇부터 확인해야 하나요?

먼저 다운로드가 완료됐는지, 파일 확장자가 시스템에 맞는지 확인하고 웹페이지로 저장된 것은 아닌지 살펴보세요. 이어서 프로세서 아키텍처, 남은 저장 공간, 시스템 설치 안내를 확인합니다. 다시 다운로드해도 실패한다면 정확한 오류 문구를 기록해 안내에 따라 해결하세요. 시스템 보안 기능을 무작정 끄지 마세요.

클라이언트를 업그레이드하거나 바꾸기 전에 무엇을 백업해야 하나요?

구독 주소, 로컬 YAML, 오버라이드 규칙, 유지할 정책 그룹 선택을 백업하세요. 클라이언트마다 데이터 디렉터리와 오버라이드 처리 방식이 다를 수 있으므로 프로그램 폴더 전체를 그대로 덮어쓰지 않는 것이 좋습니다. 먼저 설정을 내보내고 기존 클라이언트를 종료한 다음 새 클라이언트를 설치해 확인하세요.

Clash for Windows와 ClashX Meta를 새로 설치해도 괜찮나요?

두 클라이언트 모두 유지 관리가 중단되었습니다. 다운로드 링크는 기존 환경 이전이나 과거 설정을 참고할 때 사용하세요. 새로 설치한다면 현재 시스템과 호환되는 클라이언트를 우선 선택하세요. 구버전은 최신 프로토콜, 구독 필드 또는 시스템 권한을 제대로 지원하지 않을 수 있으므로, 실행 결과만으로 모든 설정의 유효성을 판단할 수 없습니다.