Claude Code na prática: meu setup real (modos, skills, plugins e MCP)

A proposta do vídeo

A promessa central do conteúdo é apresentar um setup real de Claude Code, afastando-se das listas genéricas de funcionalidades extraídas da documentação oficial. O autor mostra exatamente o que configura antes de iniciar qualquer projeto, seja para clientes ou para uso pessoal, e explica o raciocínio por trás de cada decisão. A abordagem é pragmática e orientada a fluxos de trabalho, com foco em desenvolvedores, vibe coders e até mesmo profissionais de outras áreas que desejam usar a ferramenta para gerenciar clínicas, escritórios ou pequenas empresas. O vídeo avisa desde o início que haverá bastante tela preta de terminal, o que funciona como um filtro natural para quem busca tutoriais superficiais.

Arquitetura de funcionamento

Um dos pontos mais importantes do vídeo é a explicação sobre como o Claude Code localiza arquivos no ambiente de trabalho. Diferente do que muitos imaginam, o sistema não utiliza banco vetorial ou embeddings para busca semântica. Ele executa comandos bash comuns, como ls, cd e cat, diretamente no terminal do sistema operacional. Essa característica justifica a ênfase do autor na organização do projeto: se a estrutura de pastas for caótica, o agente gasta contexto listando arquivos e pode perder informações relevantes durante a execução. A metade das configurações apresentadas existe justamente para mitigar esse comportamento e orientar o agente a trabalhar de forma eficiente.

Modos de operação

O vídeo dedica uma parte substancial à explicação dos modos disponíveis no Claude Code. O auto mode funciona como piloto automático, executando tarefas com mínima intervenção humana, ideal para operações repetitivas ou quando o usuário confia no fluxo definido. O modo manual é recomendado para situações que exigem aprovação constante, especialmente em alterações críticas de código ou configuração. O plan mode aparece como etapa obrigatória antes de qualquer implementação, permitindo que o agente proponha uma estratégia antes de tocar nos arquivos. O accept edits complementa o fluxo de revisão, facilitando a aceitação granular de mudanças sugeridas.

Configuração inicial e scaffolding

O comando /init e o arquivo CLAUDE.md são apresentados como fundação de qualquer projeto bem configurado. O CLAUDE.md funciona como memória persistente do agente, contendo instruções sobre estilo, estrutura e regras específicas do projeto. O autor vai além do init básico e demonstra um processo de scaffolding que inclui organização de diretórios, convenções de nomenclatura e documentação mínima necessária para o agente operar sem ambiguidade. Essa etapa é especialmente importante para quem trabalha com repositórios grandes ou com múltiplos colaboradores.

Output styles e personalização

O vídeo mostra como configurar output styles, com destaque para um estilo personalizado chamado pelo autor de "explica como se eu tivesse 5 anos". Esse ajuste altera o tom das respostas do agente, tornando-as mais acessíveis para usuários não técnicos ou para momentos em que a simplicidade é mais importante que a precisão terminológica. A personalização de output styles é apresentada como uma forma de reduzir ruído e acelerar a compreensão, especialmente em equipes com níveis heterogêneos de conhecimento técnico.

Plugins e integrações

O autor adota uma postura minimalista em relação a plugins, justificando que poucos são realmente necessários para o fluxo de trabalho. Entre os citados, Playwright se destaca por permitir que o agente visualize o front-end de aplicações web, capturando screenshots e validando interfaces. Wispr Flow aparece como ferramenta complementar para ditado por voz, substituindo a digitação em momentos de brainstorming ou documentação extensa. O vídeo também discute quando usar o terminal diretamente versus o aplicativo desktop, apontando cenários específicos para cada interface.

Skills essenciais

Duas skills são apresentadas como as mais utilizadas pelo autor no dia a dia. A primeira é focada em escrita natural, permitindo gerar textos que não pareçam produzidos por inteligência artificial, útil para e-mails, relatórios e documentos. A segunda, project docs architect, organiza a documentação de projetos com contexto, PRDs, ADRs, sprints e evals, criando uma base sólida para colaboração e manutenção. Ambas são oferecidas como recursos complementares ao vídeo, com a skill de escrita natural disponível mediante comentário no canal.

MCPs e próximos passos

A seção final aborda Model Context Protocols (MCPs) que valem a pena conectar, incluindo Context7 para documentação de agentes, Notion para gestão de conhecimento, Gmail para comunicação, Drive para armazenamento e Calendar para agendamento. O autor encerra com a promessa de vídeos futuros explorando cenários específicos, seja para desenvolvedores ou para gestão de negócios, e reforça a importância de escolher configurações que atendam a necessidades reais em vez de acumular ferramentas desnecessárias.