5 Tecnicas de Prompt para Obter Melhores Resultados com o Claude Code [Com Exemplos]

Introducao

A qualidade do output do Claude Code esta diretamente ligada a forma como voce escreve seus prompts. Com a tecnica certa, a mesma tarefa pode ir de produzir “codigo inutilizavel” para “codigo pronto para producao”.

Neste artigo, apresentamos cinco tecnicas praticas de prompts com exemplos Before/After que voce pode comecar a usar imediatamente. Se voce e novo no Claude Code, confira primeiro o guia de introducao.

1. Forneca contexto especifico

A tecnica mais impactante e comunicar claramente o contexto e o proposito da sua tarefa. O Claude Code pode ler os arquivos do seu projeto, mas nao pode ler sua mente. Diga nao apenas o que voce quer, mas por que voce quer, e a precisao do output melhora drasticamente.

Before (prompt fraco):

Faca uma funcao de login

After (prompt forte):

Adicione autenticacao de login com email/senha a este projeto Next.js 14 App Router.
As rotas de API ja existem em src/app/api/, e a tabela de usuarios esta definida
via Prisma + PostgreSQL. Use NextAuth.js v5 como biblioteca de autenticacao.

Before (prompt fraco):

Corrija o bug

After (prompt forte):

Corrija o bug em src/components/UserList.tsx onde setState e chamado
apos o componente ser desmontado durante a busca da lista de usuarios
no useEffect. Adicione logica de cleanup usando AbortController.

2. Divida as tarefas em etapas

Quando voce entrega uma tarefa enorme ao Claude Code de uma vez, ele pode perder a visao geral. Divida intencionalmente o trabalho complexo em etapas e confirme que cada passo foi concluido antes de avancar.

Before (prompt fraco):

Construa um sistema completo de gestao de produtos. Preciso de listagem, detalhe,
criacao, edicao, exclusao, upload de imagens, gestao de categorias,
gestao de estoque e filtros de busca.

After (prompt forte):

Vamos construir a gestao de produtos em etapas. Para a Etapa 1,
crie a API CRUD de produtos:

- POST /api/products (criacao)
- GET /api/products (listagem com paginacao)
- GET /api/products/:id (detalhe)
- PUT /api/products/:id (atualizacao)
- DELETE /api/products/:id (exclusao)

Use zod para validacao e o cliente Prisma existente em src/lib/db.ts.

Before (prompt fraco):

Escreva todos os testes

After (prompt forte):

Escreva testes unitarios para src/utils/calculatePrice.ts.
Comece com os casos happy-path cobrindo:
- Calculo do preco base
- Taxas de desconto (10%, 20%, 50%)
- Calculo com impostos inclusos (taxa de 10%)
Use Vitest e siga os padroes existentes no diretorio tests/.

3. Especifique o formato de saida esperado

Indicar explicitamente a linguagem de programacao, framework, estilo de codigo e outras expectativas de formato reduz significativamente o retrabalho. Seja especialmente claro sobre definicoes de tipos TypeScript e padroes de tratamento de erros.

Before (prompt fraco):

Crie um cliente API

After (prompt forte):

Crie uma classe cliente para uma API de pagamento externa em src/lib/api-client.ts.

Requisitos:
- Definicoes de tipos TypeScript compativeis com strict mode
- Baseado em fetch (sem axios)
- Classe de erro personalizada (PaymentApiError) para tratamento de erros
- Logica de retry (maximo 3 tentativas, exponential backoff)
- Tipos de resposta genericos
- Comentarios JSDoc em todos os metodos publicos

Before (prompt fraco):

Faca um componente React

After (prompt forte):

Crie um componente de tabela reutilizavel em src/components/DataTable.tsx.

- Componente cliente ("use client"), nao React Server Component
- Props tipados com generics para aceitar definicoes de colunas
- Suporte a ordenacao e paginacao
- Estilizado com Tailwind CSS, seguindo os design tokens de src/components/Button.tsx
- Acessibilidade: roles WAI-ARIA de tabela corretamente configurados

4. Referencie o codigo existente

Uma das maiores forcas do Claude Code e compreender todo o seu projeto. Maximize isso instruindo-o explicitamente a seguir o codigo existente. Indicar caminhos de arquivo especificos torna isso ainda mais eficaz.

Before (prompt fraco):

Adicione um novo endpoint de API

After (prompt forte):

Seguindo o mesmo padrao de src/app/api/users/route.ts,
crie um endpoint de API de gestao de pedidos em src/app/api/orders/route.ts.

Replique a API de users existente em:
- Validacao com schema Zod
- Padrao de tratamento de erros try-catch
- Estilo de retorno NextResponse
- Abordagem de queries Prisma

Before (prompt fraco):

Construa uma pagina de configuracoes

After (prompt forte):

Usando src/app/dashboard/profile/page.tsx como referencia,
crie src/app/dashboard/settings/page.tsx.

Mantenha a mesma estrutura de layout (componente DashboardLayout, Breadcrumb,
uso do PageHeader) enquanto adiciona formularios de configuracoes
de notificacao e seguranca.
Use react-hook-form + zod para gestao de formularios, como na pagina de perfil.

5. Itere com um ciclo de feedback

Nao espere perfeicao na primeira tentativa. Use a conversa com o Claude Code para melhorar a qualidade incrementalmente. Trate o output inicial como base e forneca feedback especifico e acionavel.

Before (prompt fraco):

Isso nao ta certo, refaz

After (prompt forte):

Obrigado. Duas alteracoes por favor:
1. Na funcao handleSubmit, diferencie entre erros de rede e
   erros de validacao ao exibir mensagens ao usuario
2. Substitua o spinner simples do estado de carregamento pelo skeleton UI
   de src/components/Skeleton.tsx

Before (prompt fraco):

Faca melhor

After (prompt forte):

Gostaria de melhorias de performance. Especificamente:
1. Aplique React.memo a renderizacao da lista de produtos para evitar re-renders desnecessarios
2. Adicione debounce (300ms) ao input de busca
3. Implemente lazy loading para as imagens
Adicione comentarios em cada ponto de alteracao para que eu possa
avaliar o impacto no score do Lighthouse.

Conclusao

Recapitulando as cinco tecnicas:

Forneca contexto especifico para que o Claude Code entenda sua intencao com precisao
Divida as tarefas em etapas para manter o escopo de cada interacao gerenciavel
Especifique o formato de saida para minimizar retrabalho
Referencie o codigo existente para manter a consistencia do projeto
Itere com feedback para elevar a qualidade incrementalmente

Cada tecnica e eficaz isoladamente, mas elas realmente brilham quando combinadas. Escrever regras do projeto em um arquivo CLAUDE.md reduz quanto contexto voce precisa incluir em cada prompt, aumentando ainda mais a eficiencia.

Para usos mais avancados, confira nossas dicas de produtividade com Claude Code.

Para conceitos fundamentais de prompt engineering, leia tambem o guia oficial de prompt engineering da Anthropic.