🗣️ 말코딩 노하우

AI 프롬프트 잘 쓰는 법
홈페이지 제작에서 쓰는 말코딩 노하우

📅 2026년 5월 15일 ✍️ 뚝딱닷컴 ⏱️ 6분 읽기 👁 -

💬 어떻게 말하느냐가 결과를 결정한다

AI한테 말하면 홈페이지가 만들어진다. 맞는 말이다. 근데 같은 AI한테 말해도 결과가 완전히 다른 경우가 있다. 누군가는 원하는 게 바로 나오고, 누군가는 열 번 고쳐도 엉뚱한 결과만 나온다.

차이는 코딩 실력이 아니다. 말하는 방식에 있다. AI한테 어떻게 말하느냐에 따라 결과의 질이 완전히 달라진다. 이 글에서 뚝딱닷컴을 만들면서 실제로 쓴 노하우를 공유한다.

🗣️ 말코딩이 뭔가요?

말코딩은 코드를 직접 쓰는 대신 AI한테 원하는 것을 말로 설명해서 코드를 만드는 방식이다. "버튼 만들어줘", "색상 바꿔줘", "메뉴 추가해줘" 같은 식으로 대화하면 AI가 직접 파일을 수정해준다.

이 방식에서 중요한 건 HTML이나 CSS 문법이 아니다. 내가 원하는 걸 정확하게 설명하는 능력이다. 모호하게 말하면 모호한 결과가 나온다. 구체적으로 말하면 원하는 결과가 나온다.

📌

말코딩은 코딩 공부의 대체가 아니에요. 원하는 결과를 빠르게 얻는 방법입니다. 코딩을 모르는 사람도, 잘 아는 사람도 쓸 수 있어요. 속도가 다를 뿐이에요.

⚖️ 잘 되는 프롬프트 vs 안 되는 프롬프트

같은 요청도 어떻게 말하느냐에 따라 결과가 완전히 달라진다. 아래 두 예시를 비교해보면 차이가 명확하다.

❌ 안 되는 예시
"버튼 만들어줘" AI가 어디에, 어떤 색으로, 어떤 텍스트로, 클릭하면 어디로 이동하는 버튼인지 알 수가 없다. 결과가 매번 다르게 나온다.
✅ 잘 되는 예시
"오른쪽 상단에 주황색 버튼을 만들어줘. 버튼 텍스트는 '교재 보기'고 클릭하면 textbook.html로 이동해" 위치, 색상, 텍스트, 동작이 전부 명시됐다. 원하는 결과가 한 번에 나온다.

구체적일수록 원하는 결과가 나온다. 막연한 요청은 막연한 결과를 낳는다. 처음엔 어색해도 습관이 되면 시간이 훨씬 줄어든다.

🎯 실전 노하우 5가지

뚝딱닷컴을 만들면서 실제로 터득한 것들이다. 이 다섯 가지만 지켜도 결과가 달라진다.

1
원하는 위치를 말해라 "추가해줘" 대신 "헤더 오른쪽에", "본문 맨 아래에", "네비게이션 메뉴 끝에"처럼 어디에 넣을지를 함께 말한다. 위치가 명확해야 AI가 기존 구조를 건드리지 않고 정확히 넣는다.
2
색상과 크기를 구체적으로 말해라 "주황색"보다는 "#ff7a00", "크게"보다는 "font-size 1.2rem"이 낫다. 색상을 모른다면 "기존 버튼과 같은 색으로"처럼 기준을 잡아줘도 된다.
3
기존 파일 스타일을 유지하라고 말해라 새 요소를 추가할 때 "기존 디자인 스타일 그대로 유지하면서"라는 말을 앞에 붙인다. 이 한 마디가 없으면 AI가 기존 스타일을 무시하고 새 스타일로 만들 때가 있다.
4
오류가 나면 오류 메시지를 그대로 붙여넣어라 오류를 설명하려고 하면 오히려 엉뚱한 방향으로 흐른다. 브라우저 콘솔이나 터미널에 뜬 오류 메시지를 통째로 복사해서 붙여넣는 게 가장 빠르다.
5
한 번에 너무 많이 요청하지 마라 한 번의 대화에 요청을 여러 개 몰아넣으면 일부가 누락되거나 충돌이 생긴다. 하나씩 요청하고 결과를 확인한 뒤 다음 요청으로 넘어가는 게 결과적으로 더 빠르다.

🚨 오류 났을 때 대처법

코드를 넣었는데 화면이 깨지거나 기능이 안 된다. 이럴 때 가장 빠른 방법은 하나다. 오류 메시지를 그대로 복사해서 AI한테 붙여넣는 것이다.

브라우저에서 F12를 누르면 개발자 도구가 열린다. "Console" 탭에 빨간 글씨로 오류 메시지가 있다면 그걸 전체 선택해서 복사하고, Claude Code에 그대로 붙여넣으면 된다. 설명을 덧붙이지 않아도 된다. 메시지 자체가 이미 필요한 정보를 다 담고 있다.

⚠️

"뭔가 이상해요", "안 돼요"처럼 막연하게 말하면 AI도 막연하게 대답한다. 어떤 파일에서, 어떤 동작을 했을 때, 어떤 오류가 났는지를 같이 전달하면 훨씬 빠르게 해결된다.

💡

터미널(PowerShell)에서 오류가 났을 때도 같은 방법이다. 오류가 뜬 줄을 마우스로 드래그해서 복사하고 그대로 붙여넣는다. Claude Code가 맥락을 파악하고 해결책을 제시해준다.

📋 실제 사용 예시 — 뚝딱닷컴을 만들면서 쓴 프롬프트

말로만 설명하면 와닿지 않을 수 있다. 뚝딱닷컴을 만들면서 실제로 입력했던 프롬프트 세 가지를 공개한다.

예시 1 — 네비게이션 메뉴 추가
"index.html에 네비게이션 메뉴 추가해줘. 홈, 교재, 블로그, 커뮤니티, 소개 순서로. 오른쪽 끝에는 로그인 버튼 넣어줘."
순서, 항목 이름, 특수 버튼 위치까지 전부 명시했다. 한 번에 원하는 네비게이션이 나왔다.
예시 2 — 새 페이지 만들기
"기존 디자인 스타일 그대로 유지하면서 about.html 페이지 만들어줘. 내용은 뚝딱닷컴 소개, 만든 이유, 운영자 소개 순서로."
"기존 스타일 유지"를 명시한 덕분에 다른 페이지와 통일된 디자인이 나왔다. 이 한 마디가 없었으면 완전히 다른 디자인이 만들어졌을 것이다.
예시 3 — 코드 일괄 삽입
"애드센스 코드를 모든 html 파일 head에 넣어줘. 코드는 이거야: [코드 붙여넣기]"
파일 하나씩 수동으로 넣는 대신 한 번에 전부 처리했다. 파일이 10개든 20개든 같은 시간이 걸린다.

✅ 마무리 — 말 잘하는 사람이 이기는 시대

코딩을 배우는 시대가 아니다. AI한테 잘 말하는 걸 배우는 시대다. 명령어를 외우는 능력보다, 원하는 걸 정확하게 설명하는 능력이 더 중요해졌다.

처음엔 원하는 결과가 바로 안 나와도 괜찮다. 틀린 결과를 보고 "이건 이래서 안 돼, 이렇게 바꿔줘"라고 이어서 말하면 된다. AI와 대화하는 과정 자체가 노하우가 된다. 할수록 빨라진다.

뚝딱닷컴 교재 전체가 이 방식으로 만들어졌다. Claude Code와 대화하면서 페이지 하나씩 쌓아올린 과정이 교재에 그대로 담겨 있다.

말코딩으로 홈페이지를 처음부터 만드는 전체 과정이
뚝딱닷컴 교재에 담겨 있어요.

📖 교재 보러 가기