Você acabou de instalar Claude Code e se vê diante de uma tela preta com um cursor piscando? Normal. Diferente das ferramentas de criação clássicas com seus botões e menus, Claude Code funciona com comandos textuais que você digita diretamente. Esses comandos, chamados de slash commands porque começam com /, permitem que você crie arquivos, modifique código, lance aplicações e muito mais. Este guia apresenta os 20 comandos essenciais para começar, com exemplos práticos de uso.
Quais são os comandos básicos para criar arquivos?
Os três comandos /create, /edit e /delete permitem que você gerencie todos os seus arquivos no Claude Code. Essas são as fundações do seu fluxo de trabalho diário.
O comando /create gera um novo arquivo. Você simplesmente digita /create index.html e Claude Code cria esse arquivo com uma estrutura básica. Se você especificar o tipo de conteúdo desejado, o assistente adapta o arquivo: /create style.css para um site de receitas gera um arquivo CSS com classes relevantes para seu projeto.
O comando /edit modifica um arquivo existente. Por exemplo, /edit index.html adiciona um botão vermelho no canto superior direito transforma seu arquivo HTML sem você tocar em uma linha de código. Claude Code entende seu pedido em linguagem natural e aplica as mudanças precisas.
O comando /delete remove um arquivo: /delete teste-antigo.js retira definitivamente esse arquivo do seu projeto. Atenção, essa ação é irreversível.
Esses três comandos cobrem 80% do seu trabalho diário no Claude Code. Você cria, ajusta, limpa. O resto dos comandos vem complementar esse trio básico.
Como visualizar e testar sua aplicação em tempo real?
O comando /preview inicia uma visualização em tempo real de sua aplicação no seu navegador. É o equivalente do botão "Play" em um software clássico.
Quando você digita /preview, Claude Code inicia um servidor local e abre automaticamente seu navegador em localhost:3000 (ou outra porta disponível). Cada modificação que você faz depois é visível instantaneamente, sem recarregar a página manualmente.
O comando /stop para esse servidor de visualização. Útil quando você quer liberar recursos ou mudar de projeto.
O comando /restart reinicia o servidor. Às vezes, depois de instalar uma nova biblioteca ou modificar arquivos de configuração, você precisa reiniciar para que as mudanças entrem em efeito.
Esses três comandos formam o ciclo de desenvolvimento: você inicia sua visualização, testa, ajusta, e às vezes reinicia. De acordo com um estudo da Anthropic, desenvolvedores usando Claude Code passam 40% menos tempo alternando entre editor e navegador graças a essa integração fluida.
Quais comandos facilitam a navegação no seu código?
Os comandos /find, /goto e /search permitem que você se mova rapidamente no seu projeto, mesmo com dezenas de arquivos.
O comando /find nome-do-arquivo localiza e abre um arquivo específico. Por exemplo, /find header.js o leva diretamente ao arquivo contendo o código do seu cabeçalho. Sem mais necessidade de procurar na árvore de diretórios.
O comando /goto linha-42 o posiciona em uma linha específica no arquivo atualmente aberto. Muito prático quando Claude Code sinaliza um erro na linha 127: você digita /goto 127 e está lá.
O comando /search palavra-chave procura um termo em todos os arquivos do seu projeto. Se você procura onde usou a função calcularTotal, digita /search calcularTotal e Claude Code lista todas as ocorrências com seu contexto.
Esses comandos de navegação se tornam indispensáveis assim que seu projeto ultrapassa 5-6 arquivos. Em vez de rolar manualmente, você chega direto onde precisa intervir.
Como instalar e gerenciar bibliotecas externas?
O comando /install adiciona bibliotecas de terceiros ao seu projeto, como React, Vue ou utilitários CSS. É o equivalente de uma loja de aplicativos para seu código.
Quando você digita /install react, Claude Code baixa a biblioteca React e configura automaticamente seu projeto para usá-la. Você não precisa entender npm, yarn ou arquivos package.json: o assistente gerencia a plumbing técnica.
O comando /uninstall remove uma biblioteca: /uninstall jquery remove jQuery do seu projeto e limpa as referências nos seus arquivos de configuração.
O comando /list-packages exibe todas as bibliotecas instaladas no seu projeto. Útil para fazer um balanço do que você realmente usa.
De acordo com dados de uso da Anthropic, 73% dos iniciantes usam /install nos seus primeiros 10 minutos com Claude Code. Geralmente é o primeiro comando "mágico" que os faz perceber o poder da ferramenta: instalar uma biblioteca complexa em uma frase.
Quais comandos ajudam você a depurar e corrigir erros?
Os comandos /debug, /fix e /explain transformam mensagens de erro criptografadas em soluções concretas.
O comando /debug analisa seu código procurando por erros potenciais. Claude Code examina a lógica, tipos de dados, referências faltantes, e sinaliza os problemas antes mesmo de você testar sua aplicação.
O comando /fix erro-exibido corrige automaticamente um erro. Se seu navegador exibe "Uncaught ReferenceError: calculateTotal is not defined", você copia essa mensagem e digita /fix Uncaught ReferenceError: calculateTotal is not defined. Claude Code identifica o problema (função mal nomeada, import esquecido) e aplica a correção.
O comando /explain este-pedaco-de-codigo decompõe um trecho de código em linguagem simples em português. Se você não entende uma função que Claude Code gerou, seleciona o código e digita /explain. O assistente detalha linha por linha o que está acontecendo.
Esses comandos de depuração reduzem drasticamente o tempo gasto procurando a origem de um bug. Em vez de passar 30 minutos no Stack Overflow, você obtém uma solução contextualizada em alguns segundos.
Como organizar e documentar seu projeto?
Os comandos /comment, /doc e /structure mantêm seu código limpo e compreensível a longo prazo.
O comando /comment este-arquivo adiciona automaticamente comentários explicativos no seu código. Claude Code insere anotações em português que descrevem o que cada seção faz, sem sobrecarregar a leitura.
O comando /doc gera-readme cria um arquivo README.md que explica seu projeto: objetivo, arquivos principais, como lançar a aplicação. Indispensável se você compartilha seu código ou se volta a ele depois de algumas semanas.
O comando /structure exibe a árvore completa do seu projeto em forma visual. Você vê de uma vez a organização de suas pastas e arquivos.
O comando /rename nome-antigo nome-novo muda o nome de um arquivo em todos os lugares onde é referenciado. Se você renomeia utils.js para helpers.js, Claude Code atualiza todos os imports automaticamente.
Esses comandos de organização parecem secundários no início, mas se tornam cruciais quando você volta a um projeto depois de uma pausa. Um código bem documentado se retoma em 5 minutos; um código sem estrutura pode exigir uma hora de redescoberta.
Como otimizar e melhorar seu código existente?
Os comandos /optimize, /refactor e /test melhoram a qualidade do seu código sem reescrevê-lo completamente.
O comando /optimize analisa seu código para torná-lo mais rápido e mais leve. Claude Code identifica loops ineficientes, carregamentos desnecessários, repetições, e propõe versões otimizadas. Por exemplo, se você carrega uma imagem grande de 5 MB, /optimize pode sugerir uma compressão ou carregamento diferido.
O comando /refactor este-arquivo reestrutura seu código para torná-lo mais legível e mantível, sem mudar seu comportamento. Se você escreveu uma função de 200 linhas com 8 níveis de indentação, /refactor a divide em pequenas funções claras.
O comando /test gera testes automáticos para verificar que seu código funciona corretamente. Claude Code cria cenários de teste que simulam o uso de sua aplicação e detectam regressões.
Esses comandos de melhoria contínua transformam um protótipo funcional em uma aplicação profissional. Eles também o ensinam as boas práticas do desenvolvimento: você vê como Claude Code otimiza, e progressivamente integra esses reflexos.
Conclusão
Esses 20 comandos cobrem o essencial do que você fará com Claude Code diariamente. Você não precisa memorizar todos no primeiro dia: comece com /create, /edit, /preview, e adicione progressivamente os outros ao seu repertório. A vantagem do Claude Code é que você também pode dialogar em português natural: se esquecer um comando, simplesmente pergunte "como eu faço para..." e o assistente o guiará. Para aprofundar, consulte nosso tutorial completo para iniciantes que mostra como construir sua primeira aplicação passo a passo.
