Claude Code 설치 가이드

1

Step 1

Claude가 뭔가요?

Claude는 Anthropic이 만든 AI 어시스턴트입니다. GPT처럼 대화할 수 있고, 코드를 짜거나 글을 쓰거나 분석을 도와줍니다. 이 가이드에서 쓸 도구는 세 가지인데, 각각 용도가 다릅니다.

🖥️

웹 / 앱

Claude Desktop

채팅 앱이면서, Standard/Team 플랜에는 'Code' 탭이 포함됩니다. 이미 Desktop을 쓰고 있다면 CLI를 별도 설치하지 않아도 됩니다.

이 가이드에서 사용

⌨️

터미널 / Desktop 내장

Claude Code

실제 파일을 읽고 코드를 직접 작성하는 코딩 도우미입니다. Desktop의 'Code' 탭 또는 터미널 CLI로 사용합니다.

이 가이드에서 사용

🔌

개발자용

Claude API

내가 만드는 서비스에 Claude를 넣을 때 씁니다. 지금 당장은 몰라도 됩니다.

나중에

💡 흐름: Claude Desktop에서 아이디어를 구체화 → Claude Code로 실제 구현. 이 두 개가 세트입니다.

2

Step 2

Claude Desktop 설치

1

claude.ai 접속 후 계정 만들기

브라우저에서 claude.ai로 접속합니다. 구글 계정으로 가입하면 가장 빠릅니다. 무료 플랜으로 시작해도 됩니다.

2

앱 다운로드

로그인 후 좌측 하단 메뉴에서 "Download the app"을 클릭하거나, 아래 링크에서 직접 받습니다.

Mac

Windows

a

.dmg 파일 다운로드

claude.ai/download 에서 macOS용 파일을 받습니다.

b

Applications 폴더로 드래그

dmg 파일을 열고 Claude 아이콘을 Applications 폴더로 드래그합니다.

c

처음 실행 시 보안 경고 해결

"확인되지 않은 개발자" 경고가 뜨면:
시스템 설정 → 개인 정보 및 보안 → "그래도 열기" 클릭

a

.exe 설치 파일 다운로드

claude.ai/download 에서 Windows용 파일을 받습니다.

b

설치 파일 실행

다운받은 .exe 파일을 더블클릭합니다.
"Windows가 PC를 보호했습니다" 경고가 뜨면 "추가 정보 → 실행" 클릭

c

로그인

설치 완료 후 claude.ai에서 만든 계정으로 로그인합니다.

✅ Claude Desktop이 열리고 채팅창이 보이면 완료입니다. 먼저 "안녕"이라고 해보세요.

Claude Desktop 화면 구성

Claude

채팅

Cowork

코드

최근 프로젝트

my-project/

spgMonitoring/

AtCom/

무엇을 도와드릴까요?

                현재 폴더에서 Claude Code 시작...
                Enter
              

'코드' 탭이 바로 Claude Code GUI입니다. 터미널 없이 클릭만으로 프로젝트 폴더를 열고 Claude Code를 시작할 수 있습니다.

Standard / Team 플랜 사용자라면

Desktop을 설치하면 '코드' 탭이 이미 Claude Code입니다. Step 4 (CLI 설치)는 건너뛰어도 됩니다. 아래 버튼으로 Step 4 설명을 바로 확인하거나, Step 5로 넘어가세요.

Desktop 'Code' 탭 사용법 보기 Step 5 추가 도구로 건너뛰기

Desktop 버전에서만 쓸 수 있는 기능

🔍

시각적 Diff 리뷰

Claude가 수정한 코드를 변경 전/후 비교해서 GUI로 확인하고 승인

🖥️

라이브 앱 미리보기

웹 앱을 만들면 Desktop 안에서 실시간 미리보기 가능

⚡

병렬 세션

여러 작업을 동시에 진행 (Git worktrees 기반 독립 환경)

🔗

커넥터

GitHub, Slack, Linear, Notion 등 외부 서비스와 직접 연동

🗓️

예약 작업

정기 실행 작업 설정 가능 (스케줄링)

🔒

SSH 세션

원격 서버에 SSH 연결 후 Claude Code 실행

* 컴퓨터 사용(computer use) 기능은 macOS Pro/Max 플랜에서만 지원됩니다.

3

Step 3

Node.js 설치

Claude Code는 Node.js 위에서 실행됩니다. 개발 도구들의 공통 기반이라고 생각하면 됩니다. 이미 설치되어 있을 수도 있습니다 — 먼저 확인해보세요.

이미 설치됐는지 확인

터미널 / 명령 프롬프트

$ node --version

v20.11.0 ← 이런 숫자가 나오면 이미 설치됨

$ node --version

'node'은(는) 내부 또는 외부 명령... ← 이러면 설치 필요

⚠️ 터미널이 처음이라면? Mac은 Spotlight(⌘+Space) → "터미널" 검색, Windows는 시작 → "cmd" 또는 "PowerShell" 검색해서 실행하세요.

설치 방법

Mac

Windows

1

nodejs.org 접속

nodejs.org에서 LTS 버전 다운로드 (왼쪽 초록 버튼)

2

.pkg 파일 실행

다운받은 .pkg 파일을 더블클릭하고 "계속 → 설치" 클릭

3

터미널 재시작 후 확인

node --version # v20.x.x 출력되면 성공

1

nodejs.org 접속

nodejs.org에서 LTS 버전 다운로드 (왼쪽 초록 버튼)

2

.msi 설치 파일 실행

다운받은 .msi 파일 실행 → "Next → Next → Install" 클릭

3

새 PowerShell 창에서 확인

node --version # v20.x.x 출력되면 성공

⚠️ 반드시 새 창을 열어야 합니다. 기존 창에서는 인식 안 될 수 있습니다.

4

Step 4

Claude Code — Desktop 탭 또는 CLI 설치

권장

방법 A · Desktop의 'Code' 탭 사용

Standard / Team 플랜이라면 Claude Desktop을 열었을 때 상단에 '코드' 탭이 보입니다.
별도 설치 없이 탭을 클릭하는 것만으로 Claude Code를 바로 시작할 수 있습니다.

1

Claude Desktop 열기

설치된 Claude Desktop 앱을 실행합니다.

2

상단 탭에서 '코드' 클릭

채팅 | Cowork | 코드 — 세 번째 탭이 Claude Code GUI입니다.
탭이 보이지 않으면 앱을 최신 버전으로 업데이트하세요.

3

프로젝트 폴더 선택

'코드' 탭에서 작업할 폴더를 열면 Claude Code가 자동으로 시작됩니다.
터미널 없이 GUI에서 모든 대화가 가능합니다.

✅ '코드' 탭에서 폴더를 열고 메시지를 보낼 수 있으면 완료입니다. Step 5로 넘어가세요.

또는 CLI를 직접 설치하려면

방법 B

터미널 CLI 설치

터미널에서 직접 사용하거나, Desktop 없이 서버 환경에서 실행할 때 씁니다. Node.js가 먼저 설치되어 있어야 합니다.

1

터미널에서 설치

npm install -g @anthropic-ai/claude-code

설치에 1~2분 걸립니다.

2

설치 확인 및 로그인

claude --version
1.x.x   ← 이렇게 나오면 성공
# 처음 실행 시 로그인
claude
→ 브라우저가 열리며 로그인 페이지로 이동
✓ Logged in as your@email.com
              

⚠️ Windows 권한 오류: PowerShell을 관리자 권한으로 실행 후 다시 시도하세요.

+

선택 · 추천

Google Antigravity — AI 에이전트 IDE

VS Code / Cursor 방식

개발자가 직접 운전
AI는 옆에서 제안만

→ IDE 사용법을 먼저 알아야 함

Antigravity 방식

개발자는 방향만 지시
AI 에이전트 팀이 실행

→ IDE 몰라도 바로 시작 가능

Antigravity 안에서의 모델 역할 분담

✦

Gemini 3.1 Pro

기획 · 설계
병렬 에이전트 실행
브라우저 자동 테스트

+

⌨

Claude Code

복잡한 로직 구현
코드 품질 · 리팩토링
다중 파일 작업

한 모델이 Rate Limit에 걸려도 다른 모델이 이어받아 작업이 끊기지 않습니다

Windows 설치 방법

1

antigravity.google 접속

브라우저에서 antigravity.google로 접속합니다. 구글 계정으로 로그인합니다.

2

Windows용 설치 파일 다운로드

다운로드 페이지에서 Windows (.exe)를 선택합니다.
"Windows가 PC를 보호했습니다" 경고가 뜨면 추가 정보 → 실행 클릭

3

설치 완료 후 구글 계정 로그인

앱 실행 후 구글 계정으로 로그인합니다. Standard/Team Google Workspace 계정이면 더 좋습니다.

4

Claude Code 확장팩 추가

Antigravity 안 Extensions 탭(또는 마켓플레이스)에서 "Claude Code"를 검색해서 설치합니다.

⚠️ Claude Code 확장팩 사용 시 Claude Pro·Max 구독 플랜 또는 Anthropic API Key가 필요합니다. Standard/Team 플랜의 Claude Desktop과는 별도입니다.

5

CLAUDE.md 세팅 (강력 추천)

Claude Code 확장팩을 깔았으면, Claude가 내 프로젝트 맥락을 이해하도록 CLAUDE.md를 만들어줍니다.
채팅창에 이렇게 입력하세요:

이 프로젝트의 CLAUDE.md를 만들어줘.
나는 [직책/역할]이고 [프로젝트 이름/목적]을 만들고 있어.
코드 스타일은 [언어], 주석은 한국어로 써줘.
            

설치 후 첫 테스트

동작 확인

"간단한 HTML 페이지 하나 만들어줘"

병렬 에이전트 체험

"메인 페이지와 로그인 페이지를 동시에 만들어줘"

Claude Code 전환

복잡한 로직은 "@Claude 이 부분 구현해줘"

💡 VS Code를 한 번도 안 써봤어도 됩니다. Antigravity는 "무엇을 만들고 싶은지"만 말하면 IDE 설정, 패키지 설치, 파일 구조를 에이전트가 알아서 처리합니다.

5

Step 5 · 선택 사항

프로젝트에 따라 필요한 도구들

아래 도구들은 만드는 것에 따라 필요합니다. 지금 당장 다 설치할 필요 없습니다. Claude Code가 작업 중 필요한 것을 알려주기도 합니다.

💡 모르겠으면 일단 넘어가세요. 막히는 순간이 오면 그때 설치하면 됩니다.

🌿

Git

코드 버전 관리 — 거의 모든 프로젝트에 필요

필수에 가까움

코드를 저장하고 되돌리는 도구입니다. Claude Code가 변경 사항을 커밋하려 할 때 필요합니다.

Mac

Windows

# Xcode Command Line Tools 설치 시 자동으로 포함됩니다
xcode-select --install
# 또는 Homebrew가 있다면
brew install git
# 설치 확인
git --version  → git version 2.x.x
            

git-scm.com에서 Windows용 다운로드 후 설치. 설치 중 모든 옵션은 기본값으로 "Next" 클릭해도 됩니다.

# 새 PowerShell 창에서 확인
git --version  → git version 2.x.x
            

🐍

Python

AI / 데이터 / 자동화 프로젝트에 필요

프로젝트에 따라

FastAPI 백엔드, AI 에이전트, 데이터 분석, 자동화 스크립트 등을 만들 때 필요합니다. SPIGEN APM 같은 Python 프로젝트가 여기 해당합니다.

Mac

Windows

# python.org 에서 최신 버전 다운로드, 또는
brew install python
# 설치 확인
python3 --version  → Python 3.x.x
pip3 --version     → pip 2x.x.x
            

python.org/downloads 에서 최신 버전 설치. 설치 시 "Add python.exe to PATH" 체크박스 반드시 체크!

# 새 PowerShell 창에서 확인
python --version   → Python 3.x.x
pip --version      → pip 2x.x.x
            

⚠️ "PATH에 추가" 체크를 빠뜨리면 명령어가 인식되지 않습니다. 그럴 땐 재설치하세요.

🐳

Docker

DB 띄우기 / 배포 환경 통일이 필요할 때

필요 시 설치

내 컴퓨터에 PostgreSQL, MySQL, Redis 같은 DB를 직접 설치하지 않고도 명령어 한 줄로 실행할 수 있게 해줍니다. "내 환경에서는 됐는데 서버에서 안 돼요" 문제도 해결합니다.

docker.com/products/docker-desktop 에서 운영체제에 맞는 버전 설치

# 설치 확인
docker --version   → Docker version 2x.x.x

# 사용 예시: PostgreSQL DB 띄우기
docker run --name my-postgres \
  -e POSTGRES_PASSWORD=password \
  -e POSTGRES_DB=mydb \
  -p 5432:5432 -d postgres
→ 설치 없이 즉시 DB 사용 가능
          

💡 Claude Code에게 "PostgreSQL이 필요해"라고 하면 Docker 명령어를 알아서 만들어줍니다. 직접 외울 필요 없습니다.

📝

VS Code (에디터)

Claude Code가 만든 코드를 눈으로 확인할 때

강력 추천

Claude Code가 코드를 짜주지만, 그 코드를 직접 보거나 수정하고 싶을 때 코드 에디터가 필요합니다. VS Code가 가장 많이 쓰이고, Claude Code와 연동도 잘 됩니다.

code.visualstudio.com 에서 운영체제에 맞는 버전 무료 다운로드

# VS Code 설치 후, 터미널에서 프로젝트 폴더를 VS Code로 바로 열기
code .   ← 현재 폴더를 VS Code로 오픈
          

그 밖에 프로젝트에 따라 필요할 수 있는 것들

Java / JDK
Spring Boot, Tomcat 프로젝트

MySQL Workbench
DB 내용을 눈으로 확인할 때

Postman
API 테스트 도구

Redis
캐시/세션 저장 (Docker로 실행 권장)

💡 이 도구들이 필요한 시점이 오면 Claude Code에게 "~~ 설치가 필요해, 어떻게 해?"라고 물어보면 그 환경에 맞는 설치 방법을 알려줍니다.

6

Step 6

프로젝트 폴더 세팅

Claude Code는 현재 있는 폴더를 프로젝트로 인식합니다. 폴더를 만들고 그 안에서 시작하면 됩니다.

Mac

Windows

# 1. 프로젝트 폴더 만들기
mkdir my-project
cd my-project

# 2. (선택) VS Code로 열기
code .

# 3. Claude Code 시작
claude
        

# 1. 프로젝트 폴더 만들기
mkdir my-project
cd my-project

# 2. (선택) VS Code로 열기
code .

# 3. Claude Code 시작
claude
        

기본 폴더 구조 (처음엔 이것만 있어도 됩니다)

        my-project/

        └── CLAUDE.md   ← 이것만 있어도 됩니다 (없으면 Claude Code가 만들어줍니다)

💡 기존 프로젝트가 있다면 그 폴더로 이동해서 claude를 실행하면 됩니다. Claude Code가 폴더 안의 파일들을 읽고 이미 있는 코드를 기반으로 작업합니다.

7

Step 7

첫 실행 — 동작 확인

폴더에서 claude를 실행하면 대화창이 열립니다. 간단한 요청으로 동작을 확인해보세요.

~/my-project

$ claude

✓ Claude Code v1.x.x ready

> 이 폴더에 안녕.txt 파일을 만들고 "Hello Claude Code"라고 써줘

안녕.txt 파일을 생성하겠습니다.

Write(안녕.txt): "Hello Claude Code"

✓ 파일이 생성됐습니다.

처음 해보기 좋은 요청들

파일 생성

"간단한 HTML 페이지 하나 만들어줘"

현재 폴더 파악

"이 폴더 구조를 설명해줘"

코드 질문

"Python으로 1~10을 출력하는 코드 만들어줘"

종료

Ctrl+C 또는 "exit"

✅ 설치 완료 체크리스트

✓

Claude Desktop이 열리고 채팅이 됩니다

✓

Desktop의 '코드' 탭을 열고 폴더를 선택해서 대화가 됩니다 (Standard/Team 권장)

✓

터미널에서 node --version이 출력됩니다 (CLI 경로 필요 시)

✓

파일 생성 요청에 실제로 파일이 만들어집니다

✓

응답이 이상하면 Ctrl+C로 중단하고 다시 요청할 수 있다는 걸 압니다

준비됐습니다 🎉

환경 설정이 끝났습니다. 이제 아이디어를 실제로 구현하는 방법을 알아볼 차례입니다.

다음 → 아이디어를 제품으로 만드는 법

설치부터 첫 대화까지

Claude가 뭔가요?

Claude Desktop 설치

Node.js 설치

Claude Code — Desktop 탭 또는 CLI 설치

Google Antigravity — AI 에이전트 IDE

프로젝트에 따라 필요한 도구들

프로젝트 폴더 세팅

첫 실행 — 동작 확인

준비됐습니다 🎉

설치부터
첫 대화까지