Clip 1: 설치와 기본 사용법

📋 학습 개요

🎯 학습 목표

• Claude Code를 성공적으로 설치하고 초기 설정을 완료할 수 있다

• 대화형 모드와 일회성 실행 모드의 차이를 이해하고 상황에 맞게 활용할 수 있다

• Plan Mode를 활용하여 안전하게 코드 분석 및 구현 계획을 수립할 수 있다

• 실전 워크플로우(코드베이스 이해, 버그 수정, 기능 추가)를 적용할 수 있다

• Claude Code의 권한 관리 시스템을 이해하고 안전하게 사용할 수 있다

🗂️ STEP 1: Claude Code 설치하기

Claude Code는 터미널에서 작동하는 AI 코딩 도구로, Node.js 환경 또는 네이티브 설치를 통해 사용할 수 있습니다.

시스템 요구사항

시작하기 전에 다음 사항을 확인하세요:

• Node.js 18 이상 (NPM 설치 방식 사용 시)

• Claude.ai 계정 또는 Claude Console 계정

• 터미널 환경 (macOS, Linux, Windows WSL)

  • windows 를 사용하신다면 WSL을 추천드립니다.

설치 방법 선택

방법 1: NPM을 통한 설치 (권장)

# Claude Code 전역 설치
npm install -g @anthropic-ai/claude-code

# 설치 확인
claude --version

설치 트러블슈팅 방법

claude.ai 에 접속해서 오류 메시지를 붙여넣으면서 해결 방법을 알려달라고 하세요.

✅ 설치 확인

설치가 완료되면 다음 명령어로 정상 작동을 확인합니다:

# Claude Code 실행
claude

📱 STEP 2: 초기 설정 및 로그인

첫 실행 및 로그인

Claude Code를 처음 실행하면 로그인이 필요합니다:

# Claude Code 대화형 모드 시작
claude

터미널에서 다음과 같은 프롬프트가 나타납니다:

Welcome to Claude Code!
Please log in to continue.

> /login

로그인 방법

옵션 1: Claude.ai 계정 (권장)

• 개인 사용자에게 권장

• 구독 플랜을 통해 무제한 사용 가능

• 웹 브라우저를 통한 간편 인증

옵션 2: Claude Console (API 계정)

• 기업 또는 팀 사용

• API 키를 통한 인증

• 사용량 기반 과금 (선불 크레딧)

인증 프로세스

# 대화형 세션에서 로그인 명령 실행
> /login

1. 브라우저가 자동으로 열립니다

2. Claude 계정으로 로그인합니다

3. 터미널 접근 권한을 승인합니다

4. 터미널로 돌아와 인증 완료를 확인합니다

인증 성공 메시지:

✅ Successfully logged in as [e-mail]

기본 명령어 확인

로그인 후 사용 가능한 명령어를 확인하세요:

# 도움말 보기
> /help

주요 명령어 목록:

• /help - 사용 가능한 명령어 목록 표시

• /clear - 대화 기록 초기화

• /mcp - mcp 도구 관리

🎮 STEP 3: 기본 사용법

Claude Code는 두 가지 주요 실행 모드를 제공합니다.

모드 1: 대화형 모드 (Interactive Mode)

프로젝트 디렉토리에서 지속적인 작업을 할 때 사용합니다.

# 프로젝트 디렉토리로 이동
cd ~/projects/my-awesome-project

# 대화형 모드 시작
claude

대화형 모드의 특징:

• 세션이 유지되며 컨텍스트가 누적됨

• 여러 질문과 작업을 연속적으로 수행 가능

• 프로젝트 파일을 자동으로 읽고 분석

예제 대화:

# 프로젝트 이해하기
> 이 프로젝트가 무엇을 하는지 설명해줘

# 아키텍처 파악하기
> 주요 기술 스택과 폴더 구조를 설명해줘

# 특정 기능 찾기
> 사용자 인증은 어떻게 구현되어 있어?

모드 2: 일회성 실행 (One-off Execution)

간단한 질문이나 단일 작업에 사용합니다.

# 직접 질문 전달
claude -p "이 프로젝트의 진입점 파일은 무엇인가?"

# 특정 파일 분석
claude -p "app.py 파일의 주요 함수들을 설명해줘"

# 빠른 코드 검토
claude -p "최근 커밋에서 변경된 내용을 요약해줘"

일회성 실행의 장점:

• 빠른 정보 확인에 유용

• 스크립트나 자동화에 통합 가능

• 세션 오버헤드 없음

파일 참조 방법

특정 파일을 명시적으로 참조할 때는 @ 기호를 사용합니다:

# 특정 파일 참조
> @src/main.py 이 파일의 주요 로직을 설명해줘

# 여러 파일 참조
> @models/user.py @controllers/auth.py 이 두 파일이 어떻게 연동되는지 설명해줘

🎛️ STEP 4: 실행 모드 전환하기

Claude Code는 작업 상황에 맞는 4가지 실행 모드를 제공합니다. Shift + Tab 키를 눌러 언제든지 모드를 전환할 수 있습니다.

모드 전환 방법

대화형 세션 중 Shift + Tab을 누르면 모드를 변경할 수 있습ㄴ다.:

Select mode:
❯ Default Mode (기본 모드)
  Accept All Edits (자동 승인)
  Plan Mode (계획 모드)
  Bypass Permissions (권한 무시)

주의! Bypass Permissions (권한 무시 모드)

설명: 시스템 권한 확인을 건너뛰는 고급 모드입니다. 매우 주의해서 사용해야 합니다.

특징:

• ⚠️ 모든 권한 체크 우회

• 🔓 제한된 도구나 명령 실행 가능

• 🚨 보안 위험 증가

CLI 옵션:

# 시작부터 권한 무시 모드로 실행
claude --dangerously-skip-permissions

팁

1. 모드 조합 활용:

# 1단계: Plan Mode로 계획 수립
[Shift + Tab → Plan Mode]
> 이 기능을 어떻게 구현해야 할까?

# 2단계: Default Mode로 신중하게 구현
[Shift + Tab → Default Mode]
> 계획대로 구현해줘 (각 단계 검토)

# 3단계: 테스트 작성은 빠르게
[Shift + Tab → Accept All Edits]
> 관련 테스트 케이스들 작성해줘

2. Git과 함께 사용:

# 작업 전 브랜치 생성
git checkout -b feature/new-feature

📖 참고 자료

공식 문서

• Claude Code 개요 - Claude Code의 전체 기능과 특징

• Claude Code 빠른 시작 - 설치부터 첫 실행까지 단계별 가이드

• 일반적인 워크플로우 - 실전 사용 패턴과 고급 기능

---

강사 정보

• 작성자: 정구봉

• LinkedIn: https://www.linkedin.com/in/gb-jeong/

• 이메일: [e-mail]

강의 자료

• 강의 자료: https://goobong.gitbook.io/fastcampus

• Github: https://github.com/Koomook/fastcampus-ai-agent-vibecoding

• FastCampus 강의 주소: https://fastcampus.co.kr/biz_online_vibeagent