모든 플랫폼 클라이언트 및 설정 안내

Clash 내비
다운로드 및 설정

공식 Clash 다운로드 사용법 보기

시스템 선택부터 시작해 구독 가져오기, 규칙 분기, TUN 트래픽 가로채기를 차례로 진행하세요. 각 항목은 플랫폼별 안내로 연결되어 처음 설치할 때도, 나중에 설정 위치를 다시 찾을 때도 편리합니다.

영구 무료 오픈 소스 멀티플랫폼 한국어 문서
주요 설정

연결부터 트래픽 분기까지, 문제별로 확인

Clash 클라이언트마다 화면 이름은 조금씩 다를 수 있지만 핵심 흐름은 거의 같습니다. 먼저 설정을 준비하고, 프록시 모드를 선택한 뒤, 시스템 프록시 또는 TUN 중 어떤 방식으로 트래픽을 가로챌지 결정합니다. 아래 네 가지 안내에서는 헷갈리기 쉬운 설정을 나누어 설명하며, 탭을 전환해 해당 항목을 확인할 수 있습니다.

설정 메뉴

구독 링크를 가져온 뒤 설정을 선택하세요

구독 링크는 일반적으로 서비스 제공자가 생성합니다. 클라이언트 설치 파일이 아니며, 복사했다고 자동으로 적용되지도 않습니다. 설정 또는 구독 페이지에서 URL을 붙여넣고 다운로드를 실행한 다음, 목록에 설정이 나타날 때까지 기다리세요. 이후 해당 항목을 선택해 현재 설정으로 지정합니다. 형식 오류가 표시되면 복사한 내용이 일반적인 웹 주소로 시작하는지 확인하고, 브라우저에서 링크가 잘리지 않았는지도 점검하세요.

노드를 하나씩 수동으로 추가하는 것과 달리 구독 설정에는 노드, 프록시 그룹, 규칙 제공자, DNS 설정이 함께 포함될 수 있으며, 이후 업데이트 버튼으로 변경 사항을 동기화할 수 있습니다. 가져오기가 끝나면 기존 규칙 구조를 우선 유지하고 YAML을 서둘러 수정하지 마세요. 연결이 정상인지 확인한 뒤 자동 업데이트 주기와 프록시 그룹을 실제 필요에 맞게 조정하는 편이 좋습니다.

설정 관리 구독
선택됨
https://example.com/profile
일상 사용 설정 현재 설정
업데이트
가져오기 → 선택 → 프록시 그룹 업데이트
클라이언트 바로가기

사용 중인 운영체제에 맞게 선택

다운로드 페이지에는 운영체제별 그래픽 클라이언트와 사용 안내가 정리되어 있습니다. 설치 파일 주소를 바로 제공하지 않고 해당 플랫폼 영역으로 이동한 뒤, 시스템 아키텍처, 유지보수 상태, 필요한 기능에 따라 클라이언트를 선택하도록 구성해 잘못된 파일을 받는 일을 줄였습니다.

Windows

데스크톱 업무, 브라우저, 상시 프록시 사용에 적합합니다. 다운로드 페이지에서 Clash Plus, Clash Verge Rev, FlClash 같은 그래픽 클라이언트를 비교하고 프로세서 아키텍처에 맞는 설치 파일을 선택할 수 있습니다.

다운로드하기

macOS

Intel 및 Apple Silicon Mac에 적합합니다. 다운로드 전에 ‘이 Mac에 관하여’에서 칩 유형을 확인하고, 설치 후 시스템 안내에 따라 네트워크 확장, 프록시 또는 백그라운드 서비스 권한을 허용하세요.

다운로드하기

Android

스마트폰, 태블릿 및 일부 Android 기기에 적합합니다. 대부분의 스마트폰은 ARM64 설치 파일을 우선 선택합니다. 기기 아키텍처가 확실하지 않다면 다운로드 페이지에서 범용 패키지와 클라이언트별 지원 차이를 확인하세요.

다운로드하기

iOS

iPhone과 iPad에서는 App Store를 통해 Clash Plus를 받을 수 있습니다. 설치 후 구독 링크로 설정을 추가하고, 시스템에서 처음 요청할 때 VPN 네트워크 연결 생성을 허용하세요.

다운로드하기

Linux

데스크톱 사용자는 그래픽 클라이언트를 선택할 수 있고, 서버·소프트 라우터·명령줄에 익숙한 사용자는 Mihomo 코어 영역을 확인할 수 있습니다. 설치 전에 배포판, 아키텍처, 패키지 형식을 확인하세요.

다운로드하기
전체 클라이언트 보기 →
빠른 시작

설치 후 따라 할 세 가지 단계

처음 클라이언트를 열었을 때 고급 설정을 하나씩 바꿀 필요는 없습니다. 먼저 유효한 설정 하나를 정상적으로 실행한 뒤 규칙 모드와 TUN의 차이를 익히면 문제를 훨씬 명확하게 파악할 수 있습니다.

전체 사용법 보기 →
  1. 01

    구독 가져오기 및 설정 선택

    서비스 제공자가 발급한 전체 구독 URL을 복사한 뒤 클라이언트의 설정, 구독 또는 Profiles 페이지를 열고 입력란에 링크를 붙여넣어 가져오기를 실행하세요. 설정 다운로드가 끝나면 목록으로 돌아가 새로 나타난 항목을 선택해 현재 설정으로 지정합니다. 설정 이름이 보인다고 해서 활성화된 것은 아닙니다. 이후 규칙과 프록시 그룹이 적용되려면 반드시 선택 상태여야 합니다.

  2. 02

    프록시 그룹 및 규칙 모드 선택

    프록시 페이지에서 먼저 주요 프록시 그룹의 사용 가능한 항목을 선택한 다음 실행 모드를 규칙으로 설정하세요. 규칙 모드는 설정에 따라 직접 연결과 프록시를 판단하므로 일상적인 사용에 적합합니다. 웹페이지가 열리지 않으면 잠시 전체 모드로 전환해 테스트하세요. 전체 모드에서는 작동하지만 규칙 모드에서만 작동하지 않는다면 클라이언트를 다시 설치하기보다 규칙이나 프록시 그룹을 점검해야 할 가능성이 큽니다.

  3. 03

    시스템 프록시 활성화 및 연결 확인

    시스템 프록시를 켠 뒤 먼저 브라우저로 자주 방문하는 웹사이트에 접속하고 다른 프로그램도 테스트하세요. 브라우저는 되지만 특정 독립 프로그램이 여전히 직접 연결된다면 TUN 모드를 고려할 수 있습니다. 확인할 때는 한 번에 하나의 설정만 바꾸고 변경 전후 결과를 기록하세요. 이렇게 하면 구독, 노드, 규칙, 트래픽 가로채기 방식을 분리해 판단할 수 있어 여러 설정이 동시에 바뀌는 문제를 피할 수 있습니다.

오픈 소스 생태계

클라이언트, 코어, 설정의 관계 이해하기

Clash 생태계는 하나의 설치 파일로 이루어지지 않습니다. 그래픽 클라이언트는 인터페이스, 시스템 통합, 업데이트 작업을 담당하고, 코어는 설정을 읽고 규칙을 처리하며 연결을 전달합니다. 구독은 노드, 프록시 그룹, 규칙 콘텐츠를 제공합니다. 이 세 계층을 나누어 이해하면 클라이언트 선택과 문제 해결이 훨씬 쉬워집니다.

프로젝트의 발전

Clash는 처음에 규칙 기반 프록시 코어로 주목받았고 이후 여러 데스크톱 및 모바일 클라이언트가 등장했습니다. 원래 프로젝트의 유지보수가 중단된 뒤에도 커뮤니티는 호환 가능한 설정 형식, 규칙 체계, 사용 방식을 중심으로 개발을 이어갔습니다. 현재 클라이언트마다 그래픽 인터페이스는 다를 수 있지만 프록시 모드, 프록시 그룹, 구독 설정 같은 핵심 개념은 대체로 비슷합니다.

따라서 클라이언트를 선택할 때는 화면이 비슷한지보다 유지보수 상태, 운영체제 지원, 사용 중인 코어를 먼저 확인해야 합니다. 오래된 사용법과 버튼 위치가 달라졌더라도 ‘설정—프록시 그룹—모드—트래픽 진입점’의 흐름을 이해하면 새 화면에서도 해당 항목을 찾을 수 있습니다.

Mihomo 코어

Mihomo는 현재 Clash 생태계에서 널리 사용되는 커뮤니티 유지보수 코어입니다. Clash의 설정 및 규칙 사용 방식을 이어가면서 TUN, DNS, 규칙 제공자 등의 기능도 지원합니다. 많은 그래픽 클라이언트는 코어를 앱 내부에 포함하므로 일반 사용자는 인터페이스만 조작하면 됩니다. 서버와 라우터 사용자는 코어를 별도로 실행할 수도 있습니다.

클라이언트 이름과 코어 이름이 같을 필요는 없습니다. 그래픽 인터페이스를 업그레이드해도 구독 내용이 바뀌는 것은 아니며, 구독을 업데이트해도 클라이언트 프로그램이 자동으로 교체되지는 않습니다. 호환성 문제가 발생하면 ‘Clash가 안 된다’고만 설명하기보다 클라이언트 이름, 운영체제, 설정 출처, 활성화한 모드를 각각 기록하는 편이 원인을 찾기 쉽습니다.

공개 코드 및 문서

오픈 소스 저장소에서는 설정 형식, 기능 변경, 문제 논의를 공개적으로 확인할 수 있습니다. 일반 사용자가 소스 코드 전체를 먼저 이해할 필요는 없지만, 저장소 문서에서 매개변수의 의미와 알려진 문제를 확인하고 특정 기능이 코어, 클라이언트, 운영체제 통합 계층 중 어디에 속하는지 판단할 수 있습니다. 이 사이트의 안내는 가능한 한 여러 클라이언트에서 통용되는 명칭을 사용합니다.

코어를 더 깊이 살펴보려면 Mihomo 저장소를 복제해 로컬에서 문서와 커밋 기록을 확인할 수 있습니다. 이 명령은 프로젝트 소스 코드만 가져오며 그래픽 클라이언트를 설치하거나 구독 설정을 생성하지 않습니다.

업데이트 및 안정성

안정적인 사용에는 세 가지 업데이트가 관련됩니다. 클라이언트 업데이트는 인터페이스와 시스템 호환성을 조정하고, 코어 업데이트는 프록시 기능과 규칙 동작을 바꾸며, 구독 업데이트는 서비스 설정을 동기화합니다. 세 가지를 동시에 처리할 필요는 없습니다. 평소에는 정기적으로 구독만 업데이트하고, 클라이언트가 안정적으로 실행된다면 변경 사항을 먼저 읽은 뒤 프로그램 업그레이드 일정을 잡아도 됩니다.

업그레이드 전에 현재 설정, 프록시 모드, 프록시 그룹, TUN 상태를 기록하고 업그레이드 후 같은 순서로 확인하세요. 문제가 생기면 모든 설정을 삭제하고 다시 시작하기보다 시스템 프록시와 규칙 모드의 기본 조합으로 돌아간 뒤 DNS나 TUN 같은 고급 설정을 단계적으로 복원하는 편이 변화의 원인을 찾기 쉽습니다.

터미널 명령 · Mihomo 소스 코드 가져오기 git clone https://github.com/MetaCubeX/mihomo.git
자주 묻는 질문

시작 전에 헷갈리기 쉬운 네 가지

클라이언트를 설치했는데 왜 아직 연결되지 않나요?

클라이언트는 실행 환경만 제공합니다. 유효한 구독을 가져오고 설정을 선택한 다음 프록시 그룹을 지정하고 시스템 프록시를 켜야 합니다. 사용법의 순서에 따라 하나씩 확인하세요.

시작 단계 보기

규칙, 전체, 직접 연결 중 무엇을 선택해야 하나요?

일상적으로는 규칙 모드를 우선 사용하세요. 전체 모드는 프록시 연결을 임시로 테스트할 때, 직접 연결 모드는 프록시를 우회하거나 로컬 네트워크 상태를 확인할 때 적합합니다.

모드 설명 보기

시스템 프록시를 켠 뒤 일부 프로그램만 연결되지 않으면 어떻게 하나요?

해당 프로그램이 시스템 프록시를 읽지 않는 것일 수 있습니다. 먼저 브라우저 연결이 정상인지 확인한 뒤 TUN 모드에 필요한 권한과 가상 네트워크 어댑터 설정을 점검하세요.

TUN 섹션 읽기

구독 업데이트에 실패하면 무엇부터 확인해야 하나요?

먼저 링크가 만료되거나 잘리지 않았는지 확인한 다음 로컬 네트워크, 현재 프록시 상태, 서버 응답 정보를 점검하세요. 설정을 연속해서 삭제하는 것은 피하는 것이 좋습니다.

문제 해결 방법 보기
설정 문서

최근 사용 안내

TUN, 구독 업데이트, 클라이언트 선택을 중심으로 정리한 상세 안내입니다. 기본 연결을 완료한 뒤 이어서 읽기 좋습니다.

전체 문서 보기 →
고급 설정

Clash TUN 모드 켜는 방법: 가상 네트워크 어댑터로 전체 트래픽을 가로채는 원리와 설정 단계

TUN 모드와 시스템 프록시의 차이, 권한, 서비스 설치, DNS 처리, 네트워크 스택 등 핵심 설정을 설명합니다.

전체 글 읽기
시작 가이드

Clash 구독 업데이트 실패 해결: 시간 초과, 404, 자동 업데이트 주기 설정

오류 양상을 기준으로 링크 만료, 서버 제한, 로컬 프록시 간섭을 구분하고 자동 업데이트 주기를 설정하는 방법을 설명합니다.

전체 글 읽기
클라이언트 비교

Clash Verge, ClashX, Clash Meta for Android 비교: 5개 플랫폼 클라이언트 선택 가이드

운영체제 지원, 코어, TUN 기능, 유지보수 상태를 기준으로 주요 클라이언트를 비교하고 실제 기기에 맞는 선택 경로를 제시합니다.

전체 글 읽기