Claude Code 사용법 완전 가이드 — 터미널 AI 코딩 어시스턴트 시작법

Claude Code는 Anthropic이 만든 AI 코딩 어시스턴트로, 터미널 기반의 에이전트형 도구다. 코드베이스 전체를 이해하고, 파일을 직접 수정하며, 복잡한 리팩토링을 자율적으로 수행하는 점에서 GitHub Copilot이나 Cursor와 차별화된다.

📌 Claude Code란?
터미널에서 실행하는 AI 코딩 어시스턴트. 프로젝트 전체를 분석하고, 지시에 따라 파일을 직접 생성·편집·삭제한다. 사용자 승인 과정을 거쳐 안전하게 코드를 변경한다.

Claude Code 설치 및 시작

# npm으로 설치
npm install -g @anthropic-ai/claude-code

# 프로젝트 디렉토리에서 실행
cd my-project
claude

# API 키 설정 (처음 실행 시)
ANTHROPIC_API_KEY=your-key claude

주요 기능과 활용법

코드베이스 이해

> 이 프로젝트의 인증 시스템이 어떻게 작동하는지 설명해줘
→ Claude가 관련 파일을 찾아 읽고 전체 흐름 설명

멀티파일 리팩토링

> 모든 API 호출에 에러 핸들링을 추가해줘
→ 관련 파일 자동 식별 → 각 파일 수정 계획 제시 → 승인 후 실행

버그 수정

> 사용자 로그인 시 세션이 유지되지 않는 버그를 찾아 수정해줘
→ 관련 코드 추적 → 원인 분석 → 수정안 제시

📊 Claude Code 성능 지표
Anthropic 공식 발표(2025)에 따르면, SWE-bench(실제 소프트웨어 엔지니어링 태스크) 벤치마크에서 Claude Code는 72.5% 성공률을 기록해 당시 기준 최고 점수를 달성했다. 이는 복잡한 실제 코드베이스 수정 능력을 평가한 결과다.

Claude Code가 특히 강한 영역

대규모 코드베이스 리팩토링
테스트 코드 자동 생성
레거시 코드 이해 및 문서화
보안 취약점 탐지
API 통합 작업

요금

Claude API 사용량에 따라 과금된다. Claude Sonnet 모델 기준 입력 토큰 $3/1M, 출력 토큰 $15/1M (2025 기준). 일반적인 코딩 작업 1시간 세션은 $1~$5 범위다.

자주 묻는 질문

Q. Claude Code와 Cursor의 차이는 무엇인가요?

Cursor는 IDE 기반으로 코드 작성 중 실시간 AI 지원이 특징이고, Claude Code는 터미널 기반으로 더 자율적인 에이전트 방식이다. 복잡한 멀티파일 변경이나 자동화 작업에서 Claude Code가 더 강력한 경우가 많다.

Q. 내 코드가 Anthropic에 전송되나요?

Claude API를 통해 코드가 Anthropic 서버로 전송된다. 기업 환경에서 민감한 코드는 Claude Claude API의 데이터 처리 정책을 확인하고, 필요시 기업 전용 Claude for Enterprise를 사용한다.

복잡한 레거시 코드베이스를 이해하거나 대규모 리팩토링이 필요할 때, Claude Code는 IDE 플러그인 이상의 강력한 에이전트 역할을 한다.

📚 관련 글