코딩 프롬프트는 '동작 설명서'처럼 써야 한다
AI에게 코드를 부탁할 때 가장 흔한 실수는 이렇게 말하는 것이다.
엑셀 자동화 코드 짜줘.
이 오류 고쳐줘.
크롤링 코드 만들어줘.
이런 요청은 너무 넓다. AI는 무엇을 입력받아야 하는지, 어떤 결과를 내야 하는지, 어디에서 실행할 코드인지 추측해야 한다. 코딩 프롬프트는 질문이라기보다 작은 개발 의뢰서에 가깝다.
좋은 코딩 프롬프트에는 다음 정보가 들어간다.
원하는 동작: 무엇을 자동으로 처리할 것인가
입력값: 어떤 데이터, 파일, 표, 텍스트를 사용할 것인가
출력값: 결과가 어떤 형태로 나와야 하는가
실행 환경: 엑셀, 구글 시트, 파이썬, 자바스크립트, 운영체제, 버전 등
제약 조건: 사용 가능한 라이브러리, 금지할 방식, 속도, 보안 조건
오류 상황: 현재 에러 메시지, 기대 결과와 실제 결과
검증 방법: 잘 작동하는지 확인할 테스트 예시
핵심은 간단하다. "코드 짜줘"가 아니라 "이 입력을 넣으면 이런 출력이 나오도록, 이 환경에서 실행 가능한 코드를 만들어줘"라고 요청해야 한다.
AI 생성 이미지
엑셀·구글 시트 자동화 프롬프트
언제 쓰는가
엑셀과 구글 시트 자동화는 비개발자에게 가장 실용적인 AI 활용 영역이다. 반복되는 정리, 조건별 분류, 날짜 계산, 매출 집계, 중복 제거, 이메일 목록 정리 등에 바로 쓸 수 있다.
단순 수식이면 엑셀 함수나 구글 시트 함수로 충분하다. 반복 실행이 필요하면 VBA, Office Script, Google Apps Script를 요청하면 된다.
그대로 쓰는 프롬프트
당신은 엑셀/구글 시트 자동화 전문가입니다.
아래 조건에 맞는 해결 방법을 제안해 주세요.
[사용 도구]: 엑셀 / 구글 시트
[데이터 구조]:
- A열: [열 이름과 예시]
- B열: [열 이름과 예시]
- C열: [열 이름과 예시]
[원하는 작업]: [예: 상태가 '완료'인 행만 모아 월별 합계를 계산]
[원하는 결과]: [예: 새 시트에 월, 건수, 합계 금액 표로 출력]
[조건]:
- 초보자도 따라 할 수 있게 설명
- 가능하면 수식으로 먼저 제안
- 수식으로 어렵다면 스크립트 코드 제안
- 붙여넣을 위치와 실행 방법까지 설명
출력 형식:
1. 추천 방법
2. 사용할 수식 또는 코드
3. 적용 순서
4. 주의할 점예시
당신은 구글 시트 자동화 전문가입니다.
[사용 도구]: 구글 시트
[데이터 구조]:
- A열: 주문일, 예: 2026-05-01
- B열: 상품명, 예: 무선 키보드
- C열: 주문상태, 예: 완료 / 취소 / 환불
- D열: 결제금액, 예: 35000
[원하는 작업]: 주문상태가 '완료'인 데이터만 기준으로 월별 매출 합계를 계산하고 싶습니다.
[원하는 결과]: 새 시트에 월, 완료 주문 수, 매출 합계가 나오게 해 주세요.
[조건]:
- 먼저 구글 시트 수식으로 해결할 수 있는지 알려 주세요.
- 수식이 복잡하면 Google Apps Script도 제안해 주세요.
- 초보자가 그대로 따라 할 수 있게 단계별로 설명해 주세요.더 잘 쓰는 팁
표 자동화를 요청할 때는 열 이름을 정확히 알려주는 것이 중요하다. "매출 데이터"라고 쓰기보다 "A열은 주문일, B열은 상품명, C열은 상태, D열은 금액"처럼 적어야 한다.
날짜 형식도 꼭 알려주자. 2026-05-01, 2026.05.01, 5/1/2026은 도구에 따라 다르게 처리될 수 있다. 통화, 소수점, 빈칸, 중복값이 있는지도 함께 말하면 오류가 줄어든다.
응용 방식
고객 명단에서 중복 이메일 제거하기
결제 내역에서 환불 건만 따로 모으기
담당자별 업무 건수 자동 집계하기
마감일이 지난 항목에 색상 표시하기
매주 같은 형식의 보고용 표 만들기
파이썬·자바스크립트 자동화 프롬프트
언제 쓰는가
파이썬은 파일 정리, 데이터 가공, 엑셀 처리, 간단한 크롤링, 텍스트 변환에 강하다. 자바스크립트는 웹페이지 동작, 브라우저 자동화, 구글 Apps Script, 간단한 API 연동에 자주 쓰인다.
초급자는 처음부터 완성도 높은 프로그램을 요구하기보다 "작게 작동하는 코드"를 먼저 만든 뒤 개선하는 방식이 좋다.
그대로 쓰는 프롬프트
당신은 초급자를 도와주는 프로그래밍 튜터입니다.
[사용 언어]: 파이썬 / 자바스크립트
[실행 환경]: [예: Windows 11, Python 3.12, VS Code]
[자동화 목표]: [무엇을 자동화할지]
[입력값]: [파일, 폴더, 텍스트, URL, 표 구조 등]
[출력값]: [저장 파일, 화면 출력, 새 폴더, 표 등]
[제약 조건]:
- [사용 가능한 라이브러리]
- [사용하면 안 되는 방식]
- [초보자가 이해할 수 있는 코드]
요청:
1. 전체 흐름을 먼저 설명해 주세요.
2. 실행 가능한 최소 코드를 작성해 주세요.
3. 코드에 핵심 주석을 달아 주세요.
4. 설치해야 할 패키지와 실행 방법을 알려 주세요.
5. 예상 오류와 해결 방법을 함께 알려 주세요.예시
당신은 초급자를 도와주는 파이썬 튜터입니다.
[사용 언어]: 파이썬
[실행 환경]: macOS, Python 3.11, VS Code
[자동화 목표]: 특정 폴더 안의 PDF 파일명을 날짜_거래처명 형식으로 바꾸고 싶습니다.
[입력값]: 파일명 예시는 'invoice_ABC_20260501.pdf'입니다.
[출력값]: '2026-05-01_ABC.pdf' 형식으로 변경된 파일명
[제약 조건]:
- 원본 파일을 바로 바꾸기 전에 변경 예정 목록을 먼저 출력해 주세요.
- 사용자가 확인한 뒤 실제 변경하도록 만들어 주세요.
- 초보자가 이해할 수 있게 주석을 달아 주세요.
전체 흐름, 코드, 실행 방법, 주의할 점을 알려 주세요.더 잘 쓰는 팁
자동화 코드는 처음부터 많은 기능을 넣으면 실패하기 쉽다. 먼저 1개의 파일, 3개의 행, 1개의 예시 URL처럼 작은 샘플로 테스트하자. 잘 작동하면 그다음에 전체 폴더나 전체 데이터로 확장한다.
또한 AI에게 "최소 작동 버전"을 먼저 요청하면 좋다. 최소 작동 버전은 필요한 기능만 담은 가장 단순한 코드다. 이후 예외 처리, 로그 기록, 속도 개선, 사용자 입력 기능을 차례로 추가하면 된다.
오류 해결을 위한 디버깅 프롬프트
언제 쓰는가
코딩에서 오류는 자연스러운 과정이다. 중요한 것은 에러 메시지를 숨기지 않고 정확히 전달하는 것이다. "안 돼요"보다 "이 코드를 실행했더니 이런 에러가 났고, 나는 이런 결과를 기대했다"가 훨씬 좋다.
그대로 쓰는 프롬프트
당신은 디버깅을 도와주는 개발자입니다.
아래 코드의 오류 원인을 찾아 주세요.
[사용 언어]: [예: Python]
[실행 환경]: [예: Python 3.12, Windows 11, VS Code]
[하려던 작업]: [기대했던 동작]
[실제 결과]: [실제로 일어난 일]
[에러 메시지]:
[에러 메시지 전체 붙여넣기]
[문제가 된 코드]:
[코드 붙여넣기]
요청:
1. 오류 원인을 초보자도 이해할 수 있게 설명해 주세요.
2. 수정된 코드를 제시해 주세요.
3. 왜 그렇게 고쳤는지 설명해 주세요.
4. 같은 오류를 막기 위한 체크리스트를 알려 주세요.더 잘 쓰는 팁
에러 메시지는 일부만 자르지 말고 가능한 한 전체를 붙여넣자. 특히 파일 경로, 줄 번호, 오류 이름이 중요하다. 다만 회사 내부 경로, 고객 정보, API 키, 비밀번호 같은 민감한 정보는 반드시 지우고 공유해야 한다.
좋은 디버깅 요청에는 세 가지가 함께 들어간다.
기대 결과: 원래 무엇이 되어야 했는가
실제 결과: 무엇이 다르게 나왔는가
재현 방법: 어떤 순서로 실행했을 때 문제가 생기는가
기존 코드를 읽기 쉽게 만드는 프롬프트
언제 쓰는가
AI는 새 코드를 만드는 것뿐 아니라 기존 코드를 정리하는 데도 유용하다. 변수 이름이 헷갈리거나, 함수가 너무 길거나, 주석이 부족하거나, 같은 코드가 반복될 때 리팩터링을 요청할 수 있다. 리팩터링은 코드의 동작은 유지하면서 구조를 더 읽기 좋게 바꾸는 작업이다.
그대로 쓰는 프롬프트
당신은 코드 리뷰어입니다.
아래 코드를 더 읽기 쉽고 유지보수하기 좋게 개선해 주세요.
[사용 언어]: [언어]
[코드 목적]: [이 코드가 하는 일]
[유지해야 할 동작]: [절대 바뀌면 안 되는 결과]
[개선하고 싶은 점]:
- 변수명 개선
- 함수 분리
- 중복 제거
- 주석 추가
- 예외 처리 추가
[기존 코드]:
[코드 붙여넣기]
출력 형식:
1. 현재 코드의 문제점 요약
2. 개선된 코드
3. 변경한 이유
4. 동작이 바뀌지 않았는지 확인할 테스트 예시더 잘 쓰는 팁
리팩터링을 요청할 때는 "더 좋게 해줘"라고만 쓰지 말고 "동작은 바꾸지 말고", "초급자가 읽기 쉽게", "함수 단위로 나누어", "주석은 핵심 로직에만"처럼 기준을 정해야 한다.
AI가 코드를 정리하면서 의도치 않게 동작을 바꿀 수 있다. 그래서 반드시 테스트 예시를 함께 요청해야 한다. 입력값과 기대 출력값을 비교하면 코드가 정말 같은 일을 하는지 확인할 수 있다.
API·크롤링·파일 정리 자동화 설계 프롬프트
언제 쓰는가
API 연동, 크롤링, 파일 정리는 반복 업무 자동화의 대표 사례다. API는 다른 서비스의 데이터를 정해진 방식으로 주고받는 연결 통로다. 크롤링은 웹페이지에서 필요한 정보를 수집하는 작업이다.
이런 작업은 바로 코드부터 쓰기보다 전체 흐름을 먼저 설계해야 한다. 어떤 데이터를 가져오고, 어디에 저장하고, 실패하면 어떻게 처리할지 정하지 않으면 코드가 쉽게 엉킨다.
그대로 쓰는 프롬프트
당신은 업무 자동화 설계자입니다.
아래 반복 작업을 자동화하는 흐름을 설계해 주세요.
[자동화 대상 업무]: [예: 매일 특정 API에서 주문 데이터를 받아 엑셀로 저장]
[입력 데이터]: [API, 웹페이지, 폴더, 파일 등]
[처리 과정]: [필터링, 변환, 합치기, 정렬 등]
[출력 결과]: [CSV, 엑셀, 구글 시트, 이메일, 대시보드 등]
[실행 주기]: [매일, 매주, 수동 실행 등]
[실패 시 처리]: [로그 저장, 알림, 재시도 등]
[보안 조건]: [API 키 관리, 개인정보 제외 등]
요청:
1. 전체 자동화 흐름을 단계별로 설계해 주세요.
2. 각 단계에서 필요한 도구나 라이브러리를 제안해 주세요.
3. 초보자가 먼저 만들 수 있는 최소 버전을 제안해 주세요.
4. 이후 확장 기능을 제안해 주세요.
5. 주의해야 할 보안·법적·운영 리스크를 알려 주세요.응용 방식
매일 다운로드한 CSV 파일을 하나로 합치기
특정 폴더의 이미지 파일을 날짜별 폴더로 이동하기
고객 문의 메일을 유형별로 분류해 시트에 기록하기
공개 API에서 환율이나 날씨 정보를 받아 보고서에 넣기
웹페이지의 가격 정보를 확인해 변동이 있으면 알림 보내기
크롤링을 요청할 때는 사이트의 이용 약관과 robots.txt 같은 접근 정책을 확인해야 한다. 로그인 정보가 필요한 페이지, 유료 콘텐츠, 개인정보가 포함된 페이지를 무단으로 수집하면 문제가 될 수 있다.
AI가 만든 코드 점검 프롬프트
언제 쓰는가
AI가 만든 코드는 초안이다. 실행은 될 수 있지만 안전하다는 뜻은 아니다. 특히 파일 삭제, 결제, 고객 정보, API 키, 데이터베이스 수정처럼 영향이 큰 작업은 반드시 점검해야 한다.
그대로 쓰는 프롬프트
당신은 보안과 안정성을 점검하는 코드 리뷰어입니다.
아래 코드를 실행하기 전에 위험 요소를 검토해 주세요.
[코드 목적]: [무엇을 하는 코드인지]
[실행 환경]: [로컬 PC, 서버, 구글 시트 등]
[중요 데이터]: [개인정보, 결제정보, 업무 문서, API 키 등]
[코드]:
[코드 붙여넣기]
검토 기준:
1. 보안 위험이 있는 부분
2. 개인정보나 비밀키가 노출될 가능성
3. 파일 삭제·수정처럼 되돌리기 어려운 동작
4. 예외 처리가 부족한 부분
5. 실패했을 때 로그나 알림이 필요한 부분
6. 테스트 케이스로 확인해야 할 부분
7. 더 안전한 코드로 바꾸는 방법더 잘 쓰는 팁
코드 실행 전에는 다음을 확인하자.
API 키, 비밀번호, 토큰을 코드에 직접 넣지 않았는가
원본 파일을 덮어쓰기 전에 백업을 만드는가
삭제 기능은 테스트 폴더에서 먼저 실행했는가
빈 값, 잘못된 날짜, 중복 데이터가 들어와도 멈추지 않는가
에러가 났을 때 어떤 파일에서 문제가 생겼는지 알 수 있는가
최소 3개의 테스트 입력으로 결과를 확인했는가
테스트 케이스는 거창하지 않아도 된다. 정상 데이터 1개, 빈 값이 있는 데이터 1개, 형식이 잘못된 데이터 1개만 있어도 많은 문제를 미리 찾을 수 있다.
코딩 프롬프트 기본 템플릿
마지막으로 어떤 코딩 작업에도 쓸 수 있는 기본 템플릿을 정리해 보자.
당신은 [역할]입니다.
[목표]: [만들고 싶은 기능이나 자동화 작업]
[사용 언어/도구]: [Python, JavaScript, Excel, Google Sheets 등]
[실행 환경]: [운영체제, 버전, 실행 도구]
[입력값]: [데이터 예시, 파일 구조, 표 구조]
[출력값]: [원하는 결과 형식]
[조건]:
- [초보자용 설명]
- [사용 가능한 라이브러리]
- [보안 조건]
- [예외 처리 조건]
요청:
1. 전체 접근 방법을 설명해 주세요.
2. 실행 가능한 코드를 작성해 주세요.
3. 코드에 필요한 주석을 달아 주세요.
4. 실행 방법을 단계별로 알려 주세요.
5. 테스트 케이스를 3개 제안해 주세요.
6. 보안과 예외 처리 관점에서 점검해 주세요.코딩에서 AI를 잘 쓰는 사람은 코드를 많이 맡기는 사람이 아니다. 원하는 동작을 정확히 설명하고, 작은 단위로 테스트하고, 결과를 검토하는 사람이다. AI는 빠른 초안을 만들어 주지만, 실행 환경과 데이터의 책임은 사용자에게 있다. 특히 자동화는 편리한 만큼 실수도 빠르게 반복한다. 그래서 처음에는 작게 만들고, 확인하고, 백업한 뒤 넓히는 습관이 가장 중요하다.
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.