Última actualización: Julio 2025
- ¿Qué es Vibecoding?
- Configuración Inicial
- Metodología de Trabajo
- Funcionalidades Avanzadas
- Casos de Uso Prácticos
- Palabras Clave que Funcionan
- Tips y Mejores Prácticas
- TL;DR - Ejemplo Práctico Real
- Troubleshooting - Problemas Comunes
- Comparación de Herramientas
- Recursos Adicionales
Vibecoding es una metodología de programación que utiliza IA como tu compañero de pair programming, pero mucho más rápido que vos. La idea es que la IA funcione como un desarrollador senior que puede implementar, debuggear y refactorizar código a velocidad superhumana, mientras vos actuás como mentor y director técnico.
💡 Punto clave: La IA ya es más rápida que vos para muchas tareas. Si sabés cómo promptear correctamente, vas a volar.
IMPORTANTE: Vibecoding NO es magia. No esperés que funcione perfecto al primer prompt. La realidad es:
- Primera iteración: 60-70% de lo que necesitás
- Segunda iteración: "Arreglá esto, falta aquello"
- Tercera iteración: "Cambiá el approach de esta parte"
- Cuarta iteración: Refinamientos y edge cases
- Quinta iteración: Pulido final
El poder NO está en la perfección del primer intento, sino en la velocidad de iteración. Donde antes te llevaba horas cambiar algo, ahora te lleva minutos.
# Instalar Claude Code
npm install -g @anthropic/claude-code
# Usar Claude Code
cd tu-proyecto/
claudeEste archivo es lo más crítico de toda la guía. La IA lo lee siempre que ejecutas una acción.
¿Qué debe contener tu CLAUDE.md?
- Tu forma de programar: Patrones que prefieres, arquitectura
- Estilo de código: Uso de comentarios, logs, try-catch
- Patrones de diseño: Qué patrones usar y cuáles evitar
- Lógica de negocio: Contexto específico de tu aplicación
- Restricciones: Qué NO debe hacer la IA
# CLAUDE.md - Ejemplo básico
## Principios de Desarrollo
- Usar TypeScript estricto
- Implementar error handling con try-catch
- Logs detallados para debugging
- Código autodocumentado, comentarios solo cuando sea necesario
## Arquitectura
- Usar Clean Architecture
- Separar lógica de negocio de infraestructura
- Inyección de dependencias
## Restricciones
- NO usar any en TypeScript
- NO logs con información sensible
- Siempre validar inputs del usuario
⚠️ Importante: Este archivo es iterativo. Si ves que la IA hace algo mal, agregás la restricción y cómo debe hacerlo correctamente.
Claude Code permite crear comandos que son básicamente prompts reutilizables:
# Ejemplos de comandos
/frontend # "Actúa como un desarrollador frontend experto"
/backend # "Actúa como un desarrollador backend con foco en APIs"
/bugbounter # "Analiza este código buscando bugs y vulnerabilidades"
/reviewer # "Revisa este código como un senior developer"Fase 1: Entrenamiento (Primeras semanas)
- Empezá con tareas que ya sabés resolver
- Bugs que ya conocés - Para ver si los encuentra y soluciona como esperás
- Revisá TODO lo que hace - No confíes ciegamente
- Iterá tu CLAUDE.md - Agregá restricciones cuando algo no te guste
Fase 2: Delegación Gradual
- Tareas más complejas pero supervisadas
- Comenzar a confiar en refactorings simples
- Permitir que implemente features nuevas con review
Fase 3: Colaboración Avanzada
- Múltiples terminales trabajando en paralelo
- Delegación de tareas como un PM
- Confianza en implementaciones complejas
🎯 Meta: Llegar al punto donde puedas confiar en lo que hace, pero esto lleva tiempo - tené paciencia.
Ejemplo práctico - Implementar login:
# Iteración 1
> "Implementa un formulario de login con validación"
# Resultado: Formulario básico, falta manejo de errores
# Iteración 2
> "Agregá manejo de errores específicos: credenciales incorrectas, usuario no existe, rate limiting"
# Resultado: Mejor, pero falta UX de loading states
# Iteración 3
> "Agregá loading spinner, disable del botón durante submit, y mensaje de éxito"
# Resultado: Funcional, pero falta accesibilidad
# Iteración 4
> "Implementá ARIA labels, focus management y soporte para lectores de pantalla"
# Resultado: ¡Listo para producción!💡 Mindset correcto: Cada iteración es rápida (1-2 minutos), pero necesitás varias. Es como esculpir: vas refinando hasta llegar al resultado final.
Comparación: Desarrollo tradicional vs Vibecoding
🐌 TRADICIONAL (días/semanas):
Problema → Investigación → Diseño → Implementación → Testing → Debug → Deploy
🚀 VIBECODING (horas):
Problema → IA analiza → Iteración 1 → Review → Iteración 2 → Review → Deploy
↳ 2 min ↳ 3 min ↳ 1 min ↳ 3 min ↳ 1 min ↳ Ready
La diferencia clave:
- Antes: Pensabas horas, implementabas días
- Ahora: Pensás minutos, iterás rápido, llegás al resultado en horas
Claude Code es un programa de terminal, podés abrir varias instancias y trabajar como un PM:
# Terminal 1: Backend
cd backend/
claude
# Terminal 2: Frontend
cd frontend/
claude
# Terminal 3: Testing
cd tests/
claude
# Terminal 4: DevOps
cd infra/
claudeLos MCPs son herramientas que agregás al agente para expandir sus capacidades:
| MCP | Función | Uso |
|---|---|---|
| Sequential Thinker ⭐ | Análisis paso a paso | Debugging complejo, arquitectura |
| Puppeteer/Playwright | Control de navegador | Testing E2E, web scraping |
| Database MCP | Acceso a DB | Queries directas, análisis de datos |
| Jira/ClickUp | Project Management | Leer tickets automáticamente |
| Gemini Integration | Más contexto | Análisis con mayor ventana de contexto |
# Instalar MCP (ejemplo)
claude --install-mcp sequential-thinker
claude --install-mcp puppeteerEs un repositorio con prompts predefinidos que podés instalar:
git clone https://github.com/SuperClaude/prompts
# Instalar según documentación del repoIncluye personas especializadas, modelos específicos y prompts orientados a tareas específicas.
# 1. Problema complejo
"Analiza este error que aparece intermitentemente en producción"
# 2. Usa Sequential Thinker para análisis paso a paso
"Usa el MCP sequential-thinker para analizar sistemáticamente este stack trace"
# 3. Implementación de fix
"Implementa la solución que consideres más robusta"Plan Mode (Shift+Tab): Para que no implemente nada, solo planifique
# Activar plan mode
Shift + Tab
# O simplemente decir:
"NO implementes nada. Dame 3 alternativas de solución para este problema"Ejemplo práctico - Sistema de notificaciones:
# Iteración 1: Pedir alternativas
> "Dame 3 alternativas para implementar un sistema de notificaciones real-time"
# Resultado: WebSockets, Server-Sent Events, Polling
# Iteración 2: Profundizar
> "No me convence ninguna. Dame 2 alternativas más, considerando escalabilidad y costos"
# Resultado: Push notifications + WebSockets híbrido, Message Queue con Redis
# Iteración 3: Refinamiento
> "Me gusta la del Message Queue. Dame 3 formas diferentes de implementarla"
# Resultado: Redis Pub/Sub, RabbitMQ, AWS SQS + SNS
# Iteración 4: Implementación híbrida
> "Quiero combinar Redis para real-time y push notifications para offline. ¿Cómo?"
# Resultado: ¡Solución final personalizada!Vos implementás parte, IA completa el resto:
# Ejemplo: Vos creás el modelo de datos
> "Creé estas tablas para el sistema de pedidos:
- orders (id, user_id, status, total)
- order_items (id, order_id, product_id, quantity, price)
- products (id, name, price, stock)
Ahora implementá la lógica de negocio para:
1. Crear pedido con validación de stock
2. Actualizar stock automáticamente
3. Manejo de pedidos parciales cuando no hay stock suficiente"
# O al revés: IA propone modelo, vos modificás
> "Tu modelo está bien pero falta auditoria. Agregá campos created_at, updated_at
y una tabla order_audit para trackear cambios de status"- Descripción del problema - Sé específico
- Pedir 3+ alternativas - Nunca te conformes con la primera
- Iterar hasta encontrar algo que te guste - 3-5 rondas es normal
- Partir la implementación:
- Vos: Arquitectura/modelo de datos/decisiones críticas
- IA: Implementación/boilerplate/testing
- Revisar y refinar - La IA aprende de tus correcciones
"Busca en internet las mejores prácticas para implementar authentication con JWT"
"Investiga librerías modernas para manejo de estado en React"# Subir imagen (Ctrl+V en Mac, Command+V)
"Analiza este diseño y genera el componente React correspondiente"Frases "mágicas" que mejoran dramáticamente la calidad de las respuestas:
# Activa pensamiento más profundo
> "Pensá profundamente en esto..."
> "Analizá paso a paso..."
> "Considerá todas las alternativas..."
> "Evaluá los pros y contras de cada opción..."
> "¿Qué podría salir mal con este approach?"# Mejora la precisión
> "Sé específico y detallado..."
> "Dame ejemplos concretos..."
> "Mostrá el código exacto que necesito..."
> "Explicá tu razonamiento..."
> "¿Por qué elegiste esta solución?"# Fuerza revisión y mejora
> "Revisá tu respuesta anterior y mejorala..."
> "¿Hay una forma más elegante de hacer esto?"
> "Optimizá esto para performance..."
> "Simplificá esta solución..."
> "Refactoreá esto para mejor legibilidad..."# Desbloquea creatividad
> "Dame 3 enfoques completamente diferentes..."
> "Pensá fuera de la caja..."
> "¿Cuál sería un approach no convencional?"
> "Inspirate en [tecnología/patrón específico]..."
> "¿Cómo lo haría un experto en [dominio]?"# Para cuando necesitás algo directo
> "Solo dame el código, sin explicación..."
> "Implementación mínima que funcione..."
> "Quick fix para esto..."
> "Dame la versión más simple..."
> "Directo al grano..."# Mejora diseño de sistemas
> "Considerá la escalabilidad..."
> "¿Cómo manejarías 1M de usuarios?"
> "Diseñá esto pensando en mantenibilidad..."
> "¿Qué patrones de diseño aplicarías?"
> "Pensá en la experiencia del desarrollador..."# Enfoque en seguridad
> "Analizá las vulnerabilidades de esta solución..."
> "¿Qué validaciones faltan?"
> "Asegurate que esto sea seguro para producción..."
> "¿Qué edge cases estoy perdiendo?"
> "Aplicá el principio de menor privilegio..."# Mejora el contexto
> "Basándote en este código existente..."
> "Siguiendo el patrón de [ejemplo]..."
> "Consistente con nuestro estilo actual..."
> "Buscá en internet ejemplos similares y adaptá..."
> "¿Cómo lo hace [framework/librería conocida]?"# Activa diferentes personas/roles
> "Actuá como un arquitecto senior..."
> "Desde la perspectiva de un auditor de seguridad..."
> "Como si fueras un reviewer de código estricto..."
> "Pensá como un usuario final..."
> "Desde el punto de vista de performance..."Para problemas complejos:
> "Pensá profundamente en esto paso a paso. Dame 3 enfoques diferentes,
considerá pros/contras, y recomendá el mejor explicando tu razonamiento."Para código de calidad:
> "Analizá este código desde seguridad, performance y mantenibilidad.
Refactoreá mejorando cada aspecto y explicá los cambios."Para arquitectura:
> "Actuá como arquitecto senior. Evaluá esta solución considerando
escalabilidad, mantenibilidad y costs. Dame alternativas si es necesario."💡 Pro tip: Combiná múltiples frases para mejores resultados. La IA responde mejor a prompts estructurados y específicos.
- Aceptar la iteración: Planificar 3-5 refinamientos por feature
- Ser específico: Cuanto más contexto, mejor funciona
- Usar CLAUDE.md: Mantenerlo actualizado constantemente
- Revisar todo: Especialmente al principio
- Iterar gradualmente: Construir confianza de a poco
- Usar múltiples terminales: Para paralelizar tareas
- Mandar "choclazos" de contexto: No tengas miedo de ser detallado
- Tratar cada iteración como un paso normal: Es parte del proceso, no una falla
- Esperar perfección al primer prompt: NUNCA va a pasar
- Frustrarse por las iteraciones: Es lo normal y esperado
- Confiar ciegamente: Siempre revisar el código generado
- Saltear la configuración: CLAUDE.md es fundamental
- Apurarse: La construcción de confianza lleva tiempo
- Ser vago en prompts: Especificidad = mejores resultados
- Abandonar después de 1-2 intentos: La magia está en la iteración 3-5
SuperWhisper: Para dictado por voz
# Evita escribir prompts largos
# Especialmente útil para dar contexto extensoBranches específicas:
# Configurar diferentes Claude instances para diferentes branches
cd feature-auth/
claude
cd feature-dashboard/
claudeColaboración entre instances:
# Hacer que múltiples Claude instances trabajen juntas
# Usando archivos .txt compartidos para coordinación- SuperClaude: Prompts predefinidos
- SuperWhisper: Dictado por voz
- Sequential Thinker MCP: Análisis paso a paso
- Puppeteer/Playwright MCP: Automatización de navegador
Si tenés repos relacionados (backend + frontend):
# Crear carpeta contenedora
mkdir my-project
cd my-project
# Clonar repos relacionados
git clone backend/
git clone frontend/
# Abrir Claude Code en la carpeta contenedora
cd my-project/
claude
# Crear CLAUDE.md que explique la relación entre proyectosSituación: Necesito crear una guía completa sobre vibecoding. Tengo la idea en mi cabeza pero escribir todo manualmente me llevaría días.
Cómo lo resolví con vibecoding:
# 1. Audio inicial (10 minutos)
cd guias-proyecto/
claude
> 🎤 SuperWhisper: "Hola, necesito que me hagas un MD para explicar una guía
básica de cómo vibecodear. Actualmente el mejor modelo es Sonnet-4, quiero
mostrar ejemplos prácticos, múltiples terminales, iteración constante..."
# 2. Primera iteración - Estructura base
> "Genial, me gustó la estructura. Ahora necesito agregar un TL;DR arriba
con un ejemplo más complejo..."
# 3. Iteración - Reorganización
> "La comparación de herramientas debería estar al final, no es lo más
importante. Lo crucial es la configuración inicial..."
# 4. Iteración - Corrección técnica
> "El comando no es claude-code backend/, es simplemente estar parado
en el directorio y hacer: claude"
# 5. Iteración - Enfoque en iteración
> "Me gustaría agregar bastante más importancia a la iteración, que no
te va a hacer todo bien con 1 prompt sino que lleva 3/4/5..."
# 6. Iteración - Features complejas
> "En la sección de features complejas me gustaría que también se haga
énfasis en iterar las soluciones que te propone..."
# 7. Más iteraciones...
> Troubleshooting, ejemplos, refinamientos varios...Resultado: En 45 minutos tengo una guía completa de 500+ líneas que manualmente me hubiera llevado 2-3 días. Y es mejor porque Claude aportó estructura y ejemplos que no se me habían ocurrido.
⚠️ REALIDAD CHECK: Fueron ~12 iteraciones hasta llegar al resultado final. Cada refinamiento tomó 2-5 minutos. El poder está en poder iterar súper rápido, no en que salga perfecto al primer intento.
💡 La magia: Mientras escribo esto, estás leyendo exactamente el resultado de este proceso. Esta guía SE CREÓ usando la metodología que te está enseñando.
Síntomas:
- Genera código que no tiene sentido para tu proyecto
- Ignora la arquitectura existente
- Propone soluciones genéricas
Soluciones:
# 1. Revisar CLAUDE.md - agregá más detalle
> "Mi CLAUDE.md actual tiene esto: [contenido]
La IA sigue generando código genérico. ¿Qué le falta?"
# 2. Agregar ejemplos de código existente
> "Este es un ejemplo de cómo escribimos componentes en nuestro proyecto:
[código ejemplo]
Ahora generá el nuevo componente siguiendo este patrón"
# 3. Especificar convenciones de naming
> "Usamos estas convenciones:
- Componentes: PascalCase con sufijo Component
- Funciones: camelCase con verbos descriptivos
- Constantes: UPPER_SNAKE_CASE"Síntomas:
- El código funciona pero "no se siente tuyo"
- No respeta las convenciones del equipo
- Mezcla diferentes estilos
Soluciones:
# 1. Ejemplos de "así SÍ" y "así NO"
> "MALO ❌:
function getData() { return fetch('/api/data') }
BUENO ✅:
async function fetchUserData(): Promise<UserData> {
try {
const response = await apiClient.get('/users/data');
return response.data;
} catch (error) {
logger.error('Failed to fetch user data', { error });
throw new UserDataError('Unable to retrieve user data');
}
}
Ahora reescribí mi función siguiendo el patrón BUENO"
# 2. Iterar CLAUDE.md con restricciones específicas
> "Agregá a mi CLAUDE.md:
- NUNCA usar console.log, usar nuestro logger
- SIEMPRE agregar tipos TypeScript explícitos
- SIEMPRE manejar errores con try-catch y logging"Síntomas:
- Cada iteración cambia cosas pero no mejora
- Se "olvida" de restricciones anteriores
- Vuelve a errores ya corregidos
Soluciones:
# 1. Ser más específico en cada iteración
> "El código anterior tenía el problema X. Corregí SOLO ese problema,
mantené todo lo demás igual"
# 2. Referenciar versiones anteriores
> "La versión 3 estaba bien excepto por Y. Tomá la versión 3 como base
y solo cambiá Y"
# 3. Usar el historial de conversación
> "Mirá mis restricciones del mensaje anterior y asegurate de seguirlas"Síntomas:
- Da vueltas sin resolver el problema
- Propone soluciones demasiado complicadas
- No puede debugging efectivamente
Soluciones:
# 1. Usar Sequential Thinker MCP
> "Usá el MCP sequential-thinker para analizar este problema paso a paso"
# 2. Dividir el problema en partes
> "Este problema es muy complejo. Dividilo en 3 sub-problemas más simples
y resolvamos uno por vez"
# 3. Empezar con lo mínimo
> "Olvidate de todas las features. Implementá solo lo básico que funcione,
después iteramos"Síntomas:
- Archivos muy largos con mucho código repetitivo
- No reutiliza funciones/componentes existentes
- Sobre-engineering las soluciones
Soluciones:
# 1. Enfocarse en lo específico
> "No generes todo el CRUD. Solo necesito la función updateUser() que use
nuestros helpers existentes"
# 2. Referenciar código existente
> "Ya tenemos un UserService. Extendelo con el nuevo método, no crees uno nuevo"
# 3. Pedir minimalismo
> "Implementá la solución MÁS SIMPLE que funcione. Sin abstracciones extra"Cuando nada funciona:
# 1. Reset completo
> "Empecemos de nuevo. Este es el problema: [descripción simple]
Dame 3 enfoques diferentes, sin implementar nada"
# 2. Cambiar de terminal/sesión
# A veces empezar fresh ayuda
# 3. Usar ejemplos externos
> "Buscá en internet ejemplos de cómo resolver esto y adaptalo a nuestro caso"
# 4. Pedir ayuda para el prompt
> "¿Cómo debería preguntarte para obtener mejor resultado en esto?"Los mejores modelos para vibecoding son los de Anthropic:
- Claude Sonnet-4 ⭐ (Recomendado)
- Claude Opus-4 (Muy caro y poca disponibilidad)
¿Por qué Sonnet-4? La diferencia en calidad de código entre Sonnet-4 y otros agentes es escandalosa. No es que los otros codeen mal, pero usar Sonnet-4 vs otros es como hablar con un SSR vs un trainee.
| Herramienta | Modelo de Facturación | Pros | Contras | Recomendación |
|---|---|---|---|---|
| Claude Code ⭐ | Sesiones de 5 horas | - Mejor integración - Comandos personalizables - Límite realista (nadie codea 5h seguidas) |
Requiere terminal | IDEAL para uso real |
| Cursor | Mensual fijo | UI amigable | - Si te lo gastás en la primera semana, estás 3 semanas sin poder usarlo - Menos personalizable |
Riesgoso para uso intensivo |
| Copilot Agent | Por mensaje + caro | Integrado con GitHub | - Más limitado en funcionalidades - Más caro a largo plazo - Menos potente |
Para uso ocasional |
💡 Por qué Claude Code gana: El modelo de 5 horas por sesión es perfecto porque:
- Nadie puede mantener productividad por más de 5 horas seguidas
- Te fuerza a tomar descansos (saludable)
- No te quedás sin créditos a mitad de mes
- Podés planificar tu uso efectivamente
Vibecoding no es magia - es una metodología que requiere:
- Configuración inicial cuidadosa (CLAUDE.md)
- Construcción gradual de confianza
- Iteración constante de prompts y restricciones (3-5 por feature)
- Supervisión activa (al menos inicialmente)
- Paciencia con el proceso iterativo - cada refinamiento te acerca al objetivo
💪 No le tengas miedo a la IA - tratala como si fueras un mentor. Se va a equivocar, sí, pero va a codear mucho más rápido que vos y te va a ayudar a pensar mejor las soluciones.
🔁 La clave del éxito: Abrazar las iteraciones como parte natural del proceso. La velocidad no viene de la perfección instantánea, sino de iterar rápidamente hasta llegar al resultado deseado.
El objetivo final: Llegar a un punto donde puedas actuar como un PM técnico, delegando tareas y coordinando múltiples streams de trabajo mientras mantenés la visión arquitectónica y la calidad del código.
Esta guía es un ejemplo práctico de vibecoding en acción.
Fue creada usando Claude Code siguiendo exactamente la metodología que describe:
- Audio inicial: Le mandé un audio de ~10 minutos explicando cómo quería que fuera la guía
- Primera iteración: Claude generó la estructura y contenido inicial
- Refinamientos iterativos: Fuimos iterando sección por sección:
- "Mové la comparación de herramientas al final"
- "Agregá más énfasis en la iteración"
- "El comando no es claude-code, es simplemente claude"
- "Expandí la sección de features complejas"
- Resultado final: Esta guía completa, creada colaborativamente
Tiempo total: ~45 minutos (que hubieran sido días escribiendo manualmente)
Iteraciones: ~12 refinamientos hasta llegar al resultado final
💡 Meta-ejemplo: Estás leyendo el resultado de la metodología que describe. La guía se creó usando vibecoding, demostrando que realmente funciona para generar contenido complejo de alta calidad.
Esta guía fue creada en julio 2025. Los precios, disponibilidad y capacidades de las herramientas pueden haber cambiado desde entonces.