Claude Code는 터미널에서 바로 AI와 협업하며 코드를 작성할 수 있는 CLI 도구예요. 원래 맥이나 리눅스 환경에 익숙한 개발자들 사이에서 먼저 알려졌지만, 지금은 윈도우에서도 무리 없이 설치하고 사용할 수 있어요. 오늘은 윈도우 환경에서 Claude Code를 설치하는 방법을 준비물부터 확인 단계까지 순서대로 정리해볼게요.
설치 전 준비물 확인하기
Claude Code를 설치하려면 가장 먼저 Node.js가 컴퓨터에 설치되어 있어야 해요. Claude Code는 Node.js 패키지 형태로 배포되기 때문에 Node.js 18 버전 이상이 설치되어 있지 않으면 설치 자체가 진행되지 않아요. Node.js 공식 홈페이지에서 LTS 버전을 내려받아 설치하면 npm(Node Package Manager)도 함께 설치돼요.
두 번째로 챙겨두면 좋은 준비물은 Git for Windows예요. Claude Code는 작업 중 Git 명령어를 활용해서 변경 사항을 확인하거나 커밋하는 기능을 제공하기 때문에, Git이 미리 설치되어 있으면 훨씬 자연스럽게 작업할 수 있어요.
마지막으로 Anthropic 계정이 필요해요. Claude Code를 실행하려면 로그인 과정을 거쳐야 하는데, 이때 Claude 계정이나 API 키가 있어야 인증이 완료되고 실제 기능을 사용할 수 있어요.
Node.js 설치 확인하는 법
이미 Node.js를 설치한 적이 있다면 새로 설치하기 전에 버전을 먼저 확인하는 게 좋아요. 윈도우 터미널이나 명령 프롬프트를 열고 node -v를 입력하면 현재 설치된 Node.js 버전이 출력돼요. 이 값이 v18 미만이라면 최신 LTS 버전으로 업데이트해줘야 해요.
Node.js가 아예 설치되어 있지 않다면 nodejs.org에서 Windows Installer(.msi) 파일을 내려받아 실행하면 돼요. 설치 마법사에서 기본 옵션 그대로 진행하면 npm이 함께 설치되고, 설치가 끝나면 터미널을 재시작해야 명령어가 정상적으로 인식돼요.
Claude Code 설치 명령어 실행하기
준비물이 모두 갖춰졌다면 터미널을 열고 다음 명령어를 입력하면 돼요. npm install -g @anthropic-ai/claude-code@latest를 입력하면 npm이 전역(global) 환경에 Claude Code 패키지를 설치해줘요. 이 과정은 인터넷 속도에 따라 다르지만 보통 30초 안팎이면 끝나요.
설치 중 오류가 발생한다면 대부분 Node.js 버전이 낮거나 관리자 권한 문제인 경우가 많아요. 일반 사용자 권한으로도 전역 설치가 가능하도록 설정되어 있어서 반드시 관리자 권한으로 실행할 필요는 없지만, 권한 오류가 계속 발생한다면 관리자 권한으로 터미널을 다시 열어서 시도해보면 해결되는 경우가 많아요.
설치가 완료되면 claude –version 명령어로 정상적으로 설치됐는지 확인할 수 있어요. 버전 번호가 출력되면 설치가 제대로 끝난 거예요.
실행 및 로그인 확인하기
- claude 명령어 실행 — 터미널에서 원하는 프로젝트 폴더로 이동한 뒤 claude 명령어를 입력하면 Claude Code가 실행되면서 초기 설정 화면이 나타나요.
- 계정 인증 — 처음 실행하면 브라우저 창이 열리면서 Anthropic 계정 로그인을 요구하는데, 로그인을 완료하면 터미널로 다시 돌아와 인증이 자동으로 완료돼요.
- 동작 테스트 — 인증이 끝나면 간단한 질문이나 코드 요청을 입력해서 정상적으로 응답이 오는지 확인하면 설치와 설정이 모두 마무리된 거예요.
이 과정을 거치면 별도의 복잡한 환경변수 설정 없이도 윈도우 터미널에서 바로 Claude Code를 사용할 수 있는 상태가 돼요.
설치 후 자주 발생하는 문제
가장 흔한 문제는 명령어를 입력했는데 ‘claude’라는 명령을 찾을 수 없다는 오류가 뜨는 경우예요. 이는 npm 전역 설치 경로가 시스템 환경변수 PATH에 등록되지 않아서 생기는 문제로, 터미널을 완전히 종료했다가 다시 열면 대부분 해결돼요. 그래도 해결되지 않는다면 npm의 전역 설치 경로를 확인해서 PATH에 직접 추가해줘야 해요.
두 번째로 자주 겪는 문제는 사내망이나 방화벽 환경에서 npm 설치가 중간에 멈추는 경우예요. 이런 환경에서는 프록시 설정을 npm에 등록하거나, 개인 네트워크로 전환해서 설치를 다시 시도하면 문제가 해결되는 경우가 많아요.
정리하면 윈도우에서 Claude Code를 설치하는 과정은 Node.js 설치, npm 설치 명령어 실행, 버전 확인, 로그인 및 동작 테스트라는 네 단계로 요약할 수 있어요. 이 순서만 따라가면 복잡한 설정 없이도 윈도우 환경에서 Claude Code를 문제없이 사용할 수 있어요.