대부분의 사람들은 ultrathink와 ultracode를 혼용해서 사용합니다. 하지만 이 둘은 같은 것이 아닙니다. 하나는 턴당(per-turn) 키워드이며, 다른 하나는 세션 수준(session-level) 명령입니다. 잘못된 것을 사용하면 더 나은 결과를 얻지 못한 채 비용만 낭비하게 됩니다.

두 가지 메커니즘

Claude Code에는 추론 노력(reasoning effort)을 제어하는 두 가지 별개의 방식이 있습니다:

ultrathink — 프롬프트에 추가하는 턴당(per-turn) 키워드입니다. 이는 Claude에게 해당 단일 요청에 대해 최대 확장 사고 예산(maximum extended thinking budget)을 사용하도록 지시합니다.

ultracode — /effort ultracode 슬래시 명령(slash command)에 의해 트리거됩니다. 이는 세션 노력 수준을 xhigh로 설정하고, 동적 워크플로우(dynamic workflows, 여러 서브 에이전트가 동시에 작업하는 병렬 방식)를 활성화합니다.

이 둘은 독립적입니다. 하나를 다른 하나 없이 사용할 수 있습니다.

5가지 노력 수준

Claude Code에는 단순히 높음(high)과 낮음(low)만 있는 것이 아니라 5가지 노력 수준이 있습니다:

이러한 수준은 Claude가 응답하기 전에 얼마나 많이 생각할지에 영향을 미칩니다. 더 많은 연산(compute)은 더 나은 추론(reasoning)을 의미하지만, 더 많은 토큰과 더 높은 비용을 수반합니다.

ultrathink가 실제로 하는 일

프롬프트에 ultrathink를 추가하면, Claude는 해당 특정 요청에 대해 확장 사고(extended thinking) 기능을 사용합니다. Claude는 답변을 제공하기 전에 내부적으로 단계별로 추론합니다.

# 최대 사고를 적용한 단일 프롬프트
"ultrathink — 왜 이 React 컴포넌트가 키를 입력할 때마다 리렌더링(re-rendering)되나요?"

이는 오직 해당 메시지 하나에만 적용됩니다. 다음 메시지는 세션의 기본 노력 수준으로 돌아갑니다.

사용 시점:

• 해결하기 어려운 문제를 디버깅(Debugging)할 때
• Claude에게 복잡한 코드베이스 섹션을 분석하도록 요청할 때
• 가능한 가장 깊은 추론을 원하는 모든 단일 질문

ultracode가 실제로 하는 일

/effort ultracode는 두 가지 일을 동시에 수행합니다:

1. 세션 전체에 대해 노력 수준을 xhigh (8× 토큰 배수)로 설정합니다.
2. 동적 워크플로우(dynamic workflows)를 활성화합니다 — Claude가 동시에 작동하는 병렬 서브 에이전트(parallel subagents)를 생성할 수 있습니다.

# Claude Code에서
/effort ultracode

...

병렬 서브에이전트 (parallel subagents)가 진정한 차별점입니다. 작업을 순차적으로 수행하는 대신, Claude는 여러 에이전트를 동시에 실행할 수 있습니다. 예를 들어, 하나는 데이터베이스 스키마 (database schema)를 확인하는 동안 다른 하나는 API 경로 (API routes)를 읽는 식입니다.

사용 시점:

• 여러 파일에 걸친 대규모 리팩터링 (refactors)
• 처음부터 시작하는 전체 기능 구현 (Full feature implementation)
• 여러 가지 사항을 동시에 조사해야 하는 운영 환경의 장애 (Production incidents)

비용의 현실

토큰 배수 (token multipliers) 효과는 실재합니다. medium 수준에서 0.10달러가 드는 작업은 다음과 같은 비용이 발생합니다:

• high: 약 0.40달러
• xhigh (ultracode): 약 0.80달러
• max: 약 1.60달러

복잡한 2시간의 코딩 세션의 경우, 컨텍스트 크기 (context size)에 따라 medium과 xhigh 사이의 비용 차이는 5~20달러에 달할 수 있습니다.

실질적인 규칙:

• 작업의 80%에는 medium (기본값)을 사용하세요.
• 특정 문제에 막혔을 때는 high 또는 단일 ultrathink를 사용하세요.
• 병렬 작업이 도움이 되는 크고 명확하게 정의된 작업에만 ultracode를 사용하세요.

/effort max의 용도

max는 가장 높은 수준이며 의도적으로 ultracode와 분리되어 있습니다. 이는 다음과 같은 용도로 설계되었습니다:

• 심층 연구 작업 (Deep research tasks)
• 매우 큰 코드베이스 (codebases) 분석
• Claude가 수많은 에지 케이스 (edge cases)를 진정으로 고려해야 하는 문제들

max는 동적 워크플로우 (dynamic workflows)를 자동으로 활성화하지 않습니다. 그것은 오직 ultracode만의 기능입니다. max는 순수한 사고의 깊이 (thinking depth)를 의미합니다.

흔한 실수들

모든 것에 ultrathink 사용하기 — 대부분의 작업에는 필요하지 않음에도 불구하고 모든 메시지에 대해 16배의 비용을 지불하게 됩니다. 진정으로 어려운 문제에만 아껴두세요.

ultracode가 단순히 "고품질"을 의미한다고 생각하기 — 이는 세션의 동작 방식을 변경합니다. 병렬성 (parallelism)의 이점을 얻지 못하는 작업은 ultracode를 사용해도 이점이 없습니다.

속도를 위해 max 사용하기 — max는 느립니다. 확장된 사고 (Extended thinking)는 더 많은 시간을 소요합니다. 속도를 원한다면 medium을 유지하세요.

ultracode 사용 후 effort를 재설정하지 않기 — 큰 작업을 위해 /effort ultracode를 설정했다면, 작업 후에는 반드시 /effort medium으로 돌려놓는 것을 기억하세요. 그렇지 않으면 남은 세션 동안 모든 질문에 대해 8배의 비용을 지불하게 됩니다.

빠른 결정 가이드

어려운 질문 하나에 도움이 필요하신가요?
→ 프롬프트에 "ultrathink"를 추가하세요

...

전체 가이드: stacknotice.com/blog/claude-code-ultrathink-ultracode-effort-guide-2026