Claude Code carrega esquemas de ferramentas sob demanda via ToolSearch para economizar tokens

Uma análise do Reddit sobre o prompt de sistema do Claude Code revela que as ferramentas são carregadas de forma lazy para reduzir o consumo de tokens. Em vez de enviar o esquema completo de cada ferramenta em toda requisição, o Claude Code envia uma lista de nomes de ferramentas em uma tag <system-reminder> e instrui o modelo a chamar ToolSearch primeiro para carregar o esquema de cada ferramenta.

Como Funciona

O prompt de sistema inclui uma instrução como esta:

<system-reminder>
As seguintes ferramentas adiadas estão agora disponíveis via ToolSearch. Seus esquemas NÃO estão carregados — chamá-las diretamente falhará com InputValidationError. Use ToolSearch com a consulta "select:<nome>[,<nome>...]" para carregar os esquemas das ferramentas antes de chamá-las:

AskUserQuestion CronCreate CronDelete CronList EnterPlanMode EnterWorktree ExitPlanMode ExitWorktree Monitor NotebookEdit PushNotification RemoteTrigger TaskOutput TaskStop TodoWrite WebFetch WebSearch
[+ ~130 ferramentas MCP (Slack, Notion, Gmail...)]
</system-reminder>

O <system-reminder> é injetado apenas na primeira mensagem do usuário na conversa. Um bloco semelhante lista habilidades com descrições de uma linha.

Impacto em Tokens

De acordo com o post, as instruções do sistema mais os lembretes consumiram 38k tokens em uma simples mensagem de teste "oi". Carregar o esquema completo de todas as ferramentas de antemão aumentaria drasticamente esse consumo — daí a abordagem de carregamento lazy.

Implicações Práticas

Se você está desenvolvendo no Claude Code ou em sistemas de agente similares, vale a pena adotar este padrão:

• Adie esquemas de ferramentas raramente usadas até que sejam necessárias.
• Use um comando semelhante a ToolSearch para solicitar esquemas explicitamente.
• Mantenha os lembretes dentro da primeira mensagem para evitar repetição de contexto.

Isso também significa que, se você estiver escrevendo ferramentas personalizadas para o Claude Code, deve garantir que o modelo possa descobri-las via ToolSearch — caso contrário, elas ficarão invisíveis ou causarão erros de validação.