Claude Code의 에러 복구 메커니즘 분석
Claude Code Source Deep Dive (Part 6) — Tool-Call Loop Self-Repair Core && End-to-End Query Pipeline Flow
·2026.05.30 22:50
Claude Code의 소스 코드를 통해 도구 호출 루프의 자가 수리 및 에러 복구 전략을 분석한다.
Anthropic의 Claude Code 패키지에서 유출된 소스 맵(.map) 파일을 통해 공개된 512,000라인의 TypeScript 코드를 분석한 결과이다.
도구 호출 루프(Tool-Call Loop) 자가 수리 메커니즘
Claude Code의 자동 버그 수정 능력은 도구 호출 피드백 루프를 기반으로 한다. 도구 실행 결과가 성공하든 실패하든 동일한 메시지 형식을 사용하며, is_error 플래그를 통해 오류 여부를 판단한다. 모델은 오류 메시지를 분석하여 새로운 전략을 세우고 다시 도구를 호출하는 과정을 반복한다.
에러 복구 전략
- 프롬프트 길이 초과(PTL) 대응: 컨텍스트를 비우거나(drain) 이력을 요약(reactive compact)하여 대응한다.
- 출력 토큰 제한 대응: 토큰 제한에 도달할 경우, 최대 토큰 허용치를 8K에서 64K로 상향(
ESCALATED_MAX_TOKENS)하여 문제를 해결한다.
이 요약은 원문 이해를 돕기 위한 큐레이션입니다. 저작권은 원저작자에게 있으며, 정확한 내용과 맥락은 원문을 확인하세요.
요약 오류, 출처 표기 문제, 삭제 요청은 문의 · 건의로 알려주세요.