클로드 코드 설치 오류

남기춘

작성한 질문수 1

0

안녕하세요, 인프런 AI 인턴입니다.

남기춘님, 오류 메시지의 EPROTO와 tls_validate_record_header: wrong version number는 Node.js 버전보다는 npm이 npm 저장소에 접속하는 과정에서 프록시 또는 네트워크 설정이 충돌할 때 주로 발생합니다.

먼저 npm 저장소 설정을 확인해 주세요.

npm config get registry
npm config get proxy
npm config get https-proxy

정상적인 registry 값은 다음과 같아야 합니다.

https://registry.npmjs.org/

회사 네트워크나 VPN을 사용하지 않는 환경이라면 프록시 설정을 삭제한 후 다시 설치해 보세요.

npm config delete proxy
npm config delete https-proxy
npm config set registry https://registry.npmjs.org/
npm cache verify
npm install -g @anthropic-ai/claude-code

Windows 환경 변수에 프록시가 등록되어 있을 수도 있으므로 명령 프롬프트에서 다음 명령도 실행해 주세요.

set HTTP_PROXY=
set HTTPS_PROXY=
set http_proxy=
set https_proxy=

그 후 다시 설치합니다.

npm install -g @anthropic-ai/claude-code

회사 또는 기관 네트워크를 사용 중이라면 보안 프록시가 HTTPS 연결을 가로채면서 현재 오류가 발생할 수 있습니다.

이 경우에는 다음 방법 중 하나를 시도해 주세요.

1. 회사 VPN을 잠시 해제하고 개인 네트워크 또는 모바일 핫스팟에서 설치
2. 회사에서 제공한 npm 프록시 주소를 npm proxy 설정에 등록
3. 사내 인증서가 있다면 IT 담당자에게 Node.js/npm용 인증서 설치 요청

프록시 주소를 알고 있다면 다음과 같이 설정할 수 있습니다.

npm config set proxy http://아이디:비밀번호@프록시주소:포트
npm config set https-proxy http://아이디:비밀번호@프록시주소:포트

비밀번호에 @, #, % 같은 특수문자가 포함되어 있다면 URL 인코딩이 필요하므로, 가능하면 회사 IT 담당자에게 설정 방법을 확인해 주세요.

현재 출력해 주신 node -v는 v24.20.0이고, 오류 자체는 npm의 TLS 접속 단계에서 발생했기 때문에 우선 프록시와 네트워크 설정을 점검하는 것이 좋습니다.

다만 설치 후 다른 호환성 문제가 발생한다면 Node.js 최신 버전보다는 LTS 버전인 Node.js 22를 사용하는 것을 권장합니다.

참고로 버전 확인 명령은 rpm -v가 아니라 다음 명령입니다.

npm -v

문제가 계속되면 다음 명령의 결과와 npm config get proxy, npm config get https-proxy 결과를 함께 확인해 보시면 원인을 더 정확히 파악할 수 있습니다.

npm -v
npm config list

Spring Boot 설치 문서에서도 개발 도구를 실행하기 전에 Java와 같은 필수 실행 환경의 버전을 먼저 확인하도록 안내하고 있으므로, Claude Code 설치 전 Node.js와 npm 버전을 확인하는 현재 방식은 올바릅니다.

참고 자료:
https://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/#getting-started.first-application.prerequisites