클로드 코드6분 읽기

클로드 코드 설치 3단계, 시간이 실제로 걸리는 곳은 로그인입니다

클로드 코드를 처음 설치해 보려는 분께 맞습니다. 준비물과 설치, 확인, 로그인 세 단계와 시간이 갈리는 지점, 자주 겪는 오류를 정리했습니다.

글 꾸비 · 2026.09.09

한 줄 요약

클로드 코드 설치는 명령어 한 줄, 버전 확인, 로그인 세 단계입니다. 명령어 실행보다 네트워크와 로그인 인증 단계에서 시간이 갈립니다.

AI에게 이렇게 시키기

클로드 코드를 처음 설치하려고 해.
내 운영체제에 맞는 설치 명령어를 알려 주고, 설치가 끝났는지 확인하는 방법과 처음 로그인하는 순서를 단계별로 정리해 줘.
설치 중에 자주 나는 오류와 원인을 찾는 방법도 알려 줘.

클로드 코드 설치는 터미널(명령어를 입력하는 화면) 하나만 있으면 되는 과정입니다. 공식 문서는 이 과정을 크게 세 단계로 나눕니다. 설치, 로그인, 첫 세션 시작입니다.

시작 전에 무엇이 필요한가요

필요한 건 세 가지뿐입니다.

구독은 Pro, Max, Team, Enterprise 중 하나입니다. 터미널을 한 번도 안 써봤다면 공식 문서에 별도의 터미널 안내 페이지가 링크돼 있습니다.

STEP 1

macOS, 리눅스, WSL은 아래 한 줄이면 됩니다.

터미널

curl -fsSL https://claude.ai/install.sh | bash

윈도우는 파워셸이나 CMD에 맞는 별도 명령어가 있습니다. 홈브루(Homebrew)나 윈겟(WinGet)으로도 설치할 수 있습니다.

STEP 2

버전 번호가 뜨는지 봅니다.

터미널

claude --version

STEP 3

claude를 입력하면 처음 실행 시 로그인 안내가 뜹니다. 브라우저 창이 열리고 거기서 인증을 완료하면 됩니다.

여기까지 마치면 프로젝트 폴더에서 claude만 입력해도 바로 시작할 수 있습니다.

명령어 자체를 실행하는 시간은 짧습니다. 시간이 갈리는 지점은 따로 있습니다.

저도 처음엔 "5분이면 되겠지" 하고 시작했는데, 로그인 창에서 계정을 여러 개 두고 헷갈리는 바람에 예상보다 더 걸렸습니다. 명령어 실행 자체보다 로그인과 인증 단계에서 시간이 더 갔던 셈입니다.

윈도우에서 파워셸과 CMD 명령어를 바꿔 입력함

윈도우에서는 파워셸용 명령어를 CMD 창에 입력하거나 그 반대로 입력해서 오류가 나는 경우가 흔합니다. 프롬프트 앞에 PS C:\가 있으면 파워셸, 그냥 C:\만 있으면 CMD입니다.

curl 오류나 403 오류를 그냥 반복함

공식 문서에는 설치 오류를 원인별로 정리한 별도 문제 해결 페이지가 있습니다. curl 오류나 403 오류가 뜨면 이 페이지에서 증상별로 원인을 찾을 수 있습니다.

정말 5분이면 끝나나요?

설치 명령어와 버전 확인까지는 1~2분 안에 끝나는 경우가 많습니다. 다만 로그인 인증과 네트워크 상태까지 더하면 사람마다 차이가 있어, 정확한 총 소요 시간은 단정하지 않습니다.

설치 후 뭐부터 하면 되나요?

프로젝트 폴더로 이동해 claude를 입력하면 됩니다. 그다음 /help로 명령어를 보거나, "이 프로젝트가 뭘 하는지 설명해줘" 같은 질문부터 던지면 됩니다.

한 번 설치하면 계속 최신 버전인가요?

설치 방법에 따라 다릅니다. 공식 문서에 따르면 네이티브 설치는 백그라운드에서 자동 업데이트되지만, 홈브루나 윈겟으로 설치한 경우는 직접 업그레이드 명령을 실행해야 합니다.

설치는 명령어 한 줄이지만, 실제로 걸리는 시간은 로그인과 네트워크에서 갈립니다. 정확한 분 단위 숫자를 약속하기보다, 어디서 시간이 걸리는지 미리 알아두는 게 더 유용합니다.