에러가 떴을 때 당황하지 않는 법, AI와 함께 고치는 순서
AI 코딩 중 빨간 에러 글씨가 뜨면 막막한 분께 필요한 글입니다. 에러 읽는 법, AI에게 붙여넣을 정보, 같은 자리에서 맴돌 때의 대처를 정리했습니다.
에러 메시지는 실패가 아니라 다음 단계로 가는 안내판입니다. 메시지 전체와 상황, 직전 변경사항을 함께 AI에게 전달하고, 같은 자리에서 세 번 맴돌면 멈춰서 처음부터 다시 확인합니다.
아래 에러를 같이 고쳐 줘. - 에러 메시지 전체: <여기에 붙여넣기> - 하려던 일: <어떤 버튼·명령을 실행했는지> - 직전에 바꾼 것: <방금 수정한 파일이나 설정> 먼저 에러의 첫 줄과 파일·줄 번호를 짚어서 원인을 설명해 줘. 수정안을 적용한 뒤에는 결과를 다시 알려 줄 테니, 같은 답을 반복하지 말고 그 결과를 반영해서 다음 안을 내 줘.
에러 메시지는 AI 코딩에서 실패가 아니라 다음 단계로 가는 안내판입니다. 화면에 빨간 글씨가 뜨면 당황하기 쉽지만, 그 메시지 안에 무엇이 잘못됐는지가 대부분 적혀 있습니다.
에러 메시지 읽는 법
에러 메시지는 보통 세 부분으로 이루어집니다. 어떤 파일·어느 줄에서 문제가 생겼는지, 무슨 종류의 문제인지, 그리고 왜 그런 문제가 생겼는지에 대한 힌트입니다.
전부 이해하려 하지 않아도 됩니다. 첫 줄(문제 종류)과 파일·줄 번호만 확인해도 AI에게 물어볼 때 훨씬 정확하게 전달할 수 있습니다.
AI에게 붙여넣을 정보 준비하기
에러 메시지만 덜렁 붙여넣으면 AI도 맥락을 모른 채 추측하게 됩니다. 저는 최소한 세 가지를 함께 넣습니다.
에러 메시지는 일부만 잘라 붙이면 원인 파악이 늦어집니다. 무엇을 하려다 생겼는지는 "이 버튼을 눌렀더니", "이 명령을 실행했더니" 같은 상황 설명이고, 대부분의 에러는 방금 바꾼 부분과 관련이 있습니다.
첫 번째 시도가 안 통할 때
AI가 준 첫 번째 수정이 에러를 없애지 못할 때가 있습니다. 이때 같은 요청을 그대로 다시 보내는 것은 도움이 안 됩니다. 대신 "이 수정을 적용했더니 이런 새 메시지가 떴다"처럼 결과를 함께 전달해야 합니다.
에러가 바뀌었다면 그건 진전입니다. 완전히 같은 에러가 반복된다면 애초에 원인 진단이 틀렸다는 신호입니다.
되돌리기(git)로 안전망 확보하기
여러 번 수정을 시도하다 보면 어느 시점이 가장 멀쩡했는지 헷갈리는 순간이 옵니다. 이때를 대비해 되돌릴 수 있는 지점을 미리 만들어 두는 게 안전합니다.
작업이 잘 되는 상태일 때마다 커밋(변경사항을 저장하는 기록점)을 남겨 두면, 여러 번 시도하다 오히려 더 꼬였을 때 그 지점으로 돌아갈 수 있습니다. 이 습관 하나가 "일단 다 지우고 처음부터"를 막아 줍니다.
자주 하는 실수
저도 같은 에러를 고치겠다고 대여섯 번을 계속 시도한 적이 있습니다. 매번 조금씩 다른 수정이 왔지만 에러는 똑같이 떴습니다. 나중에 보니 문제는 제가 붙여넣은 에러 메시지가 일부 잘려 있었던 것이었습니다. 전체 메시지를 다시 붙여넣자 한 번에 해결됐습니다. 이 경험 이후로 세 번 이상 같은 자리에서 맴돈다면 일단 멈추고 에러 메시지 전체를 처음부터 다시 확인합니다.
자주 묻는 질문
에러가 무슨 말인지 하나도 모르겠어요.
전체를 이해하지 않아도 됩니다. 첫 줄과 파일·줄 번호만 확인해서 AI에게 그대로 붙여넣으면 나머지는 AI가 해석을 도와줍니다.
같은 에러가 계속 반복되면요?
같은 요청을 반복하지 말고, 어느 시점부터 문제가 생겼는지 되짚어야 합니다. 직전 커밋과 비교해 보는 것도 방법입니다.
커밋을 안 해뒀는데 꼬여버렸어요.
지금이라도 지금 상태를 별도로 저장해 두고, 그다음부터는 잘 되는 상태마다 커밋하는 습관을 들이면 됩니다.
정리
에러가 뜨면 메시지를 끝까지 읽고, 상황과 직전 변경사항을 함께 전달합니다. 같은 자리에서 세 번 이상 맴돌면 멈추고, 잘 되던 지점으로 돌아갈 수 있도록 미리 커밋해 두는 습관이 안전망이 됩니다.
공식 자료
- 운영자가 직접 작업하며 정리한 내용입니다.