Claude Code em Ação: do Prompt ao Código
09 de outubro de 2025 às 18:15 - Por Larissa Santos
Algumas oportunidades chegam de um jeito que você não esperava. Foi assim com o convite para ministrar o webinar "Claude Code em Ação: do Prompt ao Código", promovido pela Nuvini e Datahub Big Data & Analytics.
Fui convidada após me destacar nos testes e aprendizados internos com a ferramenta, como parte de um investimento das empresas para explorar o potencial do Claude Code no dia a dia de desenvolvimento. Foi uma responsabilidade enorme e, ao mesmo tempo, uma das experiências mais gratificantes que já tive na carreira.
Neste post, trago o conteúdo completo que apresentei no evento.
O que é Claude Code?
Claude Code é a ferramenta de IA da Anthropic integrada a editores de código como o VSCode, projetada especificamente para assistência em programação. Ela funciona diretamente via terminal, oferecendo comandos slash para interações rápidas e poderosas com a inteligência artificial.
No cenário atual de IA generativa, o Claude Code se destaca por focar em segurança, produtividade e personalização avançada.
Instalação
npm install -g @anthropic/claude-code
Pré-requisitos:
- Node.js 18 ou superior
- Uma conta na Anthropic (solicitada na primeira execução)
Após a instalação, você pode iniciar o Claude Code de duas formas:
# Iniciar no diretório atual
claude
# Ou especificar um diretório
claude /caminho/para/projeto
Também é possível usar o Claude sem o terminal interativo, passando comandos diretamente:
claude -p "Stage my changes and write a set of commits for them" --allowedTools "Bash,Read" --permission-mode acceptEdits
Documentação sobre o modo headless: docs.claude.com
Conceitos Fundamentais
Antes de sair usando a ferramenta, vale entender os quatro pilares que estruturam o funcionamento do Claude Code.
Prompt: instrução que guia a IA para gerar respostas úteis e contextualizadas para o seu projeto.
Agentes: subassistentes especializados, configuráveis para tarefas específicas como revisão de código ou debugging.
MCP Protocol: Model Context Protocol para gerenciar contexto e referências de arquivos de forma inteligente.
Memória: arquivos CLAUDE.md que armazenam informações persistentes e contexto do projeto para a IA.
Ferramentas internas (Tools)
O Claude Code usa ferramentas internas para executar tarefas de desenvolvimento. Cada uma tem um papel específico, permitindo que o modelo não fique só no texto, mas interaja com o ambiente de programação:
| Tool | O que faz |
|---|---|
Read(arquivo) | Leitura do arquivo para analisar o conteúdo |
Write(arquivo) | Criação ou sobrescrita de arquivo |
Update(arquivo) | Alteração parcial dentro de um arquivo existente |
Delete(arquivo) | Exclusão de arquivo do projeto |
Search(...) | Busca de informação e documentação |
Run(comando) | Execução de comando no terminal |
Todas as ferramentas disponíveis estão na documentação oficial.
Comandos Essenciais (Built-in Slash Commands)
Os slash commands são uma das partes mais práticas do Claude Code. Aqui estão os principais:
| Comando | O que faz |
|---|---|
/init | Inicializa um novo projeto Claude Code no diretório atual |
/model | Alterna entre diferentes modelos disponíveis (Sonnet, Opus, etc.) |
/agents | Gerencia agentes personalizados para tarefas específicas |
/clear e /compact | Limpa o histórico ou compacta conversas para manter o foco |
/config e /permissions | Configura o ambiente e gerencia permissões de acesso |
/review e /memory | Solicita revisão de código e edita arquivos de memória |
/rewind | Volta a conversa para um ponto anterior |
/mcp | Gerencia e executa plugins (Model Context Protocols) |
Mais comandos disponíveis em: docs.claude.com/slash-commands
Criando e Utilizando Agentes
Agentes são subassistentes configuráveis para tarefas específicas, como revisão de segurança ou otimização de performance. Eles aumentam a produtividade por meio da especialização.
Atenção: cada agente tem seu próprio contexto (system prompt), carregado no momento em que é ativado. Por esse motivo, pode consumir mais tokens.
Para criar um agente, basta rodar /agents. Uma interface passo a passo vai guiar a criação com as seguintes configurações disponíveis:
- Nome do agente
- System Prompt
- Modelo do agente
- Permissões de acesso e tools
- Tipo do agente (Pessoal ou Projeto)
- Cor do agente (para destacar no terminal)
Mais detalhes em: docs.claude.com/sub-agents
Model Context Protocol (MCP)
O MCP é o protocolo que conecta o Claude a recursos externos como APIs, bancos de dados, arquivos e sistemas internos. Ele fornece contexto atualizado de documentação e torna as respostas muito mais precisas e relevantes.
Exemplos de MCPs úteis
Context7 para documentação atualizada de bibliotecas:
claude mcp add --transport http context7 https://mcp.context7.com/mcp
Figma para acessar designs diretamente:
claude mcp add --transport http figma-dev-mode-mcp-server https://mcp.figma.com/mcp
Exemplo prático: se você perguntar "Como uso useQuery do Apollo Client?" e incluir "use context7", o MCP vai buscar a documentação atual do Apollo Client, e não algo que a IA lembra de versões antigas. Isso faz uma diferença enorme no dia a dia.
Documentação: docs.claude.com/mcp
Criação de Comandos Personalizados
Slash commands personalizados são úteis para automatizar tarefas repetitivas, padronizar processos da equipe e acelerar o fluxo de trabalho com prompts consistentes.
Para criar um comando:
- Crie a pasta
.claude/commands/(comandos do projeto) ou~/.claude/commands/(válidos em todos os projetos) - Adicione um arquivo
.mddescrevendo a função do comando - Use
$1,$2, etc. para parâmetros individuais, ou$ARGUMENTSpara capturar todos de uma vez
Exemplo: revisar-codigo.md
---
description: Revisar código em busca de melhorias
argument-hint: [caminho-do-arquivo]
---
Analise o código em `$1`, identifique possíveis bugs, problemas de performance e sugira melhorias.
Depois, no Claude Code:
/revisar-codigo src/utils/helpers.js
O $1 será substituído pelo caminho informado e a revisão acontece automaticamente.
Documentação: docs.claude.com/slash-commands
Modos de Operação
O Claude Code tem quatro modos de operação, cada um adequado a um tipo diferente de situação:
Safe Mode (padrão): Claude solicita confirmação antes de implementar cada modificação. Ideal para revisar mudanças sensíveis.
Plan Mode: Claude cria um plano de ação detalhado antes de realizar qualquer edição. Perfeito para tarefas complexas.
All Edits On: Claude edita múltiplos arquivos simultaneamente sem pedir confirmação. Agiliza o desenvolvimento, mas exige confiança total no modelo.
Thinking On: Claude mostra seu processo de raciocínio antes de responder. Útil para entender a lógica por trás das soluções.
Atalhos:
- Alternar entre modos:
Alt+M - Ativar/Desativar o modo Thinking:
Tab
Como Criar Prompts Eficazes
A qualidade do prompt define a qualidade do resultado. Três princípios básicos:
- Seja claro: descreva exatamente o que você precisa, incluindo contexto e objetivos específicos.
- Use exemplos: forneça exemplos concretos do input e output desejado para guiar a IA.
- Delimite o escopo: defina limites claros e especifique o formato de resposta esperado.
Exemplo para otimização de código:
Otimize esta função JavaScript para melhor performance, mantendo a legibilidade. Foque em reduzir complexidade O(n²) e explique as mudanças.
Exemplo com menção de arquivos:
Crie um novo service em @src/services/ chamado UserService.js. Nele iremos lidar com CRUD de usuários nos seguintes endpoints: get-users (GET), get-user-by-id (GET), get-user-details (GET), add-users (POST), edit-users (POST) e delete-users (POST). Siga o padrão de @services/ApiService.js e, assim como nele, utilize axios.
Desafios do Uso de IA na Geração de Código
Por mais incrível que seja a ferramenta, é importante entender seus limites. Por mais que o código seja gerado por IA, a responsabilidade ainda é sua.
Os principais desafios que você vai encontrar:
- Contradições: o modelo pode gerar respostas inconsistentes em momentos diferentes da mesma sessão.
- Repetição: respostas redundantes que atrapalham a clareza do resultado.
- Ambiguidade: respostas com múltiplas interpretações, dificultando a implementação correta.
- Estereótipos: decisões baseadas em ideias simplificadas sobre determinadas situações ou personas.
- Alucinações: informações inventadas pelo modelo que parecem corretas, mas não têm base real.
- Preconceito: sugestões enviesadas, como indicar ferramentas ou frameworks que não fazem sentido para aquele contexto.
- Generalização excessiva: tirar conclusões amplas a partir de poucos exemplos, aplicando uma regra de forma errada para todos os casos.
Claude Code vs. Claude no Navegador
Para quem está acostumado a usar o Claude pelo navegador, vale entender as vantagens específicas do Claude Code para desenvolvimento:
Integração nativa: você trabalha diretamente no VSCode, sem alternar entre ferramentas e mantendo o foco total no código.
Automação avançada: os comandos slash permitem automação e personalização do fluxo de trabalho de um jeito que o navegador não oferece.
Segurança local: os dados permanecem no ambiente local, reduzindo exposição e aumentando a segurança do projeto.
O que ficou de aprendizado
Preparar e ministrar esse webinar foi uma experiência que me fez enxergar o Claude Code de uma forma ainda mais completa. Explicar algo para outras pessoas exige que você realmente entenda o que está falando, e isso me fez aprofundar em partes da ferramenta que ainda não tinha explorado tanto.
O que mais me surpreende no Claude Code é a possibilidade de personalização: agentes especializados, comandos próprios, integração com MCPs externos. Não é só um chat com IA dentro do editor. É uma camada de automação que você molda para o seu fluxo de trabalho.
Se você ainda não testou, minha sugestão é começar pelo básico: instale, rode /init no seu projeto e experimente descrever uma tarefa real. A partir daí, as possibilidades se abrem naturalmente.
