Claude Code 시리즈 튜토리얼 1: Claude Code란 무엇인가?

1.1 Claude Code란 무엇인가?

한마디 정의

Claude Code는 Anthropic이 출시한 터미널(Terminal)에서 실행되는 AI 프로그래밍 에이전트(Agent)입니다. 개발자가 자연어로 작업을 설명하면, Claude Code가 능동적으로 코드베이스를 읽고, 수정 제안을 하며, 명령을 실행하고, 테스트를 돌리고, Git을 조작하며, 수정 전에 승인을 요청하기도 합니다. 단순히 조언을 주는 "챗봇"이 아니라, 직접 작업을 수행하는 "파트너"입니다.

터미널 속 자율 프로그래밍 에이전트

Claude Code를 이해하는 핵심은 "Agentic"이라는 단어에 있습니다. 기존의 AI 프로그래밍 도우미는 상담사와 같아서, 질문을 하면 조언을 주고 사용자가 직접 코드를 수정해야 했습니다. 반면 Claude Code는 에이전트입니다. 목표를 제시하면 스스로 단계를 계획하고, 관련 파일을 찾아내고, 작업을 수행하며, Shell이 할 수 있는 모든 것(파일 수정, 명령 실행, 자동 디버깅, 확장 도구를 통한 다른 형식 파일 접근/편집 등)을 실행합니다.

이러한 자율성은 세 가지 수준에서 나타납니다.

파일 작업: 여러 파일에 걸쳐 읽기, 검색, 생성, 편집이 가능하며, 단일 파일에 제한되지 않고 전체 프로젝트 구조를 이해합니다.
명령 실행: Shell 명령을 실행하고, 개발 환경을 설정하며, 테스트 및 빌드 스크립트를 실행할 수 있습니다.
워크플로 조정: 여러 단계의 작업을 계획하고 자율적으로 실행합니다. 예를 들어 "현재 디렉터리의 모든 TypeScript 파일을 읽어 엄격 모드로 리팩토링한 후 검사를 실행하세요."

어떤 능력을 가지고 있나요?

Anthropic의 공식 정의와 엔지니어링 팀의 모범 사례에 따르면, Claude Code는 현재 다음과 같은 핵심 기능을 제공합니다.

코드 이해: 프로젝트 디렉터리에서 직접 코드 구조를 분석하고, 호출 관계를 추적하며, 비즈니스 로직을 이해합니다.
코드 생성 및 수정: 자연어 명령에 따라 새 코드를 생성하거나, 기존 코드를 여러 파일에 걸쳐 리팩토링합니다.
명령 실행: Shell 명령을 실행하고, 테스트, 빌드, 배포 스크립트를 실행하며, 결과를 설명할 수 있습니다.
지속적 메모리: CLAUDE.md 파일을 통해 프로젝트 규칙과 개발 선호도를 기록하여 세션 간에도 컨텍스트를 일관되게 유지합니다.
컨텍스트 압축: 긴 대화 기록을 자동으로 압축하여 컨텍스트를 유지하면서 토큰을 절약합니다.
멀티 모델 전환: Sonnet, Opus, Haiku 등 다양한 모델을 지원하며, 작업 복잡도에 따라 유연하게 선택할 수 있습니다.
백그라운드 작업: 백그라운드에서 실행 및 비동기 작업 수행을 지원합니다.

마지막 요약

Claude Code를 이렇게 이해하면 됩니다. 코드를 아는 동료가 옆에 앉아, 당신이 요구하면 직접 파일을 수정합니다.

Claude Code는 당신을 대체하는 "블랙박스 코드 생성기"가 아니라, "자동 페어 프로그래머"입니다. 당신이 방향을 잡고, Claude Code가 세부 사항을 실행합니다. 실제 페어 프로그래밍에서 당신이 검토와 방향을 제시하고, 파트너가 구현과 테스트 검증을 담당하는 것처럼, "말하면 실행하는" 협업 모델을 실현합니다.