같은 Claude인데 결과가 천지차이,
프롬프트가 답이다
Same Claude, but wildly different results —
the prompt is the answer
같은 모델, 같은 도구인데 누구는 놀라운 결과를 뽑아내고, 누구는 "AI 별거 아니네"라고 합니다.
차이는 프롬프트에 있습니다.
Same model, same tools — yet some get amazing results while others say "AI is nothing special."
The difference is the prompt.
식당에서 "맛있는 거 주세요"라고 하면 셰프가 알아서 줍니다. 운이 좋으면 맛있고, 아니면 안 맞죠.
하지만 "매운맛 레벨 2의 토마토 파스타, 면은 알덴테로, 마늘은 많이, 치즈 토핑 추가요"라고 하면?
거의 100% 원하는 음식이 나옵니다.
Claude도 마찬가지입니다. 구체적으로 주문할수록, 원하는 결과가 나옵니다.
If you say "something delicious please" at a restaurant, the chef decides. If you're lucky it's good, otherwise it might not suit you.
But if you say "tomato pasta, spice level 2, al dente noodles, lots of garlic, add cheese topping"?
You'll get exactly what you want nearly 100% of the time.
Claude is the same. The more specifically you order, the more you get what you want.
Anthropic 공식 모범 사례에서 정리한 8가지 원칙입니다. 이것만 지켜도 결과가 극적으로 달라집니다.
8 principles distilled from Anthropic's official best practices. Following just these will dramatically change your results.
특정 파일을 참조하고, 제약 조건을 언급하고, 기존 패턴을 가리켜주세요. Claude는 의도를 추론할 수 있지만 마음을 읽을 수는 없습니다.
Reference specific files, mention constraints, point to existing patterns. Claude can infer intent but cannot read minds.
"이 파일에서 무엇을 개선하시겠습니까?"처럼 열린 질문은 당신이 미처 생각하지 못한 것을 발견하게 해줍니다. 탐색 중이고 방향을 수정할 여유가 있을 때 효과적입니다."What would you improve in this file?" can reveal things you hadn't thought of. Effective when you're exploring and have room to adjust direction.Claude가 자신의 작업을 확인할 수 있도록 테스트, 스크린샷 또는 예상 출력을 포함하세요. 이것이 할 수 있는 가장 영향력 높은 단일 행동입니다.
Include tests, screenshots, or expected output so Claude can verify its own work. This is the single highest-impact thing you can do.
구체적인 입력/출력 쌍을 제공해서 Claude가 결과를 스스로 검증하게 하세요.
Provide specific input/output pairs so Claude can verify results on its own.
UI 변경 시 목표 디자인 스크린샷을 붙여넣고, Claude가 결과와 비교하게 하세요.
For UI changes, paste the target design screenshot and have Claude compare its result to it.
"수정하고 빌드가 성공하는지 확인해주세요. 근본 원인을 해결하고 오류를 억제하지 마세요."
"After fixing, verify the build succeeds. Resolve the root cause and don't suppress errors."
Claude가 바로 코딩으로 뛰어들도록 하면 잘못된 문제를 해결하는 코드가 생성될 수 있습니다. 탐색과 실행을 분리하세요.
Letting Claude jump straight into coding can produce code that solves the wrong problem. Separate exploration from execution.
컨텍스트와 방향을 제공하고 세부 사항은 Claude가 파악하도록 믿으세요. 세세하게 지시하면 오히려 Claude의 능력을 제한합니다.
Provide context and direction, then trust Claude to figure out the details. Over-specifying actually limits Claude's capabilities.
Claude Code는 챗봇이 아니라 에이전트입니다. 처음부터 완벽한 프롬프트를 짜려 하지 말고, 시작한 후 피드백으로 개선하세요.
Claude Code is an agent, not a chatbot. Don't try to craft the perfect prompt from the start — begin and improve through feedback.
Claude가 잘못된 방향으로 가고 있다면 Esc를 눌러 즉시 멈추세요. 컨텍스트는 보존됩니다.
If Claude is heading in the wrong direction, press Esc to stop immediately. The context is preserved.
"정확하지 않아요. 문제는 세션 처리에 있습니다."처럼 피드백을 주면 됩니다. 처음부터 다시 시작할 필요 없습니다.
Just give feedback like "That's not right. The issue is in session handling." No need to start over from scratch.
/clear를 실행하고 배운 내용을 통합한 더 구체적인 프롬프트로 새로 시작하세요./clear and start fresh with a more specific prompt that incorporates what you've learned.아키텍처 설계, 복잡한 버그, 트레이드오프 분석처럼 깊은 사고가 필요한 문제에는 프롬프트에 ultrathink를 포함하세요.
For problems requiring deep thinking like architecture design, complex bugs, or trade-off analysis, include ultrathink in your prompt.
컨텍스트가 기본 제약입니다. Subagent는 별도의 컨텍스트 창에서 실행되고 요약만 보고하므로, 주요 대화를 깨끗하게 유지합니다.
Context is the fundamental constraint. Subagents run in a separate context window and report only a summary, keeping the main conversation clean.
매번 같은 규칙을 프롬프트에 넣고 있다면 CLAUDE.md에 옮기세요. Claude가 모든 대화 시작 시 자동으로 읽습니다.
If you're putting the same rules in every prompt, move them to CLAUDE.md. Claude reads it automatically at the start of every conversation.
Anthropic 공식 권장 워크플로우입니다. 탐색 → 계획 → 구현 → 커밋 4단계로 복잡한 작업을 안전하게 처리합니다.
Anthropic's officially recommended workflow. Safely handle complex tasks in 4 steps: Explore → Plan → Implement → Commit.
Shift + Tab을 두 번 눌러 Plan Mode로 전환합니다. Plan Mode에서 Claude는 파일을 읽고 질문에 답하지만 변경을 수행하지 않습니다.Shift + Tab twice to switch to Plan Mode. In Plan Mode, Claude reads files and answers questions but does not make changes.Claude가 파일을 읽고 코드베이스를 이해합니다. 이 단계에서는 어떤 변경도 하지 않습니다.
Claude reads files and understands the codebase. No changes are made at this stage.
탐색을 바탕으로 상세한 구현 계획을 작성합니다. Ctrl+G를 눌러 계획을 텍스트 편집기에서 직접 편집할 수도 있습니다.
Write a detailed implementation plan based on exploration. You can also press Ctrl+G to edit the plan directly in a text editor.
계획을 검토하고 승인한 후 Normal Mode로 다시 전환합니다. Claude가 계획에 따라 코드를 작성하고 테스트를 실행합니다.
Review and approve the plan, then switch back to Normal Mode. Claude writes code and runs tests according to the plan.
구현이 완료되면 Claude에게 설명적인 메시지로 커밋하고 PR을 생성하도록 요청합니다.
Once implementation is complete, ask Claude to commit with a descriptive message and create a PR.
Claude에게 정확한 파일을 가리켜주면, 컨텍스트 정확도가 극적으로 올라갑니다.
Pointing Claude to the exact files dramatically increases context accuracy.
특정 파일을 Claude의 컨텍스트에 직접 로드합니다. Claude가 해당 파일의 전체 내용을 읽고 이해한 상태에서 작업합니다. 정확한 수정이 필요할 때 필수입니다.
Directly loads a specific file into Claude's context. Claude works with a full understanding of that file's content. Essential when precise modifications are needed.
폴더 내의 파일 구조를 Claude에게 보여줍니다. 전체적인 구조를 파악하거나, 여러 파일에 걸친 패턴을 찾을 때 유용합니다.
Shows Claude the file structure inside a folder. Useful for understanding the overall structure or finding patterns across multiple files.
Claude의 기억력에는 한계가 있습니다. /compact와 /clear로 효율적으로 관리하세요.
Claude's memory has limits. Manage it efficiently with /compact and /clear.
Claude의 컨텍스트 윈도우는 책상 위 공간과 같습니다.
대화가 길어질수록 책상 위에 서류가 쌓입니다. 처음에는 넓었던 공간이 점점 좁아지고, 새 서류를 놓으려면 오래된 서류가 밀려납니다.
/compact = 서류를 정리해서 핵심 내용만 요약 메모로 바꾸기. 공간은 확보되고, 중요한 맥락은 유지됩니다.
/clear = 책상을 완전히 치우기. 깨끗한 상태에서 새 작업을 시작합니다.
Claude's context window is like desk space.
As the conversation grows, papers pile up on the desk. The space that was once wide gets narrower, and old papers get pushed aside when new ones arrive.
/compact = Organize the papers into a summary note with just the key points. Space is freed, important context is preserved.
/clear = Clear the desk completely. Start fresh for a new task.
같은 주제를 계속 작업 중이라면 /compact를 사용하세요.
대화 내용을 요약하여 컨텍스트를 압축합니다. 이전 맥락을 유지하면서 공간을 확보합니다.
If you're still working on the same topic, use /compact.
Summarizes the conversation to compress context. Frees space while preserving previous context.
완전히 다른 주제로 전환한다면 /clear를 사용하세요.
이전 대화를 모두 지우고 깨끗한 상태에서 시작합니다. 이전 맥락이 오히려 방해가 될 때 유용합니다.
If switching to a completely different topic, use /clear.
Clears all previous conversation and starts fresh. Useful when previous context is actually a hindrance.
| 상황Situation | 커맨드Command | 설명Description |
|---|---|---|
| 대화가 길어져서 느려짐Conversation is long and slow | /compact | 대화를 요약하여 컨텍스트 공간 확보Summarize conversation to free context space |
| 완전히 다른 작업 시작Starting a completely different task | /clear | 이전 맥락을 지우고 깨끗하게 시작Clear previous context and start fresh |
| Claude가 이상한 답을 함Claude is giving strange answers | /clear | 오염된 컨텍스트를 리셋Reset polluted context |
| 대규모 코드 리뷰 중During a large code review | /compact | 리뷰 진행 상황을 유지하면서 공간 확보Free space while preserving review progress |
| 토큰 한도에 도달Reached token limit | /compact | 자동으로 요약이 실행되지만, 수동으로 하면 더 정확Summary runs automatically, but manually is more accurate |
| 민감한 정보를 입력함Sensitive information was entered | /clear | 컨텍스트에서 완전히 제거Remove completely from context |
/compact 현재 작업 중인 결제 모듈 관련 맥락은 반드시 유지해줘처럼 쓰면, 중요한 맥락을 더 잘 보존합니다./compact make sure to keep context related to the payment module I'm working on better preserves important context.긴 세션이 필요할 때 단순히 /compact만 쓰지 말고, 3계층 전략으로 체계적으로 관리하세요.
When long sessions are needed, don't just use /compact. Manage systematically with a 3-tier strategy.
큰 작업을 시작하기 전에 세션 자체를 나누세요. "인증 모듈 분석" → /clear → "인증 모듈 구현". 하나의 세션 = 하나의 작업이 원칙입니다.
Split the session itself before starting big tasks. "Analyze auth module" → /clear → "Implement auth module." One session = one task is the principle.
세션 중간에 /compact "결제 API 관련만 유지"처럼 키워드를 지정하여 중요한 맥락만 보존합니다. 무지정 /compact보다 훨씬 정확합니다.
Mid-session, use /compact "keep only payment API context" to specify keywords and preserve only important context. Far more accurate than bare /compact.
한계에 도달하면 하네스가 자동 압축합니다. 이때를 대비해 CLAUDE.md에 핵심 규칙을 적어두세요 — CLAUDE.md는 압축되지 않으므로 항상 살아남습니다.
When limits are reached, the harness auto-compresses. Prepare for this by writing key rules in CLAUDE.md — CLAUDE.md is never compressed, so it always survives.
복잡한 작업을 줄 때, Claude에게 먼저 계획을 세우게 하면 완료율이 크게 올라갑니다. 계획 없는 에이전트는 방향을 잃습니다.
When giving complex tasks, having Claude plan first dramatically increases the completion rate. An agent without a plan drifts.
바로 복사해서 쓸 수 있는 실전 프롬프트 템플릿입니다. 상황에 맞게 수정해서 사용하세요.
Ready-to-use prompt templates you can copy immediately. Modify them to fit your situation.
프롬프팅에 대해 가장 많이 궁금해하는 것들
The most common questions about prompting
claude --continue로 가장 최근 대화를 재개하거나, claude --resume으로 최근 세션 목록에서 선택할 수도 있습니다.claude --continue, or choose from recent sessions with claude --resume.ultrathink를 프롬프트에 포함하면 Claude의 확장 사고(extended thinking)가 활성화됩니다. 이는 단순한 구현 작업에는 불필요하지만, 다음과 같은 상황에서 결과 품질을 크게 향상시킵니다: 아키텍처 설계, 여러 트레이드오프가 있는 기술 결정, 복잡한 경쟁 조건(race condition) 분석, 보안 취약점 검토 등 깊은 추론이 필요한 문제들입니다. 사용 예시: "ultrathink: 이 마이크로서비스 전환 전략의 트레이드오프를 분석해주세요."ultrathink in your prompt activates Claude's extended thinking. This is unnecessary for simple implementation tasks, but greatly improves quality in: architecture design, technical decisions with multiple trade-offs, complex race condition analysis, security vulnerability review, and other problems requiring deep reasoning. Example: "ultrathink: analyze the trade-offs of this microservices migration strategy.""subagent를 사용하여 [작업]을 처리하고 결과를 요약해서 보고해주세요." 컨텍스트가 가득 찰 것 같거나, 조사/검증 작업을 주 대화에서 분리하고 싶을 때 활용하세요."Use a subagent to handle [task] and report results with a summary." Use it when the context might fill up, or when you want to separate investigation/verification tasks from the main conversation./clear로 컨텍스트를 완전히 리셋합니다. (2) 지금까지 배운 내용, 실패한 접근 방식, 제약 조건을 통합한 더 나은 초기 프롬프트를 작성합니다. (3) 새 대화에서 더 구체적인 프롬프트로 시작합니다. 누적된 수정이 있는 긴 세션보다 좋은 프롬프트를 가진 깨끗한 세션이 항상 더 나은 성능을 발휘합니다./clear. (2) Write a better initial prompt incorporating what you've learned, the failed approaches, and constraints. (3) Start fresh in a new conversation with a more specific prompt. A clean session with a good prompt always outperforms a long session with accumulated corrections.
처음부터 구체적으로 — 파일, 제약, 패턴까지
검증 기준 제공 — 테스트, 예상 출력 포함
탐색 → 계획 → 구현 — Plan Mode 4단계
위임하되 마이크로 관리 금지 — 방향만 제시
대화로 반복 개선 — Esc로 중단, 피드백으로 수정
ultrathink — 복잡한 문제에 확장 사고 활성화
Subagent — 격리된 작업에 별도 컨텍스트
CLAUDE.md — 반복 규칙은 한 번만 작성
Be specific from the start — files, constraints, patterns
Provide verification criteria — include tests, expected output
Explore → Plan → Implement — Plan Mode 4 steps
Delegate, don't micromanage — just give direction
Iterate through conversation — stop with Esc, correct with feedback
ultrathink — activate extended thinking for complex problems
Subagent — separate context for isolated tasks
CLAUDE.md — write repetitive rules just once
프롬프트는 연습할수록 좋아집니다.
위의 레시피부터 시작해서, 자신만의 패턴을 만들어보세요.
Prompting gets better with practice.
Start with the recipes above and build your own patterns.