Clash Meta(mihomo) 코어 업그레이드 2026: Windows·macOS 교체, Hysteria2·TUIC v5

왜 Premium에서 Clash Meta 코어로 바꿔야 하나요?

Clash GUI를 쓰다 보면 설정에 Hysteria2·TUIC v5가 이미 적혀 있는데도 연결이 안 되는 경우가 있습니다. 노드가 나빠서가 아니라 코어가 오래됐기 때문인 경우가 많습니다.

Clash 개발은 두 갈래로 갈렸습니다. 원래 Clash Premium 코어는 2023년 11월 이후 업데이트가 끊겼고 GitHub 저장소는 읽기 전용으로 보관되었습니다. 반면 Clash Meta(공식 저장소 mihomo)는 커뮤니티가 계속 릴리스를 내고 있습니다.

실사용 기준으로 보면 차이는 다음과 같습니다.

항목	기존 Premium 코어	Clash Meta(mihomo)
유지보수	중단, 저장소 보관	적극 유지보수
Hysteria2	미지원	전체 지원
TUIC v5	미지원	전체 지원
REALITY	미지원	지원
Rule Providers	기본	더 풍부하고 유연함
설정 호환	—	일반적인 Premium 스타일 YAML과 하위 호환

일상 사용에서는 Meta로 옮겨도 구독 프로필이 깨지지 않도록 설계되어 있습니다. 대부분 코어 실행 파일만 바꾸면 되고 YAML 전면 수정은 필요 없습니다.

한 줄 요약 제공자가 Hysteria2·TUIC v5 노드를 주는데 먹히지 않으면, 먼저 코어를 확인·업그레이드한 뒤 노드나 원격 설정을 의심하세요.

업그레이드 전에 할 일

교체가 실패하거나 데이터를 잃지 않도록 아래만 짧게 챙기면 됩니다.

설정 백업

어떤 클라이언트든 다음을 복사해 두세요.

프로필 YAML 전부(앱 데이터 폴더 안 profiles/ 등)
구독 URL(여러 개면 메모·텍스트 파일로 저장)
사용자 규칙·오버라이드(Clash for Windows의 Mixin/Override 등)

현재 코어 버전 확인

설정 또는 정보에서 버전 문자열을 봅니다. meta 또는 mihomo가 보이면 이미 Meta이므로 업데이트만 하면 됩니다. clash와 버전만 보이면(예: clash v1.18.x) 전체 교체를 계획하세요.

Windows: Clash for Windows에서 코어 교체

Clash for Windows(CFW)는 엔진을 별도 파일로 두므로 수동 교체가 비교적 단순합니다.

실행 파일 위치

기본적으로 설치 경로 아래 resources\static\files\win\x64\ 또는 32비트는 win\ia32\입니다. 파일명은 보통 clash-win64.exe(또는 해당 아키텍처 이름)입니다.

CFW에서 Settings → General → Home Directory를 열어 clash-win64.exe 위치를 찾을 수도 있습니다.

교체 순서

Clash for Windows를 완전히 종료합니다(트레이 아이콘 포함).
mihomo-windows-amd64.zip을 풀어 새 .exe를 얻습니다.
이름을 기존 바이너리와 같게 바꿉니다(예: clash-win64.exe).
원본을 clash-win64.exe.bak 등으로 바꾼 뒤 같은 폴더에 새 파일을 넣습니다.
CFW를 다시 켜고 Settings → General → Core Version에서 Meta/mihomo 빌드인지 확인합니다.

장기적으로는 대안 권장 CFW 자체도 더 이상 유지되지 않습니다. 신규 설치는 Windows 섹션의 Clash Verge Rev를 권장합니다. 최신 Meta가 포함되고 GUI에서 코어를 갱신할 수 있어 반복적인 파일 교체가 필요 없습니다.

Windows: Clash Verge Rev는 Meta 기본 탑재

Clash Verge Rev는 Clash Verge의 커뮤니티 포크로, Meta(mihomo) 코어와 최신 UI를 묶어 제공하며 Windows에서 가장 활발히 관리되는 GUI 중 하나입니다. 신규 사용자는 CFW 대신 여기서 시작하는 편이 좋습니다.

새로 설치

Windows 다운로드 페이지에서 최신 .msi를 받아 설치하면 번들 Meta 코어가 바로 준비됩니다.

CFW에서 구독 옮기기

CFW Profiles에서 프로필을 우클릭해 구독 URL을 복사합니다.
Clash Verge Rev에서 Subscriptions로 가 가져오기에 URL을 붙여 넣습니다.
가져오기가 끝나면 프로필을 고르고 활성화합니다.
Settings → Core(또는 유사 메뉴)에서 활성 코어가 Meta(mihomo)인지 확인합니다.

번들 코어 업데이트

Verge Rev에도 항상 최신 mihomo가 들어 있지는 않을 수 있습니다. 설정의 코어 섹션에서 업데이트 확인으로 새 바이너리를 받으면 CFW처럼 수동으로 파일을 바꿀 필요가 없습니다.

macOS: ClashX 안에서 코어 바꾸기

ClashX는 오래된 macOS용 GUI입니다. 엔진은 확장자 없는 clash 파일이며 앱 번들 안에 있어 패키지 내용 보기로 교체합니다.

번들 열기

Finder에서 ClashX를 우클릭 → 패키지 내용 보기, Contents/MacOS로 이동해 clash를 찾습니다.

교체 절차

ClashX를 완전히 종료합니다(메뉴 막대 아이콘 → 종료).
mihomo-darwin-amd64.gz(Intel) 또는 mihomo-darwin-arm64.gz(Apple Silicon)를 풉니다.
터미널에서 chmod +x로 실행 권한을 줍니다(추출된 파일명에 맞게 조정).
원본 clash를 clash.bak으로 백업하고, 새 바이너리 이름을 clash로 한 뒤 MacOS에 넣습니다.
서명된 앱을 수정했으므로 실행이 막힐 수 있습니다. 시스템 설정 → 개인정보 보호 및 보안에서 허용하거나 xattr -dr com.apple.quarantine /Applications/ClashX.app를 사용합니다.
ClashX를 다시 실행하고 도움말 → 정보에서 코어 문자열을 확인합니다.

Apple Silicon M 시리즈 Mac에는 arm64 빌드를 써야 합니다. amd64를 넣으면 코어가 실행되지 않고 프록시 전체가 멈출 수 있습니다.

macOS: Clash Verge Rev에 내장된 Meta

macOS에도 Clash Verge Rev가 있으며, Windows와 같이 최근 Meta(mihomo)를 넣고 UI에서 코어를 갱신할 수 있어 Apple Silicon·Intel 모두에서 편합니다.

macOS 다운로드에서 최신 .dmg를 받아 응용 프로그램 폴더로 옮기면 번들 교체 없이 사용할 수 있습니다.

다른 클라이언트와 링크는 다운로드 센터를 참고하세요.

Hysteria2와 TUIC v5 켜기

코어를 바꾼 뒤에는 Meta가 추가한 프로토콜을 YAML에 쓸 수 있습니다. Hysteria2와 TUIC v5는 패킷 손실이 큰 회선에서 자주 쓰는 저지연 옵션입니다.

예: Hysteria2 프록시

Hysteria2는 QUIC 기반이라 손실이 클 때 유리합니다. 항목 예시는 다음과 같습니다.

proxies:
  - name: "HY2 예시"
    type: hysteria2
    server: your-server.example.com
    port: 443
    password: "your-password"
    sni: your-server.example.com
    skip-cert-verify: false
    fast-open: true

예: TUIC v5 프록시

TUIC v5도 QUIC를 쓰며 예전 TUIC 계열 대비 핸드셰이크와 멀티플렉싱이 개선되었습니다. 예시:

proxies:
  - name: "TUIC v5 예시"
    type: tuic
    server: your-server.example.com
    port: 443
    uuid: "your-uuid"
    password: "your-password"
    alpn: [h3]
    version: 5
    skip-cert-verify: false
    congestion-controller: bbr

프록시 그룹에 넣기

이름을 proxy-groups(예: url-test·자동)에 넣지 않으면 목록에만 보이고 규칙에서 선택되지 않습니다.

proxy-groups:
  - name: "자동"
    type: url-test
    proxies:
      - "HY2 예시"
      - "TUIC v5 예시"
      # ... 기타 프록시 ...
    url: "https://www.gstatic.com/generate_204"
    interval: 300

구독만 쓰는 경우 제공자 URL만 넣었다면 위 YAML을 직접 쓸 필요가 없는 경우가 많습니다. Meta로 올린 뒤 구독을 새로고침하면 새 프로토콜 노드가 자동으로 들어옵니다.

동작 확인과 자주 나는 오류

새 코어에 의존하기 전에 짧게 점검하세요.

코어 문자열 확인

설정 또는 정보에서 meta 또는 mihomo와 시맨틱 버전(예: v1.18.x)이 보여야 합니다. 예전 Premium처럼 보이면 경로나 파일명이 잘못된 것입니다.

프로필 다시 로드

다시 로드한 뒤 로그·코어 로그를 봅니다. Meta는 YAML 오류 시 줄 번호를 비교적 명확히 찍습니다.

전형적인 증상

메시지·증상	가능한 원인	대응
`unknown field: xxx`	지원되지 않는 YAML 키	Meta 문서에 맞게 필드 삭제·이름 변경
`bind: address already in use`	포트 충돌	YAML의 포트 변경 또는 다른 프로세스 종료
코어가 바로 종료	CPU 아키텍처 불일치(amd64 vs arm64)	맞는 빌드로 다시 받기
macOS에서 열 수 없음·Gatekeeper	번들 수정·격리	설정에서 허용하거나 앱에 `xattr -dr` 적용
Hysteria2가 연결되지 않음	서버·클라이언트 프로토콜 불일치	원격이 Hysteria2인지(구 Hy1 아님) 제공자에 확인

지연 테스트

프록시 목록에서 지연을 재면, 예전엔 타임아웃이던 HY2 노드가 Meta에서는 숫자가 나오는 경우가 많습니다. 같은 노드에서도 QUIC 안정성이 나아지는 편입니다.

마무리

코어를 올리는 것은 프록시의 "엔진"을 새것으로 바꾸는 일과 같습니다. «네트워크 문제»나 «노드 문제»로 보였던 현상이 사실은 Premium 한계였을 수 있습니다. 한편 GUI마다 편의성 차이가 크므로, 모든 설정을 YAML로 만져야 하거나 메뉴가 산만해 디버깅이 힘든 클라이언트도 있습니다.

ClashNote가 안내하는 클라이언트는 구독 가져오기·노드 선택·규칙 관리를 UI로 묶고 Meta를 포함·갱신하기 쉽게 두었습니다. 지금 쓰는 앱이 불편하다면 아래를 참고해 보세요.

→ Clash 다운로드 — Meta 코어 포함, 여러 플랫폼, 실행 파일을 직접 갈아끼울 필요 없이 시작할 수 있습니다.

정책 그룹·Rule Providers·DNS 유출 방지 등 YAML을 더 파고 싶다면 기술 칼럼의 다른 글을 이어서 보세요.

Clash Meta(mihomo) 코어 업그레이드: Windows·macOS에서 구형 코어를 교체하고 Hysteria2·TUIC v5 켜기

왜 Premium에서 Clash Meta 코어로 바꿔야 하나요?

업그레이드 전에 할 일

설정 백업

현재 코어 버전 확인

최신 Meta(mihomo) 빌드 받기

Windows: Clash for Windows에서 코어 교체

실행 파일 위치

교체 순서

Windows: Clash Verge Rev는 Meta 기본 탑재

새로 설치

CFW에서 구독 옮기기

번들 코어 업데이트

macOS: ClashX 안에서 코어 바꾸기

번들 열기

교체 절차

macOS: Clash Verge Rev에 내장된 Meta

Hysteria2와 TUIC v5 켜기

예: Hysteria2 프록시

예: TUIC v5 프록시

프록시 그룹에 넣기

동작 확인과 자주 나는 오류

코어 문자열 확인

프로필 다시 로드

전형적인 증상

지연 테스트

마무리