Claude Code Thinking Mode: ultrathink로 깊게 생각시키기

고급 기능 하나 알려드릴게요. ultrathink라는 키워드예요.

프롬프트에 ultrathink 넣으면 Claude Code가 더 깊게 생각해요. 복잡한 아키텍처 설계하거나 어려운 버그 잡을 때 쓰면 성공률이 확 올라가요.

단, 시간이 좀 더 걸려요. 급할 땐 빼고, 정말 중요한 결정할 때만 ultrathink 쓰세요.

---

TL;DR

• think < think hard < think harder < ultrathink — 단계별 thinking 강도
• ultrathink = 최대 32,000 토큰의 thinking budget 할당
• 복잡한 아키텍처, 까다로운 버그에 효과적
• Claude Code 전용 기능 (일반 Chat/API에서는 안 됨)
• 시간/비용 더 드니까 중요한 결정에만 사용

---

Extended Thinking이란?

"We recommend using the word 'think' to trigger extended thinking mode, which gives Claude additional computation time to evaluate alternatives more thoroughly." — Anthropic Best Practices

Extended Thinking은 Claude가 답변하기 전에 내부적으로 더 오래 생각하게 하는 기능이에요. 사람이 복잡한 문제를 풀 때 더 오래 고민하는 것처럼요.

---

Thinking 레벨 4단계

Anthropic 공식 문서에 명시된 4단계 thinking budget:

think < think hard < think harder < ultrathink

"These specific phrases are mapped directly to increasing levels of thinking budget in the system." — Anthropic Best Practices

토큰 할당량

Simon Willison이 Claude Code 소스를 분석한 결과:

키워드 Thinking 토큰 용도

think	~4,000	일반적인 작업
think hard, megathink	~10,000	중간 복잡도
think harder, ultrathink	~32,000	최고 복잡도

트리거 키워드들

ultrathink 레벨 (32K 토큰):

• ultrathink
• think harder
• think intensely
• think longer
• think really hard
• think super hard
• think very hard

megathink 레벨 (10K 토큰):

• think hard
• think deeply
• think more
• think a lot
• megathink

기본 think (4K 토큰):

• think
• think about it

---

언제 ultrathink를 쓸까?

✅ ultrathink 권장

1. 복잡한 아키텍처 설계
2. Design a scalable microservices architecture for our e-commerce platform. Please ultrathink about scalability, fault tolerance, and maintainability.
3. 까다로운 버그 디버깅
4. This race condition only happens in production under high load. Ultrathink about all possible causes and solutions.
5. 중요한 마이그레이션 계획
6. We need to migrate from MongoDB to PostgreSQL without downtime. Think harder about the migration strategy and rollback plan.
7. 보안 취약점 분석
8. Review our authentication flow for security vulnerabilities. Ultrathink about edge cases and attack vectors.
9. AI가 루프에 빠졌을 때
10. You've been trying the same approach 3 times. Ultrathink and try a completely different strategy.

❌ ultrathink 불필요

• 단순한 버그 수정
• 기본적인 CRUD 구현
• 간단한 리팩토링
• 문서 업데이트
• 커밋 메시지 작성

"For routine tasks - trivial bug fixes, simple feature additions - the standard think level offers optimal efficiency-cost ratio." — goatreview.com

---

사용 예시

아키텍처 설계

I need to design a real-time notification system that handles 1M+ concurrent users.
Please ultrathink about:
- Message queue architecture (Kafka vs RabbitMQ vs Redis)
- WebSocket scaling strategy
- Failure handling and retry logic
- Cost optimization

복잡한 디버깅

Our payment processing sometimes fails silently in production.
Logs show no errors but transactions don't complete.
Ultrathink about what could cause this and how to debug it.

기술 스택 결정

We're starting a new project and need to choose between:
- Next.js vs Remix vs SvelteKit
- PostgreSQL vs MongoDB vs CockroachDB
- Vercel vs AWS vs GCP

Think harder about the trade-offs for a team of 5 developers 
building a B2B SaaS with complex data relationships.

Plan Mode와 함께

[Plan Mode에서]
I want to add real-time collaboration features to our document editor.
Ultrathink about the implementation plan, considering:
- Conflict resolution (OT vs CRDT)
- Presence indicators
- Offline support
- Performance at scale

---

실전 팁

1. CLAUDE.md에 가이드라인 추가

# Thinking Mode Guidelines

- Use "think" for routine tasks and bug fixes
- Use "think hard" for API design and integration
- Reserve "ultrathink" for:
  - System architecture decisions
  - Critical security reviews
  - Complex migration planning
  - When Claude gets stuck in a loop

2. 커스텀 명령어로 만들기

<!-- .claude/commands/deep-analysis.md -->
---
description: Deep analysis with extended thinking
model: opus
---

Ultrathink about this problem before proposing solutions.

Follow these steps:
1. Analyze the problem thoroughly
2. Consider multiple approaches with trade-offs
3. Evaluate security, performance, and maintainability
4. Recommend the best solution with detailed reasoning

Problem: $ARGUMENTS

사용:

> /deep-analysis "How should we implement real-time sync?"

3. 단계적 접근

급하게 ultrathink부터 쓰지 말고:

1. 먼저 일반 요청으로 시도
2. 결과가 얕으면 think hard 추가
3. 그래도 부족하면 ultrathink

# Step 1: 일반 요청
> Design the authentication flow

# Step 2: 결과가 얕다면
> Think harder about edge cases and security

# Step 3: 정말 복잡하면
> Ultrathink about the entire auth architecture including OAuth, MFA, and session management

---

주의사항

Claude Code 전용

"'ultrathink' is a real, documented feature - but it only works in Claude Code, Anthropic's command-line coding tool." — ITECS Online

일반 Claude Chat이나 API에서는 작동하지 않아요. Claude Code CLI에서만 동작합니다.

시간과 비용

• ultrathink는 응답 시간이 길어짐
• 토큰 사용량 증가 → 비용 증가
• 급한 작업에는 비효율적

최신 버전 변경사항

Claude Code v2.0 이후로 thinking mode가 기본 활성화되고 Tab 토글로 변경되었어요. 하지만 ultrathink 키워드는 여전히 최대 thinking budget을 명시적으로 요청하는 방법으로 유효합니다.

---

Thinking Mode 토글 (v2.0+)

최신 버전에서는 Tab 키로 thinking mode를 토글할 수 있어요:

# Tab 한 번: Plan Mode (thinking 강화)
# Shift+Tab 두 번: Plan Mode 진입

ultrathink 키워드와 함께 사용하면 더 강력해요:

[Tab으로 Plan Mode 진입]
> Ultrathink about the database schema for our multi-tenant SaaS

---

요약: 언제 뭘 쓸까?

상황 권장 레벨

단순 버그 수정	(기본)
일반적인 기능 구현	think
API 설계, 리팩토링	think hard
아키텍처 설계	ultrathink
복잡한 디버깅	ultrathink
보안 리뷰	ultrathink
Claude가 루프에 빠짐	ultrathink

---

체크리스트

기본 사용

• [ ] 복잡한 작업에 think 키워드 추가
• [ ] 중요한 설계에 think hard 사용
• [ ] 최고 난이도에만 ultrathink 사용

고급 활용

• [ ] CLAUDE.md에 thinking 가이드라인 추가
• [ ] /deep-analysis 같은 커스텀 명령어 생성
• [ ] Plan Mode + ultrathink 조합 활용

주의

• [ ] 급한 작업엔 ultrathink 피하기
• [ ] 비용/시간 고려하기
• [ ] Claude Code에서만 작동함 기억하기

---

마무리

ultrathink는 Claude Code의 숨겨진 파워 기능이에요.

기억하세요:

• think < think hard < think harder < ultrathink
• ultrathink = 최대 32K 토큰의 thinking budget
• 복잡한 아키텍처, 어려운 버그에 효과적
• 시간이 더 걸리니까 중요한 결정에만
• Claude Code 전용 (Chat/API에서는 안 됨)

"These specific phrases are mapped directly to increasing levels of thinking budget in the system." — Anthropic Best Practices

정말 중요한 아키텍처 결정이나 며칠째 못 잡는 버그가 있다면, ultrathink 한 번 써보세요. 성공률이 확 달라질 거예요.

---

참고 자료

Anthropic 공식

• Claude Code Best Practices — ultrathink 공식 문서

분석/가이드

• Simon Willison's Analysis — 토큰 할당량 코드 분석
• Claude Code Extended Thinking Guide — 종합 가이드
• Thinking Levels Deep Dive — 레벨별 상세 설명

---