Claude Code, 도구 스키마 지연 로드
Claude Code's tools are lazy-loaded. The system prompt tells the model to call ToolSearch first.
·2026.04.28 22:34
Claude Code는 도구 스키마를 즉시 보내지 않고 ToolSearch로 지연 로드한다.
Claude Code는 모든 도구의 전체 스키마를 한 번에 보내지 않고, 대화의 첫 user message에만 삽입되는 <system-reminder>로 지연 로드 규칙을 안내한다. 필요한 도구를 쓰려면 먼저 ToolSearch를 호출해야 하며, 직접 호출하면 InputValidationError가 난다.
select:<name>[,<name>...]형식으로 스키마를 불러온다.AskUserQuestion,CronCreate/Delete/List,Enter/ExitPlanMode,Enter/ExitWorktree,Monitor,NotebookEdit,PushNotification,RemoteTrigger,TaskOutput,TaskStop,TodoWrite,WebFetch,WebSearch등이 포함된다.- Slack, Notion, Gmail 등 약 130개 MCP 도구도 같은 구조를 따른다.
- skills도 이름과 한 줄 설명만 담은 별도
<system-reminder>로 전달된다.
작성자의 hi 테스트에서는 시스템 지시문과 reminder만으로도 약 38k tokens가 소모됐다.
이 요약은 원문 이해를 돕기 위한 큐레이션입니다. 저작권은 원저작자에게 있으며, 정확한 내용과 맥락은 원문을 확인하세요.
요약 오류, 출처 표기 문제, 삭제 요청은 문의 · 건의로 알려주세요.