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브라우저가 자동으로 열립니다
Claude 계정으로 로그인합니다
터미널 접근 권한을 승인합니다
터미널로 돌아와 인증 완료를 확인합니다
인증 성공 메시지:
✅ Successfully logged in as your-email@example.com기본 명령어 확인
로그인 후 사용 가능한 명령어를 확인하세요:
# 도움말 보기
> /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/
이메일: bong@dio.so
강의 자료
강의 자료: https://goobong.gitbook.io/fastcampus
Github: https://github.com/Koomook/fastcampus-ai-agent-vibecoding
FastCampus 강의 주소: https://fastcampus.co.kr/biz_online_vibeagent
Last updated