Aula 08Custos, limites e modelos

Objetivos

Ao final desta aula você vai saber:

• O que gasta o uso do seu plano, e por que mexer na página gasta mais do que conversar no chat
• Por que, com o Pro ou o Max, você não precisa de chave de API
• Ver quanto você já usou, com /usage e /status
• Ler as mensagens de limite e o que fazer quando uma delas aparecer
• Escolher o modelo (/model) e o esforço (/effort) de acordo com o pedido
• Escolher o jeito de o Claude responder (/output-style), e por que o estilo Explanatory serve a quem está aprendendo

Na Aula 07, você viu que tudo o que entra na conversa ocupa a memória de trabalho do Claude. Nesta aula, você vê o outro lado: tudo o que entra na conversa também gasta o uso do seu plano. E aprende a escolher o modelo e o esforço certos para cada pedido da página, sem gastar à toa.

💡 Você não precisa decorar números. Bastam três hábitos: olhar o uso de vez em quando, escolher o modelo logo no começo da conversa e começar uma conversa nova a cada tarefa.

O que gasta o seu uso

O Claude Code mede o uso em tokens, os pedacinhos de texto que o modelo lê e escreve. E ele lê bastante: a cada pedido, a conversa inteira vai junto. Cada vez que o Claude usa uma ferramenta, como ler o index.html, sai mais um pedido, levando o resultado dela. Por isso, a memória de trabalho da Aula 07 também é uso: quanto mais coisa na conversa, mais tokens em cada pedido.

É também por isso que mexer na página gasta bem mais do que conversar no chat. Para consertar o filtro do cardápio, o Claude lê os arquivos, muda, confere e tenta de novo, e cada passo leva a conversa inteira. Segundo a documentação, uma única sessão de conserto pode gastar mais do que um dia inteiro de chat.

O que mais pesa:

• Conversas longas, que nunca começam do zero. Tudo o que ficou para trás vai junto em cada pedido novo.
• Pedidos vagos. "Arruma a página" faz o Claude ler tudo para descobrir o que você quer.
• Arquivos grandes e conversas cheias de prints. Tudo o que o Claude lê entra na conta.
• Raciocínio. Quando o modelo pensa antes de responder, esse pensamento também conta, mesmo quando você não o vê.

Você só precisa da sua assinatura

Você entrou no Claude Code com a conta do seu plano pago (Aula 03). Com ela, você paga um valor fixo, e o plano tem limites de uso, que se renovam sozinhos: um numa janela de cinco horas e outro na semana. O que você usa no terminal, no app e na web sai do mesmo lugar.

Existe um segundo jeito de pagar, a chave de API (API key): uma senha de acesso da Claude Console, o serviço da Anthropic para programadores. A Console cobra por uso, a cada pedido, numa conta separada.

💡 Quem assina o Pro ou o Max não precisa de chave de API. O login da Aula 03 já basta. A chave é outro serviço, cobrado à parte: o uso dela não sai do seu plano, sai da conta da Console.

⚠️ Cuidado com uma chave esquecida no computador. Alguns tutoriais mandam guardar a chave numa configuração do terminal chamada ANTHROPIC_API_KEY. Quando ela existe, o Claude Code pergunta, uma vez, se deve usar essa chave. Responda que não. Se aprovar, ele passa a usar a chave no lugar da sua assinatura, e o uso vira cobrança na Console. Aprovou sem querer? Rode /config e desligue a opção Use custom API key (usar uma chave de API própria).

Para conferir qual das duas está valendo, rode:

/status

Na linha Login method (forma de login), aparece a sua assinatura, como Claude Max account, ou uma chave de API.

Veja quanto você já usou

/usage

O /usage mostra o uso do seu plano em barras: uma para a janela de cinco horas e outra para a semana. Embaixo, um detalhamento mostra o que mais está gastando e avisa quando algo pesa demais, como uma conversa longa, com uma dica de como gastar menos. As teclas d e w alternam entre as últimas 24 horas e os últimos 7 dias.

No alto, no bloco da sessão, aparece também um valor em dólares. Para quem assina, ele não é o que você paga. É uma estimativa pelo preço de tabela, feita para quem usa chave de API.

Quando o limite chega

Se o uso de uma janela acaba, o Claude Code para e mostra uma mensagem em inglês. Estas são as mais comuns:

A hora vem no formato americano: 3:45pm é 15h45, e 12:00am é meia-noite, 0h. Antes de o limite chegar, ele avisa: You've used 85% of your session limit · resets 3:45pm (você já usou 85% do limite da sessão, que volta às 15h45).

O que fazer:

1. Esperar. Com a assinatura e o terminal aberto, o Claude Code espera a renovação e continua a tarefa sozinho. Embaixo da conversa aparece Continuing automatically at 3:45pm · esc to cancel (continuando sozinho às 15h45; o Esc cancela). Deixe o terminal aberto. Quando a renovação está a mais de um dia, como pode acontecer no limite da semana, ele não espera sozinho: mostra um menu com as opções.
2. Trocar de modelo, só no limite de um modelo. O limite da sessão e o da semana valem para todos os modelos juntos: trocar não adianta. Já o limite do Opus vale só para o Opus. Aí, trocar para o Sonnet, como você vê logo abaixo, deixa você continuar.
3. Pagar à parte, se quiser. Os créditos de uso (usage credits) deixam você continuar além do limite, pagando pelo que passar. No Pro e no Max, o comando /usage-credits abre a página deles no claude.ai. Esperar não custa nada; os créditos, sim.

ℹ️ Aviso de memória cheia ou de compactação automática não é limite de uso. É a janela de contexto da Aula 07.

Escolha o modelo certo para cada pedido

O modelo é a IA que pensa e escreve (Aula 02). Hoje (outubro de 2026), o padrão do Claude Code é o Opus mais recente, o mais capaz. Ele também é o que mais gasta. Para muitos pedidos da página, um modelo mais leve dá conta:

Para trocar, abra o seletor:

/model

Desça com as setas até o modelo e escolha como confirmar:

• s: troca só nesta sessão. As próximas voltam ao padrão.
• Enter: troca e guarda como padrão das próximas sessões.

⚠️ Pegadinha: digitar o nome direto, como /model haiku, funciona como o Enter: o Haiku vira o seu padrão. Para experimentar um modelo, use o seletor e a tecla s.

Na dúvida, fique no padrão. Trocar vale a pena quando o pedido é claramente simples, ou quando chegou o limite do Opus.

Escolha no começo da conversa

Trocar de modelo no meio de uma conversa tem um custo escondido. O Claude Code guarda o que já leu da conversa e cobra bem mais barato para reler. Mas cada modelo guarda a sua parte: depois da troca, o próximo pedido relê a conversa inteira, sem esse desconto. É por isso que, se você trocar no meio, o terminal pode pedir para você confirmar.

O hábito que resolve: escolha o modelo no começo, antes do primeiro pedido. Mudou de tarefa, de trocar um preço para planejar a página inteira? Comece uma conversa nova com /clear (Aula 07), já com o modelo certo.

Ajuste o esforço

O esforço diz quanto o modelo pensa antes de responder. Menos esforço responde mais rápido e gasta menos; mais esforço pensa mais fundo e gasta mais. No Opus, no Sonnet e no Haiku atuais, o padrão é o medium (médio), bom para o dia a dia.

Para mudar, abra o controle:

/effort

Escolha o nível com as setas. Como no /model, o Enter guarda como padrão, e o s vale só nesta sessão. Para voltar ao padrão do modelo, rode /effort auto. Nos modelos atuais, mudar o esforço no meio da conversa não tem o custo da troca de modelo.

Para pensar mais fundo num pedido só, escreva ultrathink em qualquer lugar do pedido:

ultrathink: planeje como deixar a página boa de ler no celular. Não mude nada ainda

O esforço da conversa continua o mesmo. Frases como "pense bem" não ativam nada.

O jeito de responder: /output-style

O estilo de resposta (output style) muda como o Claude fala com você na conversa inteira, sem você repetir o pedido a cada vez. Além do jeito normal, há quatro estilos prontos. Para quem está aprendendo, um deles ajuda muito, e outro não serve:

Para ligar o estilo explicativo:

/output-style explanatory

Ele vale a partir da próxima mensagem e fica guardado para esta pasta. Sem nada depois, o /output-style lista os estilos e marca o atual. Para voltar ao normal, rode /output-style default.

💡 O Explanatory escreve respostas mais longas, então gasta um pouco mais. Vale a pena enquanto você aprende. Quando quiser respostas curtas, o Concise faz o contrário.

Hábitos que economizam

• Uma conversa por tarefa. Terminou o cardápio e vai mexer no horário? /clear (Aula 07). Começar do zero não custa nada; já o /compact relê a conversa inteira para resumir.
• Pedidos específicos, com as cinco partes da Aula 04: "no cardápio, troque o preço do brigadeiro para R$ 4,00" em vez de "arruma os preços".
• Plan Mode nas mudanças grandes, e correção de rumo cedo, com Esc. Corrigir um plano gasta menos do que refazer a página.
• O modelo e o esforço no começo da conversa, de acordo com a tarefa.
• Desligue os conectores que você não usa com o /mcp (Aula 07). Se ainda não ligou nenhum, guarde a dica para a Aula 14.

Para ir além (opcional): o cache, a chave de API e outros ajustes

🔧 Para ir além (para quem já programa; pode pular): esta parte mostra as duas formas de pagar em detalhe, o cache, outros apelidos de modelo, o conselheiro (/advisor), o modo rápido e alguns ajustes finos. Se você nunca programou, pule direto para o Na prática: tudo o que ele pede já foi explicado acima.

As duas formas de pagar, por inteiro

• Com uma ANTHROPIC_API_KEY no ambiente, o Claude Code pergunta uma vez se deve usá-la e lembra a resposta. A opção Use custom API key do /config só aparece enquanto a variável existe. Em modo não interativo (-p), a chave é sempre usada quando existe.
• Para voltar à assinatura, também vale rodar unset ANTHROPIC_API_KEY antes de abrir o Claude Code. Com login e chave ao mesmo tempo, o /status marca a credencial que não está em uso.
• O /usage-credits só funciona com o login da assinatura.

O cache, em detalhe

O Claude Code reaproveita o que já processou da conversa (o cache) e cobra essa releitura bem mais barato. Cada modelo tem o seu próprio cache, então trocar de modelo no meio da tarefa faz o próximo pedido reler a conversa inteira sem desconto: um turno mais lento e mais caro. O /model pede confirmação só enquanto o cache ainda está quente.

• Esforço: nos modelos atuais, com assinatura ou chave de API, mudar o esforço mantém o cache. Nos mais antigos, também quebra, e o terminal pede confirmação.
• Modo rápido: ligar quebra o cache uma vez por conversa.
• Mantêm o cache: trocar o estilo de resposta, ligar ou desligar o conselheiro, mudar o modo de permissão e editar os arquivos do projeto.
• Validade: uma hora na assinatura, dentro do uso do plano, e cinco minutos com créditos de uso ou chave de API. Voltar depois de uma pausa longa deixa o primeiro pedido mais lento e mais caro.
• Compactação na pausa: numa conversa grande (a partir de 200 mil tokens) parada por cerca de 54 minutos, o Claude Code a compacta pouco antes de o cache vencer. Na volta, você vê Compacted while idle, before the prompt cache expired, e o próximo pedido manda só o resumo. Para manter a conversa inteira, ponha "idleCompaction": false num arquivo de configurações (a partir da versão 2.1.290).
• Acompanhar: depois da primeira resposta, o bloco da sessão do /usage ganha a linha Prompt cache (main), com a taxa de acerto do cache.

Outros apelidos de modelo

E claude --model haiku abre uma sessão já no Haiku, sem mudar o seu padrão.

Um conselheiro mais forte: /advisor

Quer a economia do Sonnet sem abrir mão do Opus nas horas difíceis? O /advisor liga um conselheiro: um segundo modelo, normalmente mais forte, que o Claude consulta nos momentos decisivos, como antes de escolher um caminho, quando um erro se repete ou antes de dar a tarefa por terminada. O modelo da sessão continua fazendo o trabalho.

/advisor opus    # o Opus aconselha o modelo da sessão (fica salvo)
/advisor         # abre o seletor
/advisor off     # desliga

• O conselheiro precisa ser do mesmo nível ou acima do modelo da sessão: Sonnet com conselheiro Opus funciona; o contrário, não.
• Cada consulta lê a conversa inteira e conta no seu uso. Mesmo assim, costuma sair mais barato do que usar o modelo mais forte o tempo todo.
• Ligar ou desligar o conselheiro não quebra o cache, ao contrário de trocar de modelo.
• É um recurso experimental e não funciona quando o Claude Code roda pelos provedores de nuvem (AWS, Google Cloud ou Microsoft).

Os subagentes e o modelo

Um subagente sem modelo definido normalmente herda o da sua sessão: se você está no Opus, ele também está. Até o subagente Explore, que já vem pronto, usa o modelo da conversa principal (a exceção é o Fable: numa assinatura, com a conversa no Fable, o Explore roda no Opus). Para tarefas simples, defina model: haiku no arquivo do subagente (Aula 12).

Modo rápido

O /fast deixa o Opus até 2,5 vezes mais rápido, com a mesma qualidade, mas cada token custa mais. Três cuidados:

• Na assinatura, ele é cobrado só em créditos de uso, mesmo que ainda sobre uso no seu plano.
• Ele continua ligado nas próximas sessões. Desligue com /fast off quando não precisar mais.
• Ligue no começo da conversa. Na primeira vez que você o liga numa conversa, todo o contexto já acumulado é cobrado no preço do modo rápido.

Vale para depurar ao vivo ou iterar depressa. Para tarefas longas e automações, fique no modo normal.

A barra de status

Para ver o uso o tempo todo, configure a barra de status descrevendo o que quer: /statusline mostre o modelo, o esforço e a porcentagem do contexto. No Pro e no Max, ela também pode mostrar quanto você já usou da janela de cinco horas e da semana.

Mais sobre o limite

• O /rate-limit-options mostra as saídas: esperar e continuar sozinho, comprar créditos de uso ou mudar de plano. Ele só funciona com o login da assinatura.
• Para cancelar a espera, aperte Esc com a caixa de texto vazia, ou Ctrl + C, ou escolha Don't continue automatically no /rate-limit-options.
• Para desligar a espera automática de vez, desligue a opção Continue automatically at usage limit no /config.
• Se o limite voltar a bater depois da renovação, o Claude Code arma a espera de novo, no máximo duas vezes seguidas.

Mais hábitos para quem programa

• Prefira a CLI ao MCP quando ela existir (como o gh): ela não acrescenta uma lista de ferramentas ao contexto.
• CLAUDE.md com menos de 200 linhas. O que só vale às vezes vira skill (Aula 13).
• Delegue o que é verboso: rodar testes, ler logs e documentação num subagente, de preferência com um modelo menor. Só o resumo volta.
• Subagentes e equipes de agentes têm contexto separado, mas os pedidos deles contam no mesmo uso que a sua conversa.

Para praticar esta parte, rode /advisor para ver o seletor, peça uma barra de status com os limites do plano e, numa conversa já começada, troque de modelo e olhe a linha Prompt cache (main) do /usage depois do próximo pedido.

Na prática

Use a pasta da sua página (a confeitaria, ou a da sua ideia), com o cardápio da Aula 06. Nada do que você mudar aqui precisa ficar na página.

1. Abra o terminal, entre na pasta e abra o Claude Code: cd Documents/confeitaria, com o nome da sua pasta, e depois claude. Aperte Shift + Tab e confira se aparece manual mode on.
2. Rode /status e encontre a linha Login method: ela deve mostrar a sua assinatura, e não uma chave de API.
3. Rode /usage. Olhe as barras da janela de cinco horas e da semana, e use d e w para comparar o dia com a semana.
4. Abra o seletor com /model, desça até o Haiku e aperte s, para trocar só nesta sessão. Peça uma mudança simples: "troque a frase de boas-vindas por 'Doces feitos com carinho, todos os dias'". Aprove, abra a página no navegador e confira.
5. Comece uma conversa nova com /clear, porque a próxima tarefa é outra. Logo no começo, antes de qualquer pedido, abra /model, escolha o Opus e aperte s: é o modelo para planejar a página inteira.
6. Peça: "ultrathink: planeje como deixar a página boa de ler no celular. Não mude nada ainda: só me mostre o plano, em português simples". Repare que ele demora mais para responder: está pensando mais fundo.
7. Ligue o estilo explicativo com /output-style explanatory e peça uma mudança pequena: "deixe o horário de funcionamento em negrito". Aprove e leia o bloco Insight, em que ele explica a escolha. Depois, volte ao normal com /output-style default.
8. Gostou das mudanças? Guarde uma versão, como na Aula 06: "guarde uma versão com uma mensagem em português explicando o que mudou". Não gostou? Peça: "volte a frase de boas-vindas e o horário para como estavam".

Resumo

• O Claude Code mede o uso em tokens, e cada pedido leva a conversa inteira. Mexer na página gasta mais do que conversar no chat.
• Com o Pro ou o Max, você não precisa de chave de API: ela é cobrada à parte. Se o Claude Code perguntar se deve usar uma ANTHROPIC_API_KEY, responda que não, e confira no /status.
• O /usage mostra o uso do plano, na janela de cinco horas e na semana. O valor em dólares é só uma estimativa.
• No limite, o Claude Code espera a renovação e continua sozinho. resets 3:45pm quer dizer que o uso volta às 15h45. Trocar de modelo só ajuda no limite de um modelo, como o do Opus.
• O padrão é o Opus. Use o haiku para trocar um texto, o sonnet no dia a dia e o opus para o que pede raciocínio. No /model, o s troca só nesta sessão, e o Enter guarda como padrão.
• Escolha o modelo no começo da conversa: trocar no meio faz o próximo pedido reler tudo sem desconto.
• O esforço (/effort) diz quanto o modelo pensa: medium é o padrão, e ultrathink aprofunda um pedido só.
• O estilo Explanatory explica as escolhas e serve a quem está aprendendo. O Learning deixa código para você escrever.

Agora que você sabe gastar bem, falta conferir se o que sai dessas conversas é o que você pediu. Na próxima aula: revisar o que o Claude fez.