Claude Code 작동 방식 이해하기 1: 에이전트 루프, 내장 도구

 

Claude Code는 antropic의 대표적인 AI 에이전트 툴입니다. 코딩을 굉장히 잘하며 터미널 기반으로 실행되지만 문서 작성, 빌드 실행, 파일 검색, 정보 탐색 등의 작업 역할까지 잘합니다.

이런 Claude Code를 가장 잘쓰는 빌더가 되기 위해서는 작동 방식을 이해하는 것이 가장 중요합니다.

오늘은 에이전트 루프, 내장 도구 등의 요소를 바탕으로 Claude Code가 여러분의 프로젝트와 어떻게 상호작용 하는지 알아보겠습니다.

 

에이전트 루프

Claude(혹은 Claude Code)에게 작업을 시키면 다음과 같이 세가지 단계를 거칩니다.

1. Gather context(컨텍스트 수집)
2. Take action(작업 수행)
3. Verify results(결과 검증)

이러한 3단계를 하나의 루프라고 부르고 각 단계는 사용자 요청에 맞게 조정됩니다. 예를 들어 코드에 대한 질문은 컨텍스트 수집만 필요할 수도 있습니다. 반면 버그 수정이나 리팩토링과 같은 과정들은 세 단계를 반복적으로 수행할 것입니다. 

Claude는 이전 단계에서 얻은 것을 바탕으로 현재 단계에서 필요한 것을 결정하고, 수십 개의 작업을 연결 혹은 도출하여 앞으로의 작업 방향을 결정합니다. 

 

하지만 이 루프의 주체는 Claude 뿐만 아니라 사용자도 포함됩니다. 언제든지 Claude의 작업을 중단하고 다른 방향을 제시하거나 추가적인 context를 제공하여 제어할 수 있습니다. 바로 이 점에서 Claude를 잘 쓰는 사람의 차별점이 나옵니다. 추후 올바른 사용법도 다른 글에서 알아보도록 하겠습니다.

 

에이전트 루프는 다음과 같이 두가지 구성 요소로 구동됩니다.

 

• 추론하는 모델: Claude 같은 모델. 무엇을 할지 판단하는 두뇌
• 작용하는 도구: 파일 읽기·수정, 명령 실행, 검색 등 실제 동작을 수행하는 수단. 모델의 판단을 실제 행동으로 옮김

 

추론하는 모델

Claude Code는 Claude 모델을 사용하여 코드를 이해하고 작업에 대해 추론합니다. Claude는 모든 언어의 코드를 이해하고 구성 요소가 간의 연결 관계를 이해합니다. 또한 목표를 달성하기 위한 변경 사항을 파악합니다. 만약 작업이 복잡할 경우에는 작업의 단계를 나누고, 실행하고, 단계별 결과를 통해 방향성을 조정합니다.

Claude에서 제공하는 다양한 모델을 활용할 수 있고 각 모델별로 장단점이 있습니다. 각 모델들의 장단점을 잘 파악해서 세션에 맞는 모델을 /model 명령어를 통해 전환하거나 claude --model <name>로 모델을 설정해서 세션을 시작할 수 있습니다.

 

항목	Haiku 4.5	Sonnet 4.6	Opus 4.8	Fable 5
포지션	경량·고속	균형 (범용 기본값)	고성능 플래그십	Mythos급 최상위
출시	2025.10	2026.02	2026.05.28	2026.06.09
가격(입력/출력, 100만 토큰)	$1 / $5	$3 / $15	$5 / $25	$10 / $50
컨텍스트 윈도우	200K	1M	1M	1M
최대 출력	—	64K~	128K	128K
Extended thinking	미지원	지원	지원 (adaptive)	지원
안전 등급/특징	ASL-2(가장 안전)	ASL-3	ASL-3	안전 분류기 내장, 고위험 질의 Opus 4.8로 자동 폴백

 

도구

도구는 Claude를 Claude Code(에이전트)로 만들어주는 역할을 합니다. 만약 도구 없이 Claude만 활용한다면 사용자의 요청을 텍스트로만 응답할 것입니다. 하지만 도구가 있으면 Claude는 다음과 같은 작업들을 할 수 있습니다.

• 코드 읽고 이해
• 파일 편집
• 명령어 실행
• 웹 검색
• 외부 서비스 상호작용
• 그 밖의 다양한 작업들

각각의 도구들은 작업을 할 뿐만 아니라 작업에 대한 피드백을 제공하여 Claude가 다음 결정을 하는 데에 도움을 줍니다.

 

Claude의 내장 도구는 일반적으로 다음과 같이 다섯 가지 범주로 나뉩니다.

범주	Claude가 할 수 있는 것
파일 작업	파일 읽기, 코드 편집, 새 파일 생성, 이름 변경 및 재구성
검색	패턴으로 파일 찾기, 정규식으로 콘텐츠 검색, 코드베이스 탐색
실행	셸 명령 실행, 서버 시작, 테스트 실행, git 사용
웹	웹 검색, 문서 가져오기, 오류 메시지 조회
코드 인텔리전스	편집 후 타입 오류 및 경고 확인, 정의로 이동, 참조 찾기 (코드 인텔리전스 플러그인 필요)

이 밖에도 Claude는 subagents를 생성하고, 질문을 하고, 다른 오케스트레이션 작업을 위한 도구를 제공합니다. 전체 도구 목록은 Claude가 사용할 수 있는 도구 에서 확인할 수 있습니다.

 

Claude는 사용자의 프롬프트를 이해하고 이해한 내용을 바탕으로 사용할 도구를 선택합니다. 만약 "실패한 테스트에 대한 내용을 수정해"라고 말하면 Claude는 다음과 같이 동작합니다.

1. 테스트를 실행하여 무엇이 실패하는지 확인
2. 오류 출력 읽기
3. 관련 소스 파일 검색
4. 해당 파일을 읽어 코드 이해
5. 파일을 편집하여 문제 수정
6. 테스트를 다시 실행하여 검증

내장 도구는 가장 기초적인 도구입니다. 앞으로 skills로 Claude가 알 수 있는 것을 확장하고, MCP로 외부 서비스에 연결하고, hooks로 워크플로우를 자동화하고, subagents로 작업을 위임하는 등 다양한 도구를 활용하여 기능을 확장할 수 있습니다. 이러한 확장은 기본적인 에이전트 루프 위에 계층을 형성해줍니다. 필요에 따라 확장하는 방법은 Claude Code 확장 에서 확인할 수 있습니다.