Claude Code란 무엇인가

들어가며

이전 섹션에서 Claude AI의 기초, 가격 체계, 접근 방법을 학습했다. 이제 본격적으로 Claude Code의 세계로 들어간다.

Claude Code는 단순한 코드 자동완성 도구가 아니다. AI가 코드를 직접 읽고, 수정하고, 명령을 실행하는 에이전틱 코딩(Agentic Coding) 도구다. 이번 차시에서는 Claude Code가 무엇인지, 기존 AI 코딩 도구와 어떻게 다른지, 어떤 상황에서 활용할 수 있는지 살펴본다.

Claude Code란

정의

Claude Code는 Anthropic이 만든 에이전틱 코딩 도구(Agentic Coding Tool)다. 터미널, IDE, 데스크톱 앱, 웹 브라우저에서 실행되며, 코드베이스를 이해하고 파일을 편집하고 명령을 실행할 수 있다.

에이전틱(Agentic)이란

“에이전틱”이란 AI가 스스로 판단하고 행동할 수 있다는 의미다. 사용자가 일일이 지시하지 않아도 Claude가 필요한 작업을 스스로 결정하고 수행한다.

일반 AI 코딩 도구의 작업 흐름

사용자: "이 함수를 수정해줘"
AI: [코드 제안]
사용자: [제안된 코드를 복사해서 붙여넣기]
사용자: [테스트 실행]
사용자: [오류 발생 시 다시 질문]

에이전틱 코딩 도구(Claude Code)의 작업 흐름

사용자: "로그인 버그를 수정해줘"
Claude:
  1. 파일 시스템 탐색
  2. 관련 파일 찾기
  3. 코드 읽기
  4. 버그 분석
  5. 수정 적용
  6. 테스트 실행
  7. 결과 확인
  8. 필요시 추가 수정

사용자는 목표만 제시하면 된다. Claude가 나머지를 처리한다.

핵심 능력

자율적 탐색

Claude Code는 프로젝트 전체를 탐색하고 이해한다. 특정 파일 위치를 알려주지 않아도 필요한 파일을 스스로 찾는다. 의존성 관계를 파악하고 관련 코드를 추적한다.

멀티파일 편집

여러 파일을 동시에 수정할 수 있다. 하나의 기능을 구현하려면 여러 파일을 수정해야 하는 경우가 많은데, Claude Code는 이를 자동으로 처리한다. 파일 간 일관성도 유지한다.

명령 실행

터미널 명령을 직접 실행한다. 테스트 실행, 빌드, 린트 검사 등을 수행하고 결과를 확인한다. 오류가 발생하면 원인을 분석하고 수정한다.

Git 통합

Git 작업을 자동화한다. 변경사항을 확인하고, 커밋 메시지를 작성하고, 브랜치를 만들고, PR을 생성한다.

에이전틱 루프

Claude Code는 “에이전틱 루프(Agentic Loop)“라는 방식으로 동작한다.

1. 사용자 요청 이해
   ↓
2. 필요한 도구 선택 (Read, Edit, Bash 등)
   ↓
3. 도구 실행
   ↓
4. 결과 분석
   ↓
5. 추가 작업 필요? → 2로 돌아감
   ↓
6. 완료 및 응답

Claude는 작업이 완료될 때까지 이 루프를 반복한다. 파일을 읽고, 분석하고, 수정하고, 테스트하고, 필요하면 다시 수정한다. 사용자가 매 단계를 지시할 필요가 없다.

GitHub Copilot과의 비교

기능 비교

근본적인 차이

GitHub Copilot은 코드 자동완성에 초점을 맞춘다. 개발자가 코드를 작성하는 동안 다음에 올 코드를 예측해서 제안한다. 개발자는 제안을 수락하거나 거부한다.

Claude Code는 작업 자체를 수행한다. “이 버그를 수정해줘”라고 하면 Claude가 직접 파일을 찾고, 코드를 분석하고, 수정하고, 테스트한다. 개발자는 결과를 검토하고 승인한다.

비유하자면, Copilot은 옆에서 제안하는 페어 프로그래머고, Claude Code는 직접 일하는 주니어 개발자다.

언제 어떤 도구를 사용할까

GitHub Copilot이 적합한 경우

• 코드를 직접 작성하면서 자동완성 도움을 받고 싶을 때
• 간단한 함수나 반복적인 코드 작성
• IDE에서 끊김 없이 코딩할 때

Claude Code가 적합한 경우

• 복잡한 버그 수정이 필요할 때
• 여러 파일에 걸친 리팩토링
• 테스트 작성 및 실행
• Git 작업 자동화
• 프로젝트 구조 분석

두 도구는 경쟁 관계라기보다 상호 보완적이다. 함께 사용할 수 있다.

실제 활용 사례

버그 수정

claude
> 테스트가 실패해. 수정해줘

Claude의 작업:

1. npm test 실행
2. 실패 로그 분석
3. 관련 코드 파일 찾기
4. 버그 원인 파악
5. 코드 수정
6. 테스트 재실행
7. 성공 확인

새 기능 추가

> 사용자 프로필에 아바타 업로드 기능 추가해줘

Claude의 작업:

1. 기존 프로필 코드 분석
2. 업로드 컴포넌트 생성
3. API 엔드포인트 추가
4. 스토리지 로직 구현
5. UI 연동
6. 테스트 작성

코드 리팩토링

> 이 클래스가 너무 커. 더 작은 함수들로 분리해줘

Claude의 작업:

1. 클래스 구조 분석
2. 책임 분리 (Single Responsibility)
3. 새 파일 생성
4. 코드 이동
5. import 문 업데이트
6. 테스트로 동작 검증

프로젝트 분석

> 이 프로젝트의 아키텍처를 설명해줘

Claude가 프로젝트 전체를 탐색하고 구조를 분석해서 설명한다. 어떤 프레임워크를 사용하는지, 디렉토리 구조가 어떻게 되어 있는지, 주요 모듈이 어떻게 연결되어 있는지 파악한다.

Git 작업

> 변경사항을 커밋하고 PR을 만들어줘

Claude의 작업:

1. git status로 변경사항 확인
2. 변경 내용 분석
3. 적절한 커밋 메시지 작성
4. 커밋 생성
5. 브랜치 생성 (필요시)
6. PR 생성

사용 가능한 환경

Claude Code는 여러 환경에서 사용할 수 있다.

각 환경은 동일한 Claude Code 엔진을 사용한다. CLAUDE.md 파일, 설정, MCP 서버가 모든 환경에서 동일하게 적용된다.

터미널 (CLI)

가장 기본적인 사용 방법이다. 파일 편집, 명령 실행, 프로젝트 관리를 모두 터미널에서 할 수 있다.

cd your-project
claude

VS Code 확장

VS Code 내에서 Claude Code를 사용한다. 인라인 diff, @-멘션, 플랜 리뷰, 대화 히스토리를 제공한다. Extensions에서 “Claude Code”를 검색해서 설치한다.

JetBrains 플러그인

IntelliJ IDEA, PyCharm, WebStorm 등 JetBrains IDE에서 사용한다. JetBrains Marketplace에서 “Claude Code” 플러그인을 설치한다.

데스크톱 앱

독립 실행형 앱이다. 시각적으로 diff를 검토하고, 여러 세션을 동시에 실행하고, 예약 작업을 설정할 수 있다. macOS와 Windows를 지원한다.

웹

claude.ai/code에서 브라우저로 실행한다. 로컬 설치 없이 사용할 수 있다. 장시간 실행되는 작업을 시작하고 나중에 확인할 수 있다.

구독 요구사항

Claude Code를 사용하려면 다음 중 하나가 필요하다.

무료 플랜에서는 Claude Code를 사용할 수 없다. Pro 이상의 구독 또는 API 키가 필요하다.

정리

핵심 요점

1. Claude Code는 에이전틱 코딩 도구다: AI가 스스로 판단하고 작업을 수행한다

2. 에이전틱 루프로 동작한다: 도구 선택 → 실행 → 결과 분석 → 추가 작업의 순환을 반복한다

3. Copilot과 근본적으로 다르다: Copilot은 제안하고, Claude Code는 실행한다

4. 다양한 환경에서 사용 가능하다: 터미널, VS Code, JetBrains, 데스크톱 앱, 웹

5. Pro 이상 구독이 필요하다: 무료 플랜에서는 사용할 수 없다

확인해볼 링크

• Claude Code 공식 사이트
• Claude Code 문서
• Claude 구독 플랜

다음 단계

다음 차시에서는 Claude Code를 설치하고 초기 설정을 진행한다. macOS, Linux, Windows 각 운영체제별 설치 방법과 로그인 절차를 학습한다.

참고 자료

• Claude Code overview - Claude Code
• Claude Code quickstart - Claude Code