Claude Code 설치와 첫 실행

⏱ 약 30분

Claude Code를 처음 시작하는 분들을 위한 가이드입니다. 개발 경험이 전혀 없어도 괜찮고요. 아래 순서대로 따라 하면 30분 안에 첫 대화까지 도달할 수 있습니다.

한 가지 미리 말씀드리면, 설치가 가장 큰 벽입니다. 이 벽만 넘으면 그다음은 그냥 채팅창과 비슷하죠. 중간에 에러가 나도 정상이니 당황하지 않으셔도 됩니다. 설치 중 뜰 수 있는 화면과 해결 방법은 이 글 후반부에 정리해 두었습니다.

이 가이드는 처음부터 끝까지 한 번에 하지 않아도 됩니다. 이미 완료한 단계는 건너뛰고, 멈췄던 단계부터 이어서 진행하세요. 각 단계 끝의 확인 방법으로 어디까지 왔는지 점검할 수 있습니다.

시작 전 준비물

시작하기 전에 아래 세 가지를 확인하세요. 이 준비가 안 된 상태로 시작하면 중간에 막힙니다.

항목	설명
Claude 유료 구독	Pro($20/월) 또는 Max($100/월). Pro로 시작해서 많이 쓰게 되면 올리면 됩니다
이메일 접근	계정 인증에 필요합니다. 구독에 쓴 이메일의 받은편지함을 열 수 있어야 합니다
노트북 관리자 권한	프로그램을 설치할 수 있는 권한입니다. 회사 노트북이라면 미리 확인하세요

구독은 claude.ai에서 가입 후 결제하면 됩니다. Claude Code는 별도 결제가 아니라 이 구독에 포함되어 있습니다.

TIP — 회사 노트북이라면

설치 전에 IT 담당자에게 "VS Code와 Git 설치 승인"을 미리 요청해 두면 중간에 멈추지 않습니다. 두 프로그램 모두 전 세계 기업에서 널리 쓰는 표준 도구라서 승인 거절되는 경우는 드뭅니다.

미리 알아두면 좋은 용어 2개

외울 필요는 없습니다. 설치 중에 이 단어들이 나오면 "아, 그거"라고 알아볼 정도면 충분합니다.

용어	뜻
터미널	컴퓨터와 텍스트로 대화하는 검은 창. Claude Code가 여기서 실행됩니다
VS Code	Microsoft가 만든 무료 프로그램. "개발자들의 워드"라고 보면 됩니다. Claude Code가 작동하는 공간입니다

핵심만 기억하세요. Claude Code = 검은 화면에서 AI와 대화하는 것. 그게 전부입니다.

Windows 설치

VS Code 설치

code.visualstudio.com에 접속해 Download for Windows를 클릭합니다.
내려받은 파일을 실행하고, 옵션은 전부 기본값 그대로 다음을 누릅니다.
설치가 끝나면 VS Code를 한 번 실행해 봅니다. 열리면 통과입니다.

WHY — 왜 하나요?

VS Code는 Claude Code가 작동하는 "사무실"입니다. 파일을 보여주는 화면과 대화창을 한 곳에 모아주기 때문에, 비개발자에게 가장 진입장벽이 낮은 방법입니다.

Git 설치

git-scm.com에 접속해 Download for Windows를 클릭합니다.
설치 화면에 옵션이 많이 나오는데, 헷갈리면 전부 기본값으로 두고 다음만 누르면 됩니다.
설치 후 별도로 열어볼 필요는 없습니다. 이후 직접 다룰 일도 없습니다.

WHY — 왜 하나요?

Git은 Claude Code가 내부적으로 쓰는 부품입니다. 자동차의 엔진 부품처럼, 한 번 장착하면 존재를 잊어도 됩니다.

Claude Code 확장 설치

VS Code를 열고, 왼쪽 세로 메뉴에서 네모 블록 4개 모양 아이콘(확장 프로그램)을 클릭합니다.
검색창에 Claude Code를 입력합니다.
Claude Code for VS Code (Anthropic 제공)를 찾아 Install을 클릭합니다.

WHY — 왜 하나요?

확장은 VS Code에 기능을 더하는 부속품입니다. 이 단계로 VS Code 안에 Claude와 대화하는 버튼이 생깁니다.

설치가 끝나면 VS Code 오른쪽 위나 사이드바에 Claude 아이콘이 생깁니다. 클릭하면 로그인 창이 뜹니다.
브라우저가 열리면서 Claude 계정 로그인을 요청합니다. 구독한 계정으로 로그인하고 승인을 누릅니다.
"인증 완료" 메시지가 뜨면 VS Code로 돌아옵니다.

브라우저 팝업이 안 뜨면 팝업 차단 설정을 확인하세요.

WHY — 왜 하나요?

로그인은 "이 컴퓨터의 Claude Code가 내 구독 계정 소속"임을 연결하는 절차입니다. 한 번만 하면 이후에는 자동으로 유지됩니다.

Mac 설치

VS Code 설치

code.visualstudio.com에서 Download for macOS를 클릭합니다.
내려받은 파일의 압축을 풀고, Visual Studio Code 앱을 응용 프로그램(Applications) 폴더로 끌어다 놓습니다.
응용 프로그램 폴더에서 VS Code를 한 번 실행해 봅니다.

WHY — 왜 하나요?

Windows와 같은 이유입니다. Claude Code가 작동할 공간을 먼저 마련하는 단계입니다.

Git 확인

Mac은 Git이 이미 깔려 있는 경우가 많습니다. VS Code에서 터미널을 열고(Cmd + ~) 아래를 입력해 봅니다.

git --version

버전 번호가 나오면 통과입니다. "설치하시겠습니까?"라는 팝업이 뜨면 설치를 누르고 기다리면 됩니다.

WHY — 왜 하나요?

Claude Code가 내부적으로 쓰는 부품이 이미 있는지 확인하는 단계입니다. 있으면 그냥 넘어가고, 없으면 Mac이 알아서 설치해 줍니다.

Claude Code 확장 설치와 로그인

Windows와 동일합니다.

VS Code 확장 프로그램에서 Claude Code를 검색해 Claude Code for VS Code (Anthropic 제공)를 설치합니다.
Claude 아이콘을 눌러 브라우저 로그인을 완료합니다. 구독한 계정으로 로그인하고 승인을 누릅니다.

WHY — 왜 하나요?

확장 설치로 대화 버튼이 생기고, 로그인으로 내 구독과 연결됩니다. 이 두 가지가 끝나면 설치는 사실상 완료입니다.

첫 실행: 폴더 열고 대화 시작하기

Claude Code는 폴더 단위로 일합니다. 폴더를 하나 열어주면, Claude가 그 안의 파일을 읽고 새 파일을 만들 수 있습니다.

작업 폴더 만들기

바탕화면에 새 폴더를 하나 만듭니다. 이름은 자유롭게, 예를 들어 AI작업.

WHY — 왜 하나요?

Claude Code에게 "여기가 네 책상"이라고 정해주는 단계입니다. Claude는 이 폴더 안에서만 파일을 읽고 쓰기 때문에, 컴퓨터 전체를 뒤지는 일은 없습니다.

VS Code에서 폴더 열기

VS Code에서 파일 → 폴더 열기로 방금 만든 폴더를 엽니다. "이 폴더의 작성자를 신뢰하시겠습니까?"라는 화면이 뜨면 신뢰를 누릅니다. 직접 만든 폴더이니 안전합니다.

Claude Code 실행과 첫 프롬프트

Claude 아이콘을 눌러 Claude Code를 실행합니다. 입력창이 나타나면 준비 완료입니다. 첫 프롬프트로 이걸 그대로 붙여넣어 보세요.

나 이런거 하고싶은데. 어떻게 해야해?
방금 클로드 코드 설치했거든. 완전 초보자야.
내가 해야하는것들 단계별로 순차적으로 알려줘.
클로드 코드 하나도 모르니깐 아주 기본적인 용어들도 친절하게 설명해줘!

Claude가 친절하게 안내를 시작할 겁니다.

실제 업무 하나 시켜보기

이어서 실제 업무를 하나 시켜보세요.

내일 미팅 안건을 정리해서 파일로 저장해줘. 주제는 [미팅 주제].

결과가 채팅 답변이 아니라 폴더 안의 파일로 바로 저장되는 것을 확인해 보세요. 채팅창이었으면 복사해서 붙여넣어야 했을 일이, 파일로 완성되어 나옵니다. 이것이 Claude Code의 핵심 차이입니다.

진행 중 뜰 수 있는 화면들

설치와 첫 실행 중에 아래 화면들이 뜰 수 있습니다. 전부 정상적인 과정이니, 해당하는 항목을 찾아 그대로 처리하면 됩니다.

1. 보안 경고 ("알 수 없는 게시자", "확인되지 않은 개발자")

Windows에서 "이 앱이 디바이스를 변경하도록 허용하시겠습니까?", Mac에서 "확인되지 않은 개발자" 경고가 뜰 수 있습니다. 이 글의 공식 사이트(code.visualstudio.com, git-scm.com)에서 받은 파일이라면 허용/열기를 눌러 진행하면 됩니다. 공식 사이트가 아닌 곳에서 받은 파일이라면 진행하지 말고 다시 받으세요.

2. 권한 요청 팝업

설치 중 관리자 비밀번호를 묻거나, Claude Code 사용 중 "이 파일을 수정해도 될까요?", "이 명령을 실행해도 될까요?"라고 물어볼 수 있습니다. 이것은 오류가 아닙니다. Claude Code의 안전장치가 작동하는 모습이죠. 내용을 읽고 이해되는 요청이면 승인하고, 이해되지 않으면 "방금 요청한 게 무슨 뜻이야?"라고 Claude에게 물어본 뒤 결정하면 됩니다.

3. 백신 프로그램 차단

V3, 알약 같은 백신이 설치 파일이나 터미널 실행을 차단하는 경우가 있습니다. 백신을 잠시 비활성화하거나, VS Code와 Git을 예외(허용) 목록에 추가한 뒤 다시 시도하세요. 설치가 끝나면 백신은 다시 켜도 됩니다.

4. 회사 노트북 제약

관리자 권한이 없거나 사내 보안 정책으로 설치가 막히는 경우입니다. IT 담당자에게 VS Code와 Git 설치 승인을 요청하세요. 프록시나 방화벽 때문에 로그인이 안 되는 경우도 있는데, 이때도 IT 담당자에게 "claude.ai 도메인 접속 허용"을 문의하면 됩니다.

TIP — 그 밖의 모든 에러

에러 메시지를 통째로 복사해서 Claude(웹 채팅이든 Claude Code든)에 붙여넣고 "이거 왜 이래?"라고 물어보세요. 대부분 해결됩니다. 에러는 실패가 아니라 설치 과정의 일부입니다.

보안: 입력하면 안 되는 것

Claude에 입력하는 내용은 Anthropic 서버로 전송됩니다. 일반적인 업무는 괜찮지만, 아래는 어떤 AI 서비스에서든 직접 입력하지 않는 게 원칙입니다.

입력해도 되는 것	주의가 필요한 것
이메일·보고서 초안	고객 개인정보 (이름, 연락처, 주민번호)
일반 업무 자료	미공개 재무·계약 정보
공개된 시장 데이터	비밀번호, 인증키
내부 회의록 요약	법적 분쟁 관련 문서

끝났는지 확인

CHECK — 설치 완료 체크리스트

아래 다섯 개가 모두 "예"라면 설치는 완벽하게 끝난 겁니다.

VS Code가 실행된다
VS Code 왼쪽 확장 목록에 Claude Code가 "설치됨"으로 보인다
Claude 아이콘을 누르면 로그인 요청 없이 입력창이 바로 뜬다
폴더를 열고 말을 걸면 Claude가 답한다
"테스트 파일 하나 만들어줘"라고 하면 폴더 안에 실제 파일이 생긴다

하나라도 "아니오"라면, 위의 "진행 중 뜰 수 있는 화면들"에서 해당 단계로 돌아가 다시 진행하세요.

마무리 팁: 창 2개 전략

익숙해지기 전까지는 세션 2개를 띄워 두시길 권합니다.

세션 1: 실제 작업	세션 2: 과외 선생님
"문서 작성해줘"	"이게 무슨 뜻이야?"
"데이터 정리해줘"	"방금 에러 났는데 왜?"

한쪽에서는 일을 시키고, 다른 한쪽에서는 궁금한 점을 물어보는 방식입니다. Claude 자체가 가장 좋은 선생님입니다.

설치를 마쳤다면, 다음 글에서 Claude Code를 움직이는 원리, 즉 LLM과 에이전트가 무엇인지부터 개념을 잡아보세요.