에이전틱 루프의 동작 원리

Claude Code의 동작은 한 문장으로 요약됩니다. 판단하고, 도구를 쓰고, 결과를 보고, 다시 판단한다. 이 순환을 목표가 달성될 때까지 반복합니다.

한 번의 루프에서 일어나는 일

1. 판단 — 지금 상태에서 다음에 무엇을 해야 하는지 결정합니다.
2. 행동 — 파일 읽기, 검색, 편집, 명령 실행 중 하나를 호출합니다.
3. 관찰 — 도구가 돌려준 결과(파일 내용, 테스트 출력, 오류 메시지)를 읽습니다.
4. 반복 — 관찰 결과를 근거로 다시 1번으로 돌아갑니다.

테스트가 실패하면 그 실패 메시지가 곧 다음 판단의 입력이 됩니다. 사람이 다시 알려주지 않아도 스스로 방향을 고치는 이유가 여기 있습니다.

왜 "먼저 읽는가"

Claude Code는 수정하기 전에 거의 항상 파일을 먼저 읽습니다. 추측으로 편집하면 기존 코드를 덮어쓰거나 컨벤션을 깨기 때문입니다. 실제로 편집 도구는 읽지 않은 파일의 수정을 거부하도록 설계돼 있습니다.

이 때문에 "왜 바로 안 고치고 파일부터 뒤지지?"라는 인상을 받을 수 있지만, 이 탐색 단계가 결과 품질을 결정합니다.

컨텍스트가 쌓이는 방식

루프가 돌 때마다 읽은 파일과 명령 출력이 대화 맥락에 쌓입니다. 그래서 세션이 길어질수록:

• 프로젝트 이해도는 올라가고
• 남은 컨텍스트 여유는 줄어듭니다

이 균형을 다루는 방법은 컨텍스트 윈도우 관리에서 다룹니다.

서브 에이전트로 루프를 나누기

한 세션에서 모든 걸 처리하면 맥락이 뒤엉킵니다. 독립적인 조사 작업은 서브 에이전트에게 맡기면, 그쪽에서 파일을 잔뜩 읽더라도 결론만 돌아옵니다. 메인 세션의 맥락은 깨끗하게 유지됩니다.

이 저장소에서 결제 관련 코드가 어디에 흩어져 있는지 조사해줘.

이런 광범위한 탐색이 서브 에이전트에 적합한 전형적인 작업입니다.

사람이 개입해야 하는 지점

에이전틱 루프는 강력하지만 만능이 아닙니다. 다음 상황에서는 사람이 판단해야 합니다.

• 되돌리기 어려운 작업 — 배포, 데이터 삭제, 외부 전송
• 요구사항 자체가 모호할 때 — 잘못된 전제로 루프가 오래 돌면 손해가 큽니다
• 여러 해석이 가능한 설계 결정 — 어느 쪽이든 동작하지만 팀 방향과 다를 수 있는 경우

좋은 사용법은 "루프를 전부 맡기는 것"이 아니라 "루프가 잘 돌 수 있는 조건을 만들어 주는 것"입니다. 명확한 성공 기준과 실행 가능한 검증 명령이 그 조건입니다.