How to debug code errors with AI

When your code fails, the programming environment (the terminal, browser, or IDE) shows an error message. That message contains key information that AI needs to help you:

• Error type: for example, TypeError, SyntaxError, NameError, 404, undefined is not a function
• Line number: indicates where the problem occurred in your code
• Description: a phrase explaining what went wrong

Copy the full message, including all lines of the error trace (traceback or stack trace). Do not summarize or shorten it: the more complete it is, the better AI can diagnose it.

If the error appears in the browser, press F12, go to the Console tab and copy the full red text.

Open claude.ai or chatgpt.com and sign in. Then write a message that includes:

1. One brief line explaining what you were trying to do
2. The full error message (pasted as is)
3. The code snippet where the error occurs

Example of a good message for AI:

“I am learning Python and I get this error when running my script. Can you explain what it means and how to fix it?

Error:

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

My code:

quantity = 5
price = input("What is the price? ")
total = quantity + price
print(f"The total is {total}")
```"

The key is giving context. Do not just paste the error: briefly explain what you were trying to do.

To learn how to write better messages for AI, the tutorial How to write effective prompts for artificial intelligence has techniques you can apply directly here.

AI usually responds with three parts:

1. Error explanation: what it means and why it occurred
2. Fixed code: the version of the code with the problem solved
3. Explanation of the fix: what changed and why it works now

Do not copy the fixed code without reading the explanation. Try to understand what happened: that way you avoid making the same mistake in the future.

If the response is not clear, ask again in the same chat:

• “Can you explain it more simply?”
• “What exactly does the line you added do?”
• “Is there another way to solve this?”

AI does not get tired of answering. Use it to genuinely learn.

Apply the changes the AI suggested to your code and run it again:

1. Copy the fixed code from the AI response
2. Replace the problematic snippet in your file
3. Save the file and run the program again
4. Check that the error is gone

If a different error appears, go back to step 2 with that new message. It is normal for one error to reveal another hidden problem: follow the same process.

If the same error persists, reply in the AI chat with: “I applied your fix but the error still appears. Here is the updated code and the new message: […]”. AI can adjust its diagnosis with that additional information.

The debugging process does not always end on the first try. Each fix brings you closer to working code.

When your project has multiple files and the error involves several parts of the code, copying and pasting snippets can get complicated. For those cases, Claude Code is much more powerful: it works directly inside your project, can read all related files, and run commands in the terminal to verify the error is gone.

To use Claude Code:

1. Open Visual Studio Code with your project
2. Install Claude Code if you do not have it yet (see the tutorial How to connect Claude to Visual Studio Code)
3. Open the Claude Code chat and type: “I have this error: [paste error]. Can you review it and fix it?”
4. Claude Code can read the project files and run tests directly to verify the fix

This option requires the Claude Pro plan ($20/mo). For most everyday errors, claude.ai (even the free plan) is enough.

If you already have an account and want to debug your error right now, follow this quick path:

1. Copy the full error message from your terminal or browser

2. Open claude.ai or chatgpt.com and paste this:

   “This error appears in my [language] code. What does it mean and how do I fix it? [paste the error here] [paste the relevant code here]”

3. Apply the corrected code the AI gives you and run again

This solves 80% of beginner errors in under 5 minutes.

Problem	What to do
AI gives a solution that does not work	Reply in the same chat saying the error persists and paste the updated code with the new error message
AI says it needs to see more code	Paste the additional files or snippets relevant to the error
AI’s code introduces a new error	Tell AI about the new error so it can adjust the fix
I do not understand the explanation	Ask for a simpler explanation: “Explain it like it is my first week programming”
The error is specific to my environment	Mention the OS, language version, and how you run the code