있어요. 클로드(Claude) 무료 버전에 에러 메시지 전체와 하던 일을 함께 붙여 넣고 아래 프롬프트로 물으면, 원인 후보와 확인 방법, 고치는 순서가 한 번에 나와요. 에러 문구를 검색해 글을 여러 개 뒤지던 일을 대화 한 번으로 줄이는 방법이에요.
이런 분께
- 엑셀 자동화 스크립트나 사내 도구를 돌리다 빨간 글씨가 뜨면 손을 놓게 되는 분
- 개발을 막 시작해서 에러 메시지 중 어디를 봐야 할지 모르는 분
끝나면 이렇게 됩니다
파이썬으로 엑셀을 읽다가 KeyError: '매출'이 뜬 상황을 이 프롬프트로 실제로 물어본 답이에요(2026-11-03 실행, 일부 발췌).
- 한 줄 요약: 표에서 '매출'이라는 열을 찾으려 했는데 그 이름의 열이 없어서 멈췄어요.
- 원인 후보: ① 머리글 글자가 달라요('매출 '처럼 뒤에 공백, 또는 '매출액') ② 머리글이 첫 줄이 아니에요 ③ 다른 시트를 읽었어요.
- 고치는 순서:
print(df.columns.tolist())로 열 이름 확인 → 공백이면df.columns = df.columns.str.strip()→ 머리글이 둘째 줄이면header=1지정
어디부터 손대야 하는지 순서가 보여서 덜 막막해요.
준비물
- 클로드 계정(무료 요금제로 돼요, 2026년 11월 기준)
- 에러 메시지 전체. 마지막 한 줄만으로는 원인을 좁히기 어려워요.
따라 하기
- 에러가 난 창에서 빨간 글씨를 맨 윗줄부터 끝까지 드래그해 복사해요.
- claude.ai를 열고 「New chat」으로 새 대화를 시작해요.
- 아래 프롬프트를 붙여 넣고 대괄호 세 곳(하던 일, 에러 메시지, 환경)을 채워 보내요.
- 답의 4번 「고치는 순서」를 위에서부터 하나씩 해 봐요.
- 안 되면 해 본 결과와 새로 뜬 에러를 그대로 붙여 넣고 "이렇게 했더니 이렇게 나와"라고 이어서 물어요.
복사해서 쓰는 프롬프트
너는 친절한 시니어 개발자야. 아래 에러를 보고 이 순서로 답해 줘.
1. 한 줄 요약: 무슨 일이 일어났는지 쉬운 말로
2. 가능성 높은 원인 3가지(높은 순)
3. 원인마다 확인하는 방법 1가지
4. 고치는 순서: 바로 해 볼 수 있는 것부터 번호로
5. 정확히 알려면 내가 더 보여 줘야 할 것
추측이면 "추측"이라고 표시하고, 모르는 건 모른다고 해 줘.
[하던 일]
[에러 메시지 전체]
[환경]
- [하던 일] 예: 파이썬으로 영업 실적 엑셀을 읽어 합계를 내는 중
- [에러 메시지 전체] 예: Traceback으로 시작하는 빨간 글씨 전부
- [환경] 예: 윈도우 11, 파이썬 3.12, pandas 사용
AI에게 통째로 맡기기
위 가이드대로 내 에러를 같이 풀어 줘. 한 단계씩 확인을 시키고, 내가 결과를 알려 주면 다음 단계로 넘어가 줘.
자주 막히는 곳
중간에 막히면 아래부터 봐요.
- 답이 너무 뻔하게 나올 때: 에러 마지막 줄만 넣었을 가능성이 커요. Traceback 전체와 에러 난 줄 앞뒤 코드 10줄을 같이 넣어요.
- 회사 코드라 붙여 넣기 꺼려질 때: 비밀번호, API 키(서비스에 접속하는 비밀 열쇠), 고객 이름은
***로 바꾼 뒤 넣어요. - 알려 준 대로 했는데 다른 오류가 뜰 때: 새 오류를 붙이고 "1번 원인은 아니었어"라고 알려 주면 후보를 좁혀 줘요.
확인
고친 뒤 같은 작업을 다시 돌려 에러 없이 끝나면 성공이에요. 같은 에러가 또 나면 답의 5번 「더 보여 줘야 할 것」을 챙겨서 다시 물어요.
