클로드 코드 (Unable to connect to API) - USB 이더넷 어댑터 연결 시 통신 오류

Wi-Fi로 클로드 코드를 사용하던 중 PC에 특정 USB 이더넷 어댑터를 꽂는 순간 API 연결이 끊기는 일이 있었다. 당시 브라우저로 claude.ai에 접속하면 채팅기능은 멀쩡히 쓸 수 있는데 클로드 코드 사용 시에만 네트워크 오류가 발생하는 것이다. 원인을 확인해보니 라우팅 테이블 문제였다.

 

 

원인

Windows에서 네트워크 어댑터가 여러 개 연결되면 각 어댑터에 default route(0.0.0.0/0)가 생길 수 있다. 이 경우 메트릭이 낮은 쪽이 우선으로 트래픽을 처리하는데, '자동메트릭'으로 설정되어 있으면 어댑터의 Link speed(대역폭)을 기준으로 메트릭이 설정되기 때문에 Wi-Fi보다 유선 연결이 더 낮은 메트릭 값을 할당받는 경우가 많다.

 

즉, USB 이더넷 어댑터 쪽의 메트릭이 더 낮고, 인터넷에 연결되어 있지 않으면서, 게이트웨이는 실제 존재하는 경우, 클로드 코드의 API 요청이 해당 경로로 나가서 통신이 안됐던 것이다.

 

> route print

IPv4 Route Table
===========================================================================
Active Routes:
Network Destination        Netmask          Gateway       Interface  Metric
          0.0.0.0          0.0.0.0     192.168.10.1    192.168.10.123    36  <-- Ethernet
          0.0.0.0          0.0.0.0     10.204.93.39    10.204.93.220    200  <-- Wi-Fi

 

 

✓ default route : 목적지가 0.0.0.0/0으로 설정된 경로로, 라우팅 테이블에서 일치하는 경로가 없을 때 기본으로 사용한다. 0.0.0.0/0은 모든 IP에 매칭되지만, 더 구체적인 경로가 있는 경우 그쪽이 우선한다.

 

✓ 메트릭 : 낮을수록 우선순위가 높다. 동일한 목적지로 가는 경로가 여러 개면 OS는 메트릭이 가장 낮은 경로를 선택한다.

 

해결 방법

제어판 > 네트워크 및 공유센터 >  어댑터 설정 변경

 

해당 네트워크 어댑터 우클릭 > 속성 > 인터넷 프로토콜 버전 4 (TCP/IPv4) 선택 > 속성

 

방법 1 : 기본 게이트웨이 제거

 

기본 게이트웨이 항목을 비운다.

 

방법 2 : 메트릭 수동 고정

 

고급 > IP 설정 탭에서 자동 메트릭 체크를 해제하고 Wi-Fi의 메트릭보다 높은 값을 입력한다.