Clash 전체 플랫폼 클라이언트 다운로드 및 설정 핸드북

Windows / macOS / Android / iOS / Linux 5개 플랫폼을 모두 지원하며, 클라이언트 다운로드, 구독 가져오기, 규칙 분기까지 다루는 완전한 한국어 가이드를 제공합니다.

Clash 다운로드 튜토리얼 보기
  • 전체 플랫폼 클라이언트
  • 오픈소스 코드
  • 한국어 문서
features

핵심 기능 인덱스

Clash는 하나의 YAML 설정 파일을 기반으로 동작하며, 규칙·구독·정책 그룹·TUN·DNS 다섯 모듈이 일상 사용의 모든 장면을 담당합니다. 왼쪽에서 항목을 선택하면 오른쪽 패널에 해당 설명과 바로 적용할 수 있는 설정 조각이 표시됩니다.

규칙 분기

Clash는 rules 목록을 위에서부터 순서대로 확인하며 각 연결을 매칭합니다. 도메인 접미사, GEOIP 등의 조건에 맞으면 지정된 출구로 전달되고, 어느 조건에도 맞지 않으면 마지막의 MATCH 기본 규칙으로 떨어집니다. 이 기능이 해결하는 핵심 문제는 "어떤 트래픽을 프록시로 보낼지"를 더 이상 수동으로 전환하지 않아도 된다는 점입니다. 국내 사이트는 직접 연결, 해외 사이트는 프록시 경유, 광고 도메인은 차단——모두 규칙이 자동으로 처리합니다. 규칙은 설정 파일에 작성하며, 수정 후 다시 불러오기만 하면 즉시 적용되고 클라이언트를 재설치할 필요는 없습니다. 기존의 전역 프록시와 달리 분기 단위를 단일 도메인이나 IP 대역까지 세밀하게 제어할 수 있다는 점이 Clash와 단순 프록시 도구의 결정적 차이입니다.

rules:
  - DOMAIN-SUFFIX,github.com,PROXY
  - DOMAIN-KEYWORD,speedtest,DIRECT
  - GEOIP,CN,DIRECT
  - MATCH,PROXY
downloads

플랫폼별 클라이언트 받기

5개 플랫폼 모두 현재 유지 관리 중인 클라이언트를 사용할 수 있습니다. 사용 중인 시스템을 선택해 다운로드 페이지의 해당 섹션으로 이동하면, 각 플랫폼의 추천 순서와 시스템 요구 사항을 확인할 수 있습니다. 하나의 구독이 모든 플랫폼에서 공통으로 쓰이므로 여러 기기를 함께 써도 설정을 따로 관리할 필요가 없습니다.

Windows

Windows 10 / 11

데스크톱 주력 기기에 적합. 기능이 풍부하고 꾸준히 업데이트되는 Clash Verge Rev 추천.

다운로드 바로가기

macOS

macOS 11+

Intel과 Apple Silicon 모두 네이티브 빌드 제공. 가볍게 쓰려면 ClashX Meta.

다운로드 바로가기

Android

Android 8.0+

APK를 바로 설치해 사용 가능. VpnService 기반이라 루팅이 필요 없습니다.

다운로드 바로가기

iOS

App Store 등록됨

Stash 등 호환 앱은 데스크톱과 동일한 설정 문법을 사용합니다.

다운로드 바로가기

Linux

deb / rpm / AppImage

데스크톱은 GUI 패키지, 서버는 mihomo 코어 + systemd 상주가 정석.

다운로드 바로가기

전체 클라이언트 보기 →

quickstart

3단계로 끝내는 첫 설정

빈 시스템에서 프록시가 작동하기까지 핵심 과정은 딱 세 단계입니다. 각 단계의 상세한 설명과 스크린샷 위치는 사용 문서에서 확인할 수 있습니다.

  1. 클라이언트 다운로드 및 설치

    다운로드 페이지에서 사용 중인 플랫폼에 맞는 추천 클라이언트를 선택하고, 설치 파일을 실행해 안내에 따라 설치를 완료합니다. Windows에서는 처음 실행할 때 SmartScreen 같은 시스템 보안 경고가 나타날 수 있는데, 서명이 없는 오픈소스 소프트웨어에서 흔한 현상이며 대처 방법은 문서의 설치 챕터에서 확인할 수 있습니다. macOS에서 "개발자를 확인할 수 없음"이 뜨면 시스템 설정의 개인정보 보호 및 보안에서 한 번 허용하면 됩니다.

  2. 구독 링크 가져오기

    서비스 제공업체가 제공한 구독 링크를 복사해 클라이언트의 설정 또는 구독 페이지에 붙여넣어 가져옵니다. 가져오기가 완료되면 노드 목록과 규칙이 로컬 설정에 자동으로 저장되며, 이후에는 설정한 주기에 따라 자동으로 업데이트됩니다. 구독 링크는 계정 자격 증명이나 마찬가지이므로 스크린샷이나 전달로 타인에게 노출하지 마세요. 가져온 뒤 노드 목록이 비어 있다면 링크가 완전히 복사되었는지 먼저 확인합니다.

  3. 시스템 프록시 켜고 확인하기

    클라이언트에서 시스템 프록시 스위치를 켜고 지연 시간이 정상인 노드를 선택한 다음, 규칙에 따라 프록시를 거치는 사이트에 접속해 연결을 확인합니다. 먼저 클라이언트에서 지연 시간 테스트를 실행해 시간 초과되는 노드를 걸러낸 뒤 확인하는 것이 좋습니다. 확인 방법과 지연 시간 테스트에 관한 자세한 내용은 문서의 검증 챕터에 있으며, 실패하면 문제 해결 페이지의 순서대로 단계별로 원인을 좁혀 가세요.

전체 튜토리얼 보기 →

open source

오픈소스 코드, 직접 확인하고 빌드 가능

Clash 생태계의 코어와 주요 클라이언트는 모두 오픈소스 라이선스로 공개되어 있으며, 코드는 공개 저장소에서 관리됩니다. 누구나 구현을 검토하거나 이슈를 제출하거나 소스에서 직접 빌드할 수 있습니다.

생태계 현황

  • 오리지널 Clash 코어는 2018년에 오픈소스로 공개되어 YAML 설정·규칙 분기·정책 그룹이라는 기본 틀을 확립했습니다. 2023년 원본 저장소가 보관 처리된 뒤에는 커뮤니티 포크인 mihomo(Clash Meta 코어)가 이어받아 GPL-3.0 라이선스로 꾸준히 릴리스하고 있습니다
  • GUI 클라이언트와 코어는 두 계층 구조입니다. Clash Verge Rev, FlClash, ClashX Meta 등 GUI는 모두 동일한 mihomo 코어를 내장하므로 설정 파일이 클라이언트 간에 호환되며, 클라이언트를 바꿔도 설정을 다시 쓸 필요가 없습니다
  • 이들 클라이언트 역시 공개 저장소로 커뮤니티가 유지 관리하며, 업데이트는 GitHub Releases로 배포됩니다. 버전 번호·변경 로그·체크섬을 모두 공개적으로 대조할 수 있고, 클라이언트 안에서 코어 핫 업데이트도 지원합니다
  • 설정 파일은 순수 텍스트 YAML 형식이며, 각 필드의 의미는 공개 문서로 정리되어 있어 오프라인에서도 확인할 수 있습니다. 이 사이트의 문서는 공개 자료와 실제 설정 검증을 바탕으로 작성되었으며, 어떤 설치 파일도 수정하지 않습니다

소스에서 코어 받기

코드를 검토하거나 서버에서 직접 코어를 빌드해야 할 때는 저장소를 클론하면 됩니다:

git clone https://github.com/MetaCubeX/mihomo.git

일반 데스크톱과 모바일 사용자는 이 단계가 필요 없으며, 다운로드 페이지의 GUI 클라이언트를 사용하면 됩니다. main 브랜치는 개발 브랜치이고 릴리스 버전은 태그가 붙은 Release가 기준입니다. 빌드에는 Go 툴체인이 필요하며 결과물은 단일 정적 바이너리로, PATH에 넣고 config.yaml만 있으면 서버에서 상주 서비스로 돌릴 수 있습니다.

faq

자주 묻는 질문 모음

신규 사용자가 가장 자주 묻는 질문에 한 줄로 방향을 제시합니다. 자세한 단계는 링크된 문서 페이지를 참고하세요.

Clash for Windows는 개발이 중단됐는데 계속 써도 되나요?

원본은 2023년에 업데이트가 중단됐습니다. 지금도 유지 관리되는 Clash Verge Rev로 이전하는 것을 권장하며, 설정 파일은 그대로 쓸 수 있습니다. 비교는 클라이언트 선택 가이드를 참고하세요.

구독을 가져왔는데 노드가 없거나 갱신에 실패하나요?

대부분 링크가 불완전하게 복사됐거나 구독 서버 자체가 프록시를 거쳐야 접속되는 경우입니다. 문제 해결의 구독 챕터를 순서대로 점검하면 원인을 찾을 수 있습니다.

프록시를 켰는데도 페이지가 안 열리나요?

먼저 노드 지연 시간이 정상인지 확인하고, 그다음 규칙이 제대로 매칭되는지 확인하세요. 검증 순서와 테스트 명령은 사용 문서의 검증 챕터에 있습니다.

시작할 때 포트가 이미 사용 중이라는 오류가 나오나요?

7890 등의 포트를 다른 프로그램이 점유한 것입니다. 명령어로 충돌 프로세스를 찾거나 mixed-port를 변경하세요. 방법은 이 문제 해결 글에 있습니다.

blog

최근 업데이트된 글

설치, 선택 가이드, 문제 해결을 다루는 심층 글과 함께 그대로 복사해 쓸 수 있는 명령어와 설정 조각을 제공합니다.

문제 해결

Clash에서 포트가 사용 중이라고 나올 때: 명령어로 충돌 프로세스 찾고 혼합 포트 변경하기

실행 시 bind: address already in use 오류가 뜬다면 대부분 7890 같은 포트를 다른 프로그램이 이미 사용 중이기 때문입니다. 이 글에서는 Windows/macOS/Linux 세 플랫폼에서 충돌 프로세스를 찾는 명령어와, 설정 파일에서 다른 포트로 바꾸는 올바른 작성법을 안내합니다.

전체 읽기 →

전체 글 보기 →

Clash 클라이언트 다운로드