Claude Code CLI: Programação com IA · Capítulo 7 de 23 · 12 min
Manter modelo e custo sob controle com os comandos de barra
Oito comandos de barra que mostram o gasto, trocam o modelo e desfazem o erro antes que ele custe caro.
Este capítulo faz parte do curso gratuito Claude Code CLI: Programação com IA.
Dentro de uma sessão do Claude Code, além de digitar instruções em linguagem natural, você pode usar comandos especiais que começam com barra (/). Eles controlam o comportamento da ferramenta, do histórico ao modelo e ao custo.
Comece pelo /help, o índice da ferramenta: ele lista todos os comandos que ela aceita.
# Mostra todos os comandos disponíveis e uma breve descrição:
/help
# Use quando não lembrar de um comando ou quiser
# descobrir funcionalidades novas.Para começar do zero, use o /clear, que apaga o histórico como quem vira a página do caderno.
# Limpa todo o histórico da conversa atual:
/clear
# Use quando quiser começar uma conversa do zero,
# sem que o Claude lembre do que foi discutido antes.
# Útil quando você troca de assunto completamente.Quando a conversa fica longa, o /compact resume o contexto (o que o Claude guarda da conversa) e libera espaço, como arquivar papéis antigos numa pasta.
# Compacta o contexto da conversa:
/compact
# Em sessões longas, o Claude acumula muito contexto (memória).
# Isso pode deixar as respostas mais lentas e consumir mais tokens.
# O /compact resume a conversa, mantendo as informações importantes
# mas liberando espaço.
# Dica: use a cada 30-40 mensagens ou quando sentir que as
# respostas estão mais lentas.Troque o modelo com o /model: o Haiku para a tarefa rápida, o Opus para o que exige raciocínio.
# Mostra ou troca o modelo de IA sendo usado:
/model
# Para trocar de modelo (os aliases apontam para a geração atual):
/model fable # Claude Fable 5.1 -- o mais avançado (créditos de uso nos planos pagos)
/model opus # Claude Opus 5.5 -- raciocínio profundo (o padrão)
/model sonnet # Claude Sonnet 5 -- equilibrado, para o dia a dia
/model haiku # Claude Haiku 4.5 -- o mais rápido e barato
# Dica prática:
# - Use haiku para tarefas simples (listar arquivos, perguntas rápidas)
# - Use sonnet para o dia a dia (programação, análise)
# - Use opus ou fable para o que exige mais raciocínio (arquitetura, debugging difícil)Veja quanto a sessão gastou com o /cost, o taxímetro da conversa.
# Mostra o consumo de tokens da sessão atual:
/cost
# Exibe informações como:
# - Tokens de entrada (o que você enviou)
# - Tokens de saída (o que o Claude respondeu)
# - Custo estimado da sessão
# Útil para controlar gastos, especialmente se estiver
# usando a API por consumo.Já o /usage mostra o limite do plano e quanto você consumiu, como o saldo do pacote de dados do celular.
# Mostra os limites do seu plano e quanto você já consumiu:
/usage
# O /cost virou apelido do /usage: a mesma tela mostra a sessão
# atual e a sua assinatura: quanto da cota já foi usado e quanto
# falta até renovar. Serve para não ser pego de surpresa por um limite no
# meio de uma tarefa.Desfaça com o /rewind, que volta a um ponto de restauração como o Ctrl+Z de um editor de texto.
# Abre os pontos de restauração da sessão (ou pressione Esc duas vezes):
/rewind
# O /rewind volta o código, a conversa ou ambos a um estado anterior
# da sessão, sem depender do Git. É a rede de segurança para quando
# uma mudança não sai como esperado e você quer voltar rápido.Se algo parar de funcionar, rode o /doctor (novo em julho de 2026), o checkup da instalação.
# Faz um checkup completo da instalação e do ambiente:
/doctor
# O alias é /checkup. Ele diagnostica problemas de configuração
# (PATH, versão, permissões, conectores) e, em muitos casos, já
# corrige sozinho. É o primeiro comando a rodar quando algo parece
# quebrado, antes de reinstalar no escuro.Na Brasil GEO, usamos /model haiku para tarefas de exploração simples (buscar arquivo, verificar dados) e reservamos o Opus para o que exige raciocínio complexo (arquitetura de código, debugging avançado). Isso otimiza custos sem perder qualidade.
Outros comandos úteis
# Cancelar a operação atual:
Ctrl+C
# Sair do Claude Code:
/exit # ou Ctrl+D
# Executar comando único (sem entrar na sessão):
claude -p "sua pergunta aqui"
# Continuar a última conversa:
claude -c # ou claude --continue
# Retomar uma conversa anterior pelo seletor:
claude --resumeOs comandos de barra que mais aparecem no dia a dia, e quando cada um entra em jogo
| Comando | Para que serve | Quando usar |
|---|---|---|
| /help | Lista todos os comandos disponíveis | Primeira vez ou ao esquecer um comando |
| /clear | Limpa o histórico da conversa | Início de tarefa nova, contexto poluído |
| /compact | Comprime conversas longas preservando o que importa | Sessões de horas, antes de bater no limite de contexto |
| /model | Troca o modelo (Fable 5.1, Opus 5.5, Sonnet 5, Haiku 4.5) | Tarefa pesada → Opus ou Fable; rápida → Haiku |
| /usage | Mostra limites do plano e consumo acumulado | Ver quanto resta antes de bater no limite da assinatura |
| /cost | Apelido do /usage: custo em tokens da sessão | Auditoria FinOps, controle de gastos por API |
| /rewind | Volta código e/ou conversa a um ponto de restauração | Desfazer uma mudança sem mexer no Git |
| /doctor | Diagnostica e corrige a instalação (alias /checkup) | Algo parou de funcionar, antes de reinstalar |
| /permissions | Ajusta o que o Claude pode fazer (arquivos, shell, MCP) | Afrouxar ou endurecer o que é autorizado |
| /mcp | Gerencia conexões com ferramentas externas (MCP) | Conectar bancos, APIs e serviços ao Claude Code |
| /agents | Lembra de pedir ao Claude para criar ou ajustar sub-agentes | Projetos com agentes especializados |
| /memory | Abre e edita a memória do projeto | Salvar contexto que importa em conversas futuras |
Fechar o dia com um resumo do que andou evita a sensação de não ter feito nada. Suponha um escritório de contabilidade de duas pessoas que divide a mesma pasta de clientes: o relatório de fim de dia mostra a quem chega amanhã o que já foi feito.
Dentro da pasta em que você trabalhou, rode o pedido abaixo e depois o /cost. Se o relatório listar o que mudou hoje e o /cost mostrar o gasto da sessão, você fechou o dia com o trabalho e o custo sob controle.
Dentro do Claude Code, execute /help para ver a lista completa de comandos. Depois teste /model para ver qual modelo está ativo e /cost para ver o consumo da sessão.
Dois comandos da tabela acima mudaram. O /cost virou apelido do /usage, que agora mostra numa tela só o custo da sessão, os limites do plano e as estatísticas de uso. E o /agents deixou de abrir o assistente de sub-agentes: para criar ou ajustar um sub-agente, peça ao próprio Claude ou edite a pasta .claude/agents/.
Dez comandos pouco explorados, confirmados na documentação de setembro de 2026
| Comando | Para que serve | Quando usar |
|---|---|---|
| /context | Mostra numa grade colorida quanto da janela de contexto já foi ocupado, e com o quê | Antes de uma etapa pesada, para decidir entre seguir, /compact ou /clear |
| /effort | Ajusta o nível de esforço do modelo, de low a max, ou deixa em auto | low na triagem, high no parecer que vai para a diretoria |
| /fast | Liga o modo rápido do Opus: até 2,5 vezes mais veloz, mais caro por token e cobrado em créditos de uso | Depuração ao vivo, com alguém esperando |
| /btw | Faz uma pergunta lateral sem entrar no histórico da conversa | Tirar uma dúvida no meio de um trabalho longo |
| /tasks | Lista o que roda em segundo plano na sessão, inclusive sub-agentes já concluídos | Conferir o que ainda está em andamento |
| /loop | Repete um pedido num intervalo enquanto a sessão estiver aberta, a partir de 1 minuto | Vigiar uma publicação ou um arquivo que ainda vai chegar |
| /schedule | Cria e administra rotinas que rodam na nuvem, com o computador desligado | Relatório semanal com dia e hora fixos |
| /code-review | Revisa a mudança atual atrás de erros; com --fix, aplica as correções | Antes de publicar uma alteração |
| /plugin | Instala e administra plugins, pacotes prontos de skills, sub-agentes e conexões | Levar um conjunto pronto para o time |
| /usage-credits | Abre os créditos de uso, ou pede ao administrador que os libere | Quando a cota acabou no meio do trabalho |
O modo rápido e as rotinas estão em versão de pesquisa: recurso aberto ao público que ainda pode mudar de preço e de forma.
Suponha uma agência de viagens de duas sócias montando, numa manhã, a proposta de uma viagem de formatura. No meio da sessão, uma delas quer lembrar em qual arquivo estava a tabela de hotéis, e o /btw responde sem misturar a pergunta ao histórico da proposta. Antes do texto final, o /context mostra a janela quase cheia, e um /compact libera espaço. O parecer que vai ao cliente sai com /effort high; a separação dos e-mails de confirmação, com /effort low. Nenhum dos quatro comandos pede código.
# A manhã da agência, em quatro comandos:
/btw em qual arquivo estava a tabela de hotéis de Porto Seguro?
/context
/compact
/effort highRode /context na sessão mais longa que você tiver aberta. Acertou quando souber dizer, só de olhar a grade, se o próximo passo é seguir, compactar ou limpar a conversa.
Três controles respondem pelo gasto e pela autonomia do dia a dia. O /model abre o seletor, e na versão atual a linha padrão aponta o Opus 5.5 desde 22 de setembro. O /usage, que também atende por /cost, mostra o custo da sessão atual e das anteriores; nos planos Pro, Max, Team e Enterprise, separa o consumo por skill, sub-agente, plugin e servidor MCP. E, desde 14 de agosto de 2026, a sessão nova nos planos Pro, Max e Team começa no modo automático, com um segundo modelo revisando cada ação antes de ela rodar.
Os comandos que controlam modelo, custo e autonomia
| Comando | O que mostra ou muda | Quando usar |
|---|---|---|
| /model | Lista os modelos e o padrão da conta; /model haiku troca na hora | Antes de uma triagem longa, para não gastar o modelo mais caro em trabalho simples |
| /usage (ou /cost) | Custo estimado da sessão e das anteriores, limites do plano e consumo por skill e conector | No fim de uma sessão longa ou antes de decidir se sobe de plano |
| Shift+Tab | Alterna o modo de permissão da sessão | Antes de apontar o Claude para uma pasta sensível |
| /permissions | As listas de liberar, perguntar e bloquear | Para escrever a regra que vale em qualquer modo |
| /doctor (ou /checkup) | Diagnóstico da instalação e das configurações | Quando algo parecer quebrado, antes de reinstalar |
O valor em dólar do /usage é calculado na sua máquina a partir dos tokens e da tabela de preços publicada. Vale como estimativa; a cobrança oficial é a do plano ou do Console.
Suponha a dona de um escritório de contabilidade com três funcionárias, que tria 80 notas fiscais por semana com o Claude Code. Ela abre a sessão, digita /model haiku antes da triagem, confere no /usage quanto a tarefa consumiu e volta ao padrão pelo seletor antes de redigir o parecer do cliente. Em quatro semanas, o /usage mostra de onde sai o gasto, e a decisão de subir para o Max passa a ter número em vez de impressão.
Rode /usage ao fim da próxima sessão longa. Acertou quando souber apontar qual skill, sub-agente ou conector respondeu pela maior fatia do consumo e se o ritmo atual cabe no seu plano pelas próximas quatro semanas.

Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
Comandos que chegaram entre julho e setembro de 2026
| Comando | O que faz | Desde |
|---|---|---|
| /skill-doctor | Mostra quanto contexto cada skill ocupa e quantas vezes foi usada, para você desligar as paradas | v2.1.252, 31 de agosto |
| /diff | Abre, ao lado da conversa, o painel com os arquivos alterados e as linhas somadas e removidas | v2.1.260, 3 de setembro |
| /doctor prompt-audit | Revisa CLAUDE.md, skills e sub-agentes em busca de instruções escritas para modelos antigos | v2.1.283, 25 de setembro |
| /mcp reconnect all | Tenta de novo, de uma vez, todos os servidores MCP que falharam ou pedem login | v2.1.284, 28 de setembro |
| /usage | Ganhou o detalhe por /loop: execuções, tokens por execução e a última rodada | v2.1.243, agosto |
O /config abre só as opções pessoais mais comuns. Para o resto, como modo de permissão padrão e hooks, edite o arquivo de configurações.
Suponha a analista de conteúdo de uma loja de suplementos que instalou seis skills em julho: de briefing, de SEO, de legenda, de e-mail, de roteiro de vídeo e de tradução. Cada skill listada pesa no contexto de toda conversa, mesmo quando não é usada. Rode /skill-doctor uma vez por mês e desligue as que não foram chamadas no período. Acertou quando o relatório mostrar só skills com uso registrado e a sessão começar com menos contexto ocupado do que antes da faxina.
Perguntas frequentes deste capítulo
Quando uso /clear e quando uso /compact?
O /rewind substitui o Git?
Como escolho o modelo certo e evito estourar o limite do meu plano no meio de uma tarefa?
O Claude começou a se comportar de forma estranha; o que faço antes de reinstalar?
O /cost e o /usage mostram coisas diferentes?
Por que o Claude Code parou de pedir permissão para cada ação?
Qual modelo o /model mostra como padrão desde setembro de 2026?
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Conexões deste capítulo
Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.
Estude antes
- CursoSetup Completo: do zero ao Claude Code
- Veja o que o Claude Code faz antes de instalarsugerido pelo grafoApresenta o conceito “Claude Code”, usado em “Manter modelo e custo sob controle com os comandos de barra”.
- Usar o mapa do curso e o glossário mínimosugerido pelo grafoApresenta o conceito “MCP”, usado em “Manter modelo e custo sob controle com os comandos de barra”.
- CursoAgentes de código para executivossugerido pelo grafo3 capítulos de “Claude Code CLI: Programação com IA” usam conceitos apresentados em “Agentes de código para executivos”.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Setup Completo: do zero ao Claude CodeEscolha o modelo certo para cada tarefa e custoExaminar conexões de Escolha o modelo certo para cada tarefa e custo
- Vídeo com IA: Claude Code, Codex e ElevenLabsEstruturar o projeto de vídeo para o Claude Code operar sem improvisarExaminar conexões de Estruturar o projeto de vídeo para o Claude Code operar sem improvisar
- Prompt Engineering para ExecutivosEscolher a técnica para fluxos que rodam por horasExaminar conexões de Escolher a técnica para fluxos que rodam por horas
- Segundo cérebro com IATrocar de modelo no meio da tarefa sem começar do zeroExaminar conexões de Trocar de modelo no meio da tarefa sem começar do zero
Voltar ao capítulo anterior: Fazer a primeira delegação ao Claude e ver o arquivo nascer
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.
Capítulos vizinhos em Claude Code CLI: Programação com IA
- 05Instalar o Claude Code e fazer o primeiro acesso sem o TI
- 06Fazer a primeira delegação ao Claude e ver o arquivo nascer
- 07Manter modelo e custo sob controle com os comandos de barra
- 08Pedir o resultado em vez da tarefa ao escrever um prompt
- 09Ler, comparar e editar documentos com IA