everything-claude-code/docs/ko-KR/rules/performance.md

성능 최적화

모델 선택 전략

Haiku 4.5 (Sonnet 능력의 90%, 3배 비용 절감):

• 자주 호출되는 경량 에이전트
• 페어 프로그래밍과 코드 생성
• 멀티 에이전트 시스템의 워커 에이전트

Sonnet 4.6 (최고의 코딩 모델):

• 주요 개발 작업
• 멀티 에이전트 워크플로우 오케스트레이션
• 복잡한 코딩 작업

Opus 4.5 (가장 깊은 추론):

• 복잡한 아키텍처 의사결정
• 최대 추론 요구사항
• 리서치 및 분석 작업

컨텍스트 윈도우 관리

컨텍스트 윈도우의 마지막 20%에서는 다음을 피하세요:

• 대규모 리팩토링
• 여러 파일에 걸친 기능 구현
• 복잡한 상호작용 디버깅

컨텍스트 민감도가 낮은 작업:

• 단일 파일 수정
• 독립적인 유틸리티 생성
• 문서 업데이트
• 단순한 버그 수정

확장 사고 + 계획 모드

확장 사고는 기본적으로 활성화되어 있으며, 내부 추론을 위해 최대 31,999 토큰을 예약합니다.

확장 사고 제어 방법:

• 전환: Option+T (macOS) / Alt+T (Windows/Linux)
• 설정: ~/.claude/settings.json에서 alwaysThinkingEnabled 설정
• 예산 제한: export MAX_THINKING_TOKENS=10000
• 상세 모드: Ctrl+O로 사고 출력 확인

깊은 추론이 필요한 복잡한 작업:

1. 확장 사고가 활성화되어 있는지 확인 (기본 활성)
2. 구조적 접근을 위해 계획 모드 활성화
3. 철저한 분석을 위해 여러 라운드의 비판 수행
4. 다양한 관점을 위해 역할 분리 서브에이전트 사용

빌드 문제 해결

빌드 실패 시:

1. build-error-resolver 에이전트 사용
2. 에러 메시지 분석
3. 점진적으로 수정
4. 각 수정 후 검증