목차
Claude 가이드 - 이 글은 시리즈의 일부입니다.
이 글은 Claude API 공식 문서의 Effort 파라미터 페이지를 정리한 글입니다. 원문: https://platform.claude.com/docs/en/build-with-claude/effort 마지막 확인: 2026-05-16
1. 한 줄 요약 #
Claude에게 “얼마나 공들여서 답해줄래?“라고 한 단어로 부탁하면, 응답의 깊이와 비용이 함께 조절됩니다.
2. 무엇이고 왜 좋을까 #
요리를 시킬 때 “간단히요” 또는 “정성껏 부탁드려요"라고 말하는 것과 같습니다.
Effort(에포트, 한국어로 ‘공들이는 정도’) 파라미터는 Claude가 답변을 만들 때 얼마나 많은 생각과 글자를 쓸지 한 단어로 정해줍니다. 선택지는 다섯 개입니다 — low, medium, high, xhigh, max. 별도로 설정하지 않으면 자동으로 high로 동작합니다.
왜 필요할까요? AI에게 모든 질문에 풀코스 정찬을 시키면 돈도 시간도 많이 듭니다. “오늘 점심 메뉴 추천해줘” 같은 가벼운 질문에는 low로 부탁하고, “이 긴 보고서의 핵심을 깊이 분석해줘"에는 max로 부탁하면 됩니다.
핵심 수치 하나만 기억하세요 — low로 설정하면 같은 질문이라도 Claude가 **상당히 적은 토큰(글자 단위)**으로 답하기 때문에 응답 시간과 비용이 함께 줄어듭니다.
3. 이런 상황에서 써요 #
상황 1: 학생 — “강의 PDF에서 한 줄로만 답을 찾고 싶어요” #
학교 강의 자료에서 “이 챕터의 핵심 한 줄"만 뽑고 싶을 때가 있습니다. 굳이 Claude가 길게 설명할 필요가 없죠. 이럴 때 low로 부탁하면 군더더기 없이 한두 문장으로 깔끔하게 답해줍니다. 시험 기간에 여러 자료를 빠르게 훑어볼 때 특히 좋습니다.
상황 2: 직장인 — “회사 매뉴얼을 깊이 분석해야 해요” #
반대로, 사내 정책 문서를 읽고 “여기에 빠진 항목이 뭔지, 모순되는 부분이 있는지” 꼼꼼하게 살펴봐달라고 부탁할 때가 있습니다. 이때는 high나 max로 설정해주면 Claude가 충분히 시간을 들여 깊이 생각하고, 놓치기 쉬운 부분까지 찾아줍니다. 비용은 더 들지만, 그만큼 답변의 품질이 다릅니다.
상황 3: 일반인 — “긴 책 한 권을 요약하면서 여러 질문을 하고 싶어요” #
저녁에 책 한 권을 가볍게 정리하고 싶다면 medium이 딱입니다. 너무 짧지도, 너무 길지도 않게, 핵심을 잘 정리해주는 정도. 같은 책에 여러 질문을 던지면서 답변 톤이 일관되길 원할 때 균형 잡힌 선택입니다.
4. 가볍게 시작하기 #
💻 개발 경험이 있으신가요? 아래 코드는 Python(파이썬) 기준 가장 짧은 예시입니다. 비개발자라면 “아,
effort라는 단어 하나만 넣으면 되는구나” 정도로 보고 넘어가셔도 충분합니다.
import anthropic
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-opus-4-7",
max_tokens=4096,
messages=[
{"role": "user", "content": "이 문장을 한 줄로 요약해줘: (긴 글)"}
],
# ↓ 이 한 줄이 '공들임 정도'를 정해줍니다
output_config={"effort": "low"},
)
print(response.content[0].text)위 코드의 핵심은 단 한 줄, output_config={"effort": "low"} 입니다. “이번엔 가볍게 답해줘"라고 부탁하는 셈이죠. 만약 깊이 있는 답을 원한다면 "low"를 "high"나 "max"로만 바꾸면 끝입니다. 추가로 설정할 것도, 켜야 할 옵션도 없습니다.
5. 흔한 오해와 함정 #
⚠️ 함정 1: “low로 설정하면 답이 형편없어지지 않나요?” #
그렇지 않습니다. low는 “필요한 만큼만 간결하게 답해줘"라는 뜻이지, “대충 답해줘"가 아닙니다. 간단한 질문에는 low가 오히려 더 깔끔합니다. 다만 복잡한 문제(예: 긴 분석, 다단계 추론)는 high 이상이 더 안전합니다.
❌ “긴 보고서를 깊이 비평해줘” + low → 표면적인 답
✅ “긴 보고서를 깊이 비평해줘” + high → 충실한 답
⚠️ 함정 2: “어, 그런데 max로 하면 무조건 좋아지는 거 아니에요?” #
max는 비용도 많이 들고, 때로는 과하게 생각해서 오히려 답이 장황해지기도 합니다. 공식 문서에서도 “정말 어려운 문제에만 쓰라"고 안내합니다. 일반적인 글 요약·정리에는 medium이나 high로 충분합니다.
⚠️ 함정 3: “아무것도 설정 안 하면 어떻게 되죠?” #
별도로 정하지 않으면 자동으로 high로 동작합니다. 즉, 기본값이 이미 꽤 공들이는 모드입니다. 비용이 부담스럽다면 medium이나 low로 명시적으로 설정해주는 게 좋습니다. “알아서 절약해주겠지” 하면 그렇지 않습니다.
6. 한 단계 더 (관심 있는 분만) #
🎯 여기까지 오신 분 환영합니다. 이 섹션은 다섯 단계의 차이를 비교해보고 싶은 분을 위한 보너스입니다. 본문만 읽으셨어도 충분합니다.
다섯 단계 한눈에 비교 #
| 단계 | 어떤 느낌? | 어울리는 상황 |
|---|---|---|
low |
빠르고 간결 | 짧은 분류, 한 줄 요약, 일상 질문 |
medium |
균형 잡힌 답 | 책 요약, 일반적인 정리, 대부분의 글쓰기 |
high |
깊이 있는 답 (기본값) | 보고서 분석, 복잡한 추론, 어려운 질문 |
xhigh |
더 깊은 탐색 | 긴 호흡의 자료 조사 (Opus 4.7 전용) |
max |
최대치, 비용↑ | 정말 어려운 문제에만 |
모델별 권장 시작점 #
- Sonnet 4.6: 일상 대화는
low, 일반 작업은medium이 적절합니다. - Opus 4.7: 코딩이나 자료 조사 같은 깊은 작업은
xhigh부터 시작해보세요. 일반 글쓰기는medium~high로 충분합니다.
같은 질문을 low, medium, high로 각각 한 번씩 던져보세요. 답변의 길이와 깊이 차이가 눈에 들어오면, 본인 용도에 맞는 단계를 감으로 잡을 수 있습니다.
7. 한 마디 #
처음엔 “단계가 다섯 개나 있다고?” 싶지만, 실제로는 그냥 medium으로 시작해보고 마음에 안 들면 위·아래로 한 칸씩 옮겨보는 것만으로 충분합니다. 막힐 때는 함정 1~3 중 하나일 가능성이 큽니다 — low인데 깊은 답을 기대했거나, max인데 답이 너무 길어졌거나, 아예 설정 안 해서 비용이 예상보다 많이 나왔거나.
요리에 “간단히요/정성껏요"를 더하듯, Claude에게도 한 단어만 더해주세요. 처음 한두 번만 시도해보면 금세 손에 익습니다.
다음 글에서는 Claude 가이드 #7 — 구조화된 출력(Structured outputs), “AI가 약속한 형식대로 답하게 만들기"를 다룰 예정입니다. 표·JSON 같은 정해진 모양으로 답을 받고 싶을 때 쓰는 도구예요.
Claude API 공식 문서를 한국어로 풀어쓴 시리즈입니다. 원문 정확성이 가장 우선, 의역과 친근함은 그 위에서.
