AI 코딩 랩
2026.03.16
·
읽기 8분
⭐ 초급

Claude한테 “파이썬으로 뭐 만들어줘”라고 시켰는데, 나온 결과가 내가 원하던 게 아니었던 적 있으시죠?

“분명 같은 AI인데 블로그에서 본 결과랑 왜 이렇게 다르지?” 싶은 적도 있을 거예요.

답은 간단합니다. 프롬프트(AI에게 보내는 지시문)의 차이예요. AI는 읽심술사가 아니라서, 말한 만큼만 해줍니다. 대충 시키면 대충 나오고, 구체적으로 시키면 구체적으로 나와요.

👉 엉뚱한 요청과 결과로 인해 토큰 사용량만 차감되지 마세요..

이 글에서는 AI에게 코딩을 시킬 때 결과물의 질을 확 올려주는 프롬프트 작성법을 알려드릴게요. 한번 익혀두면 코딩뿐 아니라 모든 AI 활용에 써먹을 수 있습니다.

이 글을 읽으면 알 수 있는 것

• 같은 AI인데 결과가 달라지는 원리
• 나쁜 프롬프트와 좋은 프롬프트의 구체적 차이
• 프롬프트 작성 핵심 공식 3가지
• 복사해서 바로 쓸 수 있는 실전 템플릿 3개
• 원하는 결과가 안 나올 때 수정하는 기술

프롬프트가 왜 중요한가

프롬프트는 AI에게 보내는 “작업 지시서”입니다. 회사에서 신입 직원에게 일을 시킨다고 생각하면 이해가 쉬워요.

“이거 해줘”라고만 하면 신입은 뭘 어떻게 해야 할지 모릅니다. “이 데이터를 받아서, 이런 형태로, 이 조건에 맞게 정리해줘”라고 해야 원하는 결과가 나오죠.

AI도 마찬가지예요. 차이가 있다면, AI는 질문 안 하고 일단 만든다는 점입니다. 정보가 부족해도 알아서 추측하고 결과를 내놓아요. 그래서 프롬프트가 부실하면 AI가 “추측한 결과”를 받게 되는 거예요.

📌 비전공자 팁

프롬프트 잘 쓰는 능력은 코딩 실력이 아니라 “일을 명확하게 지시하는 능력”입니다. 직장에서 기획서나 요청 메일 쓰는 것과 비슷해요. 오히려 비전공자가 더 잘할 수도 있는 영역이에요.

나쁜 프롬프트 vs 좋은 프롬프트

백문이 불여일견. 실제로 어떤 차이가 나는지 3가지 사례로 보여드릴게요.

사례 1: 엑셀 데이터 정리

❌ 나쁜 프롬프트

엑셀 데이터 정리하는 
파이썬 코드 만들어줘

✅ 좋은 프롬프트

매출 데이터가 담긴 엑셀 파일
(sales.xlsx)을 정리하려고 해.
조건:
- A열: 날짜, B열: 상품명, 
  C열: 수량, D열: 금액
- 날짜별로 정렬
- 상품명별 합계 행 추가
- 빈 셀이 있으면 0으로 채우기
- 결과를 새 파일(result.xlsx)로 저장
Python + pandas로 만들어줘.
코드에 비전공자가 이해할 수 있게 
한글 주석 달아줘.

왼쪽은 AI가 “어떤 엑셀? 어떤 데이터? 어떤 형태로?”를 전부 추측합니다. 오른쪽은 추측할 게 없어요. 파일명, 열 구성, 정리 조건, 출력 형태까지 다 알려줬으니까요.

사례 2: 웹 크롤링

❌ 나쁜 프롬프트

뉴스 크롤링 코드 짜줘

✅ 좋은 프롬프트

네이버 뉴스에서 "AI 트렌드" 
키워드로 검색한 결과에서 
최신 10개 기사의 제목, 날짜, 
링크를 가져오는 코드를 만들어줘.
조건:
- Python + requests + 
  BeautifulSoup 사용
- 결과를 CSV 파일로 저장
- 실행할 때마다 날짜가 
  파일명에 포함되게
  (예: news_20260316.csv)
- 에러 처리 포함

사례 3: 간단한 계산기

❌ 나쁜 프롬프트

계산기 만들어줘

✅ 좋은 프롬프트

연봉 실수령액 계산기를 만들어줘.
기능:
- 연봉(만원 단위) 입력하면
  월 실수령액 계산
- 4대보험 + 소득세 반영
- 부양가족 수 선택 가능
- HTML + JavaScript로 
  브라우저에서 바로 실행
디자인은 깔끔하고 심플하게.

패턴이 보이시나요? 좋은 프롬프트의 공통점은 세 가지입니다:

1. 목적이 명확하다 (뭘 만들 건지)
2. 조건이 구체적이다 (어떤 조건으로)
3. 출력 형태가 지정되어 있다 (결과를 어떻게 받을 건지)

프롬프트 작성 핵심 공식 3가지

위에서 본 패턴을 공식으로 정리하면, 이 3가지만 기억하면 됩니다.

1역할 + 목적 먼저 알려주기

AI에게 “너는 ~이고, ~를 만들 거야”라고 맥락을 먼저 잡아주세요. 이게 있고 없고의 차이가 큽니다.

💬 프롬프트 예시

너는 Python 자동화 전문가야.
비전공자인 내가 이해할 수 있게 설명해줘.
회사에서 매주 수동으로 하는 
엑셀 보고서 작성을 자동화하고 싶어.

이렇게 하면 AI가 “아, 비전공자한테 설명하듯이, 엑셀 자동화 맥락에서 답해야겠구나”라고 모드를 잡습니다. 같은 질문이라도 답변의 깊이와 설명 방식이 달라져요.

2조건을 구체적으로 나열하기

AI가 추측하지 않도록, 조건을 리스트로 나열하세요. “이렇게 저렇게 해줘”보다 “-” 기호로 하나씩 쓰는 게 훨씬 효과적이에요.

💬 프롬프트 예시

조건:
- 입력: sales_data.xlsx (A열 날짜, B열 금액)
- 처리: 월별 합계 계산
- 출력: 막대 그래프 (월별 매출)
- 라이브러리: pandas, matplotlib
- 그래프에 한글 폰트 적용 (맑은 고딕)
- 금액은 천 단위 콤마 표시

⚠️ 주의

조건이 많을수록 좋다는 게 아닙니다. AI가 추측할 수밖에 없는 부분만 구체적으로 써주면 돼요. “Python 사용”은 필요하지만, “변수명은 영어로”처럼 당연한 건 안 써도 됩니다.

3출력 형태를 지정하기

코드만 받을 건지, 설명도 같이 받을 건지, 파일로 만들어줄 건지를 알려주세요.

💬 프롬프트 예시

출력 형태:
- 전체 코드를 하나의 .py 파일로
- 코드 각 단계마다 한글 주석 추가
- 실행 방법을 마지막에 따로 설명해줘
- 필요한 라이브러리 설치 명령어도 알려줘

특히 “한글 주석 추가”는 비전공자라면 꼭 넣으세요. 나중에 코드를 수정하거나 다시 볼 때 이해하기가 훨씬 쉬워집니다.

💡 3줄 정리

① 역할 + 목적 → “너는 ~이고, ~를 만들 거야”
② 구체적 조건 → 리스트로 하나씩 나열
③ 출력 형태 → 코드? 설명? 파일? 주석 포함 여부?

실전 프롬프트 템플릿 3개 (복사해서 쓰세요)

위 공식을 적용한 실전 템플릿입니다. 중괄호 {} 부분만 본인 상황에 맞게 바꿔서 쓰면 돼요.

🔧 템플릿 1: 엑셀/데이터 자동화

엑셀 반복 작업, 데이터 정리·분석 자동화에 사용
💬 복사용 프롬프트

너는 Python 데이터 자동화 전문가야.
비전공자인 내가 이해할 수 있게 설명해줘.
목적: {어떤 작업을 자동화하고 싶은지}
입력 파일: {파일명.xlsx}
- {A열: 이름, B열: 날짜, C열: 금액 등 구조}
처리 조건:
- {조건 1: 예) 날짜별 정렬}
- {조건 2: 예) 중복 제거}
- {조건 3: 예) 합계 행 추가}
출력:
- 결과를 {새 파일/같은 파일}에 저장
- Python + pandas 사용
- 코드에 한글 주석 추가
- 필요한 라이브러리 설치 명령어 포함

🌐 템플릿 2: 웹 데이터 수집 (크롤링)

웹사이트에서 정보를 자동으로 가져오기
💬 복사용 프롬프트

너는 웹 크롤링 전문가야.
비전공자인 내가 이해할 수 있게 설명해줘.
목적: {어디서 어떤 정보를 가져오고 싶은지}
대상 사이트: {URL 또는 사이트명}
수집 항목: {제목, 가격, 날짜, 링크 등}
수집 범위: {최신 10개 / 전체 / 특정 기간}
출력:
- 결과를 CSV 파일로 저장
- 파일명에 오늘 날짜 포함
- Python + requests + BeautifulSoup
- 에러 처리 포함 (사이트 접속 실패 등)
- 코드에 한글 주석 추가

📊 템플릿 3: 간단한 웹 도구 만들기

브라우저에서 바로 쓸 수 있는 계산기/변환기/대시보드
💬 복사용 프롬프트

너는 웹 개발 전문가야.
비전공자인 내가 바로 쓸 수 있게 만들어줘.
만들고 싶은 것: {연봉 계산기 / 환율 변환기 등}
기능:
- {기능 1: 예) 연봉 입력하면 실수령액 계산}
- {기능 2: 예) 4대보험 항목별 금액 표시}
- {기능 3: 예) 부양가족 수 선택 가능}
기술:
- HTML + CSS + JavaScript 단일 파일
- 브라우저에서 파일 열면 바로 실행
- 모바일에서도 잘 보이게 반응형
디자인: 깔끔하고 심플하게, 
배경은 흰색 계열로.

✅ 활용 팁

위 템플릿을 메모장이나 노션에 저장해두고, 필요할 때 {} 부분만 바꿔서 쓰세요. 매번 처음부터 프롬프트를 짜는 것보다 템플릿을 커스터마이징하는 게 훨씬 빠릅니다.

클로드에 직접 프롬프트를 입력해봅니다. 

정말 짧은 시간에 멋진 연봉 계산기가 만들어 졌어요.

AI가 만들어준 연봉계산기를 페이지에 삽입해보도록 할게요.

잘 동작하는지 눌러봅시다 ㅎㅎ

연봉 계산기

연봉을 입력하면 실수령액을 바로 확인하세요

2025년 기준

연봉 정보 입력
연봉 (세전)

만원
3,000
4,000
5,000
6,000
8,000
1억
부양가족 수 (본인 포함)
1명 (본인)2명3명4명5명6명 이상
20세 이하 자녀 수
0명1명2명3명 이상
비과세액 포함 (월 20만원)





월 실수령액
0원
연 실수령액 0원
실수령 비율 0%

연봉 구성 비율
실수령
4대보험
세금

4대보험 공제 내역
국민연금
0원
건강보험
0원
장기요양보험
0원
고용보험
0원
4대보험 합계
0원

세금 공제 내역
소득세
0원
지방소득세
0원
세금 합계
0원

월급 요약
월급 (세전)
0원
4대보험
-0원
세금
-0원
실수령액
0원
본 계산기는 2025년 4대보험요율 기준 추정치이며,
실제 급여와 다를 수 있습니다. 정확한 금액은 회사 급여 담당자에게 확인하세요.

원하는 결과가 안 나올 때 — 수정 프롬프트 기술

아무리 프롬프트를 잘 써도 한 번에 완벽한 결과가 나오는 경우는 드뭅니다. 오히려 “한 번에 되면 럭키”이고, 보통은 2~3번 수정하면서 완성하는 게 정상이에요.

수정할 때 쓰는 기술이 따로 있습니다.

기술 1: 에러 메시지 그대로 붙여넣기

코드를 실행했는데 에러가 나면, 에러 메시지를 한 글자도 안 바꾸고 그대로 Claude에게 보내세요.

💬 수정 프롬프트 예시

위 코드를 실행했더니 이런 에러가 나:
ModuleNotFoundError: No module named 'openpyxl'
어떻게 해결하면 돼?

에러 메시지에는 AI가 문제를 진단하는 데 필요한 정보가 다 들어 있어요. “에러 났어”라고만 하면 AI도 뭐가 문제인지 추측해야 합니다.

기술 2: “이 부분만 바꿔줘”

전체를 다시 만들어달라고 하면 이전에 잘 되던 부분까지 바뀔 수 있어요. 수정이 필요한 부분만 콕 집어서 말하세요.

💬 수정 프롬프트 예시

코드는 잘 돌아가는데, 
그래프에서 한글이 깨져.
그래프 부분만 수정해줘:
- 폰트를 '맑은 고딕'으로 변경
- x축 라벨이 겹치지 않게 45도 회전
- 나머지 코드는 그대로 두고.

기술 3: 대화를 이어가며 점진적 개선

처음부터 완벽한 프롬프트를 쓸 필요는 없어요. 대화를 통해 점점 구체화하면 됩니다.

💡 대화 흐름 예시

1회차: “엑셀 매출 데이터 정리하는 코드 만들어줘” → 기본 코드 받음
2회차: “여기에 월별 합계 계산 추가해줘” → 기능 추가
3회차: “결과를 그래프로도 보여줘” → 시각화 추가
4회차: “그래프 색상 바꾸고 제목 넣어줘” → 디자인 수정

이렇게 하면 4번의 간단한 대화로 꽤 완성도 높은 결과물을 만들 수 있습니다. 처음부터 조건 20개를 나열하는 것보다 이 방법이 더 쉬울 때가 많아요.

🐛 여기서 막혔습니다

프롬프트를 수정했는데 이전에 잘 되던 부분까지 망가지는 경우가 있어요. 이건 대화가 너무 길어졌을 때 자주 발생합니다.

해결법: 대화가 10번 이상 오갔으면, 현재 잘 되는 코드를 새 대화에 통째로 붙여넣고 거기서 수정을 이어가세요. “아래 코드에서 ~부분만 수정해줘”로 시작하면 됩니다.

이렇게 하면 AI가 이전 대화 맥락에 헷갈리지 않고, 현재 코드 기준으로 깔끔하게 수정해줍니다.

👉 하나의 대화창에서 계속 수정수정 하다보면 엉망이 될때가 있어요. 잘된다고 생각될때 한번 끊고 가는 것도 좋아요.

자주 하는 실수 TOP 5

📌 이것만 피해도 결과가 달라집니다
1
“알아서 잘 해줘”
AI는 “잘”의 기준을 모릅니다. “잘”이 뭔지 구체적으로 알려줘야 해요. 파일 형태, 정렬 순서, 포함할 항목을 명시하세요.
2
한 번에 너무 많은 걸 시키기
“데이터 정리하고 분석하고 그래프 그리고 보고서도 써줘.” 이러면 어중간한 결과가 나옵니다. 한 번에 하나씩 시키고, 결과 확인 후 다음 단계를 시키세요.
3
에러 나면 “에러 났어”만 보내기
에러 메시지를 전부 복사해서 보내세요. “에러 났어”만으로는 AI도 원인을 모릅니다.
4
파일 구조를 안 알려주기
엑셀/CSV 파일을 다룰 때는 열 이름, 데이터 형태, 행 수 등을 알려줘야 해요. 데이터 샘플 2~3줄을 같이 보내면 정확도가 확 올라갑니다.
5
새 대화에서 “아까 그 코드” 언급하기
AI는 이전 대화를 기억하지 못합니다. 새 대화를 열었으면 코드를 다시 붙여넣어야 해요. “아까 만든 코드에서 ~만 바꿔줘”는 안 통합니다.

💡 핵심 요약

• 프롬프트는 AI에게 보내는 “작업 지시서”. 구체적일수록 결과가 좋아집니다.
• 핵심 공식: ① 역할+목적 → ② 구체적 조건 → ③ 출력 형태
• 한 번에 완벽한 결과가 안 나오는 게 정상. 대화를 이어가며 수정하세요.
• 에러 메시지는 한 글자도 안 바꾸고 그대로 보내세요.
• 실전 템플릿을 저장해두고 {} 부분만 바꿔 쓰면 시간이 절약됩니다.

프롬프트 연습, 지금 바로 해보세요

위 템플릿 중 하나를 복사해서 Claude에게 보내보세요. 직접 해봐야 감이 옵니다.

Claude에서 시작하기 →

🔗 다음으로 읽으면 좋은 글

• 비전공자의 AI 코딩 시작 가이드 (전체 로드맵)
• Python 설치부터 첫 실행까지 (완전 초보용)
• 에러가 나면? AI한테 고쳐달라고 하는 법
• 직장인이 매일 쓰는 AI 프롬프트 모음

이 글은 AI 코딩 입문자를 위해 작성되었습니다.
프롬프트 예시는 직접 테스트를 거쳤으며, 학습/참고 목적으로 활용해주세요.
실무 적용 시 결과를 반드시 확인하고 사용하시기 바랍니다.