Cómo depurar errores de código con IA

Cuando tu código falla, el entorno de programación (la terminal, el navegador o el IDE) muestra un mensaje de error. Ese mensaje contiene información clave que la IA necesita para ayudarte:

• Tipo de error: por ejemplo, TypeError, SyntaxError, NameError, 404, undefined is not a function
• Número de línea: indica dónde ocurrió el problema en tu código
• Descripción: una frase que explica qué salió mal

Copia el mensaje completo, incluyendo todas las líneas del rastro de error (traceback o stack trace). No lo resumas ni lo acortes: cuanto más completo esté, mejor puede diagnosticar la IA.

Si el error aparece en el navegador, pulsa F12, ve a la pestaña Console y copia el texto rojo completo.

Abre claude.ai o chatgpt.com e inicia sesión. Luego escribe un mensaje que incluya:

1. Una línea breve explicando qué intentabas hacer
2. El mensaje de error completo (pegado tal cual)
3. El fragmento de código donde ocurre el error

Ejemplo de buen mensaje para la IA:

“Estoy aprendiendo Python y me sale este error al ejecutar mi script. ¿Puedes explicarme qué significa y cómo corregirlo?

Error:

TypeError: unsupported operand type(s) for +: 'int' and 'str'
File "mi_script.py", line 7, in <module>
    total = cantidad + precio

Mi código:

cantidad = 5
precio = input("¿Cuál es el precio? ")
total = cantidad + precio
print(f"El total es {total}")
```"

La clave está en dar contexto. No pegues solo el error: explica brevemente qué intentabas hacer.

Para aprender a escribir mejores mensajes para la IA, el tutorial Cómo escribir prompts efectivos para inteligencia artificial tiene técnicas que puedes aplicar directamente aquí.

La IA generalmente responde con tres partes:

1. Explicación del error: qué significa y por qué ocurrió
2. Código corregido: la versión del código con el problema resuelto
3. Explicación de la corrección: qué cambió y por qué funciona ahora

No copies el código corregido sin leer la explicación. Intenta entender qué pasó: así evitas cometer el mismo error en el futuro.

Si la respuesta no te queda clara, pregunta de nuevo en el mismo chat:

• “¿Puedes explicarlo de forma más sencilla?”
• “¿Qué hace exactamente la línea que añadiste?”
• “¿Hay alguna otra forma de resolver esto?”

La IA no se cansa de responder. Aprovéchalo para aprender de verdad.

Aplica los cambios que sugirió la IA en tu código y ejecuta de nuevo:

1. Copia el código corregido de la respuesta de la IA
2. Reemplaza el fragmento problemático en tu archivo
3. Guarda el archivo y ejecuta el programa de nuevo
4. Comprueba que el error desapareció

Si aparece un error diferente, vuelve al paso 2 con ese nuevo mensaje. Es normal que al resolver un error aparezca otro problema oculto: sigue el mismo proceso.

Si el mismo error persiste, responde en el chat de la IA con: “Apliqué tu corrección pero el error sigue apareciendo. Aquí está el código actualizado y el nuevo mensaje: […]”. La IA puede ajustar su diagnóstico con esa información adicional.

El proceso de depuración no siempre termina en el primer intento. Cada corrección te acerca más al código que funciona.

Cuando tu proyecto tiene varios archivos y el error involucra múltiples partes del código, copiar y pegar fragmentos puede volverse complicado. Para esos casos, Claude Code es mucho más potente: trabaja directamente dentro de tu proyecto, puede leer todos los archivos relacionados y ejecutar comandos en la terminal para verificar que el error desapareció.

Para usar Claude Code:

1. Abre Visual Studio Code con tu proyecto
2. Instala Claude Code si aún no lo tienes (ve al tutorial Cómo conectar Claude a Visual Studio Code)
3. Abre el chat de Claude Code y escribe: “Tengo este error: [pega el error]. ¿Puedes revisarlo y corregirlo?”
4. Claude Code puede leer los archivos del proyecto y ejecutar los tests directamente para verificar la corrección

Esta opción requiere el plan Claude Pro ($20/mes). Para la mayoría de los errores del día a día, claude.ai (incluso el plan gratuito) es suficiente.

Si ya tienes cuenta y quieres depurar tu error ahora mismo, sigue este camino rápido:

1. Copia el mensaje de error completo de tu terminal o navegador

2. Abre claude.ai o chatgpt.com y pega esto:

   “Este error aparece en mi código [lenguaje]. ¿Qué significa y cómo lo corrijo? [pega el error aquí] [pega el código relevante aquí]”

3. Aplica el código corregido que te dé la IA y ejecuta de nuevo

Con esto resuelves el 80% de los errores de principiante en menos de 5 minutos.

Problema	Qué hacer
La IA da una solución que no funciona	Responde en el mismo chat indicando que el error persiste y pega el código actualizado con el nuevo mensaje de error
La IA dice que necesita ver más código	Pega los archivos o fragmentos adicionales relevantes para el error
El código de la IA introduce un nuevo error	Dile a la IA cuál es el nuevo error para que ajuste la corrección
No entiendo la explicación	Pide una explicación más simple: “Explícamelo como si fuera mi primera semana programando”
El error es específico de mi entorno	Menciona el sistema operativo, la versión del lenguaje y cómo ejecutas el código