AI 도서관 · Claude · 단축 명령어 · 모델 선택

사고량 다섯 단계, 어디에 무엇을 쓰나

low·medium·high·xhigh·max. 기본은 high이고 낮추는 쪽으로 시험하세요

내용

📌 다섯 단계

low     가장 효율적. 토큰을 크게 아끼고 능력은 조금 내줍니다
        간단한 작업, 속도가 중요한 것, 서브에이전트

medium  균형. 적당히 아낍니다
        속도·비용·성능을 함께 봐야 하는 에이전트 작업

high    기본값. 파라미터를 안 넣은 것과 **정확히 같습니다**
        복잡한 추론, 어려운 코딩, 에이전트 작업

xhigh   길게 도는 작업용
        30분 넘게 도는 에이전트·코딩, 토큰 예산이 큰 일

max     제한 없이 최대
        가장 깊은 추론이 필요한 일

📌 Fable 5.1 권장 (공식 문서)
**기본값 high 에서 시작하세요.** 그다음 내 작업으로 다른 단계를 시험합니다.
능력이 특히 중요한 에이전트·코딩 작업은 xhigh 나 max 로 올리고,
일상적이거나 응답 속도가 중요한 일은 medium·low 로 내립니다.
단, **품질이 유지되는 것을 확인한 뒤에** 내리세요.

⚠️ 엄격한 토큰 예산이 아닙니다
공식 문서 표현으로 effort 는 **행동 신호**입니다.
낮은 단계에서도 충분히 어려운 문제에는 여전히 생각합니다. 다만 덜 합니다.
"low 로 두면 절대 오래 안 생각한다" 가 아닙니다.

📌 모든 출력 토큰에 적용됩니다
답변 글, 도구 호출, 생각 — 전부입니다. 생각을 꺼도 effort 는 작동합니다.

도구 사용도 달라집니다
낮추면 — 여러 작업을 한 번의 도구 호출로 합치고, 서론 없이 바로 실행하고, 짧게 보고
올리면 — 도구를 더 자주 부르고, 계획을 먼저 설명하고, 변경 내용을 자세히 정리

⚠️ high 이상에서는 max_tokens 를 크게 잡으세요
생각과 답변을 **합쳐서** 세는 하드 리밋입니다.
답변 길이만 보고 잡으면 생각하다가 잘립니다.

💡 Claude Code 에서는 /effort 로 바꿉니다. API 에서는 output_config 로 넣습니다.

궁금한 점: {{INPUT}}

{{INPUT}} 자리에 내 내용을 넣어 쓰는 프롬프트입니다. 아래 버튼으로 열면 넣는 칸이 나옵니다.

근거

유형
공식 기능·명령 — 해당 제품에서 실제로 동작합니다
사용 환경
Claude Fable 5.1 · Mythos 5.1 · Opus 5 · Sonnet 5 등 — Claude Code 는 /effort
사용 조건
모델마다 지원하는 단계가 다릅니다. max 는 되는데 xhigh 는 안 되는 모델도 있습니다
주의
엄격한 토큰 한도가 아니라 행동 신호입니다. 낮춰도 어려운 문제에는 여전히 생각합니다.
공식 출처
https://platform.claude.com/docs/en/build-with-claude/effort
확인일
2026-09-09 — 이후 바뀌었을 수 있습니다
도서관에서 열기 — 내 내용 넣고 복사하기