AI 코드 실행 오류 질문법, 파이썬·VBA 고치는 요령
비전공자라도 AI에게 부탁하면 수백 개 엑셀 파일을 하나로 합치는 파이썬 스크립트나 버튼 하나로 서식을 정리하는 엑셀 VBA 매크로를 10초 만에 받아 올 수 있는 시대입니다. 그런데 들뜬 마음으로 코드를 실행 버튼을 누르자마자 빨간 에러 글씨가 줄줄이 뜨면서 멈춰 버리면, 어디가 틀렸는지 몰라 막막해집니다.
이때 “안 돌아가는데 다시 짜 줘”라고만 물으면 AI도 똑같은 오류를 낼 가능성이 높습니다. 내 컴퓨터의 폴더 경로, 운영체제, 설치된 프로그램 버전이라는 단서를 정확히 건네는 AI 코드 실행 오류 질문법을 익히면 코딩을 깊이 몰라도 빠르게 문제를 바로잡을 수 있습니다.
AI가 완벽하다고 준 코드가 내 PC에서만 멈추는 이유
AI는 내 컴퓨터 화면을 직접 들여다보고 코드를 짜는 것이 아닙니다. “보통 윈도우 사용자라면 pandas 라이브러리가 깔려 있겠지”, “파일 경로는 영문일 거야”, “엑셀 시트 이름은 Sheet1이겠지”처럼 표준적인 가정을 바탕으로 코드를 생성합니다.
따라서 내 PC에 해당 파이썬 패키지가 설치되지 않았거나, 예전 버전 문법이 바뀌었거나, 윈도우 파일 경로에 한글·공백이 섞여 있거나, 혹은 엑셀 VBA에서 64비트 오피스 호환 선언이 빠져 있으면 코드 논리는 맞더라도 실행 순간 오류가 발생합니다.
내 PC 환경 변수와 AI 코드 실행 오류 질문법 원리
병원 진료에 빗대면 이해가 쉽습니다. 전화로 의사에게 “약 먹었는데 계속 아파요”라고만 하면 의사는 무슨 증상인지 알 길이 없어 엉뚱한 처방을 내릴 수밖에 없습니다. 반면 체온계 숫자와 혈압, 아픈 부위를 정확히 찍어서 알려 주면 원인을 바로 짚어 냅니다.
컴퓨터에서 체온계 숫자에 해당하는 것이 바로 터미널에 출력된 에러 트레이스백(Traceback, 오류 추적 로그) 전체 문장과 내 PC의 환경 정보(OS, 파이썬·엑셀 버전, 실제 시트/열 이름)입니다. AI 코드 실행 오류 질문법의 핵심은 내 생각으로 오류를 요약하지 말고, 기계가 토해 낸 에러 원문과 실행 환경을 통째로 AI에게 복사해 건네는 데 있습니다.
에러 메시지 그대로 붙여서 한 번에 고치는 4단계 질문법
파이썬이나 엑셀 VBA 코드가 멈췄을 때는 아래 4단계 순서대로 정보를 모아 다시 질문하면 수정 성공률이 크게 올라갑니다.
AI 코드 에러 해결을 위한 정확한 재질문 4단계
- 에러 메시지 첫 줄부터 마지막 줄까지 통째로 복사: 터미널 에러에서 맨 마지막 줄만 자르거나 “파일 에러 났어요”라고 말로 풀지 말고,
Traceback (most recent call last):부터 맨 아래 오류 이름(예:ModuleNotFoundError,FileNotFoundError,UnicodeDecodeError)까지 전체를 복사해 붙여 넣습니다. (엑셀 VBA는 팝업에 뜬 ‘런타임 오류 번호’와 노란색으로 하이라이트된 디버그 줄을 복사합니다.) - 내 PC 실행 환경 3가지 함께 적기: 운영체제(예: 윈도우 11, macOS), 파이썬 버전(터미널에
python --version입력) 또는 엑셀 버전(64비트/32비트, 한국어판 여부), 실행 중인 폴더 위치를 한 줄로 적습니다. - 실제 파일 구조·경로 예시 알려 주기: 오류가 경로·데이터 형식 문제라면 “실제 내 폴더 경로는
C:\Users\...\바탕화면\매출이고, 엑셀 첫 행 열 이름은거래일자, 거래처명, 공급가액이야”처럼 실제 환경과 다른 부분을 짚어 줍니다. - 코드 실행 전 안전 백업 및 주의 확인: 파일 삭제·덮어쓰기·이동이 들어간 자동화 코드를 고칠 때는 반드시 “원본 파일을 덮어쓰지 말고
output새 폴더에 저장하도록 고쳐 줘”라고 요청하고, 연습용 사본 폴더에서 먼저 테스트합니다.
잘못된 재질문 vs 정확한 디버깅 질문 비교 표
같은 오류가 났을 때 질문 방식에 따라 AI의 해결 속도가 어떻게 달라지는지 비교했습니다.
| 구분 | 막연한 재질문 (시행착오 반복) | 환경·에러 포함 디버깅 질문 |
|---|---|---|
| 질문 예시 | “방금 준 파이썬 코드 돌렸는데 에러 나고 안 돼요. 다시 짜 줘.” | “윈도우 11, Python 3.12 환경에서 실행했더니 아래 에러가 떴어. [Traceback 전체 복사] 내 CSV 파일은 한글 포함이고 첫 열 이름은 ‘주문번호’야. 원인 설명과 수정 코드 알려 줘.” |
| AI의 대응 | 라이브러리 미설치인지 경로 오타인지 몰라 비슷하게 다시 생성 | pip install 명령어나 인코딩(utf-8-sig) 보완, 정확한 열 이름 수정 코드 제시 |
핵심 정리
AI 코드 실행 오류 질문법에서 가장 중요한 습관은 에러 원인을 내 말로 추측해 요약하지 않는 것입니다. 터미널 트레이스백이나 VBA 런타임 오류 번호, 내 OS·프로그램 버전, 그리고 실제 폴더·열 이름 정보 세 가지를 그대로 붙여서 물어보면 AI가 내 PC 환경에 딱 맞는 수정 코드를 즉시 찾아낼 수 있습니다.
재발 방지 체크리스트
재발 방지 체크리스트
- 코드 오류 시
Traceback첫 줄부터 끝 줄 또는 VBA 오류 번호·노란 줄 전체를 그대로 복사하기 - 질문에 내 OS, 파이썬/엑셀 버전, 실제 파일의 열 이름·시트 이름 함께 적기
- 새로운 자동화 코드를 돌리기 전 반드시 원본 파일 사본을 백업 폴더에 따로 복사해 두기
- 한글 파일명·공백 경로 문제 예방을 위해 작업 폴더는 가급적 짧고 단순한 영문 경로 활용하기









