1.CLI 환경설정 - [Windows] Claude CLI 설정하기

0. 시작 전 확인

Claude Code는 유료 플랜(Pro / Max / Team / Enterprise)에서만 사용 가능합니다.
계정 만들기 → https://claude.ai

 

1. Windows 설치 가이드

Claude.ai 계정 & 유료 플랜

STEP 1. claude.ai (https://claude.ai) 에 접속해서 계정을 만든다.

• Pro / Max / Team / Enterprise 중 하나의 유료 플랜이 필요해요.

• 계정에 로그인 한다.

Node.js 설치

STEP 2. nodejs.org (https://nodejs.org) 에 접속한다. 

• 사이트에 들어가면 큰 초록 버튼으로 "LTS (권장)" 버전이 보여요.
•  버튼을 클릭하면 .msi 파일이 자동으로 다운로드된다. 

STEP 3. 다운로드된 설치 파일 실행하기

• 다운로드 폴더에서 node-vXX.XX.X-x64.msi 파일을 더블클릭하여 실행한다. 
• 설치 마법사가 뜨면 Next → Next → Install → Finish 순서로 눌러주어 인스톨한다.
• 체크박스는 기본값 그대로 둔다.
• "이 앱이 디바이스를 변경하도록 허용하시겠어요?" 팝업이 뜨면 [예]를 누른다. 

명령 프롬프트(CMD) 열기

STEP 4. CMD 창을 연다. 

• 키보드에서 [Windows 키 + R]을 동시에 누른다.
• 화면 왼쪽 아래에 작은 "실행" 창이 뜨면 열기(O): 칸에  cmd  를 입력하고 Enter를 누른다.
• ※ 또는 작업 표시줄 검색창에 "명령 프롬프트" 또는 "cmd"를 검색해서 열어도 된다. 

STEP 5. Node.js 설치 확인

• 2번에서 설치한 Node.js를 확인한다.
• CMD 창에 아래 명령어를 입력하고 Enter를 누른다.

node --version

 

• 버전 정보가 나오면 성공 -> v18 이상이면  ok
• 오류가 뜨면 CMD를 닫고 다시 열어 버전 정보 확인
• 그래도 오류가 뜨면 Node.js 설치가 안 된 것이니 STEP 2로 이동

Claude Code 설치

STEP 6. cmd 창에서 아래 명령어를 그대로 복사해서 붙여넣고 Enter를 누른다.

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

•  설치에 1~2분 정도 걸린다.  화면에 글자가 계속 올라가는 건 정상

로그인 & 최종 확인

 

STEP 7. cmd 창에서 Claude 계정으로 로그인

cmd 창에 아래 명령어를 실행하면 브라우저가 자동으로 열린다. Claude.ai에 로그인하면 인증이 완료된다.

claude login

• 브라우저가 안 열리면, 터미널에 출력된 URL을 복사해서 브라우저 주소창에 직접 붙여넣으세요.

 STEP 8. cmd 창에서 설치 상태 최종 확인

> claude --version
> claude doctor

• 버전 숫자가 나오고 doctor가 이상 없다고 하면 설치 완료!

프로젝트에서 시작하기

STEP 9. cmd 창에서 내 프로젝트 폴더로 이동 후 실행

> cd C:\Users\사용자이름\my-project
> claude

• 폴더 경로를 모르면? 파일 탐색기에서 해당 폴더를 열고 주소창을 클릭하면 전체 경로를 복사할 수 있어요.