Claude Code 설치하기 — 왕초보 실습 강의

START

시작하기 전에 3가지만 확인하세요

아래 세 가지만 맞으면 이 강의를 그대로 따라 하실 수 있어요.

1

내 컴퓨터 버전

Windows 10(2018년 이후 업데이트) 또는 Windows 11이면 됩니다. 설치에 필요한 curl이라는 도구가 이미 들어있어서 따로 설치할 필요가 없어요.

2

claude.ai 계정

이메일로 가입한 claude.ai 계정이 필요해요. 아직 없다면 claude.ai에서 먼저 무료로 가입해두세요. 로그인 단계에서 이 계정을 사용합니다.

3

꼭 "명령 프롬프트"

Windows에는 비슷하게 생긴 검은 창이 여러 개예요(PowerShell, 터미널 등). 이 강의는 그중 "명령 프롬프트"(영어로 cmd) 하나만 사용합니다.

알아두면 좋아요

Claude Code는 이 검은 화면(cmd) 안에서 대화하듯 명령을 내리면 AI가 코드를 읽고, 쓰고, 실행해주는 도구예요. 설치도 이 화면에서 글자 명령어 한 줄만 입력하면 끝납니다.

STEP 1 / 8

명령 프롬프트 열기

1

시작 버튼 옆 검색창에 cmd 입력 → "명령 프롬프트" 클릭

검은 창이 뜨고 C:\Users\내이름> 같은 문구가 보이면 정상이에요. 이 문구를 "프롬프트"라고 부르는데, "여기에 명령을 입력하세요"라는 뜻이에요.

STEP 2 / 8

작업용 폴더 만들기

2

아래 세 줄을 한 줄씩 입력하고 매번 Enter

"폴더"는 파일을 담는 상자라고 생각하면 돼요. Claude Code 전용 상자를 하나 만들어서, 앞으로 항상 그 안에서만 실행할 거예요.

>_ 명령 프롬프트

C:\Users\내이름> cd c:\ ← C 드라이브로 이동
C:\> mkdir ai ← ai 라는 이름의 폴더 생성
C:\> cd ai ← 방금 만든 ai 폴더로 이동
C:\ai>

마지막 줄이 C:\ai>로 바뀌었다면, 지금부터 "ai" 폴더 안에 있다는 뜻이에요.

STEP 3 / 8

설치 명령어 입력

3

아래 명령어를 그대로 붙여넣고 Enter

>_ 명령 프롬프트

C:\ai> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

강의자 노트

이 주소(claude.ai)는 Claude Code를 만든 회사(Anthropic)의 공식 주소예요. 아래 04번 "보안 수칙"에서 다시 설명하지만, "공식 주소인지"는 설치 스크립트를 실행하기 전 꼭 확인해야 하는 습관이에요.

STEP 4 / 8

설치 완료됐는지 확인하기

4

글자가 주르륵 지나가다가, 다시 프롬프트가 돌아오면 완료

정확히는 이렇게 보여요 — 설치 진행 문구가 몇 초간 흐르다가, 맨 아래 줄이 다시 C:\ai> 형태로 조용해지면 성공이에요. 에러 없이 이렇게 "제자리로 돌아오는 것"이 완료 신호입니다.

>_명령 프롬프트 · 완료 화면 예시

Installing Claude Code...
Claude Code installed successfully.

C:\ai> ← 다시 여기로 돌아오면 끝!

관리자 권한 창이나 별도 설치 창은 뜨지 않아요. 이 명령어는 관리자 권한이 필요 없습니다.

STEP 5 / 8

창을 완전히 닫았다가 새로 열기 중요

5

지금 켜져 있는 검은 창을 닫고, cmd를 새로 열어주세요

방금 설치한 명령어(claude)는 새 창부터 인식돼요. 기존 창에서 계속 입력하면 "인식할 수 없는 명령입니다" 오류가 나는데, 이건 실패가 아니라 이 단계를 건너뛴 것뿐이에요.

STEP 6 / 8

설치 확인 — 버전 확인하기

6

새 창에서 아까 폴더로 이동한 뒤 버전 확인

>_ 명령 프롬프트 (새 창)

C:\Users\내이름> cd c:\ai
C:\ai> claude --version
2.x.x (Claude Code) ← 이렇게 번호가 보이면 설치 성공!

STEP 7 / 8

실행하고 로그인하기

7

아래 명령어로 Claude Code를 실행하세요

>_ 명령 프롬프트

C:\ai> claude

보통은 브라우저가 자동으로 열려요. claude.ai에 로그인한 뒤 "허용(Allow)" 버튼만 누르면 자동으로 다시 cmd 창으로 연결됩니다.

브라우저가 저절로 안 열리면

cmd 창에 표시된 로그인 주소(URL)를 마우스로 드래그해 복사
아무 브라우저나 열어서 주소창에 붙여넣기
claude.ai 로그인 → "허용" 클릭

"코드를 붙여넣으라"는 화면이 뜨면

"허용" 클릭 후 화면에 뜨는 코드를 복사
cmd 창의 Paste code here if prompted 문구 뒤에 붙여넣기
Enter

헷갈리기 쉬운 부분

Paste code here if prompted는 cmd 화면에 영어 그대로 나타나는 안내 문구예요. 번역해서 입력하는 게 아니라, 그 문구가 보이면 "코드를 여기에 붙여넣으라는 뜻이구나" 하고 복사한 코드만 붙여넣으시면 됩니다.

STEP 8 / 8

폴더 신뢰 확인 → 로그인 완료

8

처음 사용하는 폴더라면 "이 폴더의 파일을 신뢰하시겠습니까?" 같은 확인 화면이 한 번 떠요

안내에 따라 진행하세요 (대부분 Enter 또는 Yes 선택). 항상 같은 폴더(c:\ai)에서 실행해야 다음부터 다시 안 물어봐요.

완료

여기까지 오셨다면 로그인이 끝난 거예요. 다음부터는 cd c:\ai → claude만 입력하면 바로 시작할 수 있고, 다시 로그인할 필요는 없어요.

참고

알아두면 편한 명령어 3가지

대화 종료	`/exit` 또는 `Ctrl` + `D`
다시 로그인	`/login`
도움말 보기	`/help`

03

설치가 안 될 때 — Claude에게 직접 물어보기

가장 흔한 원인은 설치 후 창을 새로 안 열었을 때(STEP 5)예요. 그래도 안 풀리면 아래처럼 해보세요.

다른 브라우저로 claude.ai에 접속해 로그인해둡니다.
cmd 창에 뜬 오류 문구를 통째로 마우스로 드래그해 복사합니다.
claude.ai 대화창(또는 이미 켜진 Claude Code)에 아래처럼 그대로 붙여넣어 물어봅니다.

Q질문 예시

"Windows 명령 프롬프트(cmd)에서 Claude Code를 설치하려는데
다음과 같은 오류가 떴어.
[여기에 오류 메시지 전체를 그대로 붙여넣기]
어떤 뜻이고 어떻게 해결하면 될지 순서대로 알려줘."

오류 문구가 잘 안 보이거나 캡처가 더 빠르면, Win + Shift + S로 화면을 캡처해서 첨부해도 됩니다.

curl이 없다는 오류가 떠요

Windows 10 1803(2018년) 이전 버전에서 종종 발생해요. 시작 → 설정 → 시스템 → 정보에서 버전을 확인하고, Windows Update로 최신 상태로 올린 뒤 다시 시도해보세요.

claude 명령어가 "인식할 수 없다"고 나와요

대부분 STEP 5(창 새로 열기)를 건너뛴 경우예요. 창을 완전히 닫고 cmd를 새로 열어 다시 시도해보세요.

그래도 안 되면 어떻게 하나요

cmd에 claude doctor를 입력하면 자가진단 결과를 보여줘요. 그 결과를 위 방식대로 Claude에게 그대로 붙여넣어 물어보시면 가장 빠릅니다.

04

보안 관련 참고사항

출처 확인

설치 스크립트는 반드시 공식 주소(claude.ai)에서만 받습니다. 다른 경로로 안내받았다면 실행하지 마세요.

관리자 권한

설치에 관리자 권한이 필요하지 않습니다. 관리자 권한을 요구하면 의심하고 진행을 멈추세요.

로그인 정보 보관

인증 정보가 내 컴퓨터에 저장됩니다. 공용 PC 사용 후에는 재로그인 또는 로그아웃 처리하세요.

민감정보 입력 금지

대화창에 고객 개인정보·서버 접속정보·인증키 등을 입력하지 않습니다.

마무리

셀프 체크리스트

완료한 단계를 체크해보세요 0 / 8

명령 프롬프트(cmd)를 열었다

c:\ai 작업 폴더를 만들었다

설치 명령어를 입력했다

프롬프트가 다시 돌아온 걸 확인했다

창을 닫았다가 새로 열었다

claude --version으로 확인했다

claude 실행 후 로그인을 완료했다

폴더 신뢰 확인까지 마쳤다