Cmd. /effort
low·medium·high·xhigh·max·ultracode 중에서 모델의 적응형 추론(effort) 강도를 설정해 응답 깊이와 속도·비용의 균형을 조정하는 명령. 인터랙티브 슬라이더로도 조절합니다.
핵심 요약
/effort는low·medium·high·xhigh·max·ultracode중에서 모델의 적응형 추론 강도를 설정합니다. 인자 없이 실행하면 인터랙티브 슬라이더가 열립니다.- 지원 레벨은 모델별로 다릅니다. Opus 4.6·Sonnet 4.6은
xhigh미지원이라 지정 시high로 폴백합니다. max와ultracode는 세션 한정이며 settings의effortLevel에 넣을 수 없습니다.ultracode는 effort 레벨이 아니라xhigh추론 + 동적 워크플로 자동 오케스트레이션을 켜는 Claude Code 설정입니다.- 우선순위는 환경 변수(
CLAUDE_CODE_EFFORT_LEVEL) → 설정한 레벨 → 모델 기본값 순이며, 변경은 응답을 기다리지 않고 즉시 적용됩니다.
명령어 원본 선언
/effort [level|auto]level에는 low, medium, high, xhigh, max, ultracode를 지정할 수 있습니다. 사용 가능한 레벨은 활성 모델에 따라 다르며, max와 ultracode는 세션 한정(session-only) 입니다. auto는 모델 기본값으로 리셋합니다.
공식 설명 요약
공식 문서 표현: "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는 모델 기본값으로 리셋합니다.- 변경은 현재 응답이 끝나길 기다리지 않고 즉시 적용됩니다.
ultracode는 모델의 effort 레벨이 아니라 Claude Code 자체 설정입니다. 모델에는 xhigh를 전달하면서, 비중 있는 작업에서는 Claude가 동적 워크플로(dynamic workflows)를 자동으로 오케스트레이션합니다. 세션 한정이며 /effort로 설정하거나 --settings, Agent SDK 컨트롤 요청에서 "ultracode": true로 전달합니다. effortLevel 설정, --effort 플래그, CLAUDE_CODE_EFFORT_LEVEL 환경 변수에는 포함되지 않습니다.
최소 지원 버전
v2.1.68: Opus 4.6에서 Max/Team 플랜 기본값 medium effort 적용, "ultrathink" 키워드 재도입v2.1.72:/effort명령 간소화v2.1.73: 응답 중에도/effort변경 가능v2.1.80: "auto" 해석값 표시, 스킬/슬래시 커맨드effortfrontmatter 지원v2.1.111:xhigh추가, 인수 없이 실행 시 인터랙티브 슬라이더 제공 (xhigh_effort기능 capability 도입)v2.1.154: Opus 4.8 출시(요구 버전). Opus 4.8 기본 effort는high이며 가장 어려운 작업에는/effort xhigh사용 가능v2.1.170: Fable 5 추가. Fable 5 기본 effort는high이며xhigh와max를 지원
사용법
/effort low/effort high/effort auto모델별 지원 effort 레벨
사용 가능한 effort 레벨은 모델에 따라 다릅니다. 아래 표에 없는 모델은 effort를 지원하지 않습니다.
| 모델 | 지원 레벨 |
|---|---|
| Fable 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는 Fable 5, Opus 4.8, Opus 4.6, Sonnet 4.6에서 high, Opus 4.7에서 xhigh입니다. Fable 5, Opus 4.8, Opus 4.7을 처음 실행하면 이전에 다른 모델에서 설정한 레벨과 무관하게 해당 모델의 기본 effort(Fable 5/Opus 4.8은 high, Opus 4.7은 xhigh)가 적용됩니다. 전환 후 다른 레벨을 쓰려면 /effort를 다시 실행하세요.
Effort 레벨 선택
| 레벨 | 표시 | 언제 사용 |
|---|---|---|
low | ○ | 지능보다 지연시간이 중요한 짧고 범위가 좁은 작업에 한정 |
medium | ◐ | 일부 지능을 양보해도 되는 비용 민감 작업에서 토큰 사용 절감 |
high | ● | 토큰 사용과 지능의 균형. Fable 5·Opus 4.8·4.6·Sonnet 4.6 기본값 |
xhigh | — | 더 높은 토큰 비용으로 더 깊은 추론. Fable 5·Opus 4.8·Opus 4.7에서 선택 가능 |
max | — | 토큰 사용 제약 없는 최대 추론. 까다로운 작업에 도움될 수 있으나 과사고(overthinking) 경향이 있어 도입 전 검증 권장. 세션 한정 |
ultracode | — | 비중 있는 작업마다 동적 워크플로를 계획하고 메시지당 xhigh 추론을 사용하는 Claude Code 설정. 세션 한정 |
auto | — | 모델 기본값으로 리셋 |
effort 스케일은 모델마다 따로 보정되어, 같은 레벨 이름이라도 모델별 실제 추론 강도는 다릅니다.
low, medium, high, xhigh는 세션 간에 유지됩니다. max는 (환경 변수 CLAUDE_CODE_EFFORT_LEVEL로 설정한 경우를 제외하면) 현재 세션에만 적용됩니다. ultracode 역시 세션 한정입니다.
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/Opus 4.8/4.7에서/effort xhigh)로 전환하여 깊은 분석 유도 - 코드베이스 전반에 걸친 대형 작업에
/effort ultracode로 동적 워크플로 오케스트레이션 활용 - 세션 설정은 그대로 두고 특정 한 턴에서만 더 깊이 생각하게 하고 싶을 때 프롬프트에
ultrathink키워드 포함
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/effort | 추론 강도 조절 | 응답 깊이/속도 균형 조정 |
/model | 모델 자체 전환 (effort 슬라이더 포함) | 모델 종류 변경 필요 시 |
/config | 전체 설정 관리 | thinking 모드 등 여러 설정을 한꺼번에 조정 |
활용 사례
- 코드 리뷰 시 high/xhigh effort로 전환해 꼼꼼한 분석 수행
- 반복적인 boilerplate 생성 시 low effort로 속도·비용 절감
- 복잡한 디버깅 세션에서 high 이상 유지, 까다로운 난제에는
max를 시험적으로 사용 - 프로젝트 전반의 멀티스텝 작업을
ultracode로 자동 워크플로화
주의사항
- effort 레벨 변경은 현재 응답이 끝나길 기다리지 않고 즉시 적용됩니다.
- 현재 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·Opus 4.8·Opus 4.7은xhigh를 지원합니다./model과/status에서 실제 활성 모델을 확인하세요. - 서드파티 프로바이더(Bedrock 등)에서 모델 ID가 패턴 매칭되지 않으면 effort가 비활성화될 수 있으며,
_SUPPORTED_CAPABILITIES에effort,xhigh_effort,max_effort를 명시해야 합니다.
출처
- Commands: https://code.claude.com/docs/en/commands
- Model configuration (Adjust effort level): https://code.claude.com/docs/en/model-config