Comandos do Claude Code: quais usar e em que momento?

Como funcionam os comandos do Claude Code?

Tudo que começa com / no início da mensagem é um comando, e o texto depois do nome vira argumento. Se você manda um comando enquanto o Claude está respondendo, ele entra na fila e roda quando o turno acaba; alguns, como /usage e /status, rodam na hora. Três prefixos completam o básico: ! no começo roda um comando de terminal direto, @ menciona um arquivo com autocompletar, e ? com a caixa vazia mostra os atalhos.

A lista oficial passa de cem comandos. Os que você usa todo dia cabem em cinco momentos da sessão.

Quais comandos usar para começar?

• claude, dentro da pasta do projeto, abre a sessão.
• /init cria um CLAUDE.md inicial, o arquivo que o agente lê em toda sessão. Veja o que é o CLAUDE.md.
• /plan, ou Shift+Tab até chegar no modo plan, faz o agente planejar antes de editar. Shift+Tab alterna os modos de permissão.
• /doctor faz um checkup da instalação e das configurações quando algo parece errado.

Quais comandos cuidam do contexto?

A janela de contexto funciona como um copo que só enche. Instruções, CLAUDE.md, histórico, arquivos lidos e saídas de comando moram ali, e tudo é reenviado a cada turno. O maior gasto quase nunca é o que você digita: são arquivos lidos por inteiro e saídas verbosas. Um arquivo de 500 linhas gasta uns 13 mil tokens. Quando o copo enche, cada turno fica mais caro e o começo da conversa, inclusive a instrução do primeiro minuto, começa a sumir.

• /context mostra o que está ocupando a janela, em grade colorida, com sugestões.
• /clear começa uma conversa nova, com a janela vazia. Use entre tarefas: terminou o login, vai mexer no relatório, limpe. A conversa anterior fica salva e volta com /resume.
• /compact troca o histórico por um resumo. Use quando precisa continuar a mesma tarefa com o copo cheio. Aceita instrução: /compact foque na correção do bug de autenticação.
• /rewind, ou Esc duas vezes com a caixa vazia, volta conversa e código a um ponto anterior, ou resume só um trecho.
• /btw faz uma pergunta lateral sem entrar no histórico da conversa.

A regra prática: quando o uso passar de uns 70%, decida de propósito entre limpar e compactar, em vez de deixar a compactação automática decidir no meio de uma edição. Para ter esse medidor sempre à vista, peça ao /statusline: /statusline mostre o modelo e a porcentagem de contexto.

Compactar tem um custo que não aparece na tela: sobrevive o que aconteceu, e evapora o porquê. Tentativas descartadas e restrições que você disse falando são as primeiras a sumir, e o sintoma clássico é o agente sugerir de novo o que já deu errado. O que está escrito no repositório não evapora, e a documentação confirma: o CLAUDE.md da raiz é recarregado do disco depois da compactação. Por isso vale dizer no /compact o que precisa sobreviver.

Como escolher o modelo e o esforço?

São dois botões independentes. O modelo define a capacidade; o esforço define quanto ele pensa antes de agir. Um modelo forte pensando pouco e um médio pensando muito são máquinas bem diferentes, e a segunda muitas vezes resolve melhor por menos.

• /model troca o modelo e salva como padrão das próximas sessões. Aceita apelidos: fable, opus, sonnet, haiku. Sem argumento, abre um seletor em que a tecla s troca só para a sessão atual. Atalho: Option+P no Mac, Alt+P no Windows e no Linux.
• /effort ajusta o raciocínio: low, medium, high, xhigh ou max, e auto volta ao padrão. O padrão é high na maioria dos modelos. max vale só para a sessão atual.
• ultrathink em qualquer lugar do pedido pede raciocínio mais fundo só naquele turno, sem mudar o esforço da sessão.

Hoje, forte é o Opus (e, acima dele, o Fable, feito para tarefas longas), médio é o Sonnet e leve é o Haiku. O padrão que mais economiza: /model opus e "planeje a migração do módulo de pagamento, não edite nada"; com o plano escrito na conversa, /model sonnet e "execute o passo um e rode os testes". O apelido opusplan faz essa troca sozinho: Opus no modo plan, Sonnet na execução. E comece no meio: suba modelo ou esforço quando a resposta vier rasa ou errada duas vezes, não por superstição.

Cada modelo tem seu próprio cache. Trocar de modelo no meio da sessão, e na maioria dos modelos também trocar o esforço, faz a próxima resposta reler todo o histórico sem desconto, uma vez. Continua valendo a pena no padrão planejar e executar, mas não vale ficar trocando a cada pedido.

Como retomar, limpar ou bifurcar uma sessão?

• claude -c (ou --continue) reabre a conversa mais recente da pasta.
• claude -r (ou --resume) e /resume abrem o seletor de sessões. Dê nome antes com /rename para achar depois.
• /branch cria um ramo da conversa neste ponto e te leva para ele; o original fica intacto. De fora da sessão: claude --continue --fork-session.
• /fork copia a conversa para uma sessão em segundo plano e você segue trabalhando nesta.

Uma pergunta decide entre limpar, retomar e bifurcar: o que vem agora precisa do que passou? Não precisa, é outro assunto: limpe. Precisa de tudo, é a continuação direta: retome. Precisa do mesmo ponto de partida em duas direções, como testar uma solução com fila e outra com ajuste mínimo: bifurque. Se a resposta for "acho que um pouco", limpe. Arrastar a mesma sessão pelo dia inteiro gera contaminação: o agente usa corretamente tudo o que você deixou na mesa, inclusive o que não tem nada a ver com a tarefa nova.

Antes de limpar, escreva no repositório duas linhas por decisão que custou discussão. É a única memória que atravessa a compactação e o fim da sessão.

Como acompanhar o custo?

/usage mostra custo da sessão, limites do plano e estatísticas; /cost e /stats hoje são apelidos dele. O custo aparece de um jeito diferente conforme o acesso. Na assinatura, você não vê centavo: vê o limite chegando antes do que devia. Na chave de API, vê o valor no painel. Os dois medem a mesma coisa: tokens que você não precisava gastar. Mais sobre planos em quanto custa o Claude Code.

O cache trabalha a seu favor: o começo repetido do contexto sai por uma fração do preço, e por isso seguir na mesma tarefa é barato. /clear não custa nada; /compact lê a conversa inteira para resumir, então faça numa pausa natural entre tarefas.

Qual comando serve para quê? A referência rápida

No Mac, os atalhos com Option (menos o Option+T) pedem que o terminal trate Option como Meta. A documentação explica a configuração de cada terminal.

Continue lendo

• CLAUDE.md: o que é, onde fica e o que escrever nele?O CLAUDE.md é o arquivo de instruções que o Claude Code lê em toda sessão. Onde ele fica, o que entra, o que não entra e um modelo para copiar.
• Claude Code é pago? Preço, planos e limites em setembro de 2026Quanto custa o Claude Code em setembro de 2026: Pro, Max, Team, Enterprise e API, os limites de uso e a conta de tokens que decide o seu gasto.
• Claude Code vs Cursor (e Codex e Copilot): qual usar?Claude Code, Cursor, Codex e Copilot comparados pelo que importa: autocompletar ou agente, onde roda e como cobra. Dados de setembro de 2026.