22단계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가 무엇을 하려는지 읽는 것 자체가 공부가 됩니다. 묻지 않게 하는 방법은 28단계에서 다룹니다.

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

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

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

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

현장 장면

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

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

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

따라 하기

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

복사해 쓰는 프롬프트

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

막히면 이렇게

실습 파일

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

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

스스로 점검

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

기억할 것

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

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