AI가 이해하는 코딩 프롬프트 작성법 10가지
핵심 요약
AI 코딩 도구를 잘 쓰려면 “코드 만들어줘”라고 말하는 것보다, 목적·기능·환경·출력 형식·검증 기준을 함께 알려주는 것이 좋습니다.
프롬프트는 개발자에게 주는 업무 지시서와 비슷합니다. 설명이 모호하면 결과도 흔들리고, 조건이 분명하면 AI가 더 안정적으로 코드를 작성합니다.
처음에는 완벽한 프롬프트를 쓰려고 하기보다, 작은 기능부터 요청하고 실행 결과를 보며 수정하는 방식이 가장 현실적입니다.
요즘은 개발 경험이 많지 않아도 AI에게 코드를 요청해서 웹페이지, 간단한 프로그램, 자동화 도구를 만들어볼 수 있는 시대가 되었습니다. 예전에는 코딩을 하려면 문법부터 외우고, 오류를 직접 찾아보고, 개발 환경을 하나씩 맞춰야 했습니다. 그런데 지금은 “이런 기능을 만들어줘”라고 말하면 AI가 기본 코드를 만들어주는 경우가 많습니다.
하지만 여기서 많은 분들이 한 번쯤 막힙니다. 분명 AI에게 요청했는데 결과물이 내가 원하는 방향과 다르게 나오는 것이죠. 버튼은 생겼지만 작동하지 않거나, 디자인은 괜찮은데 저장 기능이 빠져 있거나, 엑셀 파일을 읽어달라고 했는데 전혀 다른 구조의 코드를 만들어주는 경우도 있습니다.
이럴 때 문제는 AI가 무조건 부족해서라기보다, 프롬프트가 너무 넓거나 모호한 경우가 많습니다. AI는 사람처럼 내 머릿속 상황을 알아서 추측하지 못합니다. 내가 어떤 도구를 쓰는지, 어떤 파일을 다루는지, 어떤 결과물이 필요한지, 어디까지 직접 해보고 싶은지 설명해줘야 합니다.
그래서 이번 글에서는 AI가 더 잘 이해하는 코딩 프롬프트 작성법 10가지를 정리해 보겠습니다. 개발 경험이 없는 분도 읽을 수 있도록 어렵지 않게 풀어보겠습니다. 특히 챗GPT, GitHub Copilot, Claude, Cursor 같은 AI 코딩 도구를 사용할 때 공통적으로 도움이 되는 방식 위주로 설명하겠습니다.
목차
1. 만들고 싶은 결과를 먼저 말하기
AI에게 코딩을 부탁할 때 가장 먼저 해야 할 일은 “무엇을 만들고 싶은지”를 말하는 것입니다. 여기서 중요한 것은 기술 용어를 많이 쓰는 것이 아닙니다. 오히려 개발을 잘 모른다면 일상적인 말로 결과물을 먼저 설명하는 편이 좋습니다.
예를 들어 “웹앱 만들어줘”라고 하면 AI는 어떤 웹앱인지 알기 어렵습니다. 메모장인지, 계산기인지, 재고 정리 도구인지, 블로그 제목 생성기인지 방향이 너무 넓습니다. 반대로 “상품명과 수량을 입력하면 표로 정리되고, 전체 수량 합계가 자동으로 계산되는 간단한 웹앱을 만들어줘”라고 하면 훨씬 명확합니다.
나쁜 예:
웹앱 하나 만들어줘.
좋은 예:
상품명과 수량을 입력하면 표로 정리되고,
전체 수량 합계가 자동으로 계산되는 간단한 재고 정리 웹앱을 만들어줘.AI는 목적이 뚜렷할수록 코드를 더 잘 구성합니다. 화면에 무엇이 있어야 하는지, 어떤 버튼이 필요한지, 어떤 계산이 들어가야 하는지 판단하기 쉬워지기 때문입니다. 그러니 프롬프트의 첫 문장은 가능하면 “무엇을 만들고 싶은지”로 시작하는 것이 좋습니다.
2. 사용 환경을 구체적으로 적기
같은 기능이라도 어디에서 실행할지에 따라 코드가 달라집니다. HTML 한 파일로 실행할 수도 있고, Python으로 만들 수도 있고, Streamlit 같은 도구로 웹앱을 만들 수도 있습니다. 또 CodeSandbox에서 돌릴지, Replit에서 실행할지, 내 컴퓨터의 VS Code에서 실행할지도 결과에 영향을 줍니다.
그래서 코딩 프롬프트에는 사용 환경을 적어주는 것이 좋습니다. 개발 초보자라면 “설치가 복잡하지 않게”, “HTML 한 파일로”, “CodeSandbox에서 실행할 수 있게”처럼 조건을 붙여보세요. 이렇게 말하면 AI가 너무 복잡한 서버 구조나 불필요한 라이브러리를 넣는 것을 줄일 수 있습니다.
| 상황 | 프롬프트에 넣으면 좋은 말 | 기대 효과 |
|---|---|---|
| 블로그용 간단한 도구 | HTML, CSS, JavaScript 한 파일로 만들어줘 | 복사해서 바로 실행하기 쉬움 |
| 엑셀 자동화 | Python과 openpyxl을 사용해서 만들어줘 | 엑셀 파일 처리에 적합한 코드가 나올 가능성이 높음 |
| 웹앱 형태 | Streamlit으로 만들고 실행 방법도 알려줘 | 초보자도 화면이 있는 프로그램을 만들기 쉬움 |
| 온라인 코드 실행 | CodeSandbox에서 실행 가능한 구조로 만들어줘 | 파일 구조와 실행 방식이 더 명확해짐 |
3. 필수 기능과 제외할 기능을 나누기
초보자가 자주 하는 실수 중 하나는 원하는 기능을 한 문장에 모두 섞어서 말하는 것입니다. “예쁘고 빠르고 저장도 되고 엑셀도 되고 로그인도 되고 모바일도 되는 앱”처럼 요청하면 AI도 우선순위를 잡기 어렵습니다. 이럴 때는 필수 기능과 나중에 추가할 기능을 나누는 것이 좋습니다.
예를 들어 재고 정리 프로그램을 만든다면 처음부터 회원가입, 로그인, 서버 저장, 관리자 페이지까지 넣으려고 하지 않아도 됩니다. 처음에는 상품명 입력, 수량 입력, 표 출력, 합계 계산 정도만 필수 기능으로 두는 것이 좋습니다. 그다음 버전에서 엑셀 다운로드, 검색, 저장 기능을 붙이면 됩니다.
필수 기능:
1. 상품명 입력
2. 수량 입력
3. 입력한 내용을 표로 표시
4. 전체 수량 합계 계산
이번 버전에서 제외할 기능:
1. 로그인
2. 결제
3. 서버 저장
4. 회원 관리이렇게 구분하면 AI가 불필요하게 복잡한 코드를 만들 가능성이 줄어듭니다. 특히 개발 경험이 없는 분이라면 처음부터 기능을 많이 넣는 것보다, 작게 완성한 뒤 하나씩 붙여가는 방식이 훨씬 안전합니다.
4. 입력값과 출력값 예시를 보여주기
AI가 코딩 프롬프트를 이해하는 데 가장 도움이 되는 것 중 하나는 예시입니다. 말로만 “정리해 줘”라고 하면 어떤 형태로 정리해야 하는지 모호합니다. 하지만 입력 예시와 출력 예시를 함께 보여주면 AI가 결과 형식을 훨씬 정확하게 맞출 수 있습니다.
예를 들어 상품 데이터를 정리하고 싶다면 아래처럼 적어볼 수 있습니다. 이 방식은 엑셀 정리, 텍스트 변환, 표 생성, 데이터 추출 같은 작업에서 특히 유용합니다.
입력 예시:
캐논 잉크 10개
삼성 토너 5개
HP 용지 20개
출력 예시:
상품명 | 수량
캐논 잉크 | 10
삼성 토너 | 5
HP 용지 | 20예시는 길지 않아도 됩니다. 2~3줄만 있어도 AI는 “아, 사용자가 원하는 형식이 이런 거구나” 하고 이해하기 쉬워집니다. 특히 코딩에서는 출력 형식이 중요합니다. 표로 보여줄지, JSON으로 만들지, 엑셀로 저장할지, 화면에 카드 형태로 보여줄지에 따라 코드가 달라지기 때문입니다.
5. 한 번에 하나의 작업만 요청하기
AI 코딩을 처음 할 때는 한 번에 모든 것을 끝내고 싶어 집니다. “웹사이트 만들고, 디자인하고, 로그인 넣고, 관리자 페이지 만들고, 결제 붙이고, 배포까지 해줘”라고 요청하고 싶은 마음이 들 수 있습니다. 그런데 이렇게 범위가 크면 결과물이 중간중간 어긋나기 쉽습니다.
좋은 방법은 작업을 작은 단위로 나누는 것입니다. 먼저 화면을 만들고, 그다음 버튼을 작동시키고, 그다음 데이터를 저장하고, 마지막에 디자인을 다듬는 식입니다. 이렇게 하면 문제가 생겼을 때 어느 단계에서 오류가 났는지도 찾기 쉽습니다.
작게 나누는 예시
1단계: 기본 화면만 만들어줘.
2단계: 입력한 내용을 표에 추가하는 기능을 넣어줘.
3단계: 전체 수량 합계를 계산해 줘.
4단계: 모바일에서도 보기 좋게 디자인을 정리해 줘.
5단계: 엑셀 다운로드 기능을 추가해 줘.
이 방식은 느려 보이지만 실제로는 더 빠를 때가 많습니다. 한 번에 크게 요청해서 꼬인 코드를 고치는 것보다, 작은 기능을 하나씩 확인하면서 쌓는 편이 결과물이 안정적이기 때문입니다.
6. 파일 구조와 실행 방법까지 요청하기
AI가 코드를 만들어줘도 초보자는 “이걸 어디에 붙여 넣어야 하지?”에서 막힐 수 있습니다. 코드 자체보다 실행 방법이 더 어려운 경우도 많습니다. 그래서 프롬프트를 쓸 때는 코드만 달라고 하지 말고, 파일 구조와 실행 방법도 함께 요청하는 것이 좋습니다.
아래 조건으로 코드를 만들어줘.
1. 전체 파일 구조를 먼저 보여줘.
2. 각 파일에 들어갈 코드를 따로 보여줘.
3. 초보자도 따라 할 수 있게 실행 방법을 순서대로 설명해줘.
4. 오류가 날 때 확인할 부분도 함께 알려줘.특히 React, Next.js, Streamlit, Python 프로젝트처럼 파일이 여러 개로 나뉘는 경우에는 파일 구조가 매우 중요합니다. 어떤 파일을 만들고, 어디에 코드를 넣고, 어떤 명령어로 실행해야 하는지 알아야 실제로 사용할 수 있습니다.
“전체 프로젝트 구조까지 알려줘”라는 문장 하나만 추가해도 결과가 훨씬 실용적으로 바뀝니다. 개발 초보자에게는 코드보다 실행 과정이 더 중요할 때도 많기 때문입니다.
7. 초보자용 주석과 설명을 요구하기
AI가 만들어준 코드를 그대로 복사해서 실행할 수도 있지만, 장기적으로는 코드가 어떤 역할을 하는지 조금씩 이해하는 것이 좋습니다. 그래야 나중에 수정하고 싶을 때 덜 막힙니다. 이럴 때는 프롬프트에 “초보자용 주석을 달아줘”라고 요청해 보세요.
주석은 코드 안에 들어가는 설명입니다. 예를 들어 버튼을 누르면 실행되는 부분, 입력값을 가져오는 부분, 합계를 계산하는 부분에 짧은 설명을 붙여두면 나중에 다시 볼 때 훨씬 편합니다.
코드를 작성할 때 각 기능마다 초보자도 이해할 수 있는 주석을 달아줘.
특히 입력값을 가져오는 부분, 계산하는 부분, 화면에 표시하는 부분은 따로 설명해줘.주석이 많다고 무조건 좋은 것은 아니지만, 처음 배우는 단계에서는 도움이 됩니다. “이 줄이 왜 필요한지”를 조금씩 알게 되면 AI에게 수정 요청을 할 때도 더 구체적으로 말할 수 있습니다.
8. 에러 메시지를 그대로 붙여 넣기
코딩을 하다 보면 에러는 거의 반드시 만납니다. 초보자 입장에서는 빨간 글씨로 에러가 뜨면 당황스럽지만, 사실 에러 메시지는 문제를 알려주는 안내문에 가깝습니다. 중요한 것은 에러를 요약해서 말하지 말고, 가능한 한 그대로 붙여 넣는 것입니다.
“안 돼요”라고만 말하면 AI도 원인을 찾기 어렵습니다. “버튼을 눌렀는데 표에 추가되지 않고, 콘솔에 아래 에러가 나옵니다”처럼 상황과 에러 메시지를 함께 알려주는 것이 좋습니다.
상황:
저장 버튼을 눌러도 표에 데이터가 추가되지 않습니다.
에러 메시지:
TypeError: Cannot read properties of null
요청:
이 오류가 왜 나는지 초보자도 이해할 수 있게 설명하고,
수정된 전체 코드를 다시 보여줘.에러 메시지를 그대로 보여주면 AI가 문제 지점을 더 빠르게 추정할 수 있습니다. 물론 AI의 답이 항상 맞는 것은 아니므로 수정 후에는 다시 실행해서 확인해야 합니다. 그래도 에러를 숨기거나 대충 설명하는 것보다 훨씬 좋은 결과를 얻을 가능성이 높습니다.
9. 검증 기준을 함께 제시하기
AI가 코드를 만들어줬다고 해서 바로 끝나는 것은 아닙니다. 내가 원하는 대로 작동하는지 확인해야 합니다. 그래서 프롬프트 안에 검증 기준을 함께 넣으면 좋습니다.
예를 들어 계산기를 만든다면 “10과 20을 입력하면 결과가 30으로 나와야 한다”처럼 테스트 예시를 넣을 수 있습니다. 엑셀 자동화 프로그램이라면 “상품번호가 같은 행에만 수량을 넣어야 한다”처럼 조건을 명확히 적을 수 있습니다.
검증 기준:
1. 상품명과 수량을 입력하면 표에 한 줄씩 추가되어야 합니다.
2. 수량은 숫자만 합계에 반영되어야 합니다.
3. 입력값을 지우지 않아도 다음 상품을 계속 추가할 수 있어야 합니다.
4. 모바일 화면에서도 표가 깨지지 않아야 합니다.검증 기준은 AI에게도 도움이 되지만, 사용자에게도 도움이 됩니다. 코드를 받은 뒤 무엇을 확인해야 하는지 기준이 생기기 때문입니다. 특히 업무용 자동화나 파일 처리처럼 실수가 생기면 곤란한 작업에서는 검증 기준을 꼭 적어두는 편이 좋습니다.
10. 수정 요청은 구체적으로 하기
AI가 처음부터 완벽한 결과를 내는 경우는 많지 않습니다. 그래서 바이브코딩이나 AI 코딩에서는 수정 요청이 매우 중요합니다. 이때 “다시 해줘”, “별로야”, “예쁘게 바꿔줘”처럼 말하면 결과가 또 흔들릴 수 있습니다.
수정 요청은 가능한 한 구체적으로 하는 것이 좋습니다. 예를 들어 “버튼 색을 파란색으로 바꿔줘”, “표의 글자 크기를 조금 키워줘”, “엑셀 다운로드 버튼을 화면 오른쪽 위에 배치해 줘”처럼 말하는 방식입니다.
나쁜 수정 요청:
디자인이 별로야. 다시 해줘.
좋은 수정 요청:
전체 배경은 흰색으로 유지하고,
버튼은 파란색 계열로 바꿔줘.
표는 모바일에서 가로 스크롤이 되게 만들고,
제목은 지금보다 20% 정도 크게 보여줘.구체적인 수정 요청은 결과물을 빠르게 원하는 방향으로 가져가는 데 도움이 됩니다. AI는 감정을 읽는 도구가 아니라 조건을 바탕으로 결과를 만드는 도구에 가깝습니다. 그래서 내 취향이나 목적을 말로 잘 풀어주는 것이 중요합니다.
AI 코딩 프롬프트 기본 공식
위의 10가지를 모두 외우기 어렵다면, 아래 공식만 기억해도 충분합니다. 코딩 프롬프트는 “목적, 환경, 기능, 입력 예시, 출력 예시, 제약 조건, 검증 기준” 순서로 쓰면 안정적입니다.
프롬프트 기본 공식:
나는 [목적]을 만들고 싶습니다.
사용 환경은 [도구/언어/실행 위치]입니다.
필수 기능은 [기능 목록]입니다.
입력 예시는 [입력 데이터]입니다.
원하는 출력 예시는 [결과 형태]입니다.
제약 조건은 [제외할 기능/디자인/파일 형식]입니다.
마지막으로 실행 방법과 검증 기준도 함께 알려주세요.이 공식은 초보자에게 특히 좋습니다. 무엇을 써야 할지 몰라서 막힐 때 빈칸을 채우듯 작성하면 되기 때문입니다. 처음에는 조금 길게 느껴질 수 있지만, 실제로는 이렇게 쓰는 편이 수정 시간을 줄여줍니다.
바로 써먹는 프롬프트 예시
아래는 초보자가 바로 사용할 수 있는 코딩 프롬프트 예시입니다. 필요에 따라 상품명, 기능, 실행 환경만 바꿔서 사용하면 됩니다.
개발 경험이 없는 초보자입니다.
상품명과 수량을 입력하면 표로 정리되고,
전체 수량 합계가 자동으로 계산되는 간단한 웹앱을 만들고 싶습니다.
조건:
1. HTML, CSS, JavaScript 한 파일로 만들어주세요.
2. 모바일에서도 보기 좋게 만들어주세요.
3. 상품명 입력칸, 수량 입력칸, 추가 버튼, 표, 합계 영역이 필요합니다.
4. 수량은 숫자만 입력되게 해주세요.
5. 코드에는 초보자용 주석을 달아주세요.
6. 완성된 코드 아래에 실행 방법도 설명해주세요.
7. 마지막에 테스트해야 할 항목도 체크리스트로 정리해주세요.이 정도로 요청하면 AI가 해야 할 일이 훨씬 분명해집니다. 단순히 “재고 앱 만들어줘”라고 했을 때보다 결과물이 더 안정적으로 나올 가능성이 높습니다. 물론 한 번에 완벽하지 않을 수도 있습니다. 그럴 때는 실행해 보고, 에러를 확인하고, 필요한 부분만 다시 요청하면 됩니다.
마무리
AI 코딩에서 프롬프트는 단순한 질문이 아닙니다. 개발자에게 전달하는 작업 지시서이자, 결과물의 방향을 정하는 설계도에 가깝습니다. 그래서 프롬프트가 모호하면 결과도 모호해지고, 프롬프트가 구체적이면 결과도 훨씬 안정적으로 나옵니다.
개발 경험이 없어도 괜찮습니다. 처음부터 어려운 기술 용어를 모두 알 필요도 없습니다. 중요한 것은 내가 만들고 싶은 결과를 분명히 말하고, 사용 환경과 필수 기능을 적고, 예시와 검증 기준을 함께 보여주는 것입니다.
AI에게 코딩을 맡길 때는 “알아서 다 해줘”보다 “이런 목적이고, 이런 조건이고, 이런 결과가 필요해”라고 말하는 편이 좋습니다. 그리고 AI가 만든 결과를 그대로 믿기보다 직접 실행해 보고, 오류를 확인하고, 조금씩 수정해야 합니다.
결국 AI 코딩을 잘하는 사람은 프롬프트를 잘 쓰는 사람입니다. 더 정확히 말하면, 내가 원하는 것을 AI가 이해할 수 있는 언어로 정리하는 사람입니다. 오늘 정리한 10가지 방법을 기준으로 작은 프로젝트부터 시작해 보면, 코딩이 막연하게 어렵게만 느껴지지는 않을 것입니다.
최종 체크리스트
- 만들고 싶은 결과를 첫 문장에 적었는가?
- 사용 언어와 실행 환경을 구체적으로 적었는가?
- 필수 기능과 제외할 기능을 나누었는가?
- 입력값과 출력값 예시를 넣었는가?
- 한 번에 너무 많은 기능을 요청하지 않았는가?
- 실행 방법과 파일 구조를 요청했는가?
- 에러가 났을 때 메시지를 그대로 전달할 준비가 되어 있는가?
- AI가 만든 코드를 직접 검증할 기준을 적었는가?
썸네일 문구와 이미지 설명
썸네일 문구: AI가 이해하는 코딩 프롬프트 10가지
보조 문구: 초보자도 바로 쓰는 프롬프트 공식
이미지 Alt 설명: AI가 더 잘 이해하는 코딩 프롬프트 작성법 10가지를 설명하는 초보자용 블로그 썸네일
썸네일은 흰색과 파란색 계열의 깔끔한 테크 스타일로 구성하면 좋습니다. 노트북 화면, AI 채팅창, 코드 조각, 체크리스트 아이콘을 함께 배치하면 주제가 직관적으로 보입니다.
참고자료
이 글은 AI 코딩 프롬프트 작성에 관한 일반적인 원칙과 공식 문서의 권장 사항을 참고해 작성했습니다. AI 코딩 도구의 기능은 계속 바뀔 수 있으므로 실제 사용 전에는 각 도구의 공식 문서를 함께 확인하는 것이 좋습니다.
태그
#AI코딩
#코딩프롬프트
#프롬프트작성법
#바이브코딩
#챗GPT활용
#코딩초보
#개발입문
#AI개발
#업무자동화
#티스토리블로그
'AI' 카테고리의 다른 글
| 개발 경험 없어도 시작하는 바이브코딩 가이드 (0) | 2026.04.28 |
|---|---|
| 바이브코딩 핵심 7가지 (0) | 2026.04.10 |
