증상: 에이전트 CLI는 도는데 API·npm만 끊길 때

OpenClaw처럼 터미널에서 장시간 돌아가는 에이전트 러너를 쓰다 보면 체감 증상이 세 갈래로 갈라집니다. 첫째, 프롬프트 입력과 로컬 로그는 멀쩡한데 원격 도구 호출이나 모델 응답만 끊기는 API 타임아웃 패턴입니다. 둘째, 스트리밍까지는 되는데 npm install·pnpm add 같은 패키지 단계에서만 레지스트리가 멈추는 npm·레지스트리 전용 실패입니다. 셋째, 빌드 스크립트는 받아오는데 git fetch나 릴리스 자산이 느린 GitHub 축 병목입니다. 사용자 입장에서는 “같은 프록시인데 왜 지금은 된다가 안 된다”처럼 보여 재현을 설명하기 어렵습니다.

증상 시간대를 쪼개 보면 공통점은 한 애플리케이션이 아니라 서로 다른 TLS SNI가 한 번에 개입한다는 점입니다. 에이전트 CLI는 제어·인증·텔레메트리에 붙는 호스트가 있고, 모델 API는 리전·엔드포인트별 이름이 갈라지며, 패키지 매니저는 registry.npmjs.org와 스코프 미러, 기업 사내 Verdacio 등으로 더 퍼집니다. 이중 하나가 넓은 DIRECT 블록이나 느린 노드 줄에 붙어 있으면 나머지는 빨라도 체감은 “에이전트가 자꾸 죽는다”로 응축됩니다.

이미 사내 ZTNA·분할 터널 VPN, 사내 HTTP 프록시가 있는 노트북이라면 Clash와 경로가 겹칩니다. 그런 환경에서도 사용자가 손댈 수 있는 디버깅 레이어는 대개 규칙 스택 상단의 광역 DIRECT·GEOIP, DNS 모드, 그리고 rule hit 로그의 세 축입니다. 본문은 회사 IT 지침·클라우드 이용약관·데이터 거주 규정을 지키는 범위에서만 적용한다는 전제를 둡니다.

왜 Clash Verge Rev인가: 로그 루프를 짧게 만들기

코어 YAML만 편집해도 최종 동작은 같습니다. 다만 에이전트 워크로드는 실패가 잠깐 나타났다 사라지기 쉬워, 터미널 스크롤과 코어 텍스트 로그만으로는 어느 규칙 줄에 붙었는지 놓치기 쉽습니다. Clash Verge Rev는 실시간 연결·규칙 적중을 GUI로 열어 두고 반복 비교하기 좋아, “노드만 갈아탔는데 npm만 그대로” 같은 케이스를 빨리 좁힙니다. Windows에서 통계·로그 패널을 여는 구체적 클릭 순서는 Verge Rev 트래픽 통계 글과 함께 보면 흐름이 이어집니다.

에디터 기반 에이전트에 익숙하다면 Cursor 3 API 분리 글의 “에디터·모델 출구 나누기” 사고방식을 그대로 가져와도 됩니다. 차이는 IDE UI 대신 에이전트 CLI 세션이 길게 열린다는 점, 그리고 같은 세션 안에서 npm·git 같은 서브프로세스가 한꺼번에 튀어나온다는 점입니다. 멀티레포·코워킹 공간 시나리오는 Anthropic·GitHub·npm 분리 글과 겹치는 부분이 많습니다.

범용 VPN이나 전역 스위치만 있는 클라이언트는 호스트 단위 정책이 빈약해, 개발 트래픽을 세밀하게 나누기 어렵습니다. 반면 Mihomo/Clash 계열은 proxy-group과 DOMAIN 규칙으로 API 타임아웃 원인을 출구별로 분리해 설명할 수 있어, 터미널 중심 업무에 잘 맞습니다.

축 설계: AGENT-CLI·MODEL-API·NPM·GITHUB

이름은 팀 컨벤션에 맞춰 바꿔도 되지만, 로그에 찍히는 정책 문자열이 읽히게 네 덩어리로 시작하면 rule hit 해석이 쉽습니다.

  • AGENT-CLI(런너·제어 플레인): 에이전트 바이너리가 붙는 인증·설정·텔레메트리·내부 게이트웨이 호스트. 세션이 중간에 끊기면 이 축부터 의심합니다. 실제 접미사는 제품 업데이트마다 달라질 수 있으니 연결 로그의 SNI를 모아 목록을 만듭니다.
  • MODEL-API(추론·툴 게이트웨이): OpenAI 호환 게이트웨이, 자체 배포 추론 서버, 또는 조직이 허용한 외부 프로바이더 엔드포인트. 스트림 토큰이 끊기면 TLS 레이턴시와 함께 이 줄을 봅니다.
  • NPM(패키지 레지스트리): registry.npmjs.org뿐 아니라 기업 프록시 레지스트리·스코프 미러·npm.pkg.github.com 같은 변형까지 포함합니다. lockfile을 갱신하는 CI와 로컬이 동시에 실패하면 이 축이 흔한 원인입니다.
  • GITHUB(git·릴리스 자산): github.com, api.github.com, raw.githubusercontent.com, 릴리스 첨부 호스트 등으로 갈라집니다. “코드는 받는데 릴리스 바이너리만 안 받는다”면 이 묶음을 쪼개야 합니다.

DOMAIN-KEYWORD,agent처럼 지나치게 넓은 한 줄은 사내 모니터링·문서 사이트까지 잡아 오탐을 키웁니다. 초기에는 DOMAIN-SUFFIX로 좁히고, Verge Rev 연결 목록에 반복 등장하는 이름만 단계적으로 추가하세요. 원격 규칙 세트를 합치는 팀이라면 Rule Providers 병합 순서도 함께 점검합니다.

OpenRouter 같은 집계형 API를 같이 쓴다면 OpenRouter 분리 글의 호스트 묶음을 MODEL-API 쪽 레퍼런스로 삼을 수 있습니다. 핵심은 예시 YAML을 그대로 복사하지 말고, 본인 터미널에서 잡힌 Host 문자열을 기준으로 다시 쓰는 것입니다.

YAML 출발점: proxy-group과 규칙 예시

아래 블록은 교육용 스켈레톤입니다. 프로필 맨 아래의 넓은 MATCH, 상단의 GEOIP·국내 직결 블록과 충돌하지 않는지, 그리고 에이전트 전용 줄이 그보다 위에 왔는지 확인하세요.

# Example — replace suffixes with hosts from your Verge Rev connection log
proxy-groups:
  - name: AGENT-CLI
    type: select
    proxies:
      - ♻️ Auto
      - 🇸🇬 Low-latency
      - DIRECT
  - name: MODEL-API
    type: select
    proxies:
      - ♻️ Auto
      - 🇯🇵 Stable-stream
      - DIRECT
  - name: NPM-REGISTRY
    type: select
    proxies:
      - 🌐 Global-egress
      - ♻️ Auto
      - DIRECT
  - name: GITHUB-ASSETS
    type: select
    proxies:
      - 🌐 Global-egress
      - ♻️ Auto
      - DIRECT

rules:
  - DOMAIN-SUFFIX,registry.npmjs.org,NPM-REGISTRY
  - DOMAIN-SUFFIX,npm.pkg.github.com,NPM-REGISTRY
  - DOMAIN-SUFFIX,github.com,GITHUB-ASSETS
  - DOMAIN-SUFFIX,api.github.com,GITHUB-ASSETS
  - DOMAIN-SUFFIX,raw.githubusercontent.com,GITHUB-ASSETS
  # Append agent/control-plane hosts you captured into AGENT-CLI
  # Append model API hosts you captured into MODEL-API
  # Keep these lines above broad DIRECT / GEOIP blocks

실제 OpenClaw 릴리스가 붙는 호스트 문자열은 버전에 따라 달라질 수 있습니다. 위 예시의 주석 자리에 연결 로그에서 복사한 접미사를 채우고, 테스트용 프로필에서 안정 패턴을 찾은 뒤 일상 프로필로 옮기면 업무 환경을 덜 흔들 수 있습니다.

규칙 우선순위와 DIRECT 오매칭

API 타임아웃이 간헐적이라면, 실패한 시각에 Verge Rev가 보여 준 rule hit 한 줄이 출발점입니다. 오래된 “국내 도메인 전부 DIRECT” 같은 초광역 규칙이 위에 있으면 새로 넣은 MODEL-API 줄이 호출되지 않습니다. 반대로 모든 HTTPS를 한 그룹에 몰아넣으면 레지스트리와 릴리스 CDN까지 먼 노드를 돌아 지연만 커질 수 있습니다.

처음 규칙 파일을 손본다면 사용자 정의 라우팅 입문 자료를 함께 읽고 문법 감각을 맞춘 뒤 이 글의 축 설계를 적용하세요. 핵심은 이름을 길게 늘리는 것이 아니라 매칭 순서를 로그로 증명하는 것입니다. 동일한 증상이라도 팀 레포의 GEOIP 블록 위치가 다르면 결과가 달라집니다.

DNS·fake-ip·TUN/시스템 프록시 교차점

fake-ip 프로필에서 코어가 돌려 준 가짜 주소와 셸이 본 실제 주소가 어긋나면, 같은 터미널 탭이라도 하위 프로세스마다 출구가 달라지는 패턴이 생깁니다. redir-host로 바꿔 재현이 사라지는지, fake-ip-filter에 레지스트리·Git 호스트를 넣어야 하는지 단계적으로 비교하세요.

TUN 모드와 시스템 프록시를 동시에 켠 상태면 경로가 이중으로 갈라지기도 합니다. 게임·브라우저와 달리 에이전트 CLI는 장시간 열린 연결이 많아 이중 경로가 터미널에만 드러나기도 합니다. 초기 설치 맥락은 Windows 11 설치 글의 시스템 프록시 설명과 함께 읽으면 전체 그림이 잡힙니다.

대시보드에는 연결된 것처럼 보이는데 화면만 비는 패턴이라면 DNS부터 좁히는 편이 빠른 경우가 많습니다. QUIC·HTTP/3가 켜진 환경이라면 UDP 경로도 같은 시각에 점검하세요.

자가 점검 절차

아래 순서를 이슈 본문에 붙여 두면 “에이전트 CLI만 재현” 같은 모호한 리포트가 Host·정책 이름이 적힌 로그로 바뀝니다.

  1. 타임아웃 직전 터미널에 찍힌 명령과 시각을 저장하고, Verge Rev 연결 목록에서 대응하는 Host 문자열을 내보냅니다.
  2. 같은 시각 rule hit 한 줄로 어떤 정책 그룹에 매칭됐는지 확인합니다.
  3. AGENT-CLI·MODEL-API·NPM-REGISTRY·GITHUB-ASSETS에 서로 다른 노드를 임시 지정해 증상이 어느 축에서 좁혀지는지 봅니다.
  4. DNS 모드·업스트림 DoH·fake-ip-filter를 바꿔 재현이 유지되는지 비교합니다.
  5. 사내 프록시·SSL 가시성·분할 VPN과 Clash가 동시에 개입하지 않는지 OS 네트워크 설정에서 확인합니다.
  6. IPv6 경로가 의도치 않게 빠져나가지 않는지 인터페이스 우선순위와 함께 봅니다.

한 번 맞춰 둔 YAML을 영구 신뢰하지 말고, 분기 릴리스마다 연결 로그 샘플을 다시 모으세요. SaaS·에이전트 제품은 배포 때문에 호스트 문자열이 조용히 바뀌기도 합니다.

프록시·우회 도구는 관할법·고용 계약·조직 보안 정책·클라우드 약관을 위반하는 용도로 사용해서는 안 됩니다. 회사 장비에서는 IT 지침을 따르고, 테스트는 본인 관리 기기에서만 수행하세요.
에이전트 CLI 로그에 붙일 rule hit 스크린샷 템플릿을 팀 위키에 만들어 두면, npm·GitHub만 실패하는 케이스를 “노드 불량”이 아니라 “어느 SNI가 DIRECT에 붙었다”는 증거로 바꿀 수 있습니다.
코어·GUI 릴리스를 추적할 때 설치 패키지의 단일 출처를 팀에 고정하려면 본 사이트 다운로드 페이지를 링크로 모으는 편이 혼선이 적습니다.

자주 묻는 질문

Q. 에이전트 바이너리 한 줄만 PROXY로 보내면 되지 않나요?
A. CLI가 붙는 인증·제어 플레인과 패키지 레지스트리, Git 호스트는 서로 다른 SNI로 갈라집니다. 단일 호스트 규칙으로는 npm·GitHub 타임아웃이 남을 수 있습니다.

Q. Clash Verge Rev 없이 코어만으로 충분하지 않나요?
A. 코어 YAML만으로도 동작하지만, 에이전트 디버깅은 실시간 연결과 규칙 적중을 반복 봐야 해서 GUI가 피드백 루프를 짧게 만듭니다.

Q. API 타임아웃이면 노드만 바꾸면 되지 않나요?
A. 출구가 섞이면 빠른 노드로 옮겨도 특정 경로만 여전히 DIRECT에 묶여 있습니다. rule hit로 어떤 줄에 걸렸는지 먼저 확인하세요.

정리

일부 범용 VPN이나 전역 토글 위주 클라이언트는 호스트 단위 정책이 빈약해 에이전트 CLI가 끊길 때 어느 요청이 어느 출구로 나갔는지 추적하기 어렵습니다. 결국 노드만 바꿔 가며 시간을 쓰게 되고, 터미널 중심 업무에서는 그 방식이 특히 비효율적입니다.

반면 Clash·Mihomo 계열은 Clash Verge Rev와 함께 쓰면 proxy-group으로 MODEL-API·npm·GitHub 축을 분리한 채 같은 로그 스트림에서 DNS와 rule hit까지 연속 점검할 수 있어, API 타임아웃을 재현 가능한 Host 목록으로 바꾸기 쉽습니다. 긴 세션을 유지하는 에이전트 러너와 짧은 버스트로 끊기는 레지스트리 실패를 한 화면에서 동시에 보는 경험은 설정 품질을 빠르게 끌어올립니다.

클라이언트 출처를 먼저 정리한 뒤 이 글의 규칙을 얹고 싶다면 본 사이트 클라이언트 다운로드 페이지에서 플랫폼별 패키지를 확인해 주세요. 라우팅 개념을 넓히려면 문서 허브의 고급 설정 파트를 이어 읽으면 흐름이 연결됩니다.

우선 경험부터 맞추고 싶다면 본 사이트 다운로드 페이지에서 클라를 받은 뒤, 위 절차로 에이전트 전용 프로필을 따로 두고 Verge Rev 로그와 함께 점검해 보시기 바랍니다.

→ 지금 무료로 Clash를 받아 OpenClaw·에이전트 CLI와 npm·GitHub 출구를 안정적으로 맞춰 보기

다운로드 페이지에서 Clash 클라이언트 받기