Resolución de problemas: ¿por qué hizo eso Claude?
La mayoría de los momentos de "Claude está actuando raro" tienen una causa simple. Aquí están los más comunes y su solución.
"Se inventó un dato / una fuente falsa"
Por qué: el modelo generó una continuación plausible pero falsa (alucinación). Solución: dale el texto de la fuente y dile "responde solo a partir de esto; si no está aquí, dilo." Verifica todo lo que importe.
"Se olvidó de lo que dije antes"
Por qué: la conversación superó la ventana de contexto, así que el texto más antiguo se descartó — o es una sesión nueva (sin memoria por defecto). Solución: repite la información clave o empieza un chat nuevo para un tema nuevo.
"Ignoró mi instrucción"
Por qué: la instrucción quedó enterrada en un prompt largo, era ambigua o la contradecía otra cosa. Solución: pon la instrucción al principio y repítela al final; sé específico; elimina las peticiones contradictorias. Consulta Conceptos básicos de prompting.
"Rechazó algo razonable"
Por qué: el patrón de la petición coincidió con algo sensible, o faltaba contexto. Solución: añade contexto legítimo y sé específico sobre tu objetivo. Si estás construyendo sobre la API, gestiona los rechazos con elegancia — consulta Rechazos y seguridad.
"La salida es genérica / sosa"
Por qué: no hay suficientes restricciones o ningún ejemplo de cómo es algo "bueno". Solución: dale un rol, una muestra del tono que quieres y un formato ajustado.
"La respuesta estaba mal en los números/las matemáticas"
Por qué: los LLM razonan sobre matemáticas pero no son calculadoras exactas. Solución: pídele que muestre los pasos, o dale una herramienta/código para calcular.
"No deja de ser demasiado extenso / demasiado breve"
Solución: di exactamente lo que quieres — "responde en 3 viñetas, sin preámbulo" o "dame el razonamiento completo." En Claude Code, considera los Estilos de salida.
"Claude Code hizo algo que no esperaba con mis archivos"
Por qué: unos permisos amplios le permitieron actuar sin preguntar. Solución: usa el Modo plan para los cambios grandes y ajusta tus reglas de permitir/denegar.
:::tip El primer movimiento universal Antes de dar por hecho que está roto, vuelve a leer tu prompt como si fueras un completo desconocido. Nueve de cada diez veces la solución es más contexto o una petición más clara. :::
¿Has encontrado una trampa recurrente?
Añádela aquí — esta página crece a partir de la experiencia real. Contribuye en 10 minutos.