Cmd. /effort
low·medium·high·xhigh·max·ultracode 중에서 모델의 적응형 추론(effort) 강도를 설정해 응답 깊이와 속도·비용의 균형을 조정하는 명령. 인터랙티브 슬라이더로도 조절합니다.
핵심 요약
- 모델별 reasoning effort 설정·조회
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
모델별 reasoning effort 설정·조회
/effort [level|auto|status]사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
모델이 지원하는 레벨만 사용할 수 있습니다. -p에서는 v2.1.205+의 세션 값이 적용되지만 Fable 5·Opus 4.8·4.7은 해당 slash 변경을 적용하지 않아 --effort를 사용합니다.
사용 예
/effort status/effort low/effort high/effort auto모델별 지원 effort 레벨
사용 가능한 effort 레벨은 모델에 따라 다릅니다. 아래 표에 없는 모델은 effort를 지원하지 않습니다.
| 모델 | 지원 레벨 |
|---|---|
| Fable 5.1, Fable 5 | low, medium, high, xhigh, max |
| Opus 5, Sonnet 5, Opus 4.8, Opus 4.7 | low, medium, high, xhigh, max |
| Opus 4.6, Sonnet 4.6 | low, medium, high, max (xhigh 미지원) |
활성 모델이 지원하지 않는 레벨을 설정하면 Claude Code는 지정한 레벨 이하에서 지원되는 가장 높은 레벨로 폴백합니다. 예를 들어 Opus 4.6에서는 xhigh가 high로 동작합니다.
기본 effort는 Opus 4.7(xhigh)을 제외한 모든 모델에서 high입니다. Fable 5, Opus 4.8, Opus 4.7을 처음 실행하면 이전에 다른 모델에서 설정한 레벨과 무관하게 해당 모델의 기본 effort가 세션을 넘어 유지되는 기본 effort hold가 적용되고, /effort·/model picker 슬라이더·--effort로 한 번 바꾸면 해제됩니다. Opus 5와 Fable 5.1에는 이 hold가 없어 저장한 레벨이 바로 적용됩니다. v2.1.257부터 --effort는 hold를 영구 해제하지 않고 그 세션에서만 해제합니다.
Fable 5.1에서는 v2.1.260부터 세션 중 effort를 바꿔도 prompt cache가 무효화되지 않습니다. Messages API의 per-message effort(mid-conversation-output-config-2026-07-01 beta)를 Claude Code가 활용하는 경로이며, 다른 모델에서는 여전히 effort 변경 시 cache 경고가 뜹니다.
Effort 레벨 선택
| 레벨 | 표시 | 언제 사용 |
|---|---|---|
low | ○ | 지능보다 지연시간이 중요한 짧고 범위가 좁은 작업에 한정 |
medium | ◐ | 일부 지능을 양보해도 되는 비용 민감 작업에서 토큰 사용 절감 |
high | ● | 토큰 사용과 지능의 균형. Opus 4.7을 제외한 모든 모델(Fable 5.1·Fable 5·Opus 5·Sonnet 5·Opus 4.8·4.6·Sonnet 4.6)의 기본값 |
xhigh | — | 더 높은 토큰 비용으로 더 깊은 추론. Fable 5.1·Fable 5·Opus 5·Sonnet 5·Opus 4.8·Opus 4.7에서 선택 가능 |
max | — | 토큰 사용 제약 없는 최대 추론. 까다로운 작업에 도움될 수 있으나 과사고(overthinking) 경향이 있어 도입 전 검증 권장. 세션 한정 |
ultracode | — | 비중 있는 작업마다 동적 워크플로를 계획하고 메시지당 xhigh 추론을 사용하는 Claude Code 설정. 세션 한정 |
auto | — | 모델 기본값으로 리셋 |
effort 스케일은 모델마다 따로 보정되어, 같은 레벨 이름이라도 모델별 실제 추론 강도는 다릅니다.
low, medium, high, xhigh는 modelSettings에 모델별로 저장되어 세션 간에 유지됩니다. max는 (환경 변수 CLAUDE_CODE_EFFORT_LEVEL로 설정한 경우를 제외하면) 현재 세션에만 적용됩니다. ultracode 역시 세션 한정입니다. v2.1.257부터는 /model처럼 /effort picker 행에서 s를 누르면 저장하지 않고 현재 세션에만 적용할 수 있습니다. -p의 /effort는 현재 세션에 적용되며 기본값으로 저장되지 않습니다. 다만 Fable 5·Opus 4.8·Opus 4.7의 기본 effort hold가 유지 중이면 적용되지 않고 Not applied를 출력하므로 실행 시 --effort를 쓰세요.
effort를 설정하는 다른 방법
--effort플래그: Claude Code 실행 시 단일 세션에 레벨을 지정CLAUDE_CODE_EFFORT_LEVEL환경 변수: 레벨 이름 또는auto지정 (모든 방법보다 우선)effortLevel설정: settings 파일에low,medium,high,xhigh지정 가능.max와ultracode는 세션 한정이라 여기에 넣을 수 없음- 스킬/서브에이전트 frontmatter: 스킬 또는 서브에이전트 markdown 파일에
effort를 지정하면 해당 스킬/서브에이전트가 동작하는 동안 세션 레벨을 덮어씀(환경 변수는 덮지 못함) /model슬라이더: 모델을 고르면서 좌/우 화살표로 effort 슬라이더 조정
우선순위는 환경 변수 → 설정한 레벨 → 모델 기본값 순입니다.
선택 시점
- 간단한 오타 수정 전
/effort low로 전환하여 속도·비용 확보 - 아키텍처 설계 논의 전
/effort high(또는 Fable 5.1/Opus 5/Opus 4.8에서/effort xhigh)로 전환하여 깊은 분석 유도. Fable 5.1은low에서 검색 대신 기억으로 답하는 경향이 있으니 최신 정보가 필요한 턴은 effort를 올릴 것 - 코드베이스 전반에 걸친 대형 작업에
/effort ultracode로 동적 워크플로 오케스트레이션 활용 - 세션 설정은 그대로 두고 특정 한 턴에서만 더 깊이 생각하게 하고 싶을 때 프롬프트에
ultrathink키워드 포함
관련 명령 선택
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/effort | 추론 강도 조절 | 응답 깊이/속도 균형 조정 |
/model | 모델 자체 전환 (effort 슬라이더 포함) | 모델 종류 변경 필요 시 |
/config | 전체 설정 관리 | thinking 모드 등 여러 설정을 한꺼번에 조정 |
실행 결과와 유지 범위
현재 모델의 추론 강도를 조정합니다. 세션 한정 값과 저장되는 기본값은 모델·레벨·입력 표면에 따라 다릅니다.
공식 문서 표현: "Set the model effort level. Accepts low, medium, high, xhigh, max, or ultracode; available levels depend on the model, and max and ultracode are session-only."
/effort는 모델의 effort 레벨(적응형 추론, adaptive reasoning) 을 설정하는 명령입니다. effort 레벨에 따라 모델은 각 단계의 작업 복잡도에 맞춰 얼마나 생각할지 스스로 정합니다. effort가 낮으면 단순한 작업을 더 빠르고 싸게 처리하고, 높으면 복잡한 문제를 더 깊이 추론합니다.
- 인수 없이 실행하면 인터랙티브 슬라이더가 열립니다. 좌/우 화살표로 레벨을 선택하고
Enter로 적용합니다. - 레벨 이름을 직접 지정하면 즉시 그 레벨로 설정됩니다.
/effort auto는 모델 기본값으로 리셋하고,/effort status는 현재 레벨을 출력합니다.- 변경은 응답 중에도 요청할 수 있고, cache 경고가 표시되면 확인한 뒤 같은 턴의 다음 요청부터 적용됩니다.
ultracode는 모델의 effort 레벨이 아니라 Claude Code 자체 설정입니다. 모델에는 xhigh를 전달하면서, 비중 있는 작업에서는 Claude가 동적 워크플로(dynamic workflows)를 자동으로 오케스트레이션합니다. 세션 한정이며 /effort로 설정하거나 --settings, Agent SDK 컨트롤 요청에서 "ultracode": true로 전달합니다. effortLevel 설정, --effort 플래그, CLAUDE_CODE_EFFORT_LEVEL 환경 변수에는 포함되지 않습니다.
effort 상한
maxEffortLevel 설정은 전체 또는 modelSettings의 모델별 effort 상한을 정합니다. Bedrock·Vertex·Foundry에도 적용되며 사용자는 상한보다 낮은 effort를 선택할 수 있습니다. /effort 선택이 기대보다 낮으면 적용된 상한을 확인하세요.
공식 Changelog · 2026-09-12 KST
주의사항
- effort 레벨 변경은 응답 중에도 요청할 수 있고, cache 경고가 표시되면 확인한 뒤 같은 턴의 다음 요청부터 적용됩니다.
- 현재 effort 레벨은 로고/스피너 옆에 "with low effort"처럼 표시되어,
/model을 열지 않아도 활성 설정을 확인할 수 있습니다. ultrathink키워드는 그 턴에서만 더 깊은 추론을 요청할 뿐 세션 effort 설정은 그대로 둡니다(API로 보내는 effort 레벨도 바뀌지 않습니다). 반면 "think", "think hard", "think more" 같은 표현은 키워드로 인식되지 않고 그냥 프롬프트 텍스트로 전달됩니다.- high/xhigh/max로 갈수록 토큰 사용량과 비용이 증가합니다. 특히
max는 과사고(overthinking) 경향이 있어 광범위 도입 전 검증을 권장합니다. - 모델에 따라 지원 effort 레벨이 다릅니다(Opus 4.6·Sonnet 4.6은
xhigh미지원,xhigh지정 시high로 폴백). Fable 5.1·Fable 5·Opus 5·Sonnet 5·Opus 4.8·Opus 4.7은xhigh를 지원합니다./model과/status에서 실제 활성 모델을 확인하세요. - Fable 5.1·Fable 5는 thinking을 끌 수 없습니다. 세션 toggle,
alwaysThinkingEnabled,MAX_THINKING_TOKENS=0이 모두 무시되므로 비용을 낮추려면 effort를 내리는 것이 유일한 수단입니다. - 서드파티 프로바이더(Bedrock 등)에서 모델 ID가 패턴 매칭되지 않으면 effort가 비활성화될 수 있으며,
_SUPPORTED_CAPABILITIES에effort,xhigh_effort,max_effort를 명시해야 합니다.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록