10 Comandos Essenciais do Claude Code

Você instalou o Claude Code, abriu o terminal e agora está olhando para o cursor piscando. E agora?

Claude Code tem dois tipos de interação. Slash commands começam com / e executam ações específicas da ferramenta — gerenciar contexto, trocar modelos, verificar custos. Comandos em linguagem natural são tudo o mais — você descreve o que quer em português e a IA executa.

Este artigo cobre os 10 que você vai usar com mais frequência. Cada um com explicação, cenário prático e exemplo real. Salve esta página nos favoritos. Você vai voltar aqui.

1. /init — Crie o CLAUDE.md do seu projeto

O comando /init analisa a estrutura do seu projeto e gera automaticamente um arquivo CLAUDE.md na raiz. Esse arquivo é o contexto persistente — tudo que estiver nele será lido pelo Claude Code em toda sessão futura.

Quando usar

No início de qualquer projeto novo. Antes de pedir qualquer tarefa, rode /init. Um bom CLAUDE.md muda completamente a qualidade das respostas.

Exemplo

Usuário: /init

Claude Code vai ler os arquivos principais (package.json, estrutura de pastas, configurações) e gerar algo como:

# Meu Projeto

## Stack
- Next.js 15 + TypeScript
- Tailwind CSS
- PostgreSQL + Prisma

## Comandos
- `pnpm dev` — servidor de desenvolvimento
- `pnpm test` — testes com Vitest

## Convenções
- Componentes em PascalCase
- Arquivos em kebab-case

Esse é só o ponto de partida. Edite o arquivo depois para incluir regras específicas do seu projeto — padrões de código, decisões de arquitetura, qualquer coisa que a IA precisa saber.

A diferença entre usar Claude Code com e sem CLAUDE.md é brutal. Com o arquivo, a IA já sabe sua stack, seus padrões e seus comandos. Sem ele, cada sessão começa do zero.

2. /help — Veja tudo que está disponível

Perdido? Não sabe o que o Claude Code pode fazer? /help mostra a lista completa de slash commands disponíveis com uma breve descrição de cada um.

Quando usar

Sempre que esquecer o nome de um comando. Ou quando quiser descobrir se existe um comando para o que você precisa.

Exemplo

Usuário: /help

A saída lista todos os comandos disponíveis organizados por categoria. É a sua referência rápida sem sair do terminal.

Dica: o /help também mostra combinações de teclas e flags da linha de comando. Não é só sobre slash commands — é um mapa completo da ferramenta.

3. /clear — Limpe o contexto da conversa

/clear apaga todo o histórico da conversa atual. Claude Code esquece tudo que foi discutido e começa do zero — mas continua lendo o CLAUDE.md e os arquivos do projeto.

Quando usar

Entre tarefas não relacionadas. Se você acabou de implementar uma feature e agora vai corrigir um bug em outra parte do projeto, limpe o contexto. Isso evita que a IA misture informações e cometa erros por confusão de contexto.

Exemplo

Você acabou de criar um formulário de contato. Agora quer ajustar o layout da página de preços.

Usuário: /clear

Usuário: Ajuste o layout da página de preços para ficar responsivo em mobile

Claude Code começa a tarefa sem resquícios da conversa anterior. Foco total no que importa agora.

Uma regra prática: se a tarefa nova não tem relação com a anterior, use /clear. Se tem relação e você quer que a IA lembre do contexto, continue na mesma sessão ou use /compact.

4. /compact — Comprima o histórico sem perder o essencial

Conforme a conversa cresce, o contexto consome tokens. /compact comprime o histórico: mantém as decisões e informações importantes, remove a verbosidade.

Quando usar

Quando a conversa está longa e você percebe que as respostas começam a ficar lentas ou menos precisas. Também é útil antes de uma tarefa grande — comprimir libera espaço no contexto para a IA trabalhar melhor.

Você pode incluir instruções específicas sobre o que preservar:

Exemplo

Usuário: /compact mantenha as decisões de arquitetura e as mudanças nos arquivos de configuração

Claude Code reescreve o resumo da conversa preservando os pontos que você indicou. A conversa continua normalmente, mas ocupando menos espaço no contexto.

Na prática, /compact é o comando que você mais vai usar em sessões longas. Pense nele como "salvar o progresso" — a IA mantém o que importa e descarta o ruído.

5. /cost — Controle seus gastos

/cost mostra quanto você gastou na sessão atual. Exibe o número de tokens consumidos e o custo estimado em dólares.

Quando usar

Regularmente, especialmente se você está no plano de API com cobrança por uso. Tarefas que envolvem muitos arquivos ou conversas longas consomem mais tokens do que você imagina.

Exemplo

Usuário: /cost

Session cost: $0.47
Tokens used: ~125,000 (input: 98,000, output: 27,000)

Se o custo está alto, considere usar /compact para comprimir a conversa ou /clear para começar uma nova sessão.

Uma dica de economia: para quem está no plano Max com limites de uso, /cost ajuda a distribuir o consumo ao longo do dia. Para quem usa API com cobrança por token, é ainda mais relevante — uma sessão descuidada pode custar mais do que o necessário.

6. /model — Escolha o modelo certo para cada tarefa

/model permite trocar o modelo de IA durante a sessão. Cada modelo tem características diferentes: Sonnet é mais rápido e barato, Opus é mais capaz para tarefas complexas.

Quando usar

Tarefas simples como renomear variáveis, gerar boilerplate ou criar testes básicos? Sonnet resolve. Refatoração complexa, decisões de arquitetura ou debugging difícil? Opus vale o custo extra.

Saber alternar modelos é uma das formas mais eficazes de controlar custos sem perder qualidade.

Exemplo

Usuário: /model sonnet

Usuário: Crie testes unitários para as funções do arquivo utils/validation.ts

Depois, para uma tarefa mais complexa:

Usuário: /model opus

Usuário: Refatore o sistema de autenticação para suportar login social com Google e GitHub

7. Linguagem natural — O mais poderoso de todos

Este não é um slash command. É o modo padrão de usar Claude Code. Você descreve o que quer em português (ou inglês) e a IA executa: lê arquivos, escreve código, roda comandos, cria testes.

Quando usar

Para praticamente tudo. A maioria das suas interações com Claude Code será em linguagem natural. Os slash commands são ferramentas de apoio. O trabalho real acontece aqui.

Exemplos

Leitura e análise:

Usuário: Leia o README e me explique a estrutura do projeto

Criação de código:

Usuário: Crie um componente de card de preço com três tiers: básico, pro e enterprise. Use Tailwind CSS.

Correção de bugs:

Usuário: O teste do módulo de pagamento está falhando com "TypeError: Cannot read property 'id' of undefined". Investigue e corrija.

Refatoração:

Usuário: Mova toda a lógica de validação que está espalhada nos componentes para um arquivo centralizado em lib/validators.ts

A chave é ser específico. "Melhore o código" é vago. "Extraia a lógica de formatação de datas em uma função utilitária e adicione testes" é acionável.

Outra dica: você pode encadear pedidos. "Crie o componente, adicione testes unitários e atualize o arquivo de rotas para incluí-lo." Claude Code executa tudo em sequência, arquivo por arquivo.

8. claude --resume — Retome de onde parou

A flag --resume ao iniciar o Claude Code abre uma lista das suas conversas anteriores. Você seleciona uma e continua de onde parou, com todo o contexto preservado.

Quando usar

Quando você fecha o terminal (ou a sessão expira) no meio de uma tarefa. Ou quando precisa continuar um trabalho do dia anterior.

Exemplo

claude --resume

O Claude Code mostra as últimas sessões com um resumo de cada uma. Você navega com as setas e seleciona a que quer retomar.

Também é útil para revisitar decisões anteriores. "O que decidimos sobre a estrutura do banco de dados?" — basta retomar a sessão onde a discussão aconteceu.

Se você trabalha em vários projetos ao longo do dia, --resume vira essencial. Cada projeto tem suas sessões separadas, e você alterna entre elas sem perder o fio da meada.

9. /review — Code review instantâneo

/review pede para Claude Code analisar as mudanças no seu código. Ele lê os diffs (alterações) do Git e dá feedback sobre qualidade, bugs potenciais, padrões não seguidos e melhorias possíveis.

Quando usar

Antes de fazer um commit ou abrir um pull request. É como ter um colega de equipe revisando seu código instantaneamente. Não substitui code review humano em projetos sérios, mas pega 80% dos problemas.

Exemplo

Usuário: /review

Claude Code analisa os arquivos modificados e retorna algo como:

## Revisão das mudanças

### src/lib/auth.ts
- Linha 42: A senha não está sendo hasheada antes de salvar.
  Sugestão: use bcrypt.hash() antes de persistir no banco.

- Linha 67: O token JWT não tem expiração definida.
  Sugestão: adicione expiresIn: '7d' nas opções do jwt.sign().

### src/components/login-form.tsx
- O formulário não mostra mensagem de erro quando o login falha.
  O estado de erro é setado mas não renderizado no JSX.

Corrija os problemas apontados e rode /review novamente. Itere até estar limpo.

Para quem trabalha sozinho, /review é particularmente valioso. Empreendedores e freelancers não têm equipe para revisar código. A IA não substitui um dev sênior, mas é infinitamente melhor do que nenhuma revisão.

10. /memory — Memória persistente entre sessões

/memory permite gerenciar a memória persistente do Claude Code — informações que ele lembra entre sessões. Isso inclui preferências suas, padrões de trabalho e notas que você quer que ele sempre considere.

Quando usar

Quando quiser que Claude Code lembre de algo permanentemente. Por exemplo: que você prefere testes com Vitest em vez de Jest, que seu estilo de commit segue Conventional Commits, ou que você trabalha com monorepo.

Exemplo

Usuário: /memory

Claude Code mostra as memórias salvas e permite adicionar, editar ou remover entradas. Essas informações ficam disponíveis em todas as sessões futuras, em qualquer projeto.

A diferença entre /memory e CLAUDE.md: o CLAUDE.md é contexto do projeto (específico). A memória é contexto pessoal (global, segue você entre projetos).

Exemplo prático: se você sempre quer que o Claude Code responda em português, salve isso na memória. Se quer que um projeto específico use Tailwind v4, coloque no CLAUDE.md do projeto.

Bônus: Atalhos essenciais

Além dos 10 comandos acima, três atalhos são indispensáveis no dia a dia:

Escape — Cancela a geração atual. A IA começou a responder algo errado? Aperte Escape e reformule seu pedido. Você não perde o histórico da conversa.

Ctrl+C — Encerra o Claude Code. Diferente do Escape, que só cancela a resposta, Ctrl+C sai da ferramenta completamente.

Sistema de permissões — Claude Code pede confirmação antes de executar ações que alteram arquivos ou rodam comandos. Leia o que ele está prestes a fazer antes de aprovar. Você pode configurar regras de permissão no CLAUDE.md ou nas configurações. No começo, revise cada permissão manualmente. Conforme ganhar confiança na ferramenta, ajuste as regras para acelerar o fluxo.

Referência Rápida

Comando	O que faz	Quando usar
`/init`	Gera CLAUDE.md a partir do projeto	Início de projeto novo
`/help`	Lista todos os comandos	Quando estiver perdido
`/clear`	Limpa o histórico da conversa	Entre tarefas não relacionadas
`/compact`	Comprime o histórico	Conversa longa ou antes de tarefa grande
`/cost`	Mostra gastos da sessão	Para controle de orçamento
`/model`	Troca o modelo de IA	Ajustar custo vs. capacidade
Linguagem natural	Descreve a tarefa em texto livre	Para quase tudo
`claude --resume`	Retoma sessão anterior	Continuar trabalho interrompido
`/review`	Revisa mudanças no código	Antes de commit ou PR
`/memory`	Gerencia memória persistente	Salvar preferências globais

Próximos Passos

Agora que você conhece os comandos essenciais, dois artigos complementam seu aprendizado:

O que é CLAUDE.md e por que é essencial — Domine o arquivo que mais impacta a qualidade das respostas do Claude Code.
Seu primeiro app com Claude Code — Coloque esses comandos em prática construindo algo real do zero.

E se quiser o guia completo, seção por seção, o Claude Code Guide cobre tudo — da instalação ao deploy.

Referências

Slash commands — Claude Code Docs — Referência oficial de slash commands
CLI reference — Claude Code Docs — Referência completa da CLI do Claude Code
How Claude remembers your project — Claude Code Docs — Documentação sobre CLAUDE.md e /init

10 Comandos Essenciais do Claude Code para Começar Hoje