5 Tecnicas de Prompts para Obtener Mejores Resultados con Claude Code [Con Ejemplos]

Introduccion

La calidad del output de Claude Code esta directamente ligada a como escribes tus prompts. Con la tecnica adecuada, la misma tarea puede pasar de producir “codigo inutilizable” a “codigo listo para produccion”.

En este articulo, repasaremos cinco tecnicas practicas de prompts con ejemplos Before/After que puedes empezar a usar de inmediato. Si eres nuevo en Claude Code, consulta primero la guia de inicio.

1. Proporciona contexto especifico

La tecnica mas efectiva es comunicar claramente el trasfondo y el proposito de tu tarea. Claude Code puede leer los archivos de tu proyecto, pero no puede leer tu mente. Dile no solo que quieres, sino por que lo quieres, y la precision del output mejorara dramaticamente.

Before (prompt debil):

Haz una funcion de login

After (prompt fuerte):

Anade autenticacion de login con email/contrasena a este proyecto Next.js 14 App Router.
Las rutas API ya existen en src/app/api/, y la tabla de usuarios esta definida con Prisma + PostgreSQL.
Usa NextAuth.js v5 como libreria de autenticacion.

Before (prompt debil):

Arregla el bug

After (prompt fuerte):

Arregla el bug en src/components/UserList.tsx donde setState se llama
despues de que el componente se desmonte durante la obtencion de la lista
de usuarios en useEffect.
Anade logica de limpieza usando AbortController.

2. Divide las tareas en pasos

Cuando le entregas a Claude Code una tarea masiva de una sola vez, puede perder la vision general. Divide intencionalmente el trabajo complejo en etapas y confirma que cada paso esta completo antes de avanzar.

Before (prompt debil):

Construye un sistema completo de gestion de productos. Necesito listado, detalle, crear,
editar, eliminar, subir imagenes, gestion de categorias, inventario y filtros de busqueda.

After (prompt fuerte):

Vamos a construir la gestion de productos por etapas. Para el Paso 1,
crea la API CRUD de productos:

- POST /api/products (crear)
- GET /api/products (listar con paginacion)
- GET /api/products/:id (detalle)
- PUT /api/products/:id (actualizar)
- DELETE /api/products/:id (eliminar)

Usa zod para validacion y el cliente Prisma existente en src/lib/db.ts.

Before (prompt debil):

Escribe todos los tests

After (prompt fuerte):

Escribe tests unitarios para src/utils/calculatePrice.ts.
Comienza con los casos happy-path cubriendo:
- Calculo del precio base
- Tasas de descuento (10%, 20%, 50%)
- Calculo con impuestos incluidos (tasa del 10%)
Usa Vitest y sigue los patrones existentes en el directorio tests/.

3. Especifica el formato de salida esperado

Indicar explicitamente el lenguaje de programacion, framework, estilo de codigo y otras expectativas de formato reduce significativamente el retrabajo. Se especialmente claro con las definiciones de tipos TypeScript y los patrones de manejo de errores.

Before (prompt debil):

Crea un cliente API

After (prompt fuerte):

Crea una clase cliente para una API de pagos externa en src/lib/api-client.ts.

Requisitos:
- Definiciones de tipos TypeScript compatibles con strict mode
- Basado en fetch (sin axios)
- Clase de error personalizada (PaymentApiError) para manejo de errores
- Logica de reintentos (maximo 3 intentos, exponential backoff)
- Tipos de respuesta genericos
- Comentarios JSDoc en todos los metodos publicos

Before (prompt debil):

Haz un componente React

After (prompt fuerte):

Crea un componente de tabla reutilizable en src/components/DataTable.tsx.

- Componente cliente ("use client"), no React Server Component
- Props tipados con genericos para aceptar definiciones de columnas
- Soporte de ordenacion y paginacion
- Estilos con Tailwind CSS, usando los design tokens de src/components/Button.tsx
- Accesibilidad: roles WAI-ARIA de tabla correctamente configurados

4. Referencia el codigo existente

Una de las mayores fortalezas de Claude Code es que comprende todo tu proyecto. Maximiza esto instruyendole explicitamente a seguir el codigo existente. Senalar rutas de archivo especificas lo hace aun mas efectivo.

Before (prompt debil):

Anade un nuevo endpoint API

After (prompt fuerte):

Siguiendo el mismo patron de src/app/api/users/route.ts,
crea un endpoint API de gestion de pedidos en src/app/api/orders/route.ts.

Replica el API de users existente en:
- Validacion con esquema Zod
- Patron de manejo de errores try-catch
- Estilo de retorno con NextResponse
- Enfoque de consultas Prisma

Before (prompt debil):

Construye una pagina de configuracion

After (prompt fuerte):

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

Mantiene la misma estructura de layout (componente DashboardLayout, Breadcrumb,
uso de PageHeader) mientras anades formularios de configuracion de notificaciones
y configuracion de seguridad.
Usa react-hook-form + zod para la gestion de formularios, igual que la pagina de perfil.

5. Itera con un ciclo de retroalimentacion

No esperes perfeccion en el primer intento. Usa la conversacion con Claude Code para mejorar la calidad de forma incremental. Trata el output inicial como base y proporciona feedback especifico y accionable.

Before (prompt debil):

Eso no esta bien, hazlo de nuevo

After (prompt fuerte):

Gracias. Dos cambios por favor:
1. En la funcion handleSubmit, diferencia entre errores de red y
   errores de validacion al mostrar mensajes al usuario
2. Reemplaza el spinner simple del estado de carga con el skeleton UI
   de src/components/Skeleton.tsx

Before (prompt debil):

Hazlo mejor

After (prompt fuerte):

Me gustaria mejoras de rendimiento. Especificamente:
1. Aplica React.memo al renderizado de la lista de productos para prevenir re-renders innecesarios
2. Anade debounce (300ms) al input de busqueda
3. Implementa lazy loading para las imagenes
Anade comentarios en cada punto de cambio para que pueda evaluar el impacto en el score de Lighthouse.

Conclusion

Recapitulemos las cinco tecnicas:

Proporciona contexto especifico para que Claude Code entienda tu intencion con precision
Divide las tareas en pasos para mantener el alcance de cada interaccion manejable
Especifica el formato de salida para minimizar el retrabajo
Referencia el codigo existente para mantener la consistencia del proyecto
Itera con feedback para elevar la calidad de forma incremental

Cada tecnica es efectiva por si sola, pero realmente brillan cuando se combinan. Escribir reglas del proyecto en un archivo CLAUDE.md reduce cuanto contexto necesitas incluir en cada prompt, aumentando la eficiencia aun mas.

Para usos mas avanzados, consulta nuestros tips de productividad con Claude Code.

Para conceptos fundamentales de prompt engineering, lee tambien la guia oficial de prompt engineering de Anthropic.