Voy a ser directo: Claude Code es tan bueno como lo que tú le das.
No es magia. No es un junior al que le tiras un ticket y rezas. Es una herramienta que, bien usada, te multiplica. Mal usada, te genera código que vas a borrar en tres días.
Llevo meses trabajando con Claude Code a diario, y he visto los mismos errores repetirse —en mí y en otros devs—. Este artículo es el que me hubiera gustado leer cuando empecé. Sin humo, sin hype. Solo lo que funciona.
Error 1: Ignorar Plan Mode y no configurar CLAUDE.md
Este es, de lejos, el error más caro. Y el más común.
El escenario es siempre el mismo: abres Claude Code, le escribes algo como «hazme un sistema de autenticación con JWT» y le das Enter. Claude se pone a generar archivos, toca cosas que no debería, usa librerías que no quieres y estructura el código de una forma que no encaja con tu proyecto.
¿El problema? No le diste contexto. No le diste un plan.
Plan Mode: tu primer paso, siempre
Antes de que Claude escriba una sola línea de código, necesitas que piense. Para eso existe Plan Mode. Úsalo así:
# En lugar de ir directo a "hazme X", empieza con:
"Quiero implementar autenticación JWT en este proyecto Express.
Antes de escribir código, analiza la estructura actual del proyecto
y proponme un plan paso a paso."Plan Mode obliga a Claude a detenerse, analizar el contexto de tu repositorio y proponerte una estrategia antes de ejecutar. Puedes revisar el plan, ajustarlo y recién entonces decirle que avance. Esto solo —solo esto— te ahorra horas de reescritura.
CLAUDE.md: el archivo que cambia todo
Si no tienes un archivo CLAUDE.md en la raíz de tu proyecto, estás dejando que Claude adivine cómo trabajas. Y adivinar no escala.
CLAUDE.md es un archivo de instrucciones persistentes que Claude Code lee automáticamente cada vez que inicia una sesión. Piensa en él como el onboarding que le darías a un nuevo miembro de tu equipo.
Error 2: Bad Input == Bad Output
Esto no es exclusivo de Claude Code, pero aquí se nota más. Si tu prompt es vago, el resultado es vago. Si tu prompt es preciso, el resultado es preciso. Así de simple.
Un buen prompt no tiene que ser largo. Tiene que ser inambiguo. Si al leerlo tú mismo podrías interpretarlo de dos formas, Claude también puede.
Error 3: Entrar en bucle sin saber cuándo parar
Esto es el que más frustración genera. Conoces la situación: Claude genera código, no compila, le dices que lo arregle, lo arregla pero rompe otra cosa, le dices que arregle eso, y así entras en un ciclo donde cada iteración empeora el resultado.
Si llevas más de 3 iteraciones intentando que Claude arregle algo que él mismo rompió, para.
El comando /clear existe por una razón. Cuando Claude entra en un bucle de correcciones, su contexto se contamina con intentos fallidos, mensajes de error y parches sobre parches. Cada mensaje nuevo arrastra todo ese ruido. Limpiar y empezar con un prompt mejor es casi siempre más rápido que seguir parchando.
Bonus: Lo que separa a los que usan Claude Code de los que lo dominan
La context window, la elección entre Sonnet vs Opus, MCP y Hooks, y aprender a construir sistemas completos en lugar de scripts sueltos. Estos son los diferenciadores que te llevan de «Claude Code es útil» a «Claude Code es multiplicador».
El mejor momento para mejorar cómo usas Claude Code es hoy. Empieza por crear tu CLAUDE.md. Solo eso ya va a cambiar tu experiencia.
Y si te quedas con una sola idea de todo este artículo, que sea esta: prompting no es escribir instrucciones. Es pensar con claridad antes de pedir.