Modelos, uso e limites no Claude Code

Este guia explica qual modelo você está usando, como o uso é medido e como manter sessões longas dentro de seus limites de contexto e uso.

A forma como você se conectou determina como o uso é medido. Tudo mais sobre Claude Code funciona da mesma forma independentemente.

Se você se conectou com um assento Enterprise, geralmente não precisa pensar em tokens até atingir um limite. Se você está usando uma chave de API, o comando /cost mostra seu gasto em execução para a sessão atual.

Execute /model a qualquer momento para ver quais modelos estão disponíveis para sua conta e para alternar entre eles. Como um guia aproximado:

Você pode alterar modelos no meio da sessão sem perder sua conversa. Um padrão comum é planejar com Opus e executar com Sonnet.

Cada turno envia três coisas para o modelo:

Destes, o primeiro item cresce mais rápido. Uma sessão de depuração longa na qual Claude leu vinte arquivos e produziu quinze diffs está carregando tudo isso em cada mensagem subsequente. É aqui que tanto o custo quanto os limites de contexto se originam.

A janela de contexto é a quantidade máxima de texto que o modelo pode considerar de uma vez. Claude Code mostra um indicador ao vivo de quão cheia está. Quando se enche, Claude não consegue mais ver claramente as partes mais antigas da conversa e a qualidade cai.

Dois comandos mantêm isso sob controle:

Regra de ouro: use /clear ao iniciar uma nova tarefa e /compact ao continuar uma longa.

Quase todo relatório "queimei meu limite antes do almoço" remonta a um desses cinco.

Cada mensagem anterior é reenviada a cada turno, então uma sessão que vagou por três problemas não relacionados paga por todos os três em cada nova mensagem.

Na prática: você acabou de terminar de depurar um redirecionamento de login e agora quer escrever uma migração de banco de dados. Execute /clear primeiro. Um teste simples: se seu próximo prompt faria sentido perfeito em um terminal novo, limpe antes de enviar. Seu CLAUDE.md e arquivos de projeto permanecem; apenas o histórico de chat vai.

Um aviso: /clear não pode ser desfeito. Se você ainda pode precisar de algo do histórico, copie-o primeiro ou execute /compact em vez disso, que preserva um resumo em vez de apagar tudo.

Opus custa várias vezes mais por turno do que Sonnet, e Sonnet mais do que Haiku. Gastar Opus em trabalho rotineiro é a maneira mais rápida de drenar um limite diário.

Padrões razoáveis: Sonnet para a maioria da codificação (recursos, testes, bugs conhecidos, refatorações); Opus quando você está genuinamente preso ou a mudança é ampla (depuração difícil, refatorações amplas, chamadas de arquitetura); Haiku para trabalho mecânico rápido (renomeações, linhas de log, explicações de regex, boilerplate).

Qualquer coisa que você cola fica em contexto, na íntegra, pelo resto da sessão. Referenciar um arquivo por caminho permite que Claude leia seletivamente e se concentre na parte que você se importa.

Na prática: em vez de colar auth.ts, escreva olhe para a função validateToken em src/auth.ts — mencionar o caminho permite que Claude abra e leia seletivamente. (Observe que o prefixo @ injeta o arquivo inteiro mais sua árvore CLAUDE.md no contexto, então use um caminho simples quando você está tentando economizar tokens.) Para logs e rastreamentos de pilha, corte para as 20 ou 30 linhas relevantes antes de colar. Para qualquer coisa grande (lockfiles, logs de compilação, despejos de dados), coloque-a no disco e referencie o caminho.

Este arquivo é antecedido a cada turno. O cache de prompt significa que os turnos após o primeiro são cobrados na taxa de leitura de cache muito mais barata, então o custo em dólares é menor do que a contagem de linhas brutas sugere, mas ainda ocupa espaço de janela de contexto em cada mensagem.

A regra: dois strikes, mantenha-o apertado. Adicione uma nota apenas na segunda vez que você tiver que corrigir Claude na mesma coisa (problemas de primeira vez geralmente são únicos). Mantenha o arquivo com menos de aproximadamente 200 linhas; se algo novo precisar entrar e não houver espaço, algo antigo terá que sair.

Quando atualizá-lo: logo após uma sessão em que você teve que corrigir Claude duas vezes na mesma coisa. É quando a correção é fresca e leva um minuto para anotar. A cada poucas semanas, leia o arquivo inteiro e delete qualquer coisa que não seja mais verdadeira ou cujo propósito você não consiga lembrar. Notas obsoletas são piores do que notas ausentes porque desviam ativamente Claude.

Um plano custa algumas centenas de tokens. Um diff errado de 400 linhas que você reverte e regenera custa milhares, duas vezes, mais os turnos gastos explicando o que deu errado. Na prática: para qualquer coisa tocando mais de dois ou três arquivos, mude para o Modo de Plano ou apenas pergunte: "Antes de mudar qualquer coisa, liste os arquivos que você tocará e o que fará em cada um." Leia a lista, corrija-a em inglês simples ("pule legacy/ e não toque nos testes ainda"), então deixe executar.

Dica profissional: planeje com Opus, execute com Sonnet. O uso de maior valor do Opus é escrever o próprio plano, onde o raciocínio mais profundo realmente compensa. Uma vez que um bom plano existe, a execução é principalmente mecânica e Sonnet a manipula por uma fração do custo. Este padrão é construído como /model opusplan, que usa Opus durante o planejamento e Sonnet para execução. Alternar modelos não limpa a conversa, então Sonnet ainda vê tudo que Opus produziu.