Por que conhecer os comandos nativos
A maioria dos devs que comeca a usar o Claude Code faz a mesma coisa: abre o terminal, digita claude e comeca a conversar em linguagem natural. Funciona. Mas e como usar o VS Code sem conhecer nenhum atalho de teclado -- voce consegue trabalhar, mas esta usando 30% do potencial.
O Claude Code tem um conjunto de comandos nativos (acessiveis com /) que controlam comportamento, otimizam performance, reduzem custos e automatizam workflows. Conhece-los e a diferenca entre usar o Claude Code como um chatbot e usar como uma ferramenta profissional de desenvolvimento.
Neste guia, vamos cobrir os 10 comandos mais uteis -- com explicacao do que fazem, quando usar e exemplos praticos com output real. No final, voce vai aprender a criar seus proprios comandos customizados.
Exibe a lista completa de comandos disponiveis, incluindo slash commands customizados do projeto.
Quando usar: Sempre que esquecer um comando ou quiser ver quais slash commands customizados estao disponiveis no projeto atual.
claude > /help Available commands: /help Show this help message /clear Clear conversation history /compact Compact conversation context /cost Show token usage and cost /doctor Check Claude Code health /init Initialize project with CLAUDE.md /config Open configuration /review Review code changes /pr-comments Show PR comments /login Authenticate with Anthropic /logout Sign out /quit Exit Claude Code Project commands: /deploy Custom: deploy to production /test-all Custom: run full test suite
Note que no output acima, os dois ultimos comandos (/deploy e /test-all) sao slash commands customizados -- criados especificamente para aquele projeto. Vamos falar mais sobre isso no comando 10.
Cria (ou atualiza) o arquivo CLAUDE.md na raiz do projeto. Esse arquivo funciona como um "manual de instrucoes" que o Claude Code le automaticamente ao iniciar uma sessao no diretorio.
Quando usar: Na primeira vez que usar Claude Code em um projeto. Tambem quando quiser atualizar as instrucoes do projeto (ex: mudar padroes de codigo, adicionar regras).
claude > /init I'll analyze your project structure and create a CLAUDE.md file. Analyzing... - Detected: TypeScript + React project - Package manager: pnpm - Test framework: Vitest - Linting: ESLint + Prettier Created CLAUDE.md with: - Project overview and architecture - Code style guidelines - Test conventions - Build and deploy commands
O CLAUDE.md e um dos recursos mais poderosos do Claude Code. Ele permite que voce defina regras persistentes: "sempre use aspas simples", "testes devem estar em __tests__/", "nunca use any em TypeScript". O Claude segue essas instrucoes em todas as interacoes dentro daquele projeto.
Voce pode editar o CLAUDE.md manualmente a qualquer momento. Pense nele como o .editorconfig do Claude Code -- mas muito mais poderoso, porque aceita instrucoes em linguagem natural.
Diagnostica problemas de configuracao e ambiente. Verifica autenticacao, versao, conexao com API e permissoes.
Quando usar: Quando algo nao esta funcionando como esperado. Erro de autenticacao, respostas lentas, comportamento inesperado.
claude > /doctor Claude Code Diagnostics ======================= Version: 1.0.12 (latest) Authentication: OK (API key valid) Model access: claude-sonnet-4 (default) claude-opus-4 (available) Connection: OK (latency: 142ms) Node.js: v22.4.0 OS: macOS 15.3 Shell: /bin/zsh Project: /Users/dev/my-app CLAUDE.md: Found (1.2KB) Permissions: Read/Write/Execute OK All checks passed.
O /doctor e o primeiro comando a rodar quando algo da errado. Ele identifica rapidamente se o problema e de autenticacao, rede, versao ou configuracao -- economizando tempo de debug manual.
Mostra o consumo de tokens e o custo estimado da sessao atual. Essencial para quem usa via API e quer controlar gastos.
Quando usar: Periodicamente durante sessoes longas. Especialmente antes de pedir tarefas que envolvem muitos arquivos (refatoracao de projeto inteiro, por exemplo).
claude > /cost Session Cost Summary ==================== Messages: 14 Input tokens: 48,230 Output tokens: 12,845 Cache read: 125,400 Cache write: 48,230 Estimated cost: $0.42 Model: claude-sonnet-4
Duas dicas importantes sobre custo:
- Cache tokens sao significativamente mais baratos que tokens normais. O Claude Code usa cache agressivamente -- por isso a segunda pergunta sobre o mesmo codigo e mais barata que a primeira.
- Use Sonnet para tarefas rotineiras e mude para Opus apenas quando precisar de raciocinio mais profundo. A diferenca de custo e substancial.
Compacta o historico da conversa, resumindo mensagens anteriores para liberar espaco na janela de contexto. Mantem o essencial e descarta detalhes redundantes.
Quando usar: Quando a conversa esta longa e voce percebe que o Claude esta "esquecendo" instrucoes anteriores, ou quando quer reduzir custo em sessoes extensas.
claude > /compact Compacting conversation... Before: 156,240 tokens After: 34,520 tokens (78% reduction) Summary preserved: - Project context and CLAUDE.md rules - Key decisions made in this session - Current task state and progress - File modifications tracking
O /compact e um dos comandos mais subestimados. Em sessoes longas de desenvolvimento (2+ horas), a janela de contexto vai enchendo e o custo por mensagem aumenta. Compactar periodicamente mantem a qualidade das respostas e reduz custos.
Voce tambem pode passar uma instrucao junto: /compact foque nas decisoes de arquitetura e ignore os detalhes de CSS -- assim o resumo prioriza o que importa para a proxima etapa do trabalho.
Quer dominar isso mais rapido?
Tudo que voce esta aprendendo aqui fica 10x mais poderoso com skills prontas. Em vez de digitar comandos manualmente, as skills fazem o trabalho pesado por voce. 748+ skills profissionais, instala em 2 minutos.
Quero as Skills — R$19Limpa completamente o historico da conversa, comecando do zero. Diferente do /compact, nao preserva nenhum resumo.
Quando usar: Quando voce termina uma tarefa e quer comecar outra completamente diferente no mesmo projeto. Ou quando o contexto da conversa ficou "poluido" com informacoes irrelevantes.
claude > /clear Conversation cleared. Note: CLAUDE.md and project context will be reloaded on your next message.
A diferenca entre /compact e /clear e importante:
/compact= "resuma o que fizemos ate agora" (mantem contexto)/clear= "esqueca tudo, comece do zero" (reinicia a conversa)
Use /clear entre tarefas diferentes. Use /compact no meio de uma tarefa longa.
Pede ao Claude para revisar as mudancas de codigo pendentes (staged e unstaged no git). Funciona como um code review automatizado.
Quando usar: Antes de fazer commit. Antes de abrir um PR. Sempre que quiser uma segunda opiniao sobre as mudancas que fez.
claude > /review Reviewing changes in 4 files... src/auth/jwt.ts Line 23: Potential security issue - token expiry is set to 30 days. Consider reducing to 24h for access tokens and using refresh tokens. Line 45: Good - proper error handling for invalid tokens. src/auth/middleware.ts Line 12: The catch block swallows the error silently. Add logging or re-throw. src/tests/auth.test.ts Line 8-34: Tests cover happy path but missing: - Expired token test - Malformed token test - Missing header test Summary: 2 issues, 1 suggestion, 1 missing test coverage area.
O /review e poderoso porque o Claude tem acesso ao contexto completo do projeto, nao apenas ao diff. Ele sabe quais padroes voce segue (via CLAUDE.md), entende a arquitetura e pode identificar problemas que um reviewer humano apressado deixaria passar.
Busca e exibe comentarios de pull requests do GitHub. Util para entender feedback de reviewers e endereca-los sem sair do terminal.
Quando usar: Quando receber comentarios em um PR e quiser resolver tudo via Claude Code, sem alternar entre browser e terminal.
claude > /pr-comments PR #142: Add JWT authentication module Comments (3): @senior-dev (2h ago) on src/auth/jwt.ts:23 "Should we use asymmetric keys (RS256) instead of symmetric (HS256) for better security?" @tech-lead (1h ago) on src/auth/middleware.ts:12 "Add structured logging here. We use pino." @qa-engineer (30m ago) general "Can you add integration tests with the actual auth flow?"
Depois de ver os comentarios, voce pode pedir ao Claude para resolve-los diretamente: "Endereca todos os comentarios do PR #142". Ele vai modificar os arquivos, adicionar testes e voce so precisa revisar e fazer push.
Abre as configuracoes do Claude Code. Permite ajustar modelo padrao, permissoes de ferramentas, e preferencias de comportamento.
Quando usar: Para trocar o modelo padrao (Sonnet vs Opus), ajustar permissoes de execucao de comandos, ou configurar preferencias globais.
claude > /config Claude Code Configuration ========================= Model: claude-sonnet-4 (default) Theme: dark Auto-compact: after 100K tokens Notification sound: enabled Tool permissions: File read: always allow File write: ask first Shell commands: ask first Git operations: always allow Open settings.json to edit? (y/n)
Uma configuracao importante: permissoes de ferramentas. Por padrao, o Claude Code pede confirmacao antes de escrever arquivos ou executar comandos shell. Voce pode configurar para sempre permitir (confianca total) ou sempre perguntar (maximo controle). Ajuste conforme seu nivel de conforto.
O recurso mais poderoso e menos conhecido: voce pode criar seus proprios comandos adicionando arquivos Markdown na pasta .claude/commands/ do projeto.
Quando usar: Para qualquer tarefa que voce repete frequentemente. Deploy, geracaco de componentes, auditorias, padroes de codigo, workflows especificos da equipe.
# Estrutura de arquivos: .claude/ commands/ deploy.md -> /deploy test-all.md -> /test-all new-component.md -> /new-component audit-security.md -> /audit-security # Conteudo de .claude/commands/deploy.md: Execute o seguinte workflow de deploy: 1. Rode os testes: npm test 2. Se todos passarem, faca build: npm run build 3. Deploy para produdacao: npm run deploy 4. Verifique se o health check responde 200 5. Reporte o status final # Uso: claude > /deploy Executando workflow de deploy... [roda testes - 47 passed] [build - success] [deploy - success] [health check - 200 OK] Deploy concluido com sucesso.
Cada arquivo .md na pasta .claude/commands/ vira um slash command. O nome do arquivo (sem extensao) e o nome do comando. O conteudo do arquivo sao as instrucoes que o Claude vai seguir.
E aqui que o conceito de skills se torna transformador. Em vez de criar comandos genericos, voce pode ter instrucoes profissionais escritas por especialistas que cobrem:
- Contexto completo da area (regras, boas praticas, armadilhas comuns)
- Templates e estruturas pre-definidas
- Workflows passo a passo com validacao
- Criterios de qualidade e checklist
Por exemplo, uma skill de "SEO Audit" nao e apenas "analise o SEO da pagina". Ela contem as 50+ verificacoes que um especialista em SEO faria, os criterios de pontuacao, o formato do relatorio e as recomendacoes priorizadas por impacto.
Criar skills do zero demanda horas de pesquisa e iteracao. Ou voce pode usar skills profissionais prontas -- escritas, testadas e otimizadas para resultados reais.
Dica bonus: flags de linha de comando
Alem dos slash commands (usados dentro da sessao interativa), o Claude Code aceita flags na linha de comando ao ser iniciado:
# Executar um comando unico sem sessao interativa $ claude -p "explica o que esse projeto faz" # Usar um modelo especifico $ claude --model claude-opus-4 # Pipe de entrada (stdin) $ cat error.log | claude -p "analisa esse log e sugere fix" # Continuar ultima conversa $ claude --continue # Retomar uma sessao especifica $ claude --resume
A flag -p (print) e especialmente util para integrar o Claude Code em scripts e pipelines de CI/CD. Voce pode criar scripts que usam o Claude para revisar codigo automaticamente em cada push, por exemplo.
A flag --continue retoma a ultima conversa de onde parou -- perfeito quando voce fecha o terminal sem querer ou precisa continuar uma tarefa no dia seguinte.
Proximo passo: instale skills e veja a diferenca
Voce ja sabe o basico. Agora imagine o Claude Code sabendo fazer tudo isso sozinho — SEO, copywriting, code review, deploy, analise de dados. E isso que as skills fazem. Acesso vitalicio, atualizacoes incluidas.
Ver o Mega Bundle — R$19Perguntas frequentes
Os essenciais para o dia a dia sao: /init (configurar projeto), /compact (gerenciar contexto), /cost (monitorar gastos), /review (code review automatico) e slash commands customizados para tarefas repetitivas. O /doctor e indispensavel quando algo da errado.
Crie a pasta .claude/commands/ na raiz do projeto. Cada arquivo Markdown (.md) nessa pasta vira um slash command. O nome do arquivo e o nome do comando (ex: deploy.md vira /deploy). O conteudo do arquivo sao as instrucoes que o Claude segue ao executar o comando.
Mostra tokens de entrada (input), tokens de saida (output), tokens de cache (read e write) e o custo estimado em dolares da sessao atual. Os valores sao baseados nos precos da API da Anthropic. Util para quem usa via API e quer controlar gastos -- especialmente em sessoes longas de refatoracao.