Mejores Prácticas
Estos patrones vienen del equipo de Anthropic y de ingenieros que usan Claude Code en producción. La clave: el recurso más importante es la ventana de contexto.
1. Siempre da una forma de verificar
Esta es la práctica de mayor impacto. Claude es dramáticamente mejor cuando puede verificar su propio trabajo.
Sin verificación
"implementa una función que valide emails"
Con verificación
"escribe validateEmail. Casos de prueba: user@example.com es true, invalid es false, user@.com es false. Corre los tests después"
La verificación puede ser: un test suite, un linter, un comando bash que verifique la salida, o una captura de pantalla para UI.
2. Explora primero, planifica, luego codea
No dejes que Claude salte directo a programar. Separa la investigacion de la implementacion:
Explora (Plan Mode)
"lee src/auth y explícame cómo manejamos sesiones y login"
Planifica
"quiero agregar OAuth con Google. ¿Qué archivos necesitan cambiar? Crea un plan."
Implementa (Normal Mode)
"implementa el flujo de OAuth según tu plan. Escribe tests y corre la suite"
Commit
"haz commit con un mensaje descriptivo y abre un PR"
Para tareas simples (arreglar un typo, renombrar una variable), salta directo. Planificar es para cuando no estas seguro del enfoque o el cambio toca multiples archivos.
3. Da contexto específico
Claude puede inferir, pero no lee tu mente. Referencia archivos, menciona restricciones, y apunta a patrones existentes.
Vago
"agrega tests para foo.py"
Específico
"escribe un test para foo.py cubriendo el edge case donde el usuario no esta logueado. Sin mocks."
Vago
"agrega un widget de calendario"
Específico
"mira como estan implementados los widgets existentes en la home. HotDogWidget.php es buen ejemplo. Sigue el patron para un calendario que permita seleccionar mes."
4. Maneja el contexto agresivamente
La ventana de contexto se llena rápido. Cuando se llena, Claude empieza a "olvidar" instrucciones y a cometer más errores.
Usa /clear entre tareas no relacionadas
Resetea la ventana de contexto completamente.
Usa /compact para comprimir
Comprime la conversación preservando código y decisiones clave.
Usa subagentes para investigacion
"usa subagentes para investigar cómo funciona la autenticación". El subagente explora en su propio contexto y devuelve solo un resumen.
5. Corrige temprano y seguido
Los mejores resultados vienen de feedback loops cortos:
- - Esc para detener a Claude si va por mal camino
- - "deshaz eso" para revertir cambios
- - Si has corregido a Claude más de 2 veces en lo mismo, /clear y empieza con un mejor prompt
Errores comunes a evitar
La sesión "de todo"
Empiezas con una tarea, preguntas algo no relacionado, vuelves a la primera. El contexto se llena de ruido.
Solución: /clear entre tareas no relacionadas.
Corregir una y otra vez
Claude hace algo mal, lo corriges, sigue mal, corriges de nuevo. El contexto se contamina con intentos fallidos.
Solución: después de 2 correcciones fallidas, /clear y escribe un mejor prompt inicial.
CLAUDE.md demasiado largo
Si es muy extenso, Claude ignora la mitad porque las reglas importantes se pierden en el ruido.
Solución: poda sin piedad. Si Claude ya hace algo bien sin la instrucción, elimínala.
Confiar sin verificar
Claude produce algo que se ve bien pero no maneja edge cases.
Solución: siempre proporciona verificación (tests, scripts, screenshots).
Exploración infinita
Pides "investiga X" sin acotar. Claude lee cientos de archivos llenando el contexto.
Solución: acota la investigación o usa subagentes.
Resumen
- - Verificación es la práctica #1: tests, screenshots, salidas esperadas
- - Explora > Planifica > Implementa para cambios complejos
- - Sé específico: referencia archivos, patrones existentes, restricciones
- - /clear entre tareas, /compact en sesiones largas
- - Corrige rápido: Esc y redirige, no dejes que se desvíe