AI BriefingClaude 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가 소모됐다.
이 한국어 요약은 AI가 자동으로 만들었습니다. 원문의 주장과 맥락은 원문에서 확인해 주세요. 저작권은 원저작자에게 있습니다.
