📖 /help - O Centro de Ajuda Instantaneo
O comando /help e o primeiro que voce deve aprender no Claude Code. Ele funciona como um indice vivo de tudo que a ferramenta oferece: slash commands, flags de linha de comando, atalhos de teclado e configuracoes disponiveis. Em vez de decorar documentacao, voce consulta direto no terminal.
🎯 Conceito Principal
O /help nao e apenas uma lista de comandos. Ele e um mapa de navegacao que se atualiza conforme novas funcionalidades sao adicionadas ao Claude Code. Quando uma atualizacao traz novos slash commands ou flags, o /help ja reflete isso automaticamente.
- • Lista todos os slash commands disponiveis na sessao atual (ex: /clear, /compact, /cost, /doctor, /init, etc.)
- • Mostra as flags de CLI que voce pode usar ao iniciar o Claude Code (ex: --model, --allowedTools, --print)
- • Exibe atalhos de teclado como Escape (cancelar geracao), Shift+Tab (modo multiplas linhas) e outros
📊 Por Que Isso Importa
- Menos de 20% dos usuarios de ferramentas CLI exploram todos os comandos disponiveis
- Descoberta ativa - Rodar /help periodicamente revela funcionalidades que voce nao sabia que existiam
- Zero dependencia externa - Nao precisa sair do terminal para consultar documentacao online
💡 Dica Pratica
Rode /help logo ao abrir o Claude Code pela primeira vez apos uma atualizacao. Novas versoes frequentemente adicionam comandos e flags que podem mudar completamente seu workflow. Exemplo real: o comando /doctor foi adicionado silenciosamente e resolve problemas de configuracao que antes exigiam reinstalacao.
Combine com claude --help no shell (fora da sessao) para ver as flags de inicializacao. Sao contextos complementares: um mostra o que fazer dentro da sessao, o outro mostra como configurar a entrada.
✓ O que FAZER
- ✓ Rode /help como primeiro comando em sessoes novas
- ✓ Consulte /help apos cada atualizacao do Claude Code
- ✓ Use como referencia rapida antes de tentar um comando que nao lembra
✗ O que NAO fazer
- ✗ Tentar decorar todos os comandos sem nunca consultar /help
- ✗ Buscar documentacao online quando a resposta esta no proprio terminal
- ✗ Ignorar flags desconhecidas - elas podem ser exatamente o que voce precisa
🧹 /clear - Limpando a Sessao
O /clear limpa a tela do terminal sem apagar o contexto que o Claude acumulou. E como limpar sua mesa de trabalho sem jogar fora os documentos que esta usando. A sessao continua exatamente onde parou, mas visualmente voce tem uma tela limpa para focar no proximo passo.
🎯 Conceito Principal
Existe uma confusao comum entre /clear e /compact. Sao coisas completamente diferentes:
- • /clear afeta apenas o display visual do terminal. O Claude continua com todo o historico de mensagens na memoria. Tokens consumidos permanecem iguais.
- • /compact (proximo topico) realmente altera o contexto interno, resumindo mensagens anteriores para liberar espaco na janela de contexto.
- • Analogia: /clear e limpar o quadro branco. /compact e fotografar o quadro, guardar a foto e apagar o quadro para ter espaco novo.
💡 Dica Pratica
Use /clear quando o Claude acabou de gerar um bloco enorme de codigo ou fez varias operacoes em sequencia e sua tela esta cheia de output. A limpeza visual ajuda voce a se concentrar na proxima instrucao sem distracoes.
Momento ideal: apos o Claude executar um refactoring grande, ou apos voce revisar um diff extenso. Limpe a tela e siga para o proximo passo com foco renovado.
🔍 Diferenca Tecnica
- /clear - Reseta o display do terminal. Nenhum token e liberado. Nenhuma informacao e perdida. Custo da sessao nao muda.
- Ctrl+L - Faz a mesma coisa em muitos terminais, mas dentro do Claude Code o /clear e mais confiavel porque reseta o estado visual do proprio REPL.
- Impacto zero - Voce pode rodar /clear 100 vezes e a sessao permanece identica. Nao ha risco nenhum de perder contexto.
✓ O que FAZER
- ✓ Usar /clear quando a tela esta poluida e voce precisa de foco visual
- ✓ Combinar /clear com /cost para ter visao limpa dos gastos atuais
- ✓ Usar entre transicoes de tarefas dentro da mesma sessao
✗ O que NAO fazer
- ✗ Confundir /clear com /compact achando que libera contexto
- ✗ Usar /clear esperando que o Claude "esqueca" algo que voce disse
- ✗ Rodar /clear quando voce precisa copiar output anterior (limpa a tela!)
📦 /compact - Otimizando o Contexto
O /compact e provavelmente o comando mais importante para quem trabalha em sessoes longas. Ele compacta o historico de conversa, gerando um resumo inteligente que preserva decisoes e contexto critico enquanto libera espaco na janela de contexto. Sem ele, sessoes longas degradam em qualidade e eventualmente atingem o limite.
🎯 Conceito Principal
Cada mensagem trocada com o Claude Code consome tokens da janela de contexto (tipicamente 200k tokens). Quando voce se aproxima do limite, tres coisas acontecem: o Claude começa a "esquecer" instrucoes do inicio, a qualidade das respostas cai, e eventualmente voce recebe um erro de contexto cheio.
- • Como funciona: O Claude le todo o historico, gera um resumo condensado preservando decisoes-chave, arquivos editados e estado atual do trabalho, e substitui o historico completo por esse resumo
- • O que se preserva: Decisoes de arquitetura, nomes de arquivos modificados, erros encontrados e resolvidos, estado atual da tarefa, instrucoes do CLAUDE.md
- • O que se perde: Detalhes granulares de conversas anteriores, codigo intermediario que foi substituido, tentativas que falharam (a menos que relevantes)
📊 Numeros da Compactacao
- 70-80% do contexto usado - momento ideal para rodar /compact
- ~60-70% de reducao tipica no uso de contexto apos compactacao
- Multiplas compactacoes sao possiveis na mesma sessao, mas cada uma perde mais detalhes
- Automatico - O Claude Code tambem compacta automaticamente quando se aproxima do limite, mas compactar proativamente da resultados melhores
💡 Dica Pratica
Voce pode passar instrucoes customizadas para o /compact. Em vez de apenas rodar /compact, tente /compact foco nos arquivos de API e nas decisoes de banco de dados. Isso direciona o resumo para preservar exatamente o que importa para seu proximo passo.
Regra de ouro: se voce ja rodou /cost e viu que o contexto esta acima de 70%, rode /compact imediatamente. Esperar a compactacao automatica geralmente resulta em resumos piores porque o sistema esta sob pressao.
⚠️ Atencao
Apos /compact, o Claude nao lembra detalhes granulares das conversas anteriores. Se voce precisa que ele se lembre de algo especifico, mencione explicitamente antes de compactar ou use o parametro de instrucao customizada. Informacoes no CLAUDE.md sempre sao preservadas porque sao recarregadas a cada interacao.
✓ O que FAZER
- ✓ Compactar proativamente ao atingir 70-80% do contexto
- ✓ Usar instrucoes customizadas: /compact preservar decisoes de arquitetura
- ✓ Verificar /cost antes e depois para confirmar a reducao
✗ O que NAO fazer
- ✗ Esperar a compactacao automatica (resulta em resumos piores)
- ✗ Compactar com apenas 20-30% de uso (desnecessario, perde detalhes sem ganho)
- ✗ Assumir que o Claude lembra tudo apos compactar (sempre re-confirme pontos criticos)
💰 /cost - Monitorando Gastos e Tokens
O /cost exibe o custo acumulado da sessao em dolares, contagem de tokens consumidos e estatisticas de uso. E o seu medidor de consumo em tempo real. Operadores profissionais checam /cost regularmente, assim como um piloto checa o painel de combustivel.
🎯 Conceito Principal
Cada interacao com o Claude Code consome tokens de entrada (sua mensagem + contexto) e tokens de saida (resposta do Claude). O /cost mostra exatamente quanto foi gasto ate o momento, permitindo que voce tome decisoes informadas sobre quando compactar, quando iniciar uma nova sessao, ou quando uma tarefa esta ficando cara demais.
- • Custo em USD: Valor acumulado da sessao atual, calculado com base nos tokens de input e output consumidos
- • Contagem de tokens: Total de tokens de entrada e saida, com breakdown por categoria (cache hits, novas leituras)
- • Indicador de contexto: Mostra quanto da janela de contexto esta sendo usada, servindo como trigger direto para decisoes de /compact
📊 Custos Tipicos por Tipo de Tarefa
- $0.02-0.10 - Perguntas rapidas, correcoes pontuais, explicacoes de codigo
- $0.10-0.50 - Implementacao de features pequenas, debugging, refactoring de um arquivo
- $0.50-2.00 - Features complexas, multi-file refactoring, debugging extenso
- $2.00+ - Sessoes longas com muitas iteracoes, projetos do zero, compactacoes multiplas
💡 Dica Pratica
Crie o habito de rodar /cost a cada 10-15 interacoes. Se o contexto esta acima de 70%, e hora de /compact. Se o custo esta subindo rapido, avalie se voce esta sendo especifico o suficiente nas instrucoes. Prompts vagos geram respostas longas que consomem mais tokens.
Para planos com limite de uso (Claude Pro com $100/mes, por exemplo), o /cost vira seu melhor amigo. Voce pode estimar quantas sessoes cabem no seu budget mensal e ajustar a intensidade de uso.
✓ O que FAZER
- ✓ Checar /cost regularmente (a cada 10-15 interacoes)
- ✓ Usar como trigger para /compact quando contexto passa de 70%
- ✓ Comparar custos entre sessoes para identificar padroes de uso
✗ O que NAO fazer
- ✗ Ignorar /cost e se surpreender com o consumo no final do mes
- ✗ Ficar obsessivo checando a cada mensagem (cria ansiedade desnecessaria)
- ✗ Tentar economizar tokens escrevendo prompts incompreensiveis (sai mais caro pelas retentativas)
🔎 /status - Verificando o Estado do Ambiente
O /status mostra o estado completo da sua sessao atual: qual modelo esta em uso, quais MCPs estao conectados, quais ferramentas estao disponiveis e quais configuracoes estao ativas. E o primeiro comando de troubleshooting quando algo nao funciona como esperado.
🎯 Conceito Principal
O /status funciona como um diagnostico rapido do seu ambiente. Quando um MCP nao responde, quando uma tool nao esta disponivel, ou quando o modelo parece estar se comportando diferente, o /status revela o que esta acontecendo nos bastidores.
- • Modelo ativo: Confirma se voce esta usando Opus, Sonnet ou outro modelo. Fundamental quando voce quer garantir que esta no modelo certo para a tarefa
- • MCPs conectados: Lista todos os MCP servers ativos e suas tools. Se um MCP falhou ao conectar, aparece aqui
- • Ferramentas disponiveis: Todas as tools que o Claude pode usar na sessao atual, incluindo as nativas (Read, Write, Bash, etc.) e as dos MCPs
- • Configuracoes: Mostra o diretorio de trabalho, permissoes ativas e outras configs relevantes
🔍 Quando Usar /status
- MCP nao funciona: Rode /status para verificar se o MCP esta na lista de conectados. Se nao esta, o problema e na configuracao
- Respostas diferentes do esperado: Confira o modelo ativo. Voce pode estar em Sonnet quando queria Opus
- Tool nao reconhecida: Verifique se a tool aparece na lista. Se nao aparece, o MCP que a fornece pode ter falhado
- Inicio de sessao: Rode /status logo ao abrir para confirmar que tudo esta configurado corretamente antes de comecar a trabalhar
💡 Dica Pratica
Combine /status com /cost para ter uma visao completa da sessao. O /status mostra o "o que" (ambiente, tools, modelo) e o /cost mostra o "quanto" (tokens, custo, contexto). Juntos, eles dao um raio-X completo.
Se um MCP aparece como desconectado no /status, tente rodar /doctor para diagnosticar e tentar reconectar automaticamente. O /doctor e o mecanico, o /status e o painel de instrumentos.
✓ O que FAZER
- ✓ Rodar /status como primeiro troubleshooting quando algo falha
- ✓ Verificar o modelo ativo antes de tarefas criticas
- ✓ Conferir MCPs conectados ao inicio de cada sessao
✗ O que NAO fazer
- ✗ Assumir que o ambiente esta configurado sem verificar
- ✗ Ignorar MCPs desconectados e tentar usar suas tools mesmo assim
- ✗ Confundir /status com /cost (sao complementares, nao substitutos)
🔄 Combinando Comandos no Dia a Dia
Cada comando individual tem seu papel. Mas o poder real aparece quando voce os combina em um fluxo de trabalho consciente. Operadores experientes de Claude Code desenvolvem um ritmo natural: verificam o ambiente, trabalham, monitoram o consumo, otimizam o contexto e limpam a tela. Esse ciclo se repete naturalmente ao longo de uma sessao produtiva.
🎯 O Fluxo Recomendado
Este e o fluxo que operadores experientes seguem naturalmente. Nao e uma regra rigida, mas um ritmo que maximiza produtividade e minimiza desperdicio:
- • 1. /status - Ao abrir a sessao, confirma que o ambiente esta correto (modelo, MCPs, tools)
- • 2. Trabalho - Faz suas tarefas normalmente (10-20 interacoes)
- • 3. /cost - Verifica o consumo e uso de contexto
- • 4. /compact - Se contexto > 70%, compacta com instrucoes relevantes
- • 5. /clear - Limpa a tela para o proximo bloco de trabalho
- • 6. Repete - Volta ao passo 2 ate concluir a tarefa
Inicio da Sessao
Primeiros 30 segundos
Rode /status para confirmar modelo e MCPs. Se algo estiver errado, resolva agora. Rode /help se voce atualizou o Claude Code recentemente para ver novidades.
Bloco de Trabalho
10-20 interacoes
Faca suas tarefas normalmente. Implemente features, debugue, refatore. Nao interrompa o fluxo para checar metricas a cada mensagem. Deixe o trabalho fluir naturalmente.
Checkpoint de Consumo
~30 segundos de pausa
Rode /cost. Se contexto > 70%, rode /compact com instrucoes customizadas preservando o contexto relevante. Rode /clear para limpar a tela e iniciar o proximo bloco com foco.
💡 Dica Pratica
Nao trate esses comandos como burocracia. Trate como higiene operacional. Assim como um desenvolvedor da git commit regularmente para nao perder trabalho, voce checa /cost e roda /compact regularmente para nao perder contexto.
Se voce trabalha com CLAUDE.md (e deveria), suas instrucoes persistentes sao recarregadas mesmo apos /compact. Isso significa que suas regras de projeto, padroes de codigo e preferencias sobrevivem a compactacao. O /compact so afeta o historico de chat, nao as configuracoes do projeto.
✓ O que FAZER
- ✓ Desenvolver um ritmo natural: trabalho > check > otimiza > trabalho
- ✓ Usar /status + /cost como "painel de instrumentos" da sessao
- ✓ Manter instrucoes importantes no CLAUDE.md (sobrevive a tudo)
✗ O que NAO fazer
- ✗ Trabalhar sessoes inteiras sem nunca checar /cost ou /status
- ✗ Interromper fluxo de trabalho para checar metricas a cada mensagem
- ✗ Depender apenas da compactacao automatica para gerenciar contexto
📋 Resumo do Modulo
Proximo Modulo:
1.2 - Slash Commands Nativos