Comandos Essenciais do Claude Code para Produtividade

Ter o Claude Code instalado e configurado é só metade do caminho. A diferença entre quem usa a ferramenta de forma casual e quem realmente acelera o desenvolvimento está no domínio dos comandos. Saber exatamente o que digitar — e quando digitar — transforma o Claude Code de um assistente passivo em um parceiro de desenvolvimento que antecipa suas necessidades.

Este artigo é um mapa prático dos comandos que você vai usar todos os dias. Desde interações básicas em linguagem natural até slash commands que economizam dezenas de minutos por sessão, passando por comandos de memória e refatoração que mantêm seu projeto organizado à medida que cresce.

Comandos básicos para começar a usar o Claude Code

O Claude Code opera diretamente no terminal. Depois de iniciá-lo com claude na pasta do seu projeto, você entra em um modo interativo onde pode digitar comandos em linguagem natural ou usar atalhos especiais.

Interações em linguagem natural

A forma mais direta de usar o Claude Code é simplesmente descrever o que você precisa. Não existe uma sintaxe rígida — você conversa com a ferramenta como faria com outro desenvolvedor:

• Criar arquivos: “Crie um componente React de formulário de contato com validação de email”
• Explicar código: “Explique o que a função processPayment faz no arquivo src/services/payment.ts”
• Corrigir bugs: “O teste unitário do módulo de autenticação está falhando. Analise e corrija”
• Gerar testes: “Escreva testes unitários para todas as funções do arquivo utils/helpers.js”

O Claude Code lê os arquivos do seu projeto, entende a estrutura e aplica as mudanças diretamente. Você não precisa copiar código para dentro de um chat — ele já tem acesso ao contexto completo.

Comandos de terminal integrados

Você pode pedir ao Claude Code para executar comandos de terminal sem sair da sessão. Basta ser explícito:

• “Rode npm install axios”
• “Execute os testes com pytest”
• “Faça um git status e me diga o que mudou”

O Claude Code vai pedir permissão antes de executar comandos que alteram o sistema. Essa camada de confirmação evita que algo destrutivo aconteça sem seu consentimento.

Tabela de interações básicas

Slash commands — atalhos que economizam tempo

Os slash commands são atalhos prefixados com / que acionam funcionalidades específicas do Claude Code sem precisar digitar frases completas. Eles são o atalho entre você e as ações mais frequentes.

Lista dos principais slash commands

Quando usar cada um

O /clear é essencial quando você muda de tarefa dentro da mesma sessão. Se estava trabalhando no backend e vai migrar para o frontend, limpar o contexto evita que o Claude Code misture referências e cometa erros por confusão de escopo.

O /compact resolve um problema diferente: quando a conversa fica longa demais e o modelo começa a “esquecer” instruções anteriores. Em vez de limpar tudo, ele comprime o histórico mantendo os pontos relevantes.

O /cost é seu aliado financeiro. O Claude Code consome tokens da API a cada interação, e monitorar o custo em tempo real evita surpresas na fatura.

Como usar o comando /init para iniciar projetos

O /init é provavelmente o primeiro slash command que você deveria executar em qualquer projeto. Ele cria (ou atualiza) o arquivo CLAUDE.md na raiz do repositório — um documento que funciona como o “briefing” permanente do Claude Code sobre seu projeto.

O que o CLAUDE.md contém

Quando você roda /init, o Claude Code analisa a estrutura do projeto e gera automaticamente um arquivo com:

• Descrição do projeto: linguagem, framework, propósito
• Estrutura de pastas: mapeamento dos diretórios principais
• Convenções de código: padrões detectados automaticamente
• Comandos úteis: scripts de build, teste e deploy encontrados no package.json ou equivalente
• Dependências principais: bibliotecas e ferramentas identificadas

Personalizando o CLAUDE.md

O arquivo gerado é um ponto de partida. Você deve editá-lo para incluir informações que o Claude Code não consegue inferir sozinho:

# Convenções do time
- Usamos kebab-case para nomes de arquivos
- Componentes React sempre em TypeScript com extensão .tsx
- Testes ficam na mesma pasta do arquivo testado, com sufixo .test.ts
- Nunca use any — sempre defina tipos explícitos

Essas instruções persistem entre sessões. Toda vez que o Claude Code iniciar naquele projeto, ele lê o CLAUDE.md e segue as regras definidas ali.

Hierarquia de arquivos de configuração

O Claude Code suporta múltiplos níveis de CLAUDE.md:

Essa hierarquia permite que você tenha regras globais (como “sempre comente funções públicas”) que convivem com regras específicas de cada projeto.

Gerenciando contexto com comandos de memória

Um dos maiores desafios ao trabalhar com IA generativa é a perda de contexto. Você explica algo, a conversa fica longa, e de repente o modelo esquece o que foi combinado. O Claude Code resolve isso com um sistema de memória persistente.

O comando /memory

Digitar /memory abre um editor onde você pode adicionar, editar ou remover instruções que o Claude Code vai lembrar permanentemente para aquele projeto. Diferente do CLAUDE.md (que é compartilhado via repositório), as memórias criadas via /memory ficam armazenadas localmente.

Exemplos práticos de memórias úteis:

• “O banco de dados de produção usa PostgreSQL 15 com extensão pgvector”
• “A API segue o padrão REST com versionamento via URL (/api/v1/)”
• “O deploy é feito via GitHub Actions — nunca sugira configurações de CI/CD para outras plataformas”
• “O cliente prefere mensagens de erro em português nos formulários”

Memória de projeto vs. memória de usuário

Existem dois níveis de memória:

• Memória de projeto: salva no diretório .claude/ do projeto. Relevante apenas para aquele repositório.
• Memória de usuário: salva no diretório ~/.claude/ do seu sistema. Aplicada a todos os projetos.

Use a memória de usuário para preferências pessoais (“prefiro variáveis em camelCase”, “sempre use arrow functions”) e a memória de projeto para regras específicas daquele código.

Limpando contexto estrategicamente

Além do /clear (que limpa toda a conversa), você pode gerenciar o contexto de formas mais cirúrgicas:

• Mudar de assunto explicitamente: “Esqueça o que discutimos sobre o módulo de pagamentos. Agora vamos focar no sistema de notificações.”
• Usar /compact antes de tarefas pesadas: mantém o essencial e descarta detalhes de interações anteriores.
• Iniciar nova sessão: saia e entre novamente com claude para começar com contexto limpo mas com memórias preservadas.

Comandos para revisão e refatoração de código

Revisar e refatorar código são duas das tarefas que mais consomem tempo no dia a dia de desenvolvimento. O Claude Code oferece comandos específicos para acelerar ambas.

Revisão com /review

O comando /review analisa as mudanças recentes no seu código (geralmente baseado no diff do git) e fornece feedback detalhado sobre:

• Possíveis bugs ou edge cases não tratados
• Problemas de performance
• Violações de padrões do projeto
• Sugestões de melhoria de legibilidade
• Vulnerabilidades de segurança básicas

Isso é especialmente útil antes de abrir um pull request. Rode /review, corrija o que fizer sentido e envie o código com mais confiança.

Pedidos de refatoração em linguagem natural

Para refatoração, os comandos em linguagem natural são mais flexíveis que slash commands. Alguns exemplos que funcionam bem:

• “Refatore o arquivo userController.js para separar a lógica de negócio em um service”
• “Extraia as constantes mágicas desse arquivo para um arquivo de configuração”
• “Converta essa classe para usar o padrão de composição em vez de herança”
• “Simplifique essa cadeia de if/else usando early returns”

Combinando revisão com refatoração

Um fluxo de trabalho produtivo combina os dois:

1. Faça suas alterações normalmente
2. Rode /review para identificar problemas
3. Peça ao Claude Code para corrigir os problemas encontrados: “Corrija os issues apontados na revisão”
4. Rode /review novamente para confirmar que está tudo limpo
5. Commite com confiança

Tabela de comandos para qualidade de código

Fluxo de trabalho diário com Claude Code

Para consolidar tudo, aqui está uma sequência prática que integra os comandos cobertos neste artigo:

1. Abra o terminal na raiz do projeto e digite claude
2. Na primeira vez, rode /init para gerar o CLAUDE.md
3. Configure memórias com /memory para regras que não estão no CLAUDE.md
4. Trabalhe em linguagem natural descrevendo tarefas, criando arquivos, corrigindo bugs
5. Use /compact quando a sessão ficar longa
6. Monitore custos com /cost periodicamente
7. Revise com /review antes de cada commit
8. Limpe o contexto com /clear ao mudar de tarefa

Esse ciclo mantém suas sessões organizadas, seu código revisado e seus custos sob controle.

Artigos relacionados

• Claude Code – Guia Completo para Criar Projetos com IA
• Como Instalar e Configurar o Claude Code do Zero
• Claude Code Skills — Como Criar Comandos Personalizados
• Claude Code MCPs — Integre Ferramentas Externas

Bruno Bracaioli

Empreendedor e Desenvolvedor

Bruno Bracaioli é especialista em arquitetura de software, ciência de dados e cybersecurity. Além disso, investe em criptomoedas e em investimentos tradicionais como CDBs, Ações, Tesouro e outros. É influenciador digital no instagram (@brunobracaioli) e no Youtube (/brunobracaioli). Contato por: bruno@bracaiolitech.com ou pelo bruno@b2tech.com