25단계Claude Code 설치와 첫 실행

걸리는 시간 · 읽기 약 10분 · 따라 하기 약 40분 · 난이도 ★★★ 심화 · 화면 확인 2026.09.27

이 단계를 마치면

• 공식 문서의 명령으로 Claude Code를 설치하고 claude --version으로 확인할 수 있다.
• 작업 폴더에서 Claude Code를 켜고 로그인한 뒤 첫 지시를 내릴 수 있다.
• 설치에서 흔히 나오는 오류 문구를 보고 다음에 할 일을 고를 수 있다.

검은 창에 명령 하나를 붙여 넣고 엔터를 누른다. 글자가 몇 줄 흘러가다 멈춘다. 설치가 된 걸까, 안 된 걸까? 처음 해 보는 사람은 이 짧은 순간에 가장 오래 망설인다. 이번 단계에서는 그 순간을 헤매지 않고 지나가는 법을 익힌다.

Claude Code를 쓸 수 있는 곳은 여럿이다. 터미널, Claude 데스크톱 앱, 브라우저에서 여는 웹, 개발자가 쓰는 편집기(IDE)까지. 여기서는 터미널을 기준으로 설명한다. 가장 많은 기능을 바로 보여 주고, 막혔을 때 무엇이 잘못됐는지 글자로 알려 주기 때문이다.

설치. 설치 명령은 외울 필요도, 이 책에서 베낄 필요도 없다. 공식 문서(code.claude.com/docs)의 설치 안내를 열고 거기 있는 명령을 복사해 붙인다. 명령은 언제든 바뀔 수 있다. 참고로 이 책을 쓰는 시점에 안내된 명령은 아래와 같았다.

맥과 리눅스의 터미널:

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

윈도우 PowerShell:

irm https://claude.ai/install.ps1 | iex

두 명령이 하는 일은 같다. 설치 파일을 내려받아 곧바로 실행한다. 붙여 넣고 엔터를 누르면 글자가 몇 줄 지나간 뒤 설치가 끝났다는 안내가 나온다. 이때 마지막 몇 줄은 꼭 읽자. 경로(PATH)에 추가하라거나 터미널을 다시 열라는 안내가 붙어 나올 때가 있다. 그런 안내가 있으면 그대로 따른다. 윈도우라면 다른 프로그램을 먼저 설치하라는 안내가 공식 문서에 있을 수 있으니 윈도우 항목을 끝까지 읽는다.

확인과 실행. 설치가 끝났는지는 명령 하나로 확인한다.

claude --version

버전 번호가 나오면 설치는 끝났다. 이제 작업 폴더로 들어가 Claude Code를 켠다.

cd ~/work/visit-log
claude

윈도우라면 cd C:\work\visit-log 다음에 claude를 친다. 순서가 중요하다. 폴더에 먼저 들어간 다음에 켠다. 홈 폴더에서 그냥 켜면 Claude가 내 문서 전체를 작업 대상으로 여길 수 있다. 첫 실행에서 가장 흔한 실수다.

첫 로그인. 처음 켜면 몇 가지를 차례로 묻는다. 화면 색 같은 취향을 고르고, 로그인 방법을 고른다. Claude 계정으로 로그인하기를 고르면 브라우저가 열리고, 로그인과 허용을 마치면 다시 터미널로 돌아온다. 브라우저가 저절로 열리지 않을 때는 터미널에 로그인 주소가 함께 나오는 경우가 많으니, 그 주소를 복사해 브라우저에 붙이면 된다. 이어서 이 폴더의 파일을 믿고 작업해도 되는지 묻는 질문이 나올 수 있다. 내가 만든 작업 폴더가 맞는지 확인하고 허용한다. 화면의 문구와 순서는 바뀔 수 있으니 질문을 하나씩 읽고 답하자.

첫 지시와 허락 요청. 준비가 끝나면 입력창이 나온다. 첫 지시는 가볍게 하자. "이 폴더에 무엇이 있는지 알려 줘"라고 쳐 본다. 빈 폴더라는 답이 오면 성공이다. Claude가 제대로 된 방에 들어와 있다. 다음으로 첫 페이지를 만들게 한다. 이때 Claude Code는 파일을 만들거나 명령을 실행하기 전에 허락을 구한다. 무엇을 하려는지, 어떤 파일을 만들려는지 보여 주고, 허락할지, 이번 작업 동안 계속 허락할지, 거절할지 고르게 한다. 처음에는 귀찮더라도 하나씩 읽고 누르자. 파일 이름이 작업 폴더 안에 있는지, 지우는 일은 없는지 살핀다. Claude가 무엇을 하려는지 읽는 것 자체가 공부가 된다. 묻지 않게 하는 방법은 31단계에서 다룬다.

첫 지시에 따라 결과가 크게 달라진다. "홈페이지 만들어 줘"라고만 하면 Claude는 알아서 여러 파일을 만들고, 회사와 상관없는 문구를 채우고, 무엇을 열어야 하는지도 알려 주지 않는다. 아래 프롬프트처럼 회사명, 하는 일, 고객, 위치를 알려 주고, 휴대폰 화면부터 맞추라고 하고, 파일 하나로 끝내고 여는 방법까지 알려 달라고 해 보자. 파일 하나와 여는 방법이 함께 돌아온다. 파일 이름을 index.html로 정해 두는 이유는 30단계에서 밝혀진다. 배포 서비스가 주소를 열 때 가장 먼저 찾는 이름이기 때문이다.

알아 둘 조작. 입력창에 /help를 치면 쓸 수 있는 명령 목록이 나온다. Claude가 엉뚱한 방향으로 달려가면 Esc 키로 멈추고 다시 말한다. 끝낼 때는 /exit를 친다. 다음에 이어서 할 때는 같은 폴더에 들어가 다시 claude를 친다. 자주 쓰는 / 명령은 26단계에서 표로 모아 본다.

다른 문. 터미널이 끝내 부담스러우면 다른 문으로 들어간다. Claude 데스크톱 앱에서도 Claude Code를 쓸 수 있고, 웹에서는 GitHub 저장소를 연결해 클라우드에서 작업하게 할 수 있다. 메뉴 위치는 자주 바뀌므로 공식 문서에서 현재 안내를 찾는다. 들어가는 문이 달라도 이 부의 나머지 내용은 그대로 따라갈 수 있다.

막혔을 때는 오류 문구부터 통째로 복사해 두자. 가장 좋은 습관이다. Claude 앱에 붙여 넣고 "이 오류가 무슨 뜻이고 내가 무엇을 확인해야 하는지"를 물으면 대개 다음 한 걸음이 보인다. 다만 문구 안에 비밀번호나 인증키가 섞여 있으면 지우고 붙인다.

현장 장면

IT팀의 허락이 떨어지자 윤 과장은 곧장 공식 문서를 열었다. 윈도우용 명령을 복사해 PowerShell에 붙이자 글자가 흘러가고 설치가 끝났다는 안내가 나왔다. 마지막 줄에는 터미널을 다시 열라는 문장이 있었다. 마음이 급했던 윤 과장은 그 문장을 건너뛰고 바로 claude --version을 쳤다. 돌아온 것은 빨간 글씨였다. "'claude' 용어가 cmdlet, 함수, 스크립트 파일 또는 실행할 수 있는 프로그램 이름으로 인식되지 않습니다." 창을 닫고 새로 열자 그제야 버전 번호가 나왔다.

두 번째 실수는 폴더였다. 새 창은 C:\Users\윤서진에서 열렸고, 윤 과장은 그 상태로 claude를 쳤다. 로그인을 마치고 "이 폴더에 무엇이 있는지 알려 줘"라고 하자 문서, 다운로드, 바탕 화면 폴더 목록이 줄줄이 돌아왔다. 아차 싶었다. /exit로 나와 cd C:\work\visit-log를 친 뒤 다시 켜자, 이번에는 빈 폴더라는 답이 왔다.

첫 지시는 "방문 일지 만들어 줘"였다. Claude는 파일 세 개를 만들겠다며 허락을 구했다. 결과 화면은 문구가 전부 영어였고, 거래처 이름과 전화번호를 적는 항목까지 들어 있었다. 23단계에서 공들여 뺀 바로 그 항목이었다. 문제는 지시에 있었다. 윤 과장은 23단계에서 다듬은 문장을 그대로 넣고, 파일은 index.html 하나, 화면 문구는 우리말, 거래처명 대신 업종·지역, 휴대폰 화면 먼저라고 다시 요청했다. 이번에는 파일 하나가 생겼다. 브라우저로 끌어다 놓고 창을 좁혀 보니 휴대폰 크기에서도 입력란이 잘리지 않았다. 윤 과장은 "다음 약속" 항목의 날짜 입력 방식만 한 번 더 고쳐 달라고 했다.

따라 하기

1. 공식 문서(code.claude.com/docs)의 설치 안내를 열고, 내 운영체제의 명령을 복사해 터미널에 붙인다. 성공 기준: 설치가 끝났다는 안내가 나오고, 마지막 줄의 안내가 있었다면 그대로 따랐다.
2. 터미널을 새로 열고 claude --version을 친다. 성공 기준: 버전 번호가 나온다.
3. cd로 작업 폴더에 들어간 뒤 claude를 치고 로그인을 마친다. 성공 기준: 입력창이 나오고, "이 폴더에 무엇이 있는지 알려 줘"에 빈 폴더라는 답이 온다.
4. 아래 프롬프트로 첫 페이지를 만들게 하고, 허락 요청을 하나씩 읽고 누른다. 성공 기준: 작업 폴더 안에 index.html 하나가 생기고, 허락한 파일이 모두 작업 폴더 안이었다.
5. 그 파일을 브라우저로 열고 창을 휴대폰 폭으로 줄인다. 성공 기준: 글자와 입력란이 잘리지 않고, 첫 화면만 보고도 무엇을 하는 페이지인지 알 수 있다.
6. 고칠 곳 하나만 골라 그 부분만 다시 요청하고 /exit로 끝낸다. 성공 기준: 요청한 곳만 바뀌고 나머지는 그대로다.

복사해 쓰는 프롬프트

[23단계에서 적은 도구 설명 한 문장]을 HTML 파일 하나로 만들어 줘.
입력 항목: [항목 이름 세 개 안팎]. 화면 문구는 모두 우리말로.
휴대폰 화면을 먼저 맞추고, 첫 화면만 보고도 무엇을 하는 페이지인지 알 수 있게 해 줘.
파일 이름은 index.html로 하고, 이 폴더 안에서만 작업해 줘.
다 만들면 어떤 파일을 만들었는지와 여는 방법을 알려 줘.

막히면 이렇게

실습 파일

공개 저장소에 올려 둔 가공 자료와 양식이다. 회사 자료 대신 먼저 이것으로 해 본다.

• 샘플 자료 영업_방문기록.csv · 영업 사원 네 명의 3월 방문 기록 30건

스스로 점검

• ☐ claude --version이 버전 번호를 돌려주는가
• ☐ Claude Code를 켜기 전에 작업 폴더에 들어가 있는가
• ☐ 허락 요청에서 파일 이름이 작업 폴더 안인지 읽고 눌렀는가

기억할 것

• 설치 명령은 쓸 때마다 공식 문서에서 복사하고, 마지막 줄의 안내를 읽는다.
• 작업 폴더에 먼저 들어가고, 그다음 claude를 켠다.

더 알아보기 · Claude Code 설치 · 빠른 시작