📝 /commit - Commits inteligentes com IA
O comando /commit analisa todas as mudancas staged no git, entende o proposito semantico das alteracoes e gera uma mensagem de commit clara, estruturada e informativa - tudo automaticamente. Acabou a era de commits como "fix stuff" ou "update files".
🎯 Conceito Principal
Quando voce roda /commit, o Claude Code faz um git diff --staged interno, analisa cada mudanca e gera uma mensagem seguindo Conventional Commits (feat, fix, refactor, docs, etc). Voce aprova, edita ou rejeita antes de confirmar.
- • Analise semantica: O Claude nao olha so os arquivos modificados - ele entende o que a mudanca faz. Renomear uma variavel gera "refactor:", corrigir um bug gera "fix:", adicionar funcionalidade gera "feat:"
- • Mensagem estruturada: Titulo conciso na primeira linha (max 72 caracteres), corpo explicativo com contexto, e opcionalmente lista de arquivos afetados
- • Aprovacao obrigatoria: O Claude mostra a mensagem proposta e espera seu OK. Voce pode aceitar, editar manualmente ou pedir para regenerar com instrucoes diferentes
- • Git add automatico: Se voce nao fez stage das mudancas, o Claude pergunta se deve adicionar automaticamente. Ele mostra quais arquivos serao incluidos
💻 Exemplo no Terminal
💡 Dica Pratica
Para melhores resultados, faca commits atomicos - commits pequenos e focados em uma unica mudanca. Se voce modificou 15 arquivos para 3 tarefas diferentes, o /commit vai gerar uma mensagem generica. Prefira fazer 3 commits separados.
Voce tambem pode dar contexto extra: /commit isso corrige o bug #142 do Jira e o Claude vai incluir a referencia na mensagem.
🔍 /review - Code review automatizado
O /review faz o Claude Code analisar as mudancas pendentes no seu repositorio como se fosse um code reviewer senior. Ele identifica bugs potenciais, problemas de seguranca, violacoes de padroes e sugere melhorias - tudo antes de voce abrir o PR.
🎯 Conceito Principal
O /review examina o diff das mudancas nao commitadas (ou do ultimo commit, dependendo do contexto) e gera um relatorio estruturado de review com categorias de severidade, explicacoes e sugestoes de correcao.
- • Niveis de severidade: Cada issue encontrado e classificado como Critical (bugs graves, vulnerabilidades), Warning (problemas potenciais, code smells) ou Suggestion (melhorias opcionais, estilo)
- • Contexto completo: O Claude nao analisa so o diff isolado - ele le os arquivos relacionados para entender se a mudanca e consistente com o resto do codebase
- • Categorias de analise: Bugs logicos, vulnerabilidades de seguranca, performance, tratamento de erros, tipagem, convencoes de nomes e documentacao ausente
- • Sugestoes acionaveis: Cada problema vem com uma sugestao concreta de como corrigir, incluindo trechos de codigo quando relevante
💻 Exemplo de Saida do /review
💡 Dica Pratica
Rode /review antes de cada /commit. E como ter um reviewer disponivel 24/7 que nunca reclama de ser chamado as 3 da manha. Corrigir problemas antes do commit e infinitamente mais barato do que corrigir depois do deploy.
Para reviews mais direcionados, adicione contexto: /review foque em seguranca e performance e o Claude vai priorizar essas categorias na analise.
🔀 /pr - Pull requests completos
O /pr cria um pull request completo no GitHub (ou GitLab) diretamente do terminal. O Claude analisa todos os commits da branch, gera um titulo descritivo e um corpo detalhado com resumo das mudancas, motivacao e instrucoes de teste.
🎯 Conceito Principal
O /pr usa a CLI do GitHub (gh) por baixo dos panos. Ele analisa o diff completo entre sua branch e a main, entende o proposito global das mudancas e gera um PR profissional que facilita o trabalho dos revisores.
- • Titulo inteligente: Gerado automaticamente a partir do conjunto de mudancas, seguindo convencoes do projeto. Curto, claro e descritivo
- • Corpo estruturado: Inclui resumo das mudancas, motivacao/contexto, lista de arquivos modificados e instrucoes de teste quando relevante
-
•
Integracao GitHub: Requer o
ghCLI instalado e autenticado. O PR e criado diretamente no repositorio remoto - • Review pre-PR: O Claude automaticamente faz um /review antes de criar o PR, avisando se ha problemas que deveriam ser corrigidos primeiro
💻 Exemplo no Terminal
💡 Dica Pratica
Antes de usar /pr, certifique-se de que o gh CLI esta instalado e autenticado (gh auth status). Sem ele, o Claude nao consegue criar o PR no GitHub.
Para PRs com contexto adicional, use: /pr esta mudanca resolve o issue #42 e precisa de review de seguranca. O Claude vai incluir essas informacoes no corpo do PR e linkar o issue automaticamente.
🏗️ /init - Gerando CLAUDE.md automaticamente
O /init e o comando que gera automaticamente o arquivo CLAUDE.md - o "manual de instrucoes" que o Claude Code le no inicio de cada sessao para entender seu projeto. E o ponto de partida para customizar como o Claude interage com seu codebase.
🎯 Conceito Principal
O /init escaneia seu projeto inteiro - estrutura de pastas, package.json, configuracoes, README, testes - e gera um CLAUDE.md sob medida que descreve o projeto, suas convencoes, comandos uteis e regras que o Claude deve seguir.
- • Scan automatico: O Claude le a estrutura do projeto, identifica frameworks (React, Next.js, Django, Rails), detecta ferramentas de lint, test e build, e gera instrucoes baseadas no que encontra
- • Conteudo gerado: Descricao do projeto, stack tecnologica, comandos de desenvolvimento (build, test, lint), convencoes de codigo e padroes de commit
- • Arquivo editavel: O CLAUDE.md gerado e um ponto de partida. Voce deve edita-lo para adicionar regras especificas, preferencias da equipe e informacoes que o scan nao captura
- • Impacto na sessao: Toda vez que voce abre o Claude Code numa pasta com CLAUDE.md, ele le esse arquivo primeiro. E como dar um briefing ao Claude antes de comecar o trabalho
💻 Exemplo no Terminal
💡 Dica Pratica
Rode /init uma vez para gerar a base, depois edite manualmente para adicionar regras criticas como: "nunca delete migrations", "use Zustand em vez de Redux", "testes devem cobrir pelo menos 80%". O CLAUDE.md gerado automaticamente e bom, mas o editado por voce e excelente.
Voce vai aprender tudo sobre CLAUDE.md na Trilha 2 deste curso. O /init e so o ponto de entrada.
🩺 /doctor - Diagnostico de problemas
O /doctor e o comando de troubleshooting do Claude Code. Quando algo nao funciona como esperado - um MCP nao conecta, permissoes estao erradas ou o ambiente esta mal configurado - o /doctor diagnostica e sugere a solucao.
🎯 Conceito Principal
O /doctor executa uma serie de checagens automaticas no ambiente: verifica a autenticacao, testa conexoes MCP, valida configuracoes e identifica conflitos. E como um "check-up" completo da sua instalacao do Claude Code.
- • Autenticacao: Verifica se o token de acesso esta valido, se a conta esta ativa e se o plano suporta as funcionalidades que voce esta tentando usar
- • MCP servers: Testa cada MCP configurado: ele esta rodando? Responde? As ferramentas estao acessiveis? Se algum MCP falhou, mostra o erro especifico
- • Configuracoes: Valida o settings.json, o CLAUDE.md e as permissoes do projeto. Aponta conflitos como tools bloqueadas que voce esta tentando usar
- • Ambiente: Checa versao do Node.js, versao do Claude Code, versao do git, e se ferramentas auxiliares como gh CLI estao disponiveis
💻 Exemplo no Terminal
💡 Dica Pratica
Sempre que encontrar um comportamento inesperado, a primeira coisa a fazer e rodar /doctor. Em 80% dos casos, o problema e um MCP desconectado ou uma configuracao errada que o /doctor identifica em segundos.
Rode /doctor tambem apos atualizar o Claude Code ou apos instalar novos MCPs. E a forma mais rapida de confirmar que tudo esta funcionando corretamente.
🔄 Fluxo completo: do codigo ao PR
Agora que voce conhece cada comando individualmente, vamos montar o workflow completo que leva do codigo escrito ate o pull request aberto no GitHub. Este e o fluxo que desenvolvedores profissionais usam diariamente com Claude Code.
🎯 Conceito Principal
O ciclo completo de entrega com Claude Code segue uma sequencia logica: codigo → review → commit → PR. Cada slash command se encaixa perfeitamente nesse pipeline, formando um fluxo continuo do terminal ate o GitHub.
- • Passo 1 - Desenvolver: Peca ao Claude para implementar a feature ou corrigir o bug. Ele edita os arquivos necessarios com diffs visuais para sua aprovacao
- • Passo 2 - /review: Revise as mudancas antes de commitar. Corrija qualquer issue critico ou warning relevante identificado pelo review
- • Passo 3 - /commit: Gere um commit com mensagem semantica. Para mudancas grandes, faca commits atomicos por funcionalidade
- • Passo 4 - /pr: Crie o pull request com descricao completa. O Claude inclui tudo que um reviewer precisa para avaliar o PR
💻 Workflow Completo no Terminal
✓ O que FAZER
- ✓ Sempre rodar /review antes de /commit
- ✓ Corrigir issues criticos antes de commitar
- ✓ Ler a mensagem do commit antes de aprovar
✗ O que NAO fazer
- ✗ Pular o /review e commitar diretamente
- ✗ Fazer commits gigantes com 20+ arquivos mudados
- ✗ Criar PR sem verificar se os testes passam
💡 Dica Pratica
O workflow /review → /commit → /pr pode ser executado em menos de 2 minutos. Compare com o processo manual: escrever mensagem de commit, abrir o navegador, criar o PR, escrever a descricao, adicionar reviewers. O Claude Code automatiza tudo isso.
Para projetos com CI/CD, o /pr tambem pode verificar se os checks passaram antes de criar o pull request, evitando PRs com pipeline quebrada.
🏋️ Exercicio Pratico
Neste exercicio, voce vai executar o fluxo completo: /commit, /review e /pr num repositorio de teste. Voce vai experimentar na pratica como esses comandos se integram para acelerar seu workflow de desenvolvimento.
Exercicio: Do Codigo ao Pull Request
Tempo estimado: 15-20 minutos
Criar um repositorio de teste
Crie um repo local com um arquivo simples para praticar:
$ git init && echo "# Teste" > README.md && git add . && git commit -m "init"
Abrir Claude Code e gerar codigo
Peca ao Claude para criar um arquivo com alguma funcionalidade:
> Crie um arquivo utils.js com funcoes de validacao de email e CPF
Executar /review nas mudancas
Revise o codigo gerado antes de commitar:
Observe as categorias de severidade e as sugestoes.
Executar /commit
Gere um commit com mensagem inteligente:
Leia a mensagem proposta. Aceite ou edite conforme necessario.
Rodar /init para gerar CLAUDE.md
Gere a configuracao do projeto:
Leia o CLAUDE.md gerado e note o que o Claude identificou automaticamente.
Diagnosticar com /doctor
Verifique se tudo esta funcionando corretamente:
Todos os checks devem estar verdes. Se algum falhar, siga a sugestao para corrigir.
✅ Criterios de Sucesso
📋 Resumo do Modulo
Proximo Modulo:
1.4 - Flags de Linha de Comando (-p, --model, --resume, --allowedTools, --output-format)