Claude Code Tool Use & Agent

Tool은 LLM의 한계를 없애는 대신 예측의 근거를 바꿔주는 장치이며, 이를 스스로 반복해서 쓰는 구조가 Agent임을 이해합니다

Overview

앞 레슨에서 LLM의 답만으로는 사실을 확인하기 어렵다는 점을 배웠습니다. 실제 파일이나 최신 정보를 확인하려면 다른 방법이 필요합니다.

이 레슨을 마치면 Tool이 LLM 예측의 근거를 어떻게 바꾸는지 설명하고, 하나의 Tool 호출과 그것을 반복해 목표까지 진행하는 Agent를 구분할 수 있습니다.

학습 목표

LLM이 Tool 호출을 요청하고, 외부 시스템이 실행 결과를 돌려주는 과정을 설명할 수 있습니다.
Tool로 실제 자료를 확인해 Hallucination과 Knowledge Cutoff를 보완하는 방식을 설명할 수 있습니다.
Agent가 Tool의 결과를 바탕으로 다음 행동을 정하고 목표까지 반복하는 구조를 설명할 수 있습니다.

Tool: 실제 정보를 직접 확인하는 방법

Tool(도구)은 LLM의 요청을 외부 시스템에서 실행하는 기능입니다. Claude Code는 Tool을 통해 파일을 읽거나, 웹을 검색하거나, 터미널 명령을 실행할 수 있습니다.

Claude Code가 쓰는 대표 Tool 네 가지입니다.

Read: 프로젝트 파일을 열어 내용 확인
WebSearch: 웹에서 정보 검색
Bash: 터미널 명령어 실행
Edit: 파일 내용 수정

Tool 호출이 실행되는 과정

Tool 실행 결과가 Context로 돌아오면 LLM이 답변을 만듭니다

LLM은 Tool을 직접 실행하지 않습니다. Tool 이름과 입력값을 담은 호출을 요청하고, 실행은 앱이나 서버가 처리합니다.

LLM이 Tool 이름과 입력값을 담은 호출을 요청합니다.
앱이나 서버가 Tool을 실행하고 결과를 Context에 추가합니다.
LLM이 결과를 바탕으로 답변을 생성합니다.

Context란?

Context는 친구와 카카오톡 할 때 위로 스크롤해 보는 대화와 비슷합니다. Context에는 지금 보낸 메시지와 이전 대화, Tool 결과 같은 정보가 함께 들어갑니다. LLM은 이 정보를 참고해 다음 답을 만듭니다.

Tool을 사용해도 LLM의 예측 방식은 바뀌지 않습니다. Tool이 없을 때와 달라지는 점은 답변 텍스트 대신 구조화된 Tool 호출을 출력할 수 있다는 것입니다.

웹에서 최신 정보 확인하기

"지난주에 릴리스된 Next.js 새 버전, 뭐가 바뀌었어?"

최신 자료가 Context에 없고 학습 기준일 이후에 나온 버전이라면, LLM은 해당 정보를 확인할 수 없습니다. 추측하거나 과거 버전 정보를 최신인 것처럼 말하기 쉽습니다. 웹 검색 Tool을 사용하면 공식 릴리스 노트를 찾아 그 내용을 바탕으로 답할 수 있습니다.

파일을 읽어 실제 코드 확인하기

"이 프로젝트의 인증 로직을 설명해줘"

프로젝트 코드가 Context에 없고 파일을 읽을 Tool도 없다면, LLM은 실제 구현을 확인할 수 없습니다. 일반적인 인증 패턴을 바탕으로 추측해 존재하지 않는 함수명이나 파일명을 만들 수도 있습니다. 파일 읽기 Tool로 auth.ts를 읽으면 실제 코드를 바탕으로 답할 수 있습니다.

Agent: Tool을 반복해 목표를 해결하는 구조

Tool은 파일을 읽거나 명령을 실행하는 하나의 행동을 맡습니다. 하지만 실제 개발 작업에서는 그 결과를 확인하고 다음 행동을 고르는 과정이 계속 이어집니다. 이 과정을 목표에 도달할 때까지 반복하는 구조가 Agent입니다.

Tool 결과를 보고 다음 행동이나 멈춤을 판단합니다

Agent = Tool + Loop + 자율적 판단

Tool: 파일 읽기·수정·명령 실행처럼 필요한 행동을 수행합니다.
Loop: Tool 결과를 확인하고 다시 판단 단계로 돌아갑니다.
자율적 판단: 다음 행동과 멈출 시점을 모델이 정합니다.

"로그인 페이지에서 비밀번호 찾기 링크를 눌러도 아무 반응이 없어. 고쳐줘."

이 요청을 처리하는 작업은 파일 탐색 → 원인 후보 좁히기 → 코드 수정 → 실행·확인으로 이어집니다. Agent는 각 결과를 보고 다음 행동을 정하며 이 과정을 반복합니다. 목표를 달성하거나 사람의 판단이 필요하거나 중단 조건에 도달하면 멈춥니다.

핵심 포인트 정리

Tool은 확인: 파일을 읽고 웹을 검색하거나 명령을 실행해 실제 정보를 확인합니다. LLM의 예측 방식 자체는 바뀌지 않지만, 예측의 근거가 기억에서 확인한 자료로 바뀌어 추측이 줄어듭니다.
Agent는 반복: Tool의 결과를 보고 다음 행동을 정하며, 목표를 달성하거나 멈출 조건에 도달할 때까지 이 과정을 이어갑니다.

이어서 배울 내용

다음 레슨에서는 Agent 구조가 실제 코딩 작업에서 어떻게 쓰이는지 살펴봅니다. 자동완성·대화형 편집·Agentic 코딩의 차이와 Claude Code가 Agentic 코딩에 더한 특징을 알아봅니다.

기억 대신 확인하는 AI | Tool Use & Agent