Clash Meta 완전 업그레이드 가이드: 구버전에서 Mihomo 코어로 마이그레이션

왜 구버전 Clash에서 Clash Meta로 옮겨야 할까요?

검색창에 「Clash 안 됨」, 「Clash for Windows 유지보수 종료」, 「ClashX 업데이트 없음」 같은 키워드를 입력했다면 이 글이 필요한 시점일 수 있습니다. 2023년 말을 전후로 Clash for Windows(CFW), ClashX 등 대표적인 Clash 클라이언트가 잇달아 유지보수를 중단했고, 공식 저장소는 읽기 전용으로 아카이브되어 더 이상 이슈나 풀 리퀘스트를 받지 않습니다. 알려진 취약점이 수정되지 않고, 새 macOS·Windows 버전에 맞춘 대응도 기대하기 어렵습니다. 업데이트가 멈춘 클라이언트를 계속 쓰면 보안 리스크가 커질 뿐 아니라 OS 업그레이드 후 호환 문제로 연결이 끊기는 일도 잦아집니다.

한편 Clash Meta는 공식적으로 프로젝트 이름이 Mihomo로 바뀌었지만, 지금도 가장 활발하게 개발되는 Clash 호환 코어입니다. 예전 Clash용 YAML 설정을 그대로 가져올 수 있는 호환성을 유지하면서, DNS 설정의 세밀한 제어, 유연한 라우팅 규칙, VLESS·Hysteria2·Reality 같은 최신 프로토콜 지원, 그리고 안정적인 TUN 모드 구현 등 실사용에 필요한 기능을 넓혀 왔습니다.

마이그레이션의 문턱은 생각보다 낮습니다. 대부분의 경우 새 클라이언트를 설치하고 기존 구독 URL이나 백업해 둔 설정 파일만 가져오면 바로 쓸 수 있으며, 설정을 처음부터 다시 짤 필요는 거의 없습니다. 아래에서는 플랫폼별로 단계를 나누어 설명합니다. 기본 설치와 구독 가져오기는 문서 페이지의 설치·설정 튜토리얼과 함께 보면 더 수월합니다.

ℹ️

용어 안내: 이 글에서 말하는 「Clash Meta」와 「Mihomo」는 같은 코어를 가리킵니다. MetaCubeX 팀은 2024년 초 코어 프로젝트 이름을 Mihomo로 정리했지만, 많은 GUI 클라이언트는 여전히 UI에 「Clash Meta」라는 표기를 쓰고 있어 혼동을 줄이기 위해 둘 다 언급합니다.

마이그레이션 전에 할 일

어떤 새 클라이언트를 설치하기 전에, 약 5분 정도만 투자해 설정을 백업해 두는 것을 권합니다. 실수로 구독·규칙·프록시 목록을 잃어버리면 복구에 시간이 많이 듭니다.

기존 설정 파일 백업

클라이언트마다 설정이 저장되는 경로가 다릅니다. 자주 쓰이는 위치는 다음과 같습니다.

Clash for Windows(Windows): %APPDATA%\clash\profiles\ 아래에 프로필이 있습니다. CFW의 Profiles 탭에서 항목을 우클릭해보낼 수 있습니다.
ClashX(macOS): ~/.config/clash/ 디렉터리입니다. Finder에서 ⌘⇧G로 이동해 경로를 입력하면 됩니다.
ClashX Pro(macOS): ClashX와 동일하게 ~/.config/clash/를 사용하는 경우가 많습니다.
Clash for Android: 앱 안의 「프로필」 또는 「구성」 화면에서 항목을 선택한 뒤 메뉴의 「보내기」를 이용합니다.

config.yaml을 데스크톱이나 다른 안전한 폴더에 복사해 두세요. 구독 URL만 쓰고 있다면 링크를 메모장 등에 저장해 두면 새 클라이언트에서 다시 가져오기가 가장 간단합니다.

⚠️

주의: 백업을 마쳤다고 해서 곧바로 구버전을 지울 필요는 없습니다. 새 클라이언트를 설치해 연결이 정상인지 확인한 뒤, 필요할 때만 이전 앱을 제거하면 마이그레이션 도중 인터넷이 끊기는 상황을 줄일 수 있습니다.

Windows에서 업그레이드하는 방법

Windows에서는 Clash Verge Rev(Clash Verge의 커뮤니티 포크)와 FlClash가 Mihomo 기반으로 널리 쓰이며, UI와 기능 구성이 달라 취향에 맞게 고르면 됩니다.

다운로드와 설치

우리 사이트의 클라이언트 다운로드 페이지에서 Windows용 설치 파일을 받습니다. 가능하면 .exe 설치형을 쓰면 드라이버 포함 구성이 단순해지는 경우가 많습니다.
설치 마법사를 따라 진행합니다. UAC 창이 뜨면 「예」를 눌러야 TUN 가상 어댑터 드라이버 설치가 진행될 수 있습니다.
설치가 끝나면 클라이언트가 실행되며 트레이로 최소화되는 경우가 많습니다.

프로필·구독 가져오기

트레이 아이콘을 눌러 메인 창을 엽니다.
「프로필」 또는 Profiles 화면에서 오른쪽 위의 「+」 또는 가져오기 버튼을 누릅니다.
구독 URL이 있다면 URL 구독을 선택해 붙여 넣은 뒤 업데이트하면 노드와 정책 그룹이 자동으로 채워집니다.
로컬 config.yaml이 있다면 로컬 파일을 지정해 백업본을 불러옵니다.
목록에서 방금 가져온 프로필을 선택해 현재 사용 중인 설정으로 전환합니다.

✅

팁: 가져온 뒤 자동 업데이트를 켜고 6~24시간 간격으로 구독을 갱신하도록 설정하면 노드 만료로 인한 단절을 줄일 수 있습니다.

프록시가 동작하는지 확인

노드를 고른 뒤 시스템 프록시 또는 TUN을 켜고 브라우저에서 ip.sb나 whatismyip.com 등을 열어 IP가 프록시 위치로 바뀌었는지 확인합니다. 바뀌지 않았다면 아래를 점검하세요.

상태 표시에 시스템 프록시가 켜져 있는지 확인합니다.
선택한 정책 그룹이 글로벌이거나, 접속하려는 도메인을 포함하는 규칙에 매칭되는지 봅니다.
TUN을 쓸 때는 관리자 권한으로 실행해야 드라이버가 제대로 올라갈 수 있습니다.

macOS에서 업그레이드하는 방법

macOS에서는 메뉴 막대 스타일의 ClashX Meta와 기능이 풍부한 Clash Verge Rev 중에서 고를 수 있습니다. 여기서는 Clash Verge Rev 기준으로 설명합니다.

Clash Verge Rev 설치(macOS)

다운로드 페이지에서 macOS용 패키지를 받고, 칩 종류에 맞게 arm64(Apple 실리콘 M 시리즈) 또는 x64(Intel)를 선택합니다.
.dmg를 열고 애플리케이션 폴더로 드래그합니다.
처음 실행 시 「개발자를 확인할 수 없음」 같은 경고가 나오면 시스템 설정의 「개인정보 보호 및 보안」에서 「그래도 열기」로 진행합니다.
TUN용 헬퍼 도구 설치 요청이 뜨면 macOS 로그인 비밀번호를 입력해 허용합니다.

설정 가져오기(macOS)

Windows판과 흐름은 거의 같습니다. 프로필 관리 화면에서 URL 구독 또는 로컬 파일로 가져온 뒤, 해당 프로필을 선택하고 시스템 프록시를 켜면 Safari·Chrome 등에서 동일하게 사용할 수 있습니다.

ℹ️

macOS Sequoia(15.x) 사용자: 최신 OS는 VPN·프록시 관련 권한을 더 엄격하게 다룹니다. TUN이 켜지지 않으면 시스템 설정의 「VPN 및 기기 관리」에서 프로필이나 관련 구성 요소를 신뢰해야 하는지 확인하세요.

Android에서 업그레이드하는 방법

Android에서는 ClashMeta for Android(CFA Meta)나 FlClash를 추천합니다. FlClash는 Android·Windows·macOS를 같은 UI로 쓰고 싶은 사용자에게 무난합니다.

설치 순서

다운로드 페이지에서 Android용 .apk를 받습니다.
휴대폰 설정에서 출처를 알 수 없는 앱 설치를 허용하거나, 사용 중인 브라우저·파일 앱에만 개별 허용을 줍니다.
다운로드한 APK를 탭해 설치를 완료합니다.
첫 실행 시 VPN 권한 요청이 나오면 허용해야 트래픽을 터널링할 수 있습니다.

구독 가져오기(Android)

구성 탭 오른쪽 위의 「+」에서 URL로 가져오기를 선택하고 구독 링크를 붙여 넣은 뒤 다운로드합니다. 완료되면 해당 프로필을 활성화하고 홈에서 시작 버튼으로 프록시를 켭니다.

설정 파일 호환성

많은 분이 가장 궁금해하는 질문은, 예전 Clash for Windows의 config.yaml을 Mihomo 코어에서 그대로 쓸 수 있느냐는 것입니다.

대부분의 경우 수정 없이 그대로 사용할 수 있습니다. Mihomo는 proxies, proxy-groups, rules 등 Clash의 핵심 YAML 구조를 유지합니다. 다만 아래는 실무에서 자주 마주치는 차이입니다.

프로토콜: Shadowsocks, VMess, Trojan, SOCKS5 등은 그대로 호환됩니다. VLESS나 Hysteria 노드는 구형 Clash에서는 지원되지 않았을 수 있지만, Mihomo로 옮기면 그대로 활용할 수 있는 경우가 많습니다.
DNS: 기존 dns 블록은 유효합니다. 필요하면 fake-ip-filter, proxy-server-nameserver 같은 Mihomo 전용 옵션을 추가로 조정할 수 있습니다.
Rule Providers: rule-providers는 그대로 동작합니다. ACL4SSR 등 원격 규칙 세트를 쓰고 있다면 마이그레이션 후 한 번 업데이트를 돌려 최신 규칙을 받아오면 됩니다.
폐지·변경 필드: external-controller 인증 방식처럼 세부 동작이 바뀐 항목은 있을 수 있으나, 기본 연결 자체가 막히는 수준은 아닙니다. 클라이언트 경고를 따라 수정하면 됩니다.

✅

가장 빠른 검증: 예전 설정을 그대로 가져온 뒤 지연 시간 측정을 실행해 보세요. 모든 노드에 핑이 정상적으로 나오면 호환성 문제는 크지 않다고 봐도 됩니다.

자주 묻는 질문과 해결

Q: 구독을 넣었는데 파싱 실패이거나 노드가 비어 있습니다

구독 URL이 만료되었거나 서버 측에서 형식을 바꾼 경우가 많습니다. 브라우저에서 직접 URL을 열어 YAML·Base64 본문이 내려오는지 확인하세요. 404나 오류 페이지면 공급자에게 새 링크를 요청해야 합니다. 일부 공급자는 최신 클라이언트에서 User-Agent를 지정해야만 구독을 내려주기도 하니, 앱의 구독 고급 설정을 확인하세요.

Q: TUN을 켜면 인터넷 전체가 끊깁니다

Windows에서는 관리자 권한, macOS에서는 헬퍼·시스템 확장 권한이 없으면 가상 어댑터가 제대로 설치되지 않아 트래픽이 막힐 수 있습니다. 클라이언트를 관리자로 다시 실행하거나, macOS 개인정보 보호 설정에서 헬퍼를 다시 허용한 뒤 TUN을 다시 켜 보세요.

Q: 브라우저만 프록시를 타고 게임·터미널은 직접 나갑니다

시스템 프록시(HTTP·SOCKS)는 프록시를 지원하는 앱에만 적용됩니다. 게임 클라이언트나 일부 CLI는 시스템 프록시를 무시합니다. 이럴 때는 TUN 모드로 전환해 커널 수준에서 TCP·UDP를 가로채는 편이 확실합니다.

Q: macOS에서 Safari는 되는데 Chrome만 직접 연결됩니다

Chrome은 시스템 프록시를 따르지만, 이전 프록시 상태가 캐시된 경우가 있습니다. Chrome을 완전히 종료했다가 다시 열거나, 프록시 관련 확장 프로그램·다른 VPN 앱이 설정을 덮어쓰고 있지 않은지 확인하세요.

한번 마이그레이션을 마치고 나면, 화려한 기능 목록보다 꾸준한 업데이트와 보안 대응이 얼마나 중요한지 실감하게 됩니다. Clash for Windows가 중단된 사례는, 인기 있던 도구가 짧은 기간 안에 「필수 프로그램」에서 「그대로 두기엔 불안한 유물」로 바뀔 수 있다는 점을 보여 줍니다.

우리는 Mihomo 코어를 기반으로 여러 플랫폼에서 동일한 경험에 가깝게 쓸 수 있도록 클라이언트를 다듬고 있습니다. 복잡한 YAML을 손으로 짤 필요 없이 구독 링크만 넣으면 대부분의 설정이 자동으로 맞춰지도록 하는 것이 목표입니다. 다른 도구에 비해 설정 과정이 단순하고, 코어 업데이트를 따라가며 안정성을 우선하는 편이라 일상 사용에 부담이 적습니다.

지금 쓰는 환경에 맞는 설치 파일은 Clash 공식 다운로드 페이지에서 고를 수 있습니다. → Clash를 무료로 내려받아 더 매끄러운 프록시 환경을 바로 경험해 보세요.