Claude Code 프롬프트, 초보가 자주 하는 실수 7가지와 고치는 법
Claude Code에 같은 작업을 시켜도 어떤 날은 한 번에 끝나고 어떤 날은 한참 헤맨다면, 문제는 모델이 아니라 프롬프트 일 가능성이 커요. Claude Code는 우리가 건넨 요청을 읽고, 의도를 추론한 뒤 코드를 고쳐요. 이 추론 단계에 빈틈이 많을수록 결과가 흔들려요. 다행히 결과를 망치는 패턴은 몇 가지로 정해져 있어서, 그 실수만 알면 바로 고칠 수 있어요. 아래는 초보자가 가장 자주 밟는 프롬프트 실수 7가지예요. 먼저 한눈에 보고, 이어서 잘못된 예시와 고친 예시를 하나씩 비교해 볼게요. 실수 핵심 문제 1. 모호하게 부탁하기 구체성 부족 2. 이유를 안 알려주기 맥락 부족 3. 손대지 말 곳을 안 정하기 범위 부족 4. 한 번에 큰 작업 시키기 작업 분할 없음 5. 계획 없이 바로 코드 시키기 계획 모드 미사용 6. 한 대화에서 모든 작업 하기 컨텍스트 관리 부재 7. 같은 설명을 매번 반복하기 프로젝트 메모 미사용 실수 1. 모호하게 부탁하기 가장 흔한 실수예요. "버튼 좀 예쁘게 해줘" 같은 요청은 사람마다 해석이 달라요. Claude도 마찬가지로 추측에 기댈 수밖에 없고, 그 추측이 빗나가면 엉뚱한 결과가 나와요. Before · "로그인 화면 좀 손봐줘" After · "로그인 화면의 입력칸 사이 간격을 넓히고, 로그인 버튼을 화면 너비에 꽉 차게 키워줘" 고치는 법은 간단해요. 색·크기·위치·동작처럼 눈에 보이고 확인 가능한 말 로 바꾸면 돼요. 부탁을 보내기 전에 "이 문장을 다른 사람이 읽어도 똑같이 이해할까?"를 한 번 자문해 보세요. 실수 2. 이유를 안 알려주기 무엇을 원하는지는 적었는데 왜 그게 필요한지는 빼먹는 경우예요. 이유를 모르면 Claude는 표면적인 요청만 처리하고, 정작 중요한 의도는 놓쳐요. Before · "글씨 크기를 키워줘...
