에이전트 루프

이 페이지의 목차

확인 2026-10-18근거 자료 4건갱신 2026-10-26언급 7곳

이 페이지의 목차

확인 날짜 안내

기본은 Claude Code 공식 문서 Claude Code 작동 방식(원본 날짜 미상, 수집 2026-10-18) 기준이다. 2024년·2025년 Anthropic 글에서 온 정의는 개념 정의라 날짜 계산에서 뺐다. 원본이 든 모델 이름은 "(원본 당시 예시)"다.

정의#

에이전트가 일을 끝낼 때까지 도는 반복 구조다. Claude Code 공식 문서는 작업을 받은 Claude가 세 단계를 거친다고 설명한다. Claude Code 작동 방식

맥락 수집(gather context)
행동(take action)
결과 확인(verify results)

세 단계는 따로 떨어지지 않고 섞이며, Claude는 내내 도구를 쓴다. 원본은 그 도구 사용의 예로 코드를 이해하려고 파일을 검색하기, 바꾸려고 편집하기, 작업을 확인하려고 테스트 돌리기를 든다. 작업이 끝날 때까지 반복하고, 사용자는 어느 시점에든 끼어들 수 있다(원본 도식 설명). Claude Code 작동 방식

루프는 요청에 맞춰 달라진다#

원본이 든 세 예다. Claude Code 작동 방식

요청	루프 모양 (원본 표현)
코드베이스에 대한 질문	맥락 수집만 필요할 수 있다
버그 수정	세 단계를 여러 번 돈다
리팩터링	확인을 많이 할 수 있다

Claude는 앞 단계에서 배운 것을 바탕으로 각 단계에 무엇이 필요한지 정하고, 수십 개의 동작을 이어 가며 도중에 방향을 고친다. Claude Code 작동 방식

원본 예: "실패하는 테스트를 고쳐"라고 하면 Claude는 테스트를 돌려 무엇이 실패하는지 보고 → 오류 출력을 읽고 → 관련 소스 파일을 찾고 → 그 파일을 읽어 코드를 이해하고 → 고치고 → 테스트를 다시 돌려 확인할 수 있다. 원본은 "도구를 쓸 때마다 다음 단계를 정할 새 정보가 생긴다. 이것이 에이전트 루프가 실제로 도는 모습"이라고 말한다. Claude Code 작동 방식

모델, 도구, 하네스#

모델은 추론한다. 코드를 읽고, 구성 요소의 연결을 이해하고, 목표를 이루려면 무엇을 바꿔야 할지 알아낸다. 복잡한 작업은 단계로 나눠 실행하고 배운 것에 따라 조정한다. 원본에서 "Claude가 고른다·정한다"는 모델이 추론한다는 뜻이다. Claude Code 작동 방식
도구는 행동한다. 원본은 도구가 Claude Code를 에이전트로 만든다고 말한다. 도구가 없으면 텍스트로만 답할 수 있고, 도구가 있으면 코드를 읽고, 파일을 고치고, 명령을 돌리고, 웹을 검색하고, 외부 서비스와 상호작용한다. 도구 사용마다 돌아온 정보가 루프로 들어가 다음 결정을 이끈다. Claude Code 작동 방식
하네스는 그 둘레의 층이다. Claude Code는 모델 둘레에서 도구를 제공하고 모델이 보는 컨텍스트를 관리하는 층이고, 원본은 이 층을 "agentic harness"라고 부른다(하네스 풀이: 용어 사전). Claude Code 작동 방식

Claude Code 내장 도구의 다섯 범주(파일 작업, 검색, 실행, 웹, 코드 인텔리전스)와 확장 층은 Claude Code에 있다. 원본은 스킬·MCP·훅·서브에이전트를 이 기본 루프 위에 얹는 층으로 본다. Claude Code 작동 방식 (2026-06-18 기준) 별개로, 블로그 글은 훅과 스킬을 "agent loops" 설계의 구성 요소라고 부른다. 이 글이 말하는 agent loops는 "멈춤 조건을 만날 때까지 도는 반복 워크플로"이고, 위 공식 문서의 맥락 수집·행동·확인 루프와 같은 대상인지는 두 원본 모두 말하지 않는다. 같은 글은 훅이 Claude에게 로드되는 지시가 아니라 하네스가 실행하는 코드라고 설명한다. Steering Claude Code

모델은 여러 개를 쓸 수 있고 장단점이 다르다. 원본은 Sonnet이 대부분의 코딩 작업을 잘 다루고 Opus가 복잡한 아키텍처 결정에 더 강한 추론을 준다고 쓴다(원본 당시 예시). 세션 중 /model, 시작할 때 claude --model <name>으로 고른다. Claude Code 작동 방식

사람도 루프 안에 있다#

원본은 Claude가 자율적으로 일하지만 사용자 입력에 계속 반응한다고 말한다. 언제든 끼어들어 방향을 바꾸거나, 맥락을 더하거나, 다른 접근을 시켜 볼 수 있다. Claude Code 작동 방식 Claude Code에서 끼어드는 두 방법(Esc로 멈추기, 멈추지 않고 정정 메시지 대기열에 넣기)은 Claude Code 세션·체크포인트 다루기에 있다.

다른 정의와의 관계#

(2024년 글) Anthropic의 에이전트 설계 글은 에이전트가 정교한 일을 해도 구현은 보통 "환경 피드백을 받아 루프 안에서 도구를 쓰는 LLM"일 뿐이라고 하고, 매 단계 환경에서 ground truth(도구 호출 결과, 코드 실행 결과 등)를 얻어 진척을 판단하는 것이 결정적이라고 본다. 통제를 위해 최대 반복 횟수 같은 정지 조건을 두는 것도 흔하다고 한다. 효과적인 에이전트 만들기 → 워크플로와 에이전트
(2025년 글) 컨텍스트 엔지니어링 글은 에이전트를 "루프 안에서 자율적으로 도구를 쓰는 LLM"으로 단순하게 정의하게 됐다고 말한다. 효과적인 컨텍스트 엔지니어링 → 컨텍스트 엔지니어링
편집자 해석: Claude Code 공식 문서의 "도구 사용마다 돌아온 정보가 루프로 들어가 다음 결정을 이끈다"와 "결과 확인" 단계는 2024년 글이 말한 "환경 피드백"과 "ground truth로 진척 판단"을 제품 수준에서 설명한 것으로 볼 수 있다. 근거는 두 원본의 위 문장이다. 2024년 글은 Claude Code의 이 세 단계를 직접 말하지 않는다.