Claude Code лениво загружает схемы инструментов через ToolSearch для экономии токенов

Анализ системного промпта Claude Code, опубликованный на Reddit, показывает, что инструменты загружаются лениво для уменьшения расхода токенов. Вместо отправки полной схемы каждого инструмента с каждым запросом, Claude Code отправляет список названий инструментов в теге <system-reminder> и указывает модели сначала вызывать ToolSearch для загрузки схемы каждого инструмента.

Как это работает

Системный промпт содержит инструкцию следующего вида:

<system-reminder>
The following deferred tools are now available via ToolSearch. Their schemas are NOT loaded — calling them directly will fail with InputValidationError. Use ToolSearch with query "select:<name>[,<name>...]" to load tool schemas before calling them:

AskUserQuestion CronCreate CronDelete CronList EnterPlanMode EnterWorktree ExitPlanMode ExitWorktree Monitor NotebookEdit PushNotification RemoteTrigger TaskOutput TaskStop TodoWrite WebFetch WebSearch
[+ ~130 инструментов MCP (Slack, Notion, Gmail...)]
</system-reminder>

Тег <system-reminder> вставляется только в первое сообщение пользователя в диалоге. Аналогичный блок перечисляет навыки с однострочными описаниями.

Влияние на токены

Согласно посту, одни только системные инструкции и напоминания потребляли 38 тыс. токенов на простом тестовом сообщении "привет". Загрузка полных схем всех инструментов сразу резко увеличила бы этот расход — отсюда и подход с ленивой загрузкой.

Практические выводы

Если вы разрабатываете на основе Claude Code или аналогичных агентных систем, стоит применить этот паттерн:

• Откладывайте загрузку схем для редко используемых инструментов до момента необходимости.
• Используйте команду типа ToolSearch для явного запроса схем.
• Размещайте напоминания в первом сообщении, чтобы избежать повторения контекста.

Это также означает, что при создании пользовательских инструментов для Claude Code необходимо убедиться, что модель может найти их через ToolSearch — иначе они будут невидны или вызовут ошибки валидации.