Claude Code 완전정복 가이드

터미널에서 만나는 AI 코딩 파트너

---

목차

1. Claude Code란?
2. 설치 가이드
3. 인증 및 로그인
4. 기본 사용법
5. 핵심 슬래시 명령어
6. 권한 시스템
7. CLAUDE.md - 프로젝트 메모리
8. MCP (Model Context Protocol) 소개
9. IDE 통합
10. 실전 팁과 모범 사례
11. 명령어 치트시트
12. 실습 미션

---

1. Claude Code란?

Claude Code는 Anthropic이 만든 에이전트형(Agentic) 코딩 CLI 도구입니다. 터미널 안에서 직접 동작하며, 단순한 코드 생성을 넘어 파일 읽기/쓰기, 명령어 실행, Git 작업까지 자율적으로 수행합니다.

일반 AI 챗봇과의 차이점

+-------------------+     +-------------------+
|   일반 AI 챗봇     |     |   Claude Code      |
+-------------------+     +-------------------+
| 질문 → 답변       |     | 질문 → 실행 → 결과 |
| 코드를 "복사"해서  |     | 코드를 직접 파일에  |
| 직접 붙여넣어야 함 |     | 작성하고 테스트까지  |
|                   |     | 자동으로 수행       |
| 프로젝트 맥락 모름 |     | 전체 프로젝트 이해  |
+-------------------+     +-------------------+

핵심 특징

• 터미널 네이티브: 터미널 환경에 최적화되어, 개발 워크플로우를 벗어나지 않고 사용
• 에이전트형 동작: 단순 응답이 아니라, 작업을 완수하기 위해 필요한 도구를 자율적으로 호출
• 프로젝트 이해: 코드베이스 전체를 검색하고 분석하여 맥락을 파악
• 안전한 권한 시스템: 위험한 명령어는 사용자의 명시적 허가 없이 실행되지 않음
• MCP 확장: 외부 도구와 서비스를 연결하여 기능을 무한히 확장

Tip: 언제 Claude Code를 쓰면 좋을까?

• 새 프로젝트를 빠르게 시작하고 싶을 때
• 버그를 찾고 고치고 싶을 때
• 코드를 리팩토링하고 싶을 때
• Git 작업(커밋, PR)을 자동화하고 싶을 때
• 프로젝트 구조를 파악하고 싶을 때

---

2. 설치 가이드

시스템 요구사항

항목	최소 사양
OS	macOS 13.0+, Windows 10 1809+, Ubuntu 20.04+
RAM	4GB 이상
인터넷	필수 (API 통신)
터미널	Bash, Zsh, Fish, PowerShell 등

macOS / Linux (WSL 포함)

권장 방법: 네이티브 설치관리자

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

설치 후 셸을 재시작하면 claude 명령어를 사용할 수 있습니다.

Homebrew로 설치

brew install claude

Windows

권장 방법: 네이티브 설치관리자

PowerShell에서 실행:

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

WinGet으로 설치

winget install Anthropic.ClaudeCode

참고: npm 설치는 더 이상 권장되지 않습니다

이전에는 npm install -g @anthropic-ai/claude-code로 설치했으나, 현재는 네이티브 설치관리자 사용이 권장됩니다. npm 방식은 하위 호환성을 위해 아직 지원되지만, 최신 기능과 안정성을 위해서는 위의 방법을 사용하세요.

설치 확인

claude --version

버전 정보가 출력되면 설치 성공입니다!

WSL (Windows Subsystem for Linux) 사용자 참고

Windows에서 Linux 환경으로 Claude Code를 사용하려면 WSL2가 필요합니다.

# PowerShell (관리자)에서 WSL 설치
wsl --install

# WSL 터미널 안에서 Claude Code 설치
curl -fsSL https://claude.ai/install.sh | bash

Tip: WSL에서 파일 접근하기

• Windows에서 WSL 파일 접근: \\wsl$\Ubuntu\home\사용자이름
• WSL에서 Windows 파일 접근: /mnt/c/Users/사용자이름

---

3. 인증 및 로그인

필수 계정

Claude Code를 사용하려면 다음 중 하나의 유료 플랜이 필요합니다:

플랜	설명
Pro	개인 사용자용 ($20/월)
Max	고사용량 개인용 ($100/월 이상)
Team	팀 단위 공용
Enterprise	기업용 (맞춤 설정)
Console	API 직접 결제 방식

참고: 무료(Free) 플랜으로는 Claude Code를 사용할 수 없습니다.

로그인 방법

1. 웹 브라우저 로그인 (기본)

claude

처음 실행하면 브라우저가 열리며 인증 페이지로 이동합니다. 로그인 후 터미널로 돌아오면 자동으로 인증이 완료됩니다.

2. API 키 직접 입력

export ANTHROPIC_API_KEY="sk-ant-..."
claude

3. 서드파티 클라우드 제공자 사용

Amazon Bedrock:

export CLAUDE_CODE_USE_BEDROCK=1
claude

Google Vertex AI:

export CLAUDE_CODE_USE_VERTEX=1
claude

4. 로그인/로그아웃 명령어

# 로그인
claude /login

# 로그아웃
claude /logout

# 현재 상태 확인
claude /status

인증 문제 해결

# 시스템 진단 실행
claude /doctor

Tip: 학교나 공용 PC에서 사용할 때

API 키 방식(ANTHROPIC_API_KEY)을 사용하면 브라우저를 열지 않고도 인증할 수 있어 편리합니다. 단, API 키는 절대 공개 저장소에 올리지 마세요!

---

4. 기본 사용법

대화형 모드 (Interactive Mode)

터미널에 claude를 입력하면 대화형 모드가 시작됩니다:

claude

╭─────────────────────────────────────────╮
│  Claude Code                            │
│                                         │
│  무엇이든 물어보세요!                    │
│  종료하려면 /exit 또는 Ctrl+C            │
╰─────────────────────────────────────────┘
>

대화형 모드에서는 연속적으로 질문하고 답변을 주고받을 수 있습니다. Claude가 이전 대화 맥락을 기억합니다.

원샷 모드 (One-shot Mode)

-p 플래그를 사용하면 명령어 한 줄로 질문하고 바로 종료됩니다:

# 간단한 질문
claude -p "Python에서 리스트를 역순으로 정렬하는 방법 알려줘"

# 파이프로 파일 내용 전달
cat main.py | claude -p "이 코드의 버그를 찾아줘"

# 특정 파일과 함께 질문
claude -p "app.py 파일에서 사용된 함수들을 요약해줘"

주요 실행 옵션

# 프로젝트 디렉토리 지정
claude --project-dir /path/to/project

# 모델 지정
claude --model claude-sonnet-4-20250514

# 출력 형식 지정 (파이프라인에 유용)
claude -p "요약해줘" --output-format json

# 대화형 모드에서 초기 프롬프트 지정
claude "이 프로젝트 구조를 분석해줘"

실전 예제

# 1. 새 React 프로젝트 시작하기
claude "Vite + React + TypeScript로 새 프로젝트를 설정해줘"

# 2. 버그 수정하기
claude "login 함수에서 null pointer 에러가 나는데 원인을 찾아줘"

# 3. 테스트 코드 작성
claude "utils.py의 모든 함수에 대한 단위 테스트를 작성해줘"

# 4. 코드 리뷰
claude "지금 staging area에 있는 변경사항을 리뷰해줘"

# 5. Git 커밋 메시지 생성
claude "변경사항을 분석하고 적절한 커밋 메시지를 작성해줘"

Tip: 좋은 프롬프트 작성법

• 구체적으로 작성하기: "버그 고쳐줘"보다 "login 함수의 null 체크 누락 버그를 고쳐줘"
• 맥락 제공하기: "이 프로젝트에서"보다 "이 Express 서버 프로젝트에서"
• 단계 나누기: 복잡한 작업은 여러 단계로 나누어 요청
• 예상 결과 명시: "결과물은 배열을 반환해야 해"

---

5. 핵심 슬래시 명령어

대화형 모드에서 /로 시작하는 명령어들을 사용할 수 있습니다.

명령어 목록

명령어	설명
/help	도움말 표시
/init	프로젝트에 CLAUDE.md 초기화
/compact	대화 기록 압축 (토큰 절약)
/clear	대화 기록 전체 삭제
/config	설정 관리
/review	코드 리뷰 수행
/memory	CLAUDE.md 메모리 편집
/cost	현재 세션의 비용/토큰 사용량 표시
/doctor	설치 및 설정 상태 진단
/status	계정 및 연결 상태 확인
/vim	Vim 키바인딩 토글
/login	계정 로그인
/logout	계정 로그아웃
/pr-comments	GitHub PR의 코멘트 리뷰
/terminal-setup	터미널 쉘 통합 설정 (Shift+Tab 자동완성)

자주 쓰는 명령어 상세

/compact - 대화 압축

긴 대화 세션에서 토큰 사용량이 많아지면 응답 속도가 느려집니다. /compact를 실행하면 이전 대화를 요약하여 토큰을 절약합니다.

> /compact
대화 기록을 압축했습니다. (12,000토큰 → 800토큰)

/init - 프로젝트 초기화

현재 디렉토리에 CLAUDE.md 파일을 생성하고 프로젝트 구조를 분석합니다.

> /init
CLAUDE.md 파일을 생성했습니다. 프로젝트 구조를 분석 중...

/cost - 비용 확인

> /cost
세션 토큰 사용량: 45,230 (입력: 38,000 / 출력: 7,230)
예상 비용: $0.14

/review - 코드 리뷰

현재 Git staging area의 변경사항을 자동으로 리뷰합니다.

> /review
3개 파일의 변경사항을 리뷰합니다...

[REVIEW] src/auth.py
  - 42번째 줄: 비밀번호 비교에 timing attack 방어가 필요합니다
  - 78번째 줄: 에러 메시지가 너무 구체적입니다

Tip: /compact를 습관화하세요

긴 작업 세션에서는 10~15분마다 /compact를 실행하면 응답 품질과 속도를 유지할 수 있습니다.

---

6. 권한 시스템

Claude Code는 강력한 도구인 만큼, 안전한 권한 관리 시스템을 갖추고 있습니다.

권한 흐름도

Claude가 도구 사용 요청
         │
         ▼
   ┌─────────────┐     허용     ┌──────────┐
   │  권한 확인   │─────────────▶│  도구 실행 │
   └──────┬──────┘              └──────────┘
          │ 거부/질문
          ▼
   ┌─────────────┐
   │  사용자에게  │
   │  권한 요청   │
   └──────┬──────┘
          │
     ┌────┴────┐
     ▼         ▼
   허용       거부
     │         │
     ▼         ▼
  실행     작업 취소

도구 목록

Claude Code가 사용할 수 있는 주요 도구들:

도구	설명	위험도
Read	파일 읽기	낮음
Write	파일 쓰기 (새 파일 생성)	중간
Edit	파일 편집 (기존 파일 수정)	중간
Bash	셸 명령어 실행	높음
Glob	파일 패턴 검색	낮음
Grep	파일 내용 검색	낮음
WebFetch	웹 페이지 가져오기	낮음
WebSearch	웹 검색	낮음

권한 설정 배열

설정 파일에서 세 가지 배열로 권한을 관리합니다:

• allow: 항상 허용 (사용자 확인 없이 실행)
• deny: 항상 거부
• ask: 항상 사용자에게 물어봄

// .claude/settings.json 예시
{
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep"
    ],
    "deny": [
      "Bash(rm -rf *)"
    ]
  }
}

Bash 명령어 권한 세부 설정

Bash 도구는 명령어 패턴별로 권한을 다르게 설정할 수 있습니다:

{
  "permissions": {
    "allow": [
      "Bash(git log*)",
      "Bash(git diff*)",
      "Bash(npm test*)",
      "Bash(ls *)"
    ],
    "deny": [
      "Bash(rm -rf /)",
      "Bash(sudo *)"
    ]
  }
}

설정 파일 우선순위

┌─────────────────────────────────┐
│  Enterprise Managed Settings     │  ← 최고 우선순위
│  (기업 관리자가 설정)            │
├─────────────────────────────────┤
│  Command Line Arguments          │  ← CLI 실행 시 인자
│  (claude --allowedTools ...)    │
├─────────────────────────────────┤
│  Local Project Settings          │
│  (.claude/settings.local.json)  │  ← Git에 올리지 않음
├─────────────────────────────────┤
│  Shared Project Settings         │
│  (.claude/settings.json)        │  ← 팀 공유용
├─────────────────────────────────┤
│  User Settings                   │  ← 최소 우선순위
│  (~/.claude/settings.json)      │
└─────────────────────────────────┘

Tip: 안전하게 시작하세요

초기에는 기본 설정(모든 위험 명령어에 ask)을 그대로 사용하고, 익숙해진 후에 자주 쓰는 명령어만 allow에 추가하세요. 절대 Bash(*)를 allow에 넣지 마세요!

---

7. CLAUDE.md - 프로젝트 메모리

CLAUDE.md는 Claude Code가 프로젝트에 대해 기억하는 메모리 파일입니다. 프로젝트의 규칙, 구조, 코딩 스타일 등을 적어두면 Claude가 항상 이를 참조합니다.

CLAUDE.md의 4가지 레벨

┌─────────────────────────────────────────┐
│  1. Enterprise                          │
│     ~/.claude/CLAUDE.md                 │  ← 기업 전체 규칙
├─────────────────────────────────────────┤
│  2. User                                │
│     ~/.claude/CLAUDE.md                 │  ← 개인 코딩 스타일
├─────────────────────────────────────────┤
│  3. Project (공유)                      │
│     프로젝트루트/CLAUDE.md               │  ← 팀 공유 규칙 (Git 추적)
├─────────────────────────────────────────┤
│  4. Project (로컬)                      │
│     프로젝트루트/.claude/CLAUDE.local.md │  ← 개인 프로젝트 메모 (Git 무시)
└─────────────────────────────────────────┘

CLAUDE.md 예시

# Project: MyTodoApp

## 기술 스택
- Backend: Python FastAPI
- Frontend: React + TypeScript
- Database: PostgreSQL

## 코딩 규칙
- Python은 Black 포매터 사용 (line-length: 88)
- TypeScript는 strict mode 사용
- 커밋 메시지는 Conventional Commits 형식
- 모든 함수에 docstring 작성

## 프로젝트 구조
- src/api/ - API 엔드포인트
- src/models/ - 데이터 모델
- src/services/ - 비즈니스 로직
- tests/ - 테스트 파일

## 주의사항
- .env 파일은 절대 Git에 올리지 않기
- 데이터베이스 마이그레이션은 항상 확인 후 실행

CLAUDE.md 가져오기 (Import)

다른 파일의 내용을 CLAUDE.md로 가져올 수 있습니다:

# CLAUDE.md

@docs/coding-standards.md
@docs/api-conventions.md

위 파일의 규칙을 따르세요.

빠른 메모 추가

대화 중에 # 기호를 사용하여 CLAUDE.md에 빠르게 메모를 추가할 수 있습니다:

> # 항상 한국어로 주석을 작성할 것
CLAUDE.md에 추가했습니다: "항상 한국어로 주석을 작성할 것"

CLAUDE.md 관리 명령어

# 프로젝트에 CLAUDE.md 생성
/init

# 기존 CLAUDE.md 편집
/memory

# 내용 확인
cat CLAUDE.md

Tip: CLAUDE.md는 "살아있는" 문서입니다

프로젝트가 진행되면서 규칙이 바뀌면 CLAUDE.md도 함께 업데이트하세요. Claude가 새로운 세션을 시작할 때마다 이 파일을 읽어서 최신 규칙을 반영합니다.

---

8. MCP (Model Context Protocol) 소개

MCP는 Claude Code를 외부 도구 및 서비스와 연결하는 표준 프로토콜입니다. MCP 서버를 추가하면 Claude가 데이터베이스, API, 파일 시스템 등 다양한 외부 자원에 접근할 수 있습니다.

MCP 동작 구조

┌──────────────┐     stdio/SSE/HTTP     ┌──────────────┐
│  Claude Code │◄──────────────────────▶│  MCP Server  │
│  (Client)    │                        │              │
└──────────────┘                        └──────┬───────┘
                                               │
                                    ┌──────────┼──────────┐
                                    ▼          ▼          ▼
                              ┌────────┐ ┌────────┐ ┌────────┐
                              │Database│ │ REST   │ │ File   │
                              │        │ │ API    │ │ System │
                              └────────┘ └────────┘ └────────┘

MCP 전송 방식

전송 방식	설명	사용 시기
stdio	표준 입출력으로 통신	로컬 프로세스 (기본)
sse	Server-Sent Events	원격 서버
http	HTTP 기반 통신	원격 서버

MCP 서버 관리 명령어

# MCP 서버 추가
claude mcp add <이름> <명령어> [인수...]

# stdio 예시: 로컬 파일시스템 서버 추가
claude mcp add filesystem npx -y @anthropic-ai/mcp-filesystem /path/to/dir

# SSE 예시: 원격 서버 추가
claude mcp add --transport sse remote-api https://example.com/mcp

# HTTP 예시
claude mcp add --transport http api-server https://api.example.com/mcp

# 등록된 MCP 서버 목록 보기
claude mcp list

# 특정 서버 정보 확인
claude mcp get <이름>

# 서버 제거
claude mcp remove <이름>

MCP 서버 범위 (Scope)

# 로컬 프로젝트에만 추가 (기본, .claude/settings.local.json에 저장)
claude mcp add --scope local myserver npx -y some-mcp-server

# 프로젝트 공유용 (.claude/settings.json에 저장, 팀원과 공유)
claude mcp add --scope project myserver npx -y some-mcp-server

# 사용자 전체 적용 (~/.claude/settings.json에 저장)
claude mcp add --scope user myserver npx -y some-mcp-server

인기 MCP 서버 예시

# GitHub 연동
claude mcp add github npx -y @anthropic-ai/mcp-github

# PostgreSQL 데이터베이스 연동
claude mcp add postgres npx -y @anthropic-ai/mcp-postgres postgresql://localhost/mydb

# 파일시스템 접근
claude mcp add files npx -y @anthropic-ai/mcp-filesystem ~/projects

Tip: MCP로 Claude Code를 확장하세요

MCP는 Claude Code의 확장성을 크게 높여줍니다. 자주 사용하는 외부 서비스가 있다면 MCP 서버를 찾아보세요. MCP 서버 목록에서 다양한 서버를 찾을 수 있습니다.

---

9. IDE 통합

Claude Code는 VS Code와 JetBrains IDE와 깊게 통합되어, 에디터 안에서 바로 사용할 수 있습니다.

VS Code

설치 방법:

# Claude Code 설치 시 VS Code 확장이 자동으로 설치됨
# 또는 수동 설치:
claude install-vscode-extension

주요 단축키:

단축키	동작
Cmd+Esc (Mac)	Claude Code 열기/닫기
Ctrl+Esc (Win)	Claude Code 열기/닫기
Cmd+Esc 후 선택	선택한 코드를 Claude에게 전달

주요 기능:

• 선택한 코드 조각을 컨텍스트로 전달
• Claude가 제안한 변경사항을 Diff 뷰로 확인
• 터미널 패널에서 대화형 모드 사용
• 파일 탭과 에러 정보 자동 인식

JetBrains (IntelliJ, PyCharm, WebStorm 등)

설치 방법:

JetBrains 마켓플레이스에서 "Claude Code" 플러그인을 검색하여 설치합니다.

지원 IDE:

• IntelliJ IDEA
• PyCharm
• WebStorm
• GoLand
• RustRover
• 기타 JetBrains 제품 전체

주요 기능:

• 에디터 내 터미널에서 Claude Code 실행
• 선택한 코드 컨텍스트 자동 전달
• Diff 뷰어로 변경사항 확인
• 프로젝트 구조 자동 인식

IDE 통합 워크플로우 예시

1. VS Code에서 코드 선택
2. Cmd+Esc 눌러서 Claude Code 열기
3. "이 코드 최적화해줘" 입력
4. Diff 뷰에서 변경사항 확인
5. 수락 또는 거부

Tip: IDE 통합을 적극 활용하세요

터미널만 쓰는 것보다 IDE 통합을 사용하면 시각적으로 변경사항을 확인하기 편하고, 코드 선택이 쉬워집니다. 특히 파일이 많은 프로젝트에서 유용합니다.

---

10. 실전 팁과 모범 사례

효과적인 프롬프트 작성법

1. 역할 부여하기

나는 React 초보자야. 아주 쉬운 용어로 설명해줘.

2. 단계별로 요청하기

좋음: "1단계: 데이터 모델링, 2단계: API 설계, 3단계: 프론트엔드 구현으로 나누어서 진행해줘"
나쁨: "전체 앱을 한 번에 만들어줘"

3. 제약 조건 명시하기

Python 3.11 호환 코드만 작성해줘. 외부 라이브러리는 최소한으로 사용해.

4. 예상 출력 형식 지정하기

결과는 Markdown 테이블 형식으로 정리해줘.

프로젝트 설정 팁

1. 프로젝트 시작 시 반드시 /init 실행

cd my-project
claude
> /init

이렇게 하면 Claude가 프로젝트 구조를 분석하고 CLAUDE.md를 생성합니다.

2. .claude/ 디렉토리를 .gitignore에 추가

# .gitignore
.claude/settings.local.json
.claude/CLAUDE.local.md

공유 설정(.claude/settings.json)은 Git에 올리되, 로컬 설정은 올리지 않습니다.

3. 자주 쓰는 명령어는 allow에 추가

// .claude/settings.json
{
  "permissions": {
    "allow": [
      "Bash(git *)",
      "Bash(npm run test*)",
      "Bash(python -m pytest*)",
      "Bash(ls *)",
      "Bash(cat *)"
    ]
  }
}

비용 관리 팁

1. /compact 정기 사용

긴 세션에서 대화를 압축하면 토큰 사용량을 크게 줄일 수 있습니다.

2. 원샷 모드 활용

간단한 질문은 대화형 모드 대신 -p 플래그를 사용:

claude -p "이 파일에서 TODO 주석 찾아줘"

3. /cost로 모니터링

정기적으로 비용을 확인하여 예상치 못한 사용량 증가를 방지합니다.

문제 해결

Claude Code가 응답하지 않을 때:

# 1. 상태 확인
claude /status

# 2. 진단 실행
claude /doctor

# 3. 대화 초기화
claude /clear

# 4. 재로그인
claude /logout
claude /login

터미널 표시 깨짐:

# 터미널 설정 재초기화
claude /terminal-setup

Tip: 클라우드 제공자를 비교해 보세요

Anthropic 직접 연결, Amazon Bedrock, Google Vertex AI 중 비용과 성능이 가장 적합한 것을 선택하세요. 학생이라면 Console 플랜으로 사용량 기반 결제가 유리할 수 있습니다.

---

11. 명령어 치트시트

실행 명령어

명령어	설명
claude	대화형 모드 시작
claude "질문"	대화형 모드 + 초기 질문
claude -p "질문"	원샷 모드 (질문 후 종료)
claude -p -f json "질문"	원샷 + JSON 출력
claude --model 모델명	모델 지정
claude --project-dir 경로	프로젝트 디렉토리 지정
claude --version	버전 확인
claude /doctor	설치 진단

대화형 모드 명령어

명령어	설명
/help	도움말
/init	CLAUDE.md 초기화
/compact	대화 압축
/clear	대화 초기화
/config	설정 관리
/review	코드 리뷰
/memory	메모리 편집
/cost	비용/토큰 확인
/status	상태 확인
/doctor	진단
/login	로그인
/logout	로그아웃
/pr-comments	PR 코멘트 리뷰
/terminal-setup	터미널 셋업
/vim	Vim 키바인딩 토글

MCP 명령어

명령어	설명
claude mcp add 이름 명령어	MCP 서버 추가
claude mcp list	서버 목록
claude mcp get 이름	서버 정보
claude mcp remove 이름	서버 제거

설정 파일 위치

파일	설명
~/.claude/settings.json	사용자 전역 설정
프로젝트/.claude/settings.json	프로젝트 공유 설정
프로젝트/.claude/settings.local.json	프로젝트 로컬 설정
프로젝트/CLAUDE.md	프로젝트 메모리
프로젝트/.claude/CLAUDE.local.md	개인 프로젝트 메모리
~/.claude/CLAUDE.md	사용자 전역 메모리

단축키

단축키	설명	환경
Ctrl+C	현재 작업 취소	터미널
Ctrl+C (빈 줄)	대화형 모드 종료	터미널
Cmd+Esc	Claude Code 열기/닫기	VS Code (Mac)
Ctrl+Esc	Claude Code 열기/닫기	VS Code (Win)
Shift+Tab	자동완성 토글	터미널 (setup 후)

환경 변수

변수	설명
ANTHROPIC_API_KEY	API 키 직접 설정
CLAUDE_CODE_USE_BEDROCK	Amazon Bedrock 사용
CLAUDE_CODE_USE_VERTEX	Google Vertex AI 사용

---

12. 실습 미션

아래 미션을 순서대로 완료하면서 Claude Code를 체험해 보세요!

미션 1: 설치하고 첫 인사하기

목표: Claude Code를 설치하고 첫 대화 나누기

체크리스트:
[ ] Claude Code 설치 (curl 또는 brew)
[ ] 버전 확인 (claude --version)
[ ] 로그인 완료
[ ] 대화형 모드에서 "안녕! 너에 대해 소개해줘" 입력
[ ] /cost로 토큰 사용량 확인

미션 2: 나만의 CLAUDE.md 만들기

목표: 프로젝트에 CLAUDE.md를 설정하고 메모리 활용하기

체크리스트:
[ ] 새 디렉토리 생성 (mkdir my-first-project && cd my-first-project)
[ ] claude 실행 후 /init 명령어로 CLAUDE.md 생성
[ ] /memory로 CLAUDE.md에 "나는 한국 고등학생이야. 쉬운 설명 부탁해" 추가
[ ] "내 CLAUDE.md에 뭐가 적혀있어?"라고 물어보기
[ ] cat CLAUDE.md로 파일 내용 직접 확인

미션 3: 간단한 프로젝트 만들기

목표: Claude Code와 함께 실제 프로젝트를 만들어 보기

체크리스트:
[ ] Claude에게 "Python으로 숫자 맞추기 게임을 만들어줘" 요청
[ ] 생성된 코드 확인
[ ] "한국어 주석을 달아줘"라고 추가 요청
[ ] "게임 시작 시 난이도를 선택할 수 있게 해줘" 요청
[ ] /review로 코드 리뷰 받기

미션 4: 권한 시스템 체험하기

목표: 권한 시스템을 이해하고 안전하게 설정하기

체크리스트:
[ ] Claude에게 "새 파일을 만들어줘" 요청 → 권한 요청 확인
[ ] 권한 요청에서 '허용' 선택
[ ] .claude/settings.json에서 Read를 allow에 추가
[ ] 다시 파일 읽기 요청 → 자동으로 허용되는지 확인
[ ] /cost로 세션 비용 확인

미션 5: Git과 함께 사용하기

목표: Claude Code의 Git 연동 기능 활용하기

체크리스트:
[ ] Git 저장소 생성 (git init)
[ ] Claude에게 앞서 만든 게임을 커밋해달라고 요청
[ ] 생성된 커밋 메시지 확인
[ ] "게임에 최고 점수 기능을 추가해줘" 요청
[ ] 변경사항을 커밋
[ ] git log로 커밋 내역 확인

미션 6: 종합 챌린지

목표: 배운 것을 모두 활용하여 미니 프로젝트 완성하기

체크리스트:
[ ] "Todo 리스트 앱을 Python + Flask로 만들어줘" 요청
[ ] /init으로 프로젝트 CLAUDE.md 생성
[ ] "단위 테스트도 작성해줘" 요청
[ ] 테스트 실행 (Claude에게 실행 요청)
[ ] /compact로 대화 압축
[ ] "README.md를 작성해줘" 요청
[ ] /review로 전체 코드 리뷰
[ ] 모든 변경사항 Git 커밋
[ ] /cost로 전체 세션 비용 확인

---

축하합니다! 이제 Claude Code의 기본을 모두 익혔습니다. 더 깊은 내용은 공식 문서를 참고하세요. 궁금한 점이 생기면 언제든 claude를 열고 질문해 보세요!

---

이 문서는 Claude Code 학습을 위해 작성되었습니다. 최종 업데이트: 2025년