AI TAKEOVER LOG / 자료실
CLAUDE CODE · PROMPT GUIDE

클로드 제작자가 알려주는
프롬프트 작성법 3가지

길고 복잡하게 쓰기보다, 원하는 결과와 노력의 깊이, 확인 방법을 분명하게. 처음 쓰는 사람도 자신의 작업에 맞게 바꿔 쓸 수 있도록 풀어봤어요.

정리·공식 문서 확인 2026.11.02 · 원문 게시 2026.10.06

AI에게 일을 맡겼는데 결과가 생각과 달랐던 적 있나요? “알아서 잘 해줘”만으로는 무엇이 좋은 결과인지 AI가 알기 어렵습니다.

Claude Code 제작자 Boris Cherny는 2026년 10월, 동료에게 일하듯 목표를 명확히 전달하라고 조언했어요. 특히 무엇을 원하는지, 얼마나 노력을 들일지, 어떻게 제대로 됐는지 확인할지가 중요하다고 말했습니다. 제작자 원문 보기 ↗

한 문장으로 정리하면

“이 결과를 원해. 이 정도 깊이로 작업하고, 이런 방법으로 확인해줘.”

제작자의 발언은 Claude를 쓰는 방식에 관한 개인적인 조언이며, 이 글에서는 Claude Code 작업을 중심으로 풀어 설명합니다. 문서·공부 예시는 일반 대화에도 응용할 수 있지만, 도구와 파일 접근 권한은 사용하는 환경에 따라 다릅니다.

좋은 요청에 담을 세 가지

아래 순서는 이해를 돕기 위한 구성이지, 반드시 지켜야 하는 고정 형식은 아니에요.

01 / WHAT

무엇을 원하는지

해야 할 일만이 아니라 완성된 결과가 어떤 모습인지 알려주세요. 누구를 위한 것인지, 필요한 형식이 무엇인지 덧붙이면 더 분명해집니다.

막연한 요청“이 자료 정리해줘.”
더 구체적인 요청“이 자료를 처음 배우는 대학생이 이해할 수 있게 핵심 개념과 예시로 정리해줘.”
02 / EFFORT

얼마나 노력을 들일지

가볍게 개요만 볼지, 여러 파일과 가능성을 살피며 깊이 검토할지 알려주세요. 작업 범위와 건드리지 말아야 할 부분도 함께 적으면 좋아요.

가볍게 살펴볼 때“먼저 요점 3개만 뽑고, 자료에 없는 내용은 추가하지 마.”
깊이 살펴볼 때“관련 파일과 예외 상황까지 검토하되, 관련 없는 코드는 수정하지 마.”

‘노력’은 특정 설정값 하나를 뜻하는 건 아닙니다. 시간, 범위, 비교할 대안, 깊이 등을 필요에 맞게 표현한 것은 이 글의 응용입니다. 이렇게 적는 것만으로 실제 비용이나 시간이 제한되지는 않아요.

03 / VERIFY

어떻게 확인할지

“완료했어”라는 말만 듣고 끝내지 말고, 무엇을 어떤 방법으로 확인할지 알려주세요. 결과를 뒷받침하는 근거와 확인하지 못한 부분도 함께 요청하면 검토하기 쉬워집니다.

모호한 검증“틀린 게 없는지 확인해줘.”
구체적인 검증“요약의 핵심 주장마다 제공한 문서의 해당 부분을 표시하고, 근거가 없으면 없다고 적어줘.”

웹 기능이라면 버튼을 눌러보고 화면이 잘리는지 확인할 수 있고, 코드라면 관련 테스트 결과를 볼 수 있어요. 실제 확인이 불가능했다면 확인했다고 말하지 말고 이유를 남겨달라고 요청하세요.

기억해 주세요. 세 가지를 적는다고 항상 원하는 결과가 나오지는 않아요. AI의 설명·출처·테스트 결과는 틀릴 수 있으므로 중요한 내용은 사람이 원문과 실제 결과를 직접 확인해야 합니다.

복사해서 내 작업에 맞게 바꾸기

아래 문구는 제작자의 원문을 그대로 옮긴 인용이 아니라 이 자료실에서 만든 응용 예시예요. 대괄호 안을 자신의 작업으로 바꾼 뒤 사용하세요. 파일이나 브라우저 접근이 없는 환경이라면 관련 내용을 직접 제공하거나 확인 가능한 방법을 따로 지정해야 합니다.

01 · 기본 틀

어떤 작업에도 쓸 수 있는 시작점

처음이라면 이 문장의 빈칸부터 채워 보세요.

[원하는 결과]
[누구]를 위해 [무엇]을 만들어줘. 완성된 결과는 [형식·길이·필요한 내용]이면 좋겠어.

[들이고 싶은 노력]
먼저 [확인할 자료나 파일]을 살펴보고, [간단히/자세히] 작업해줘. [바꾸지 말아야 할 부분]은 건드리지 마.

[검증 방법]
[성공 기준]을 기준으로 [확인 방법]을 실행해줘. 확인한 내용과 확인하지 못한 내용을 나눠 알려주고, 모르는 내용은 추측하지 마.
02 · 공부

어려운 자료를 이해하기 쉽게

강의자료나 논문을 처음 읽을 때 응용할 수 있어요.

[원하는 결과]
내가 제공한 [강의자료 또는 논문]의 핵심 내용을 처음 배우는 대학생이 이해할 수 있도록 설명해줘. 먼저 핵심을 쉬운 말로 요약하고, 중요한 개념은 예시와 함께 설명해줘.

[들이고 싶은 노력]
자료에 나오는 개념 사이의 관계를 살펴보고, 전문 용어는 처음 등장할 때 풀어줘. 자료에 없는 주장은 사실처럼 덧붙이지 마.

[검증 방법]
핵심 주장마다 제공한 자료의 쪽수나 해당 문장을 표시해줘. 페이지나 근거를 확인할 수 없다면 확인하지 못했다고 밝혀줘. 마지막에 내가 이해했는지 점검할 질문 3개를 만들어줘.
03 · 글쓰기

보고서 초안을 검토하기

문장을 다듬되 사실과 출처를 함부로 바꾸지 않도록 요청합니다.

[원하는 결과]
내가 붙여 넣은 [보고서 초안]을 읽고 핵심 주장이 명확하게 전달되도록 구조와 문장을 개선해줘. 독자는 [대상]이고, 분량은 [기준]으로 맞춰줘.

[들이고 싶은 노력]
먼저 글의 논리 흐름과 중복을 살펴보고 수정안을 제시해줘. 내가 쓰지 않은 경험이나 확인되지 않은 통계·출처를 새로 만들지 마.

[검증 방법]
수정 후 원문의 핵심 주장과 숫자가 바뀌지 않았는지 대조해줘. 출처나 사실을 따로 확인해야 하는 부분은 목록으로 표시하고, 주요 수정 이유도 알려줘.
04 · CLAUDE CODE

작은 웹페이지 만들기

파일을 다룰 수 있는 환경에서 목표·작업 범위·검증을 함께 전달합니다.

[원하는 결과]
이 프로젝트에 휴대폰에서도 읽기 편한 [자료실 페이지]를 만들어줘. 필요한 내용은 [내용]이고, 방문자가 [원하는 기능]을 사용할 수 있어야 해.

[들이고 싶은 노력]
먼저 기존 파일과 디자인을 살펴보고, 필요한 부분만 수정해줘. 관련 없는 파일은 바꾸지 말고, 새 패키지 설치가 필요하면 먼저 알려줘.

[검증 방법]
실행 가능한 환경이라면 모바일과 PC 화면에서 글자 잘림과 버튼 동작을 확인해줘. 확인한 화면 크기와 결과를 알려주고, 직접 실행하지 못한 검사는 했다고 말하지 마.
05 · CLAUDE CODE

오류 원인부터 차근차근 찾기

바로 수정하기보다 재현과 원인 파악을 먼저 요청합니다.

[원하는 결과]
[어떤 상황]에서 [어떤 오류]가 발생해. 먼저 원인을 조사하고, 수정이 필요하다면 가장 작은 안전한 변경을 제안해줘.

[들이고 싶은 노력]
관련 코드와 오류 메시지를 살펴보고, 가능한 원인을 비교해줘. 이 단계에서는 파일을 수정하거나 외부 서비스에 요청하지 마. 비밀번호와 API 키, 개인정보는 출력하지 마.

[검증 방법]
오류를 재현할 수 있는 조건과 수정안을 확인할 방법을 알려줘. 실제로 실행한 확인과 아직 실행하지 못한 확인을 구분하고, 근거가 부족한 부분은 추측이라고 표시해줘.

복사가 막힌 환경이라면 문구를 길게 눌러 직접 선택해 복사할 수 있습니다.

실제로 사용하는 순서

  1. 작업을 하나 고릅니다. 예를 들어 “강의자료를 이해하기 쉽게 정리하기”처럼 구체적으로 정해요.
  2. 자료와 환경을 준비합니다. 문서 내용이나 파일을 제공하고, 파일을 수정할 수 있는 도구인지 먼저 확인하세요. Claude Code를 쓴다면 공식 시작 가이드의 설치·로그인 조건을 확인합니다.
  3. 예시의 빈칸을 바꿔 요청합니다. 목표와 범위, 확인 방법을 내 작업에 맞게 적어요. 필요하지 않은 부분은 지워도 됩니다.
  4. 결과와 근거를 직접 살펴봅니다. AI가 실제로 확인한 것과 확인하지 못한 것을 구분하고, 중요한 내용은 원문이나 실제 동작으로 다시 확인하세요.
  5. 부족한 부분을 이어서 요청합니다. 예를 들어 “두 번째 설명이 어려우니 실제 예시를 하나 추가해줘. 근거가 된 부분도 표시해줘”라고 말할 수 있어요.
안전하게 시작하기. API 키·비밀번호·개인정보·실제 고객 자료는 입력하거나 공유하기 전에 정리하세요. 파일 삭제, 외부 전송, 배포나 결제처럼 되돌리기 어렵거나 영향이 큰 작업은 범위와 권한을 직접 확인하고 승인하세요.

자주 묻는 질문

프롬프트를 길게 써야 하나요?

꼭 그렇지는 않아요. 간단한 요청에는 짧은 문장으로도 충분할 수 있어요. 중요한 것은 글자 수가 아니라 목표와 필요한 맥락, 결과를 확인할 방법입니다.

일반 Claude 채팅에서도 쓸 수 있나요?

목표·노력·검증을 알려주는 방식은 일반 대화에도 응용할 수 있습니다. 다만 파일 수정, 브라우저 확인, 명령 실행은 사용하는 제품과 권한에 따라 다르므로 실행 가능하다고 가정하지 마세요.

Claude Code는 무료인가요?

공식 시작 가이드는 지원되는 Claude 구독, Claude Console 계정 또는 지원 클라우드 제공자 접근을 안내합니다. 이용 방식에 따라 사용량·과금과 제공 기능이 다를 수 있으니 공식 시작 안내와 현재 요금 안내를 확인하세요. 일반 무료 채팅 계정만으로 모든 Claude Code 기능을 쓸 수 있다고 가정하지 마세요.

“검증해줘”라고 하면 안전한가요?

아니요. AI가 수행한 검증이 부족하거나 잘못될 수 있고, 테스트 통과가 보안이나 정확성을 보장하지도 않습니다. 프롬프트는 강제 안전장치가 아니므로 중요한 결과는 별도로 검토하세요.

원문과 더 읽을 자료