Aula 08Custos, limites e modelos

🖥️ Versão Desktop. Nesta aula, quase tudo acontece na aba Code do app Claude Desktop: no anel de uso, no seletor de modelo e na caixa de mensagem. Para mudar o jeito de o Claude responder, você pede ao próprio Claude que grave uma linha num arquivo de configurações, e a aula mostra exatamente o que pedir. No fim do Na prática, quando você pede para guardar uma versão, os comandos do Git aparecem para você aprovar, como na Aula 06. A parte opcional do fim usa comandos digitados na caixa de mensagem, como o /advisor.

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 no anel de uso, ao lado do seletor de modelo
• Ler o aviso de limite e o que fazer quando ele aparecer
• Escolher o modelo e o esforço no seletor de modelo, de acordo com o pedido
• Escolher o jeito de o Claude responder (o estilo de resposta), 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 anel de uso de vez em quando, escolher o modelo antes da primeira mensagem e abrir uma sessão 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:

• Sessões 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ê.

O app usa a sua assinatura

Você entrou no app 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 app, no terminal 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 app usa sempre o login da sua assinatura: ele não aceita a chave da Console (Aula 03) e não lê a configuração ANTHROPIC_API_KEY, mesmo que ela exista no seu computador. A chave é outro serviço, cobrado à parte: o uso dela não sai do seu plano, sai da conta da Console.

⚠️ Se um dia você usar o Claude Code também no terminal, o cuidado é outro. Lá, quando existe uma chave guardada na configuração ANTHROPIC_API_KEY, ele pergunta, uma vez, se deve usar essa chave. Responda que não. Se aprovar, o uso no terminal passa a ser cobrado na Console, e não no seu plano.

Veja quanto você já usou

Clique no anel de uso, ao lado do seletor de modelo, na linha embaixo da caixa de mensagem. Ele mostra duas coisas:

• A janela de contexto da sessão atual, a memória de trabalho da Aula 07. Cada sessão tem a sua.
• O uso do seu plano no período. Esse é um só: o que você gasta no app, no terminal ou na web sai do mesmo lugar.

Dê uma olhada no anel de vez em quando, principalmente antes de uma tarefa grande, como planejar a página inteira.

Quando o limite chega

Se o uso de uma janela acaba, o app para e mostra um cartão com o aviso, em inglês. Estes são os mais comuns:

A hora vem no formato americano: 3:45pm é 15h45, e 12:00am é meia-noite, 0h. Antes de o limite chegar, pode aparecer um aviso como 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. No cartão do limite da sessão, marque a caixa Auto-continue when limits reset (continuar sozinho quando os limites renovarem). Depois da renovação, o app tenta de novo o pedido que foi interrompido, e o cartão mostra a hora da nova tentativa. Deixe o app aberto até lá. O cartão do limite da semana não tem essa caixa: ali, é esperar o dia e a hora do aviso.
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í, escolher o Sonnet no seletor de modelo, 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, eles ficam na seção Usage credits de Settings → Usage (configurações, uso), 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, clique no seletor de modelo, na linha embaixo da caixa de mensagem, ou aperte Cmd + Shift + I no Mac (Ctrl + Shift + I no Windows), e escolha o modelo.

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

Escolha antes da primeira mensagem

Dá para trocar de modelo no meio da sessão, mas isso 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.

O hábito que resolve: escolha o modelo antes da primeira mensagem. Mudou de tarefa, de trocar um preço para planejar a página inteira? Clique em + New, na barra lateral, e abra uma sessão nova (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.

Na versão atual do app, o esforço fica no próprio seletor de modelo: abra o seletor e escolha um nível em Effort (esforço). O atalho Cmd + Shift + E no Mac (Ctrl + Shift + E no Windows) abre direto o menu de esforço. Os níveis que aparecem dependem do modelo escolhido. Nos modelos atuais, mudar o esforço no meio da sessão 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 sessão continua o mesmo. Frases como "pense bem" não ativam nada.

O jeito de responder: o estilo de resposta

O estilo de resposta (output style) muda como o Claude fala com você na sessão 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:

No app, o estilo fica gravado num arquivo de configurações da pasta, o .claude/settings.local.json. Você não precisa abrir o arquivo: peça ao Claude.

Adicione "outputStyle": "Explanatory" ao meu .claude/settings.local.json

Como a pasta .claude é protegida, no Manual e no Accept edits ele pede a sua licença antes de mexer nela (Aula 05). O estilo novo vale a partir da próxima mensagem. Para voltar ao normal, peça: "tire a linha do outputStyle do meu .claude/settings.local.json".

💡 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 sessão por tarefa. Terminou o cardápio e vai mexer no horário? + New, na barra lateral (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 nas mudanças grandes, e correção de rumo cedo, com o botão de parar ou Esc. Corrigir um plano gasta menos do que refazer a página.
• O modelo e o esforço antes da primeira mensagem, de acordo com a tarefa.
• Desconecte os conectores que você não usa, em Settings → Connectors (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, os 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

• As sessões do app entram pelo login da conta, a não ser que a sua empresa configure no app um provedor de terceiros, que tem credencial própria. As variáveis ANTHROPIC_API_KEY e ANTHROPIC_AUTH_TOKEN e o apiKeyHelper valem para o terminal e para o que roda em cima dele, como a extensão do VS Code e o Agent SDK.
• No terminal, com uma ANTHROPIC_API_KEY no ambiente, o Claude Code pergunta uma vez se deve usá-la e lembra a resposta. Para mudar depois, use a opção Use custom API key do /config, ou rode unset ANTHROPIC_API_KEY antes de abrir o Claude Code. O /status mostra qual credencial está em uso.
• No Team e no Enterprise, os créditos de uso são ligados para a organização por quem tem acesso ao faturamento, em Organization settings → Usage.

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.

• 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.
• 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.

Os apelidos de modelo

Os apelidos são os nomes que o Claude Code entende por escrito, como no /advisor (logo abaixo) e no arquivo de um subagente (Aula 12): haiku, sonnet, opus e também:

Se a sua organização limita os modelos, o seletor do app esconde ou deixa em cinza os que não estão liberados.

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.

No app, digite o comando na caixa de mensagem:

/advisor opus    # o Opus aconselha o modelo da sessão (fica salvo)
/advisor         # mostra o conselheiro atual e os apelidos aceitos
/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 modo rápido deixa o Opus até 2,5 vezes mais rápido, com a mesma qualidade, mas cada token custa mais, e na assinatura ele é cobrado só em créditos de uso. A documentação mostra como ligá-lo no terminal (/fast), na extensão do VS Code e nas sessões Cloud (na nuvem), digitando /fast on na sessão, que vale só para ela. Para as sessões Local, que você usa neste curso, ela não mostra um botão no app.

O estilo de resposta no arquivo

O pedido da aula grava isto no .claude/settings.local.json:

{
  "outputStyle": "Explanatory"
}

• O nome diferencia maiúsculas: escreva Proactive, Concise, Explanatory ou Learning. Um nome que não bate exatamente, como explanatory, deixa o estilo normal.
• Para usar o mesmo estilo em todos os projetos, coloque o campo no ~/.claude/settings.json. As configurações do próprio projeto valem mais do que ele.
• No app, o /config abre Settings → Claude Code em vez de um menu de estilos.

Mais sobre o limite

• A caixa Auto-continue when limits reset do app e a opção Continue automatically at usage limit do /config do terminal são separadas: desligue cada uma no seu lugar.
• No terminal, o Claude Code espera a renovação sozinho, e o /rate-limit-options mostra as saídas: esperar, comprar créditos de uso ou mudar de plano.

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, digite /advisor na caixa de mensagem para ver o conselheiro atual, ligue um com /advisor opus e desligue com /advisor off.

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. Na aba Code, na linha abaixo da caixa de mensagem, escolha Local e a pasta da sua página. Antes da primeira mensagem, escolha Manual no seletor de modo, na mesma linha.
2. Clique no anel de uso, ao lado do seletor de modelo, e veja quanto do seu plano você já usou no período.
3. Ainda antes da primeira mensagem, abra o seletor de modelo (Cmd + Shift + I no Mac, Ctrl + Shift + I no Windows) e escolha o Haiku. Peça uma mudança simples: "troque a frase de boas-vindas por 'Doces feitos com carinho, todos os dias'". Aceite a mudança e clique no caminho do index.html na conversa para conferir no painel Browser.
4. Clique em + New, na barra lateral, e abra a sessão nova na mesma pasta, no Manual, como no passo 1, porque a próxima tarefa é outra. Antes da primeira mensagem, escolha o Opus no seletor de modelo e olhe os níveis em Effort, sem mudar nada.
5. 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.
6. Peça: "Adicione "outputStyle": "Explanatory" ao meu .claude/settings.local.json" e aceite quando ele pedir licença para mexer na pasta .claude. Depois, peça uma mudança pequena: "deixe o horário de funcionamento em negrito". Aceite e leia o bloco Insight, em que ele explica a escolha.
7. Volte ao normal: "tire a linha do outputStyle do meu .claude/settings.local.json", e aceite.
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", e aprove os comandos do Git. 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: o app usa sempre a sua assinatura, e a chave é cobrada à parte. No terminal, se ele perguntar se deve usar uma ANTHROPIC_API_KEY, responda que não.
• O anel de uso, ao lado do seletor de modelo, mostra a janela de contexto da sessão e o uso do plano, que é o mesmo no app, no terminal e na web.
• No limite da sessão, marque Auto-continue when limits reset no cartão, e o app continua sozinho depois da renovação. 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, escolhendo no seletor de modelo.
• Escolha o modelo antes da primeira mensagem: trocar no meio faz o próximo pedido reler tudo sem desconto.
• O esforço, em Effort no seletor de modelo, 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; peça ao Claude para gravá-lo no .claude/settings.local.json. O Learning deixa código para você escrever.

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