Windows WSL 환경 Claude Code OAuth 로그인 타임아웃 장애 분석

Context

Windows WSL 환경의 Claude Code 로그인 프로세스 장애 발생. Google OAuth 인증 과정에서 네트워크 응답 지연으로 인한 세션 만료 현상. 사용자 접근이 완전히 차단된 Blocking 이슈.

Technical Solution

• Google 계정 기반 OAuth 인증 플로우 수행
• 브라우저 기반 로그인 완료 후 Claude Code 애플리케이션으로의 콜백 처리
• Windows Subsystem for Linux(WSL) 네트워크 인터페이스와 호스트 OS 간의 통신 경로 확인
• OAuth 인증 응답 대기 시간 15,000ms 초과 시 발생하는 타임아웃 예외 처리
• 인증 토큰 수신을 위한 로컬 리스너의 포트 바인딩 및 네트워크 도달 가능성 검증

Impact

• OAuth 인증 타임아웃 임계치 15,000ms

Key Takeaway

가상화 네트워크 환경(WSL)에서는 호스트와 게스트 간의 포트 포워딩 및 루프백 주소 처리 방식이 인증 플로우의 안정성에 결정적인 영향을 미침.