Anthropic 콘솔은 되는데 Claude Code만 타임아웃이면 어디부터 보나요?

먼저 Claude Code를 실행한 터미널 또는 IDE 통합 터미널의 HTTPS_PROXY·ALL_PROXY가 설정돼 있는지 확인합니다. 브라우저와 다른 셸이면 변수가 비어 있을 수 있으며, 이때는 TUN 모드로 CLI 트래픽을 Mihomo에 태우거나 동일 포트로 export한 뒤 재시도합니다.

npm install은 되는데 Anthropic API만 실패할 때는?

npm과 api.anthropic.com이 서로 다른 정책 그룹에 걸렸을 가능성이 큽니다. 패널 로그에서 각 호스트가 탄 GROUP 이름을 비교하고, TLS 핸드셰이크 단계에서 reset이면 노드 회선을, DNS만 느리면 해석 모드를 점검합니다.

Claude Opus 4.7로 바꾼 뒤 갑자기 느려졌다면 프록시 문제인가요?

모델 교체 자체가 라우팅을 바꾸지는 않지만, 더 긴 컨텍스트로 요청 본문이 커지면 업링크 지연이 체감됩니다. 동일 API 키로 curl 테스트해 응답 시간을 재고, 프록시 없이도 느리면 할당량·리전 이슈를, curl만 빠르면 규칙·노드를 의심합니다.

Cursor와 Claude Code를 같이 쓸 때 충돌이 있나요?

두 도구가 서로 다른 터미널·프록시 설정을 쓰면 한쪽만 안정일 수 있습니다. 시스템 프록시는 하나로 두고, 각 IDE가 띄운 셸에 동일한 HTTPS_PROXY 문자열을 주거나 TUN으로 프로세스를 통일하는 편이 재현이 쉽습니다.

Claude Code·Clash Verge Rev

2026년 들어 Agentic AI와 Claude Opus 4.7를 중심으로 터미널에서 코드를 다루는 Claude Code가 빠르게 퍼지고 있습니다. 같은 개발기에서 Cursor와 비교·병행하는 사용자도 많은데, 공통으로 겪는 증상은 「Anthropic 콘솔·문서는 열리는데 Claude Code나 Anthropic API 호출만 타임아웃·연결 실패」입니다. 회사망이라면 방화벽 이슈가 먼저 의심되지만, 집·개인 환경에서는 브라우저와 Node 기반 CLI가 서로 다른 프록시·DNS 경로를 타는 경우가 더 흔합니다.

본 글은 Clash Verge Rev(Mihomo 코어)로 api.anthropic.com 등 API 트래픽, npm·GitHub 패키지 다운로드까지 한 번에 정렬한 실측 노트입니다. Anthropic 공식 기능을 대체하지 않으며, 회사 규정을 지키는 범위에서 프록시 분기와 타임아웃 진단 순서만 정리합니다.

Windows에서 시스템 프록시·TUN 초기 세팅이 필요하면 Clash Verge Rev Windows 완전 구성 튜토리얼을 먼저 마친 뒤 이 글을 읽으면 흐름이 자연스럽게 이어집니다.

왜 브라우저와 Claude Code·npm이 같은 PC인데 결과가 다를까요?

Anthropic 콘솔·문서 페이지는 시스템 HTTP(S) 프록시를 따르는 경우가 많습니다. 반면 Claude Code는 터미널이나 IDE가 띄운 셸에서 Node 런타임으로 Anthropic API에 직접 붙으며, http_proxy를 무시하거나 별도 DNS 해석기를 쓰기도 합니다. npm install은 또 registry.npmjs.org·github.com으로 갈라지기 때문에, API만 안정이고 패키지는 실패하는 «반쪽 성공» 패턴이 자주 보입니다.

Claude Opus 4.7처럼 컨텍스트가 긴 모델을 쓰면 요청 본문이 커져 업링크 지연이 체감되기 쉽습니다. 이를 순수 네트워크 장애로만 보면 노드만 바꾸다 끝나지만, 실제로는 규칙 미스·셸 변수 누락·TUN 미적용이 겹친 경우가 많습니다.

핵심은 동일 시나리오에서 «어떤 프로세스가 어떤 정책 그룹을 탔는가»를 Clash Verge Rev 로그와 curl -v로 겹쳐 보는 것입니다. API 키 오류(401)와 연결 실패(타임아웃·reset)를 먼저 구분해야 헛수고를 줄일 수 있습니다.

1단계：Anthropic·npm·GitHub 호스트 묶음 정리

실제 워크플로에 맞춰 나열합니다： 브라우저의 콘솔·docs.anthropic.com, CLI·SDK가 치는 api.anthropic.com, npm install 시 registry.npmjs.org·tarball CDN, 그리고 private 패키지나 @anthropic-ai 스코프가 가리키는 github.com까지 포함합니다.

API 계층：api.anthropic.com — Claude Code·Messages API의 중심.
문서·콘솔：브라우저 전용 호스트 — 시스템 프록시와 잘 맞는 편.
패키지：npm·GitHub — Claude Code CLI 설치·업데이트 경로와 겹침.
사내 미러：내부 Verdaccio 등은 NO_PROXY 또는 DIRECT 규칙으로 분리.

2단계：Clash Verge Rev 규칙으로 Anthropic 묶음 만들기

활성 프로필 YAML에서 Anthropic·개발 레지스트리를 한 정책 그룹(예: AI-DEV)에 두거나, API와 npm을 나눠 각각 업링크를 지정할 수 있습니다. 중요한 것은 Claude Code가 쓰는 호스트와 npm이 같은 의도의 경로를 타는지입니다. 구독 RULE-SET이 오래되면 신규 CDN 호스트가 빠져 간헐 실패가 날 수 있으니 주기적으로 갱신하세요.

# Example shape only — adapt GROUP names to your subscription
rules:
  - DOMAIN-SUFFIX,anthropic.com,AI-DEV
  - DOMAIN,api.anthropic.com,AI-DEV
  - DOMAIN-SUFFIX,npmjs.org,PKG-DEV
  - DOMAIN-SUFFIX,github.com,PKG-DEV
  - PROCESS-NAME,node,AI-DEV
  - MATCH,RELAY-GROUP

예시는 개념용입니다. 회사망에서는 허용된 업링크만 쓰도록 정책을 따르세요. 규칙으로 회사 차단 구간을 우회하는 설정은 승인 없이 하면 안 됩니다.

3단계：브라우저용 시스템 프록시와 혼합 포트

Anthropic 콘솔 속도는 OS 시스템 프록시와 Clash 패널의 «시스템 프록시» 토글이 일치할 때 먼저 안정됩니다. Windows는 예외 목록에 로컬 주소가 있는지, macOS는 관리 프로파일이 프록시를 덮는지 확인합니다. 혼합 포트(예: 7890)는 터미널 curl --proxy 테스트의 기준선이 됩니다.

4단계：Claude Code CLI와 TUN

터미널에서 claude를 실행했는데 프록시 변수가 비어 있으면 API만 실패할 수 있습니다. Node가 HTTP_PROXY를 놓치면 TUN 모드나 PROCESS-NAME 규칙으로 Mihomo에 편입시키는 방법을 검토합니다. 다른 VPN과 동시에 켜져 라우팅이 이중이면 한쪽을 끈 뒤 재시도하세요.

Claude Code를 실행한 셸에서 echo $HTTPS_PROXY로 변수 존재 여부를 확인합니다.
동일 셸에서 curl -v https://api.anthropic.com로 TLS·프록시 경로를 봅니다(401이어도 연결 성공이면 경로는 통과).
여전히 실패하면 TUN을 잠깐 켠 구성과 비교한 뒤, 조직 정책에 맞는 최소 설정만 남깁니다.

5단계：npm·GitHub 프록시와 셸 변수 동기화

npm config get proxy와 셸 export HTTPS_PROXY=...가 서로 다른 포트를 가리키면 «API는 됨·install만 실패»가 반복됩니다. 사내 레지스트리만 NO_PROXY에 두고, 공인 npm·GitHub는 API와 같은 업링크를 쓰도록 맞춥니다.

# Shell — replace port with your Clash mixed port
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
export NO_PROXY=localhost,127.0.0.1,<internal-registry.example>

npm config set proxy http://127.0.0.1:7890
npm config set https-proxy http://127.0.0.1:7890

ANTHROPIC_API_KEY는 프록시와 무관하지만, 키가 유효해도 경로가 막히면 타임아웃처럼 보입니다. 키·할당량 확인 후 네트워크 층을 좁히세요.

6단계：증상별 체크리스트

콘솔 OK·Claude Code만 타임아웃：IDE 통합 터미널 변수·TUN·PROCESS-NAME.
npm만 ECONNRESET：npm proxy 설정·registry.npmjs.org 규칙 그룹.
Opus 4.7 전환 후만 느림：요청 크기·노드 대역·keep-alive; curl로 프록시 on/off 비교.
Cursor는 됨·Claude Code만 실패：각 IDE가 띄운 셸의 프록시 문자열 통일.

실무 시나리오 요약표

증상	우선 점검
Anthropic 문서 빠름 · API 타임아웃	api.anthropic.com 규칙·셸 HTTPS_PROXY·curl -v
Claude Code 대화 OK · npm install 실패	npm config proxy·github.com·npmjs.org 그룹
간헐적 529·과부하 메시지	업스트림 할당량; 프록시 노드 동시 연결 수
프록시 끄면 모두 실패	지역·ISP 제한; 규칙·노드 선택 자체는 필요

자주 묻는 질문

Anthropic 콘솔은 되는데 Claude Code만 타임아웃일 때 첫 순서는?

Claude Code를 연 터미널의 HTTPS_PROXY·ALL_PROXY를 확인하고, 브라우저와 다른 셸이면 동일 포트로 export하거나 TUN으로 CLI를 Mihomo에 태웁니다.

npm은 되는데 Anthropic API만 실패하면?

api.anthropic.com과 npm 호스트가 다른 정책 그룹에 걸렸는지 패널 로그로 비교합니다. TLS reset이면 노드, DNS만 느리면 해석 모드를 봅니다.

Claude Opus 4.7로 바꾼 뒤 느려진 것 같을 때?

컨텍스트 길이로 페이로드가 커진 영향일 수 있습니다. 동일 API 키로 curl 응답 시간을 재고, 프록시 없이도 느리면 할당량·모델 측을, curl만 빠르면 규칙·노드를 의심합니다.

Cursor와 Claude Code를 같이 쓸 때?

시스템 프록시는 하나로 두고, 각 IDE 터미널에 같은 프록시 문자열을 주거나 TUN으로 프로세스 경로를 통일하면 재현이 쉽습니다.

정리하면 Claude Code·Anthropic API·npm을 한 개발 루프로 쓰려면 Clash Verge Rev에서 규칙 묶음·시스템 프록시·터미널 변수·필요 시 TUN을 같은 타임라인에 맞춰 두는 것이 중요합니다. 환경이 바뀔 때마다 짧은 curl·npm 헬스 체크로 고정 상태를 다시 확인하세요.

Claude Code 실측：Clash Verge Rev로 Anthropic API·npm 안정 접속 분기하기