검은 화면에 알 수 없는 글자가 깜빡이는 창, 열어본 적 있나요? 없다면 지금 딱 그 화면 앞에 서게 됩니다. 그런데 미리 말해두자면, 그 화면은 여러분이 생각하는 것만큼 무섭지 않아요.
지난 편에서 클로드 코드가 채팅창 클로드와 무엇이 다른지 살펴봤다면, 이번 편은 그 도구를 실제로 내 컴퓨터에 들여놓는 시간입니다. 설치, 첫 실행, 로그인, 그리고 중간에 만날 수 있는 오류까지 순서대로 따라가 볼게요. 화면 하나하나 성공 표시를 짚어드릴 테니, 지금 컴퓨터 앞에 앉아 있다면 그대로 손을 움직이면 됩니다.
설치 전에 딱 두 가지만 확인하면 돼요
클로드 코드를 깔기 전 확인할 건 딱 두 가지, 컴퓨터의 운영체제 버전과 클로드 구독 상태예요. 이 둘만 통과하면 설치는 사실상 다 끝난 거나 마찬가지입니다.
먼저 운영체제. 윈도우 10 버전 1809 이상이거나 윈도우 11이면 됩니다. 확인하는 법은 간단해요. 시작 메뉴 검색창에 winver라고 입력하고 엔터를 누르면 작은 창이 뜹니다. 운영체제 버전은 컴퓨터의 발급 연도 같은 거예요. 최근 5~6년 안에 산 컴퓨터라면 거의 다 통과한다고 보면 됩니다.
두 번째는 구독. 클로드 코드는 무료 웹 버전 계정만으로는 로그인이 안 되고, Pro 이상 유료 구독이 있어야 합니다(정확한 요금제 범위는 공식 페이지 기준 확인이 필요해요). 구독은 클로드 코드를 쓰기 위한 입장권 같은 거라고 생각하면 됩니다.
성공하면 이런 화면이 떠요 — winver 창에 “Windows 10 버전 22H2″처럼 버전 숫자가 보이면 통과입니다. 버전이 낮게 나와도 괜찮아요. 대부분은 윈도우 업데이트 한 번이면 해결되니 지금 포기하지 않아도 됩니다.
검은 창 하나 열고 명령어 한 줄이면 끝나는 설치
클로드 코드 설치는 ‘파워셸’이라는 창에 명령어 한 줄을 붙여넣는 게 전부예요. 파워셸은 마우스로 클릭하는 대신 글자로 컴퓨터에 심부름을 시키는 창이라고 보면 됩니다.
시작 메뉴에서 “PowerShell”을 검색해 실행하세요. 관리자 권한으로 실행할 필요는 없습니다. 창이 뜨면 아래 명령어를 그대로 복사해서 붙여넣고 엔터를 누릅니다.
irm https://claude.ai/install.ps1 | iex
솔직히 말하면 저도 처음 설치할 때 창을 잘못 골라서 헤맸어요. 파워셸 대신 CMD 창에 저 명령어를 붙여넣었더니 낯선 오류 문구가 떴거든요. 파워셸과 CMD는 둘 다 검은 창이지만 서로 다른 프로그램이라, 명령어도 조금씩 달라요. 이 실수와 해결법은 아래 5번 항목에서 표로 정리했으니 지금 겪었어도 당황하지 않아도 됩니다.
성공하면 이런 화면이 떠요 — 진행 표시줄이 몇 초간 지나가고, 마지막 줄에 설치 경로나 완료 문구가 뜨면 성공입니다. 화면에 빨간 글씨가 좀 보여도 마지막 줄이 정상 완료 문구라면 넘어가도 괜찮아요.
claude라고 쳤는데 화면이 조용하다면
설치 직후 claude라고 쳤는데 아무 반응이 없다면, 대부분은 터미널을 새로 열지 않아서예요. 컴퓨터는 새로 설치된 프로그램의 위치를 창이 새로 열릴 때만 확인합니다. 이사한 친구 집 주소를 수첩에 적어두는 것과 비슷해요. 창을 새로 열어야 그 주소가 반영돼요.
해결법은 간단합니다. 열려 있는 파워셸 창을 전부 닫고 새 창을 하나 다시 엽니다. 그다음 아래처럼 입력해보세요.
claude --version
성공하면 이런 화면이 떠요 — “2.1.211 (Claude Code)”처럼 버전 숫자가 적힌 한 줄이 뜹니다. 이 문구가 보이면 설치는 완전히 끝난 거예요. 이제 claude만 입력하면 클로드 코드가 실제로 실행됩니다.
브라우저 창이 뜨면 로그인만 하면 돼요
claude를 처음 실행하면 브라우저가 자동으로 열리고 로그인 화면이 나와요. 이 단계에서 Pro, Max, Team 등 유료 구독 계정으로 로그인하면 됩니다.
브라우저에서 로그인을 마치고 권한 허용 버튼을 누른 뒤, 다시 터미널 창으로 돌아오세요. 이때부터 터미널 안이 곧 클로드와 대화하는 화면이 됩니다. 설치가 끝나면 클로드 코드로 웹사이트 시안까지 만들어볼 수 있는데, 그 활용 예시는 Claude로 웹사이트 UI 프로토타입 5분 만에 만들기에서 미리 살펴봐도 좋아요. 구독 종류가 헷갈리면 클로드 Fable 5 사용법 완벽 가이드 — 무료 기간부터 요금 전환까지도 참고하세요.
로그인이 끝났다면, 화면이 정말 반응하는지 짧은 프롬프트로 확인해보세요.
지금 이 폴더 안에 어떤 파일들이 있는지 보여주고, 각 파일이 어떤 역할을 하는 것 같은지 한 줄씩 짐작해서 설명해줘.
성공하면 이런 화면이 떠요 — 로그인 완료를 알리는 문구가 뜨고, 그 아래 물음표 모양의 입력창이 깜빡입니다. 여기에 위 프롬프트를 붙여넣으면 클로드가 폴더 안 파일 목록을 읽고 설명을 내놓기 시작해요.
설치가 안 될 때 자주 나오는 오류 세 가지
설치 중 나오는 오류 문구는 대부분 세 가지 패턴 중 하나예요. 아래 표로 원인과 해결법을 바로 확인할 수 있습니다.
| 오류 메시지 | 원인 | 해결 방법 |
|---|---|---|
| “irm이(가) 내부 또는 외부 명령이 아닙니다” | CMD 창에서 실행함 | 파워셸(PowerShell) 창을 새로 열어 다시 시도 |
| “&&는 올바른 문 구분 기호가 아닙니다” | 파워셸에서 CMD 전용 명령어를 씀 | 명령어를 한 줄씩 따로 실행 |
| “claude이(가) 내부 또는 외부 명령이 아닙니다” | 설치 후 새 터미널을 열지 않음 | 터미널 창을 완전히 닫고 새로 열기 |
창 상단에 “PS C:\”라고 적혀 있으면 파워셸, “C:\”만 적혀 있으면 CMD입니다. 이 표시 하나로 지금 어느 창에 있는지 바로 구분할 수 있어요. 오류가 나도 컴퓨터가 고장 나는 건 아니니 걱정 마세요. 창을 다시 열고 명령어만 다시 넣으면 대부분 그 자리에서 풀립니다.
Before: 검은 창을 보자마자 뒤로 가기를 누르고 싶은 마음.
After:
claude 한 마디만 입력하면 대화창이 열리고, 폴더 안 파일을 클로드가 대신 읽어주는 상태.자주 묻는 질문
Q. 클로드 코드를 처음 쓰는데 어디부터 시작하나요?
클로드 코드는 파워셸을 열고 설치 명령어 한 줄을 붙여넣는 데서 시작합니다. 그 뒤 새 터미널을 열어 claude를 실행하고 브라우저에서 로그인만 하면 준비가 끝나요.
Q. 맥(Mac) 컴퓨터에서도 같은 방법으로 설치하나요?
아니요, 맥은 터미널 앱에서 curl 명령어로 설치하는 별도 방식이 있습니다. 정확한 명령어는 공식 문서 기준 확인이 필요해요.
Q. 무료 클로드 계정으로도 로그인할 수 있나요?
아니요, 무료 웹 버전 계정만으로는 클로드 코드에 로그인할 수 없습니다. Pro 이상 유료 구독이 있어야 하며, 정확한 요금제 범위는 공식 페이지 기준 확인이 필요합니다.
이제 내 컴퓨터 안에 클로드 코드가 생겼어요
운영체제 확인, 명령어 한 줄 설치, 새 터미널에서 실행, 브라우저 로그인까지 마쳤다면 오늘 할 일은 다 끝났습니다. 검은 화면이 더 이상 낯설게 느껴지지 않을 거예요.
설치는 끝났는데, 이걸로 실제로 뭘 할 수 있을지 아직 감이 안 잡히죠? 다음 편에서는 파일 정리, 문서 요약, 엑셀 정리 세 가지를 클로드 코드로 직접 손을 움직여 해봅니다. 클로드 코드 첫 실습 3가지 — 파일 정리·문서 요약·엑셀 정리에서 이어집니다.