클로드 코드에 말을 걸었는데 결과가 엉망이라면?
클로드 코드를 처음 써보면 이런 경험을 하게 됩니다. “파일 좀 고쳐줘”라고 입력했더니 엉뚱한 부분을 수정하거나, 원하는 것과 전혀 다른 코드를 만들어냅니다. AI가 나쁜 게 아닙니다. 프롬프트(AI에게 보내는 명령 또는 요청 문장) 가 명확하지 않았기 때문입니다.
좋은 프롬프트는 클로드 코드가 “내 의도”를 정확히 파악하게 해줍니다. Anthropic(클로드를 만든 회사)의 공식 문서에서도 “목표, 제약 조건, 출력 형식, 맥락” 이 네 가지를 갖춘 프롬프트가 일관되게 좋은 결과를 낸다고 강조합니다. 이번 글에서는 클로드 코드 대화 팁을 실전 예시와 함께 정리해 드립니다.
🎯 좋은 프롬프트의 4가지 핵심 요소
클로드 코드에게 보내는 프롬프트는 아래 네 가지를 포함할수록 결과가 좋아집니다.
| 요소 | 설명 | 예시 |
|---|---|---|
| 목표(Goal) | 무엇을 원하는가 | “로그인 함수를 만들어줘” |
| 제약 조건(Constraint) | 어떤 방식으로, 어떤 범위에서 | “Python으로, 기존 파일은 건드리지 말고” |
| 출력 형식(Format) | 어떤 모양으로 결과를 받고 싶은가 | “코드만, 주석 포함해서” |
| 맥락(Context) | 배경 정보나 관련 파일 | “현재 auth.py 파일을 참고해서” |
이 네 가지 중 하나라도 빠지면 클로드가 빈칸을 자의적으로 채우게 되고, 그게 의도와 다를 수 있습니다.
✍️ 초보자가 자주 하는 프롬프트 실수 5가지
1. 너무 짧고 모호하게 쓴다
❌ 나쁜 예: 파일 고쳐줘
✅ 좋은 예: index.html 파일에서 버튼 색상을 파란색(#0066CC)으로 바꿔줘. 다른 부분은 건드리지 마.
“고쳐줘”는 클로드에게 아무런 정보가 없습니다. 무엇을, 어디서, 어떻게 고쳐야 하는지를 구체적으로 써야 합니다.
2. 한 번에 너무 많이 요청한다
❌ 나쁜 예: 로그인 기능 만들고, 디자인도 바꾸고, 데이터베이스 연결도 해줘
✅ 좋은 예: 한 번에 한 가지씩 단계적으로 요청하기
복잡한 작업일수록 작은 단위로 나눠서 요청하세요. 클로드는 한 번에 처리할 수 있는 정보의 양(컨텍스트 윈도우, context window)에 한계가 있습니다. 작업을 쪼개면 실수도 줄고 결과를 검토하기도 쉬워집니다.
3. 완료 기준을 알려주지 않는다
❌ 나쁜 예: 버그 잡아줘
✅ 좋은 예: 버튼을 클릭했을 때 콘솔에 에러가 뜨지 않으면 완료야
“이렇게 됐으면 완료”라는 기준을 명시하면 클로드가 훨씬 정확하게 작동합니다. 완료 기준이 있으면 불필요한 추가 변경도 막을 수 있습니다.
4. 역할을 지정하지 않는다
❌ 나쁜 예: 코드 리뷰해줘
✅ 좋은 예: 10년 경력의 시니어 파이썬 개발자처럼 이 코드를 검토하고, 보안 취약점 위주로 피드백해줘
역할을 구체적으로 부여할수록 그에 맞는 깊이 있는 답변이 나옵니다.
5. 새 작업인데 이전 대화를 지우지 않는다
작업을 마치고 완전히 다른 주제로 넘어갈 때는 /clear 명령어로 대화 맥락을 초기화하세요. 이전 대화가 쌓이면 클로드가 새 요청에서도 이전 내용의 영향을 받아 엉뚱한 결과를 낼 수 있습니다.
💡 결과가 달라지는 프롬프트 작성 팁
팁 1: 예시를 직접 보여준다
설명만 하는 것보다 “이런 식으로 해줘”라며 예시를 넣는 게 훨씬 효과적입니다.
함수 이름은 이런 규칙으로 지어줘:
- 나쁜 예: getData(), processInfo()
- 좋은 예: getUserProfile(), calculateMonthlyRevenue()
동사+명사 형태로, 기능을 바로 알 수 있게.
팁 2: 수정 범위를 명확히 한다
login.js 파일의 handleSubmit 함수만 수정해줘.
다른 파일이나 다른 함수는 절대 건드리지 마.
범위를 지정하면 의도치 않은 부작용(예상 밖의 파일 변경)이 크게 줄어듭니다.
팁 3: 계획을 먼저 보여달라고 한다
복잡한 작업 전에 이렇게 물어보세요:
바로 코드 짜지 말고, 먼저 어떻게 구현할지 계획을 한국어로 설명해줘.
내가 OK하면 그때 코드 써줘.
클로드가 20분 동안 잘못된 방향으로 코드를 짜는 것보다, 3분 투자해서 계획을 검토하는 게 훨씬 효율적입니다.
팁 4: 모르면 솔직히 물어보라고 한다
이 요청이 애매하면 바로 만들지 말고, 먼저 질문해줘.
이 한 줄이 있으면 클로드가 불확실한 상황에서 무작정 진행하지 않고 확인을 먼저 합니다.
팁 5: 마크다운 구조를 활용한다
긴 프롬프트는 구조를 나눠 쓰면 클로드가 더 정확하게 읽습니다.
## 목표
사용자 로그인 폼을 만들어줘.
## 조건
- HTML/CSS만 사용 (JavaScript 없이)
- 모바일에서도 잘 보이도록
## 참고
현재 style.css 파일의 색상 변수를 그대로 써줘.
📋 상황별 프롬프트 템플릿
| 상황 | 프롬프트 템플릿 |
|---|---|
| 코드 작성 | [파일명]에 [기능]을 [언어/방식]으로 추가해줘. [제약 조건]. |
| 오류 해결 | 이 오류가 왜 나는지 설명하고, 수정 방법을 알려줘: [오류 내용] |
| 코드 리뷰 | 이 코드에서 [성능/보안/가독성] 문제를 찾아줘. 각 문제마다 이유와 개선안 포함. |
| 설명 요청 | 초보자도 이해할 수 있게, [개념/코드]를 쉽게 설명해줘. |
| 리팩터링 | [파일명]의 [함수명]을 더 읽기 쉽게 바꿔줘. 기능은 그대로 유지. |
❓ 자주 묻는 질문 (FAQ)
Q. 프롬프트가 길어도 괜찮나요?
A. 네, 오히려 권장합니다. 짧고 모호한 프롬프트보다 길고 구체적인 프롬프트가 훨씬 좋은 결과를 냅니다. 단, 한 번에 여러 작업을 몰아서 쓰는 것은 피하고, 작업별로 나눠서 보내세요.
Q. 클로드가 원하지 않는 파일을 자꾸 수정해요. 어떻게 막나요?
A. 프롬프트에 “다른 파일은 건드리지 마”, “이 함수 외에는 수정 금지”처럼 수정 범위를 명시하세요. CLAUDE.md 파일에 프로젝트 전체 규칙으로 등록해 두면 더 효과적입니다.
Q. 같은 프롬프트인데 결과가 매번 달라요. 왜 그런가요?
A. AI는 확률적으로 동작하기 때문에 완전히 동일한 결과를 보장하지 않습니다. 결과를 일정하게 만들고 싶다면, 프롬프트에 출력 형식을 더 구체적으로 지정하거나, 예시(few-shot)를 포함시키면 일관성이 높아집니다.
한 줄 요약: 클로드 코드 프롬프트는 목표·제약·형식·맥락 네 가지를 갖추고, 한 번에 한 가지씩 구체적으로 요청하는 게 핵심입니다.