Guia Claude Code - Tudo o que você precisa para o Vibe Coding

Guia Claude Code - Tudo o que você precisa para o Vibe Coding

Claude Code é um assistente de IA focado no terminal, projetado para se integrar ao seu fluxo de trabalho de desenvolvedor existente - não para substituí-lo. Ele lê sua codebase, executa comandos, escreve e edita arquivos, pesquisa na web e até lança subagentes para tarefas complexas. Assim que você entende como ele pensa, ele se torna um verdadeiro multiplicador de produtividade.

Instalação e primeiro uso

Instale uma vez, globalmente:

npm install -g @anthropic-ai/claude-code

Depois é só digitar claude em qualquer pasta de projeto.

Vibe-code de qualquer lugar - instale o Claude Code em um servidor remoto e conecte via SSH de qualquer dispositivo. Sem consumo de bateria, sem limites de recursos locais, sessões persistentes o dia todo. Peça um servidor cloud na DCXV e estará pronto em minutos.

Para uso remoto, combine com tmux para que sua sessão do Claude sobreviva a desconexões:

# Instalar tmux (Debian/Ubuntu)
apt install tmux

# Iniciar uma sessão nomeada
tmux new -s claude

# Desconectar - a sessão continua rodando
# Pressione: Ctrl+B, depois D

# Reconectar de qualquer dispositivo
tmux attach -t claude

# Listar sessões ativas
tmux ls

# Encerrar uma sessão
tmux kill-session -t claude

Configuração inicial

Alguns comandos slash que facilitam a vida desde o primeiro dia:

• /permissions → Escolha quais ferramentas o Claude pode usar sem pedir confirmação (Git, Bash, operações de arquivo, etc.)
• /terminal-setup → Ativa Shift+Enter para prompts de múltiplas linhas - muito recomendado
• /theme → Escolha um esquema de cores (escuro, claro ou Daltonize para daltonismo)
• /install-github-app → Conecte ao GitHub para marcar @claude em issues e PRs
• /config → Configurações gerais, incluindo notificações
• /memory → Ver e editar o que o Claude memorizou entre sessões
• /model → Trocar entre modelos do Claude durante a sessão
• /usage → Mostrar uso de tokens e custo estimado da sessão atual
• /clear → Limpar o contexto da sessão atual e começar do zero
• /review → Solicitar uma revisão de código das últimas alterações

No macOS, ativar a ditação do sistema permite falar prompts longos em vez de digitá-los.

Q&A de codebase - por onde começar

A maneira mais fácil de obter valor desde o primeiro dia é fazer perguntas sobre sua codebase. O Claude explora o código localmente - sem uploads, sem limitações artificiais de contexto.

Prompts que funcionam bem:

- "Como @RoutingController.py é usado?"
- "Como adicionar um novo @app/services/ValidationTemplateFactory?"
- "Por que recoverFromException recebe tantos argumentos? Verifique o histórico do git."
- "Por que corrigimos o issue #18383 com aquele if/else em @src/login.ts?"
- "O que eu entregue na semana passada?" - Claude vai escanear seu git log
- "Explique em termos simples o que @src/auth/ faz."
- "Encontre todos os lugares onde chamamos a API de pagamentos."
- "Quais arquivos mudaram mais nos últimos 30 dias?"
- "Quais dependências em @package.json podem estar desatualizadas?"

Comece com Q&A para calibrar o que o Claude entende imediatamente e onde precisa de mais contexto seu.

Ferramentas integradas

Claude Code vem com cerca de uma dúzia de ferramentas:

• Bash - executar qualquer comando shell
• Busca, listagem, leitura e escrita de arquivos - acesso completo ao sistema de arquivos
• Web fetch e busca - buscar documentação externa ou resultados de pesquisa
• TODOs - acompanhamento leve de tarefas
• Subagentes - delegar trabalho complexo de múltiplas etapas a agentes paralelos

Dica: ensine ao Claude as ferramentas CLI personalizadas da sua equipe. Por exemplo:

Use o CLI barley para verificar os logs de erro do último treinamento. Use -h se não tiver certeza sobre os flags.

Prompts práticos de edição

- "Proponha algumas correções para o issue #8732 e implemente a que eu escolher."
- "Encontre casos extremos não cobertos em @app/tests/signupTest.ts e atualize os testes. pense bem."
- "commit, push, pr" - Claude aprende essa abreviação para o fluxo de trabalho git padrão
- "Use 3 agentes paralelos para brainstorming de como limpar @services/aggregator/feed_service.cpp."
- "Refatore @src/utils.js para reduzir duplicação. Não mude a API pública."
- "Adicione comentários JSDoc a todas as funções exportadas em @src/api.ts."
- "Execute os testes e corrija quaisquer falhas que encontrar."
- "Veja o erro nos logs abaixo e encontre a causa raiz." - depois cole os logs

Padrões de fluxo de trabalho

Tarefas diferentes se beneficiam de abordagens diferentes:

• Explorar → Planejar → Confirmar → Codificar → Commitar - para mudanças complexas com supervisão antes de escrever qualquer coisa
• Escrever testes → Commitar → Codificar → Iterar → Commitar - abordagem TDD que ancora ao comportamento esperado
• Escrever código → Captura de tela → Iterar - para desenvolvimento de UI com Puppeteer ou simulador

Arquivos de contexto (CLAUDE.md)

Quanto mais contexto o Claude tiver, melhor ele performa. Os arquivos CLAUDE.md são lidos automaticamente na inicialização - sem precisar re-explicar o projeto a cada sessão.

Quatro locais possíveis:

- /<enterprise-root>/CLAUDE.md    - políticas de toda a organização
- ~/.claude/CLAUDE.md             - contexto global pessoal
- <project-root>/CLAUDE.md        - específico do projeto, commitado no Git
- <project-root>/CLAUDE.local.md  - substituições locais, não commitadas

Mantenha seu CLAUDE.md conciso. Um arquivo inflado torna o Claude mais lento e dilui o sinal.

Atalhos de teclado

• Shift+Tab - aceitar automaticamente as edições de arquivos (comandos Bash ainda precisam de aprovação manual)
• # - salvar uma memória no CLAUDE.md correspondente
• ! - modo Bash; o comando e sua saída vão para o contexto
• @ - adicionar um arquivo ou pasta à sessão atual
• Esc - cancelar a operação atual
• Double-Esc - voltar no histórico (combine com --resume para continuar uma sessão)
• Ctrl+R - saída detalhada: mostra o raciocínio do Claude e as ferramentas que ele considera

Scripting com o SDK

Para automação, pipelines de CI ou trabalhos não interativos:

claude -p "o que eu fiz essa semana?" \
  --allowedTools Bash(git log:*) \
  --output-format json

Também compatível com pipes Unix:

git status | claude -p "resume minhas mudanças" --output-format=json | jq '.result'

Flags de CLI úteis:

--max-turns N        - limitar o número de etapas agênticas
--continue           - retomar de onde a última sessão parou
--resume <session-id>  - retomar uma sessão passada específica
--no-cache           - desativar o cache de prompts, útil para benchmarking

Múltiplas sessões em paralelo

Usuários avançados rodam várias instâncias do Claude simultaneamente:

• Várias abas do terminal com checkouts separados do repositório
• Git worktrees - um único checkout, múltiplos branches de trabalho
• SSH + tmux para configurações remotas multi-instância
• GitHub Actions para lançar jobs do Claude em paralelo em pipelines CI

Resumo

Claude Code recompensa o investimento. Quanto mais você configurar (CLAUDE.md, ferramentas permitidas, comandos slash), menos atrito haverá por tarefa. Comece com Q&A de codebase, construa seus arquivos de contexto, aprenda os atalhos de teclado e eventualmente integre ao CI - esse é o arco completo do iniciante ao power user.

Dúvidas sobre ferramentas de IA para sua infraestrutura? Escreva para sales@dcxv.com