β¨οΈ Comandos Essenciais do Terminal
1.2β‘ Slash Commands Nativos
1.3π© Flags de Linha de Comando
1.4π Pipe de Dados
1.5π― Atalhos de Teclado e Aliases
β¨οΈ Comandos Essenciais do Terminal
Os comandos internos do Claude Code que voce vai usar todos os dias. /help, /clear, /compact, /cost, /status e como combina-los.
Comando que exibe todos os comandos disponiveis, slash commands e flags do Claude Code. E seu manual de referencia rapida dentro da sessao.
Quando voce esquece um comando ou quer descobrir novas funcionalidades, /help e o primeiro lugar pra olhar. Evita ter que sair do terminal pra consultar documentacao.
Digite /help a qualquer momento na sessao. Mostra comandos internos, slash commands de skills, e flags CLI. Funciona como um indice vivo do que o Claude Code consegue fazer.
Comando que limpa o historico visual da sessao atual no terminal. Nao apaga o contexto do Claude, apenas a exibicao na tela.
Sessoes longas ficam poluidas visualmente. /clear da um respiro sem perder o fio da conversa. Voce mantem o contexto mas ganha clareza visual.
Diferente de /compact, o /clear so afeta o que aparece no terminal. O Claude continua lembrando de tudo. Use quando a tela esta cheia mas o contexto ainda e relevante.
Comando que compacta o historico da conversa, resumindo mensagens anteriores para liberar espaco na janela de contexto. Essencial em sessoes longas.
A janela de contexto tem limite. Quando voce atinge ~70-80% de uso, o Claude comeca a perder detalhes. /compact resume o historico e libera espaco para continuar trabalhando sem perder informacao critica.
Use /compact antes de migracoes longas ou refatoracoes grandes. Monitore com /cost para saber quando compactar. O Claude gera um resumo inteligente que preserva decisoes e contexto importante.
Comando que mostra o custo acumulado da sessao atual em dolares, quantidade de tokens consumidos e estatisticas de uso. Seu medidor de consumo em tempo real.
Sem monitorar custo, voce pode queimar creditos sem perceber. /cost te da visibilidade total sobre quanto esta gastando e ajuda a decidir quando compactar ou iniciar nova sessao.
Mostra tokens de entrada, saida e custo em USD. Use como gatilho para /compact quando o contexto fica grande. Operadores profissionais checam /cost regularmente para otimizar uso.
Mostra informacoes sobre a sessao atual: modelo em uso, MCPs conectados, ferramentas disponiveis e configuracoes ativas. Seu painel de controle do ambiente.
Quando algo nao funciona como esperado, /status ajuda a diagnosticar. Talvez um MCP esteja desconectado ou o modelo errado esteja selecionado. E o primeiro comando de troubleshooting.
Exibe modelo ativo, MCPs conectados, ferramentas e permissoes. Use antes de tarefas criticas para garantir que o ambiente esta correto. Complementa /cost para visao completa da sessao.
A pratica de usar os comandos internos em conjunto durante uma sessao de trabalho. /status no inicio, /cost ao longo, /compact quando necessario, /clear para manter foco visual.
Comandos isolados sao uteis. Comandos combinados num fluxo consciente sao poderosos. Voce desenvolve um ritmo de trabalho que maximiza produtividade e minimiza desperdicio.
Fluxo recomendado: /status (verificar ambiente) > trabalhar > /cost (monitorar) > /compact (quando necessario) > /clear (limpar visual). Repita conforme a sessao avanca.
β‘ Slash Commands Nativos
Comandos de acao do Claude Code: /commit, /review, /pr, /init e /doctor. Execucao direta sem digitar prompts longos.
Analisa todas as mudancas staged/unstaged, gera uma mensagem de commit descritiva automaticamente e executa o git commit. Elimina a friccao de escrever mensagens de commit.
Mensagens de commit ruins sao epidemia. O Claude analisa o diff real e gera mensagens que descrevem o "por que" da mudanca, nao so o "o que". Commits mais claros, historico mais util.
Claude le o diff, analisa staged + unstaged, gera mensagem no padrao do repo e executa. Voce pode revisar antes de confirmar. Segue convencoes como Conventional Commits se o repo ja usa.
Revisa suas mudancas atuais procurando bugs, vulnerabilidades de seguranca, problemas de performance e qualidade de codigo. Como ter um senior reviewer disponivel 24/7.
Ninguem deveria fazer push sem review. Quando voce trabalha sozinho ou precisa de feedback rapido, /review pega coisas que voce nao viu: race conditions, SQL injection, imports desnecessarios.
Analisa mudancas por camadas: seguranca, bugs, performance e qualidade. Classifica em Critical, Important, Minor. Use antes de todo /commit em codigo de producao.
Analisa todos os commits da branch, gera titulo e descricao formatados e cria o Pull Request no GitHub automaticamente via gh CLI.
Criar PRs e tedioso. Escrever descricoes boas leva tempo. /pr faz isso em segundos, analisando o diff completo e gerando um resumo que outro dev consegue entender imediatamente.
Requer gh CLI instalado e autenticado. Analisa todos os commits (nao so o ultimo). Gera Summary + Test Plan. Voce revisa antes de publicar. Fluxo ideal: /review > /commit > /pr.
Gera automaticamente um CLAUDE.md para o projeto atual. O Claude explora a estrutura, identifica stack, comandos e convencoes, e cria o arquivo de memoria do projeto.
O CLAUDE.md e a fundacao do Claude Code (Trilha 2 inteira). /init cria esse arquivo automaticamente, economizando tempo e garantindo que os pontos essenciais estejam cobertos.
Explora o repo, detecta linguagem, framework, testes, scripts de build. Gera CLAUDE.md com overview, stack, comandos e convencoes. Voce deve revisar e personalizar o resultado.
Verifica a saude da instalacao do Claude Code: versao, autenticacao, MCPs, permissoes e dependencias. Seu checklist automatico de troubleshooting.
Quando algo nao conecta, um MCP falha ou um comando nao funciona, /doctor diagnostica o problema rapidamente. Evita horas de debug manual em configuracao.
Checa versao do Claude, Node.js, autenticacao API, MCPs instalados e suas conexoes. Aponta problemas com sugestoes de correcao. Execute quando qualquer integracao parar de funcionar.
O fluxo completo de trabalho usando slash commands em sequencia: /init (setup) > codigo > /review > /commit > /pr. O workflow profissional com Claude Code.
Slash commands isolados sao atalhos. Slash commands em sequencia sao um sistema de producao. Voce constroi um pipeline de qualidade que garante codigo revisado, commitado e publicado corretamente.
Pipeline padrao: /init (uma vez por projeto) > desenvolver > /review (antes de commitar) > /commit (com mensagem IA) > /pr (quando pronto). Cada passo agrega qualidade.
π© Flags de Linha de Comando
Controle total do Claude via flags CLI: -p para prompts diretos, --model para escolher modelo, --resume para retomar sessoes e mais.
Flag que permite enviar um prompt direto ao Claude sem abrir sessao interativa. Ideal para scripts, automacoes e tarefas rapidas de uma linha.
Nem sempre voce quer abrir uma sessao completa. Com -p voce pode integrar Claude em shell scripts, cron jobs e pipelines de CI/CD.
Sintaxe: claude -p "seu prompt aqui". Executa e retorna resultado no stdout. Combinavel com pipe: cat file.py | claude -p "explique este codigo". Nao mantem sessao.
Flag que permite selecionar qual modelo Claude usar: Opus (mais capaz), Sonnet (equilibrado) ou Haiku (rapido e barato).
Tarefas diferentes exigem modelos diferentes. Usar Opus pra tudo e desperdicio. Usar Haiku pra arquitetura complexa e insuficiente. Saber escolher economiza dinheiro e tempo.
Opus: arquitetura, decisoes complexas. Sonnet: desenvolvimento diario, 80% dos casos. Haiku: tarefas rapidas, formatacao, perguntas simples. Sintaxe: claude --model sonnet.
Flag que retoma uma sessao anterior do Claude Code com todo o contexto preservado. Voce continua exatamente de onde parou.
Sessoes longas sao interrompidas por updates, reinicializacoes ou fim de expediente. Com --resume voce nao perde o contexto acumulado. Essencial para projetos que duram dias.
Sintaxe: claude --resume. Retoma a ultima sessao. Pode especificar ID: claude --resume SESSION_ID. O contexto, decisoes e arquivos discutidos sao preservados.
Flag que restringe quais ferramentas o Claude pode usar na sessao. Controle granular de permissoes para seguranca e previsibilidade.
Em ambientes de producao ou quando voce quer limitar o que o Claude pode fazer (ex: so leitura, sem executar bash), essa flag da o controle necessario.
Permite listar ferramentas permitidas explicitamente. Util em automacoes onde voce quer garantir que o Claude so use Read e Grep, por exemplo, sem modificar arquivos.
Flag que define o formato de saida do Claude: texto puro, JSON ou streaming. Essencial para integracoes programaticas.
Quando Claude e parte de um pipeline automatizado, voce precisa de saida parseavel. JSON estruturado permite que outros scripts processem o resultado do Claude.
Opcoes: text (padrao), json, stream-json. Para automacoes use json. Para UI em tempo real use stream-json. Combinavel com -p para pipelines completos.
A arte de combinar multiplas flags para criar comandos poderosos e especificos. Cada combinacao desbloqueia um caso de uso diferente.
Flags individuais sao uteis. Flags combinadas criam automacoes reais: scripts de review automatico, pipelines de documentacao, analises de codebase sob demanda.
Exemplos: claude -p "..." --model haiku --output-format json (analise rapida com saida parseavel). claude --resume --model opus (retomar com modelo mais capaz). Crie aliases para suas combinacoes favoritas.
π Pipe de Dados
Alimente o Claude com arquivos, logs e stack traces via pipe Unix. Integre com ferramentas do terminal para fluxos poderosos.
Tecnica de enviar o conteudo de um arquivo diretamente ao Claude via stdin. O pipe Unix conecta a saida de cat com a entrada do Claude.
A forma mais rapida de fazer o Claude analisar um arquivo sem abrir sessao interativa. Funciona com qualquer tipo de arquivo texto: codigo, logs, configs, CSV.
Sintaxe: cat app.py | claude -p "explique este codigo". O conteudo do arquivo vira parte do prompt. Funciona com qualquer comando que gere saida: grep, find, git diff.
Enviar logs de erro, stack traces ou saidas de aplicacao diretamente ao Claude para analise e diagnostico automatico.
Copiar e colar stack traces manualmente e lento e propenso a erros. Com pipe, voce envia o log inteiro direto do terminal. O Claude recebe o contexto completo sem nada cortado.
Exemplos: cat error.log | claude -p "o que esta causando esses erros?". Funciona com tail -f para logs em tempo real. Combine com grep para filtrar antes de enviar.
Tecnica de concatenar multiplos arquivos e enviar tudo ao Claude de uma vez. Util quando o contexto depende de varios arquivos relacionados.
Muitos bugs so fazem sentido quando voce ve multiplos arquivos juntos: o controller, o model e a rota. Enviar todos de uma vez da ao Claude o contexto completo.
Sintaxe: cat model.py controller.py routes.py | claude -p "encontre inconsistencias". Use separadores ou file headers para o Claude saber qual arquivo e qual.
Usar operadores de redirecionamento (> e >>) para salvar a saida do Claude em arquivos. Transforma respostas do Claude em artefatos permanentes.
Respostas do Claude no terminal sao efemeras. Redirecionando para arquivo, voce cria documentacao, relatorios e analises que podem ser compartilhados ou versionados.
Sintaxe: claude -p "..." > resultado.md. Use >> para append. Combine com --output-format json > dados.json para pipelines automatizados com saida estruturada.
Usar Claude como mais uma ferramenta no pipeline Unix, combinando com grep, awk, sed, jq e outras ferramentas para criar fluxos de processamento inteligentes.
A filosofia Unix e compor ferramentas pequenas e especializadas. Claude adiciona inteligencia a esse pipeline. grep filtra, awk formata, Claude entende e analisa.
Exemplos: git diff | claude -p "resuma estas mudancas". find . -name "*.py" -exec cat {} + | claude -p "encontre vulnerabilidades". O Claude funciona como qualquer outro comando Unix.
Combinacoes avancadas de pipe com multiplos estagios: filtragem, processamento com Claude, formatacao e saida. Automacoes reais para o dia a dia.
Este e o nivel operador. Voce constroi scripts que fazem analises completas automaticamente: review de PR, documentacao de API, auditoria de seguranca por todo o codebase.
Encadear Claude em shell scripts: for file in src/*.py; do cat $file | claude -p "analise" --output-format json >> report.json; done. Combine com cron para execucao agendada.
π― Atalhos de Teclado e Aliases
Navegacao rapida, edicao de prompt, controle de execucao e como criar aliases personalizados para suas combinacoes favoritas.
Atalhos de teclado para navegar pelo historico da sessao, rolar para cima/baixo e acessar respostas anteriores sem usar o mouse.
Em sessoes longas, voce precisa revisar respostas anteriores. Navegar com teclado e mais rapido que scroll manual e mantem suas maos no teclado.
Setas cima/baixo para historico de input. Page Up/Down para scroll. Ctrl+Home/End para inicio/fim da sessao. Esses atalhos seguem convencoes padrao do terminal.
Atalhos para editar o prompt antes de enviar: mover cursor, selecionar texto, deletar palavras e linhas. Edicao eficiente sem mouse.
Prompts longos precisam de edicao. Ctrl+A (inicio), Ctrl+E (fim), Ctrl+W (deletar palavra), Alt+Backspace. Economiza segundos que acumulam em horas.
Ctrl+A: inicio da linha. Ctrl+E: fim da linha. Ctrl+W: deletar palavra anterior. Ctrl+U: limpar linha inteira. Ctrl+K: deletar ate o fim. Sao atalhos padrao readline.
Atalhos para controlar a execucao do Claude: interromper resposta em andamento, cancelar operacao e sair da sessao de forma limpa.
Se o Claude comecou a gerar algo errado, voce nao precisa esperar terminar. Interrompa, corrija o prompt e continue. Controle e produtividade.
Escape: interrompe a geracao atual. Ctrl+C: cancela e volta ao prompt. Ctrl+D: sai da sessao. Use Escape quando a resposta esta indo pro caminho errado para economizar tokens.
Navegar pelo historico de prompts que voce ja digitou na sessao, reutilizando ou modificando comandos anteriores sem digitar novamente.
Voce frequentemente envia variancoes do mesmo prompt. Com historico, voce recupera o prompt anterior, faz um ajuste pequeno e reenvia. Muito mais rapido que redigitar.
Seta cima: prompt anterior. Seta baixo: proximo prompt. Funciona como historico de bash. Combine com edicao de prompt para iterar rapidamente sobre uma tarefa.
Tecnica para escrever prompts com multiplas linhas no Claude Code sem enviar acidentalmente no meio. Essencial para prompts complexos e estruturados.
Prompts bons frequentemente precisam de estrutura: contexto numa linha, instrucao em outra, restricoes numa terceira. Multi-line permite prompts organizados e mais eficazes.
Shift+Enter: nova linha sem enviar. Backslash no final da linha: continuacao. Permite escrever prompts estruturados que o Claude interpreta melhor.
Criar aliases no shell (bash/zsh) que encapsulam comandos Claude com flags, prompts e configuracoes que voce usa frequentemente.
Se voce digita "claude -p --model haiku --output-format json" toda hora, um alias transforma isso em "cq" (claude quick). Automatize o que repete.
Adicione ao .bashrc/.zshrc: alias cr="claude --resume", alias cq="claude -p --model haiku", alias crev="claude -p --model sonnet 'review este codigo'". Recarregue com source ~/.zshrc.