먼저 네 층으로 나누기: registry·마켓·MCP·모델 API
터미널에는 모두 “로딩 중”으로 보이지만 실패 지점은 네 갈래입니다. 첫째 npm registry와 tarball CDN—메타데이터는 열리고 실제 .tgz만 다른 지역으로 가 끊기는 패턴. 둘째 marketplace.visualstudio.com 및 VS Code가 쓰는 정적 CDN—확장 다운로드·업데이트 전용. 셋째 MCP—로컬 stdio는 네트워크가 없어도 되지만 원격 SSE·HTTPS는 별도 게이트웨이·OAuth·스토리지가 붙습니다. 넷째 api.anthropic.com·api.openai.com·generativelanguage.googleapis.com 등 추론 API—대화·도구 호출이 길게 유지되는 구간입니다. 한 층만 고치면 나머지에서 다시 “전체가 망가졌다”는 인상을 받기 쉽습니다.
실패 직후 Clash Connections에서 완전한 호스트명·첫 매칭 규칙·최종 정책 그룹을 적어 두세요. 로그에 연결이 없으면 트래픽이 Meta 코어에 안 들어오거나 다른 VPN·ZTNA가 가로챈 것입니다. DIRECT로만 보이면서 RTT가 튀면 해당 클러스터를 넓은 국내 직연결 위에 올려야 합니다.
브라우저는 되는데 Cline CLI·확장만 실패하는 이유
데스크톱 브라우저는 PAC·시스템 HTTPS 프록시를 잘 따르지만, 통합 터미널·VS Code 확장 호스트·백그라운드 Node는 HTTPS_PROXY가 비어 있거나 자식만 직연결·회사 MITM 인증서 미신뢰로 TLS가 먼저 깨지고 구두로는 “타임아웃”이라 부르기도 합니다. HTTP/3·QUIC은 TCP 프록시만 있는 환경을 우회합니다. Mixed Port는 환경 변수를 존중하는 도구에는 유효하지만 Cline SDK가 띄우는 여러 프로세스에는 불안정합니다. TUN은 라우팅 계층에서 패킷을 보이게 해 작성한 분류 규칙과 실제 출구를 맞춥니다.
JetBrains 계열은 Open VSX·자체 마켓 호스트가 VS Code와 다를 수 있습니다. 마이그레이션 문서의 설치 경로와 본인 로그의 FQDN을 1:1로 대조하세요.
이 글이 다루는 범위
Cline 요금·모델명·기능 스위치는 공식 릴리스를 따릅니다. 여기서는 외부 네트워크 표면만 다룹니다. 아래 YAML·curl은 패턴 예시이며 실제 문자열은 본인 Connections 기준으로 바꿉니다. 엔드포인트는 시점에 따라 바뀔 수 있으니 정적 목록만 외우지 마세요.
1로그로 네 층의 호스트 관측
npm: registry.npmjs.org, *.npmjs.org·*.npmjs.net, 사내 Nexus 미러 FQDN. 마켓: marketplace.visualstudio.com, *.vscode.cdn.azure.cn 등 verbose·확장 로그에 나오는 다운로드 URL. MCP: 설정 JSON의 원격 URL, SSE 장기 연결, 토큰·객체 스토리지. 모델 API: 제공자별 API 호스트와 302 체인. 터미널 오류 직후 연결 패널 타임스탬프를 맞춥니다.
# Example — replace hosts; increase -m on slow paths
curl -v -m 25 https://registry.npmjs.org/
curl -v -m 25 https://marketplace.visualstudio.com/
curl -v -m 25 https://api.anthropic.com/
curl -v -m 25 https://api.openai.com/2TUN 켜기와 IDE·터미널 동시 확인
Meta 계열 클라이언트에서 TUN·규칙 모드를 켠 뒤 드라이버·Helper 권한을 마칩니다. Clash Verge Rev TUN 가이드를 먼저 통과하고, 스택은 gvisor·system 비교를 참고하세요. 같은 세션에서 npm과 VS Code를 연 뒤 Connections에 양쪽 프로세스가 보이는지 확인합니다. 사내 VPN·ZTNA와 기본 라우트가 겹치면 예외·fake-ip-filter로 내부 마켓·미러를 먼저 고정하세요.
3분류 규칙 초안 — PKG·MARKET·AI_API 묶음
거대 RULE-SET·GEOIP 위에 Mixin으로 사용자 조각을 덧붙이는 편이 안전합니다. 관측 호스트를 같은 정책 그룹(예: PKG_PROXY·MARKET_PROXY·AI_API)에 넣어 설치·확장 업데이트·추론이 첫 프레임부터 출구를 바꾸지 않게 합니다.
# Illustration — replace group names; order above catch-all GEOIP/MATCH
rules:
- DOMAIN-SUFFIX,registry.npmjs.org,PKG_PROXY
- DOMAIN-SUFFIX,npmjs.org,PKG_PROXY
- DOMAIN-SUFFIX,marketplace.visualstudio.com,MARKET_PROXY
- DOMAIN-SUFFIX,visualstudio.com,MARKET_PROXY
- DOMAIN-SUFFIX,anthropic.com,AI_API
- DOMAIN-SUFFIX,openai.com,AI_API
- DOMAIN-SUFFIX,googleapis.com,AI_API
# MCP remote gateway hosts from your logs — add above GEOIP-CN
- MATCH,DIRECT참고: MCP 원격만 문제면 MCP·Clash 분류·DNS의 stdio vs SSE 구분을 먼저 읽으세요. 규칙은 위에서 아래 첫 매칭이 승리합니다.
npm·VS Code 프록시와 TUN
npm config get registry·proxy·https-proxy·strict-ssl을 확인합니다. TUN ON 상태에서 npm 프록시를 비운 뒤 동일 명령이 나가는지 비교하세요. VS Code http.proxy가 Mixed Port만 가리키고 터미널은 직연결이면 Cline CLI 설치와 확장 업데이트가 갈라집니다. 기업은 승인된 Nexus·직통 정책을 우선합니다.
4MCP·다중 제공자 API — 장시간 연결과 노드 고정
Cline이 MCP 도구와 모델을 동시에 쓰면 짧은 REST와 긴 스트리밍·SSE가 섞입니다. url-test가 세션 중 노드를 바꾸면 끊긴 것처럼 보이므로 디버깅 중에는 selector로 AI_API 그룹을 고정하세요. Claude Code CLI TUN·Codex CLI·Gemini CLI npm 글과 같은 패턴이며 호스트 목록만 로그로 갱신하면 됩니다.
5DNS·FakeIP·스니퍼
규칙에 DOMAIN을 썼는데 DNS 모듈이 다른 경로로 풀면 “DIRECT인데 이상하다”는 착시가 납니다. DNS 유출 방지·fake-ip-filter·nameserver-policy로 MCP·모델 API 이름을 규칙과 일치시키고 변경은 한 축씩만 하세요.
검증 — 전역 설치 대신 가벼운 프로브
매번 전체 npm install -g로 부딪치지 말고: (1) registry curl -Iv, (2) 마켓 HEAD 요청, (3) 사용 중인 API 헬스 경로. TUN ON 후에도 안정적 직연결 타임아웃이면 MTU·인증서·회선 쪽을 의심합니다. Windows WSL2 안의 Node는 WSL2·Git·npm 연계를 적용하세요.
Cline 마이그레이션 간이 체크리스트
- 네 층(registry·마켓·MCP·API) 중 어느 단계에서 멈췄는지 로그로 구분했는가.
- 관측 FQDN이 규칙 트리 어디서 첫 매칭되는가.
- TUN ON/OFF로 증상이 근본적으로 바뀌는가.
- VS Code·터미널·브라우저 DoH가 코어 DNS를 덮지 않는가.
- 한 번에 한 설정만 변경했는가.
자주 묻는 질문
확장만 안 받아지고 npm은 되는 경우
MARKET_PROXY에 없는 CDN 하위 도메인이거나 VS Code만 다른 프록시를 씁니다. 확장 로그의 다운로드 URL 전체를 규칙에 추가하세요.
MCP는 로컬인데 모델만 실패
stdio MCP는 네트워크 없이 동작할 수 있습니다. 실패는 거의 항상 모델 API 층—AI_API 규칙·DNS·노드 고정을 점검하세요.
정책·약관
조직 네트워크·클라우드 데이터 처리 지침을 지키고 API 키·로그를 공개 채널에 올리지 마세요.
준수: 회사 보안·로깅 정책을 위반하지 마세요. 진단 URL·키는 로컬에만 보관합니다.
맺음말
Cline SDK·Cline CLI 마이그레이션은 npm·확장 마켓·MCP·다중 모델 API가 동시에 열립니다. 브라우저만 프록시를 타면 반쯤 성공 상태가 반복되므로 TUN으로 IDE·터미널을 한 파이프에 올리고, 로그 기반 분류 규칙과 DNS를 같은 축에서 맞추는 것이 재현성이 가장 높습니다. 다른 Agent CLI 글에서 익힌 순서를 그대로 쓰되 호스트 목록만 Cline 세션 로그로 갱신하세요.
범용 프록시 도구는 터미널마다 환경 변수를 복사해야 해 GUI가 띄운 셸에서 자주 깨집니다. Clash Meta 클라이언트는 구독·규칙·Connections를 한 화면에서 보며 네 층을 동시에 대조할 수 있습니다. 아직 쓰지 않았다면 Clash 클라이언트를 무료로 받아 본문 순서대로 TUN·규칙·DNS를 맞춘 뒤 npm 설치와 Cline 확장 업데이트·MCP·모델 호출이 같은 출구로 안정하는지 비교해 보세요.