1 브라우저 OK·터미널만 «항상 시간 초과»인 실체
클로드 코드류 터미널 에이전트는 한 프로세스가 수십 종의 이름을 순서 없이 불러옵니다. 첫 진입에서는 npm registry 메타 조회와 tarball 다운로드가 이어지고, 실행 즉시 Anthropic 콘솔 호스트 계열 인증 또는 스트림형 Anthropic API를 붙잡습니다. 이때 사용자 망에서는 브라우저가 시스템 PAC를 따르는데 네이티브 node는 그대로 라우팅된다든지, 회사 게이트웨이만 통과해야 하는 회선에 직영 DNS가 깨져 있다든지 하는 작은 간극이 곧바로 장시간 응답 없음으로 번역됩니다. 문제를 «플랫폼 버그라서 기다린다»로만 놓두면 패치마다 패턴이 달라지므로 Mihomo 같은 엔진의 Connections 탭과 동일 시간대 로그 한 줄 한 줄 대조하는 접근이 낫습니다.
기존 Claude·Anthropic 규칙이 있다면 재사용하되 Claude Code CLI용으로 패키지·도구 레이어만 더 얹습니다. 브라우저 전용 카테고리를 그대로 터미널에 복사해 넣지 말고, 실제 재현 순서별로 줄을 새로 줄 세우세요. 과도하게 넓은 GEOSITE 묶음이 먼저 붙어버리면 브라우저와 같은 호스트임에도 규칙 이름만 다르게 잡히는 일이 발생합니다.
출시 채널마다 패키지 스코프·호스트 문자열은 바뀔 수 있습니다. 아래 접미사는 출발 표이므로 장애 순간 로그 기준 패치가 가장 신뢰합니다.
2 @anthropic-ai 패키지와 npm registry 깊숙이 붙는 호스트
공개 패키지를 npm 채널로 설치하면 1순위는 보통 registry.npmjs.org, 문서·웹 허브 npmjs.com입니다. 패키지가 릴리스 자산만 GitHub 방식으로 끌어오도록 의존성을 선언하면 objects.githubusercontent.com, codeload.github.com 계열까지 같이 따라옵니다. 사내 npm registry 거울만 예외 허용한 팀이라면 접미사가 전부 교체되므로 레퍼런스 YAML 그대로 복사하면 신규 멤버 터미널부터 어긋납니다.
패키지 전역 설치나 npx 다운그레이드 실험이 겹치면 캐시 서버 접두사가 새로 노출되기도 합니다. 패턴을 DOMAIN-SUFFIX로 깔 때는 문자열 크기 순이 아니라 «실패 직후 FQDN» 순으로 메모했다가 정리해야 충돌이 줄습니다. MCP나 확장 패키지를 동시에 쓸 때는 npm·GitHub·MCP 설치 규칙을 함께 include하는 게 반복 디버깅 비용을 낮춥니다.
3 Anthropic 로그인·콘솔 호스트와 API 세션 레이턴시
조직별 정책에 따라 디바이스 코드·브라우저 보조 페이지가 활성화되면 anthropic.com 하위 이름과 claude.ai 교차 화면이 동시에 뜹니다. 본 실행 이후 장시간 열리는 경로에는 api.anthropic.com 중심의 Anthropic API 종단이 포함되며 긴 SSE·스트림 응답은 중간에서 노드 교체 빈도가 높으면 끊깁니다. 스트림 구간에서는 동일 프록시 그룹을 유지하도록 Runbook 한 줄이라도 두는 편이 실무적으로 안전합니다.
Anthropic 호스트 줄을 조직 허용 IP대와 교차 검증해야 하는 환경에서는 보안 검열 프록시가 TLS를 재서명하면서 패킷 레이턴시가 튀고, 결과만 보면 API 타임아웃 같이 보입니다. 이 경우 접미사 수정만으로 안 풀릴 때가 많으므로 허브망 허용 목록·검증 체인을 먼저 확인하세요.
4 선택 격리·Sandbox가 컨테이너를 부를 때
일부 에이전트 워크플로는 사용자 파일을 격리해 실행할 때 레지스트리에서 이미지 레이어를 받아야 합니다. 그때 등장하는 축은 registry-1.docker.io, 인증 허브 auth.docker.io, CDN 성격 문자열 같은 전형적인 패턴입니다. 터미널에서는 설치까지 됐지만 격리 스텝에서만 깨진다면 동일 패턴으로 OpenAI Codex CLI 예시처럼 컨테이너 접미사를 한 블록에 묶어두었다가 활성 프로필만 켭니다.
호스트 OS의 Clash 분할이 맞더라도 Linux VM 속 dockerd가 프록시를 모르면 동일 증상이 반복되니, 브리지 네트워크 라우팅을 먼저 그린 뒤 접미사를 넣습니다. 게이트웨이 교차 디버깅 패턴은 WSL2나 Hyper-V·NAT 글을 참조하면 시간을 아낄 수 있습니다.
5 복사용 DOMAIN-SUFFIX 스니펫 (그룹명은 교체)
아래는 개념 스케치입니다. PROXY-DEV-CODE를 본인 proxy-groups 이름으로 바꿉니다. 패키지 스코프·호스트 문자열 업데이트나 사내 NPM 미러는 직접 덧대세요.
# npm & hubs (mirror hostnames omitted)
- DOMAIN-SUFFIX,npmjs.com,PROXY-DEV-CODE
- DOMAIN-SUFFIX,npmjs.org,PROXY-DEV-CODE
- DOMAIN-SUFFIX,registry.npmjs.org,PROXY-DEV-CODE
# GitHub blobs when installs pull release assets
- DOMAIN-SUFFIX,github.com,PROXY-DEV-CODE
- DOMAIN-SUFFIX,codeload.github.com,PROXY-DEV-CODE
- DOMAIN-SUFFIX,objects.githubusercontent.com,PROXY-DEV-CODE
# Anthropic-facing hosts (narrow as your policy permits)
- DOMAIN-SUFFIX,anthropic.com,PROXY-DEV-CODE
- DOMAIN-SUFFIX,api.anthropic.com,PROXY-DEV-CODE
- DOMAIN-SUFFIX,claude.ai,PROXY-DEV-CODE
# Optional container registry if sandbox pulls images
- DOMAIN-SUFFIX,docker.io,PROXY-DEV-CODE
- DOMAIN-SUFFIX,registry-1.docker.io,PROXY-DEV-CODE
- DOMAIN-SUFFIX,auth.docker.io,PROXY-DEV-CODE
# Always prefer literal FQDNs from Mihomo Connections over stale guesses.노드 상태가 들쭉날쭉하면 url-test와 fallback 묶음으로 동일 블록에 걸립니다.
6 Rule Provider로 버전 번들 관리하기
사람이 많은 레포에서는 claude-code-rules.txt 같은 classical 목록을 Git에 두고 Mihomo Rule Provider 연동 패턴이 많이 씁니다. Claude Code CLI 패치도 브랜치명으로 라벨링해 긴급 롤포워드 순서만 문서화하면 교육 시간이 줄어듭니다. 개인 레이어 분리에는 mixin·구독 덮어쓰기 글의 패턴대로 미세 조정 레이어만 얹어도 됩니다.
7 기업 VPN·DNS·FakeIP와 TUN을 한 줄로
Mihomo 레벨에서는 규칙이 맞더라도 OS 리졸버가 엇나가면 DOMAIN-SUFFIX를 보기 전에 실패합니다. DNS·FakeIP 가이드 순서와 맞춰 DoH 채널을 정렬하세요.
회사 분할 VPN이 전역으로 올라가면 개인 레이어만 수정해도 Anthropic API가 조용히 막히는 패턴이 자주 재현되며, 이 맥락은 Windows 기업 VPN 글을 재사용하면 충분합니다. 터미널이 시스템 PAC를 따라가도록 환경 변수를 깔거나 TUN 단일 진입점을 선택하는 우열은 조직별로 다른데 한 가지만 Runbook 표준으로 박습니다.
에디터 레벨의 프록시는 Cursor·Clash와 같이 사용자 경험이 크게 겹치므로, IDE와 셸이 같은 터미널 프로파일이라면 패키지 이름만 다르게 보일 뿐 해결 과정 자체는 유사하게 가져오면 빠른 편입니다. 수동 업데이트가 잦으면 클라이언트 코어 교체 순서 글도 책갈피 두면 재현 테스트가 줄어듭니다.
8 트러블슈팅 체크 표
- npm 레이어만 ETIMEDOUT: tarball과 메타 호스트 문자열 차이부터 비교합니다.
- 웹 Claude OK·코드 에이전트만 무응:
node프로세스의 실제 라우팅과 브라우저 PAC 일치 여부부터 봅니다. - 장시간 응답 스트림 끊김: 중간 노드가 바뀌는 간격만 보아도 패턴 확인이 됩니다.
- MCP 같은 확장 패키지만 느려짐: MCP 전용 패키지 맵을 별도 줄로 깔았는지 점검합니다.
- 격리 단계 한정 실패: 컨테이너 DNS가 내부 NXDOMAIN 되돌림을 하는지 테스트합니다.
9 자주 묻는 질문
웹에서만 되고 터미널 에이전트만 깨져요.
시스템 레벨에서 프록시를 우회하면서 브라우저만 허브망 허용 경로를 쓰면 가장 많이 발생합니다. TUN을 쓰거나 셸 시작 스크립트에 프록시 환경 변수 줄을 포함시키거나, 허브망 허용이 확실한 단일 패턴으로 줄을 모읍니다.
npm 줄도 Anthropic 줄도 같은 그룹이어야 하나요?
강제 규칙은 없지만 동일 업무 패키지 라이프사이클을 한 스프린트에 묶는 팀이라면 같은 전용 묶음이 디버깅을 단순화합니다. 정책상 레지스트리는 직행·허브 API만 프록시 같은 이중 채널이면 표를 명시적으로 두 층 나눕니다.
보안 허브가 TLS를 깨어보면?
규칙 튜닝 이전 문제일 때가 많습니다. 보안 허브에 요청 순서부터 대응하세요.
10 약관·데이터 처리·허브망 정책
본 글은 합법적 개발 허브망 경계 안에서 사용자 경험 패턴 설명 목적입니다. 반출 허드·비밀 키·세션 문자열 거버넌스는 조직별 그대로이며 허브망을 우회해 달라는 뜻이 아닙니다. 설치 프로그램은 공식 배포처를 채택하기 어렵다면 검증 레이어 후 사이트 다운로드를 우선 채택해 출처를 통제하세요.
11 정리
Claude Code CLI는 npm registry에서 받은 실행 파일이 곧바로 장시간 Anthropic API를 붙는 구조입니다. 증상이 겉보기에는 동일하게 API 타임아웃으로 보여도 실제로는 tarball·레지스트리·허브 인증 줄이 순서 바꿔 터집니다. Mihomo 같은 엔진의 Connections 스냅샷 위에 소규모 DOMAIN-SUFFIX 묶음을 올린 뒤 Rule Provider 버전까지 맞추면 동일 패턴 교육이 반복 노력으로 굳습니다.
순수 명령행만 다룰 때는 브라우저만 전제한 오래된 벤더 패키지가 오히려 군더더기처럼 느껴집니다. 수동 업데이트가 잦거나 팀 간 프로필 교환이 헷갈리면 GUI에서 패치 전후 차이와 연결 로그까지 한 번에 보여 주는 Clash 패밀리 클라이언트가 시간을 많이 줄여 줍니다. 구독·규칙·연결 상태를 같은 창 안에서 순환 검토할 수 있는 흐름이면 운영과 개발이 같은 패널 언어로 대화할 수 있고요. 비슷한 단계별 지연이었다면 Clash Verge Rev 계열을 같은 Runbook 안에 포함해 두는 편이 가장 간단하게 체화됩니다.
MCP·브라우저 전용 Anthropic 레퍼런스는 전용 장문으로 나뉘었으므로 링크만 모아 회사 노션에 두면 초기 온보딩 문서 크기 자체가 줄어듭니다.
