개발바닥DEVPAW · GROUND-UP DEV NOTES
검색
메뉴
KO
한국어English日本語繁體中文EspañolPortuguês简体中文
AI Coding & Agents

[Claude Code #8] /model·/effort·/fast, AI 성능 튜닝

Claude Code의 성능 다이얼 4종을 정리했습니다. /model 별칭과 저장 규칙, /effort 레벨과 ultracode, /fast의 비용 함정, /advisor 자문 모델 조합까지 상황별 추천을 담았습니다.

5분 읽기
[Claude Code #8] /model·/effort·/fast, AI 성능 튜닝 대표 이미지

Claude Code에는 속도·품질·비용을 조절하는 다이얼이 네 개 있습니다. /model, /effort, /fast, /advisor예요.

넷의 역할이 미묘하게 달라서 헷갈리기 쉽습니다. 이번 편에서 한 번에 정리할게요.

Claude Code 7편이 일꾼을 늘리는 법이었다면, 이번엔 일꾼 하나하나의 성능을 맞추는 법입니다.

/model: 어떤 모델이 일할지

/model은 세션의 주 모델을 바꿉니다. 버전 번호 대신 별칭을 쓰면 편해요.

공식 모델 설정 문서 기준 주요 별칭은 이렇습니다.

  • fable: 가장 어렵고 오래 걸리는 작업용 최상위 모델
  • opus: 복잡한 추론 작업용
  • sonnet: 일상 코딩 작업용
  • haiku: 단순 작업용 경량 모델
  • default: 오버라이드를 지우고 계정 권장값으로 복귀

/model만 입력하면 피커가 열립니다. Enter를 누르면 선택이 기본값으로 저장되고, s를 누르면 이번 세션에만 적용돼요.

대화가 진행된 뒤 모델을 바꾸면 다음 응답에서 전체 기록을 캐시 없이 다시 읽습니다. 그래서 피커가 확인을 한 번 물어봅니다.

/effort: 얼마나 깊게 생각할지

/effort는 모델의 적응형 추론 강도를 정합니다. 낮을수록 빠르고 싸고, 높을수록 깊게 고민해요.

레벨은 low·medium·high·xhigh·max 다섯 단계입니다. 지원 레벨은 모델마다 다른데, Haiku는 effort 자체를 지원하지 않아요.

미지원 레벨을 걸면 그 이하에서 가장 높은 레벨로 내려가 돌아갑니다.

기본값은 대부분 high입니다. max는 가장 깊은 추론이지만 현재 세션에만 적용돼요.

메뉴에는 ultracode라는 항목도 있습니다. 모델에는 xhigh를 보내면서 굵직한 작업마다 멀티에이전트 워크플로를 함께 돌리는 Claude Code 설정이에요. 역시 세션 한정입니다.

Claude Code 작업 유형별 model·effort·fast·advisor 선택 가이드 다이어그램
작업 성격에서 출발하면 고르기 쉬워요

/fast: 같은 모델을 더 빠르게

/fast는 Opus를 최대 2.5배 빠르게 돌리는 토글입니다(연구 프리뷰).

중요한 건 모델이 바뀌는 게 아닙니다. 공식 fast mode 문서가 명시하듯, 같은 Opus를 속도 우선 구성으로 돌려서 품질은 동일하고 토큰 단가만 높아집니다.

  • 지원 모델: Opus 5와 Opus 4.8 (Sonnet·Haiku 미지원, 다른 모델에서 켜면 Opus로 자동 전환)
  • 요금: 공식 fast mode 문서 기준 입력 $10 · 출력 $50 (백만 토큰당)
  • 구독 플랜(Pro·Max·Team·Enterprise)은 사용량 크레딧을 켜야 함 (Team·Enterprise는 관리자 활성화도 필요)

비용 함정이 하나 있습니다. 대화 중간에 켜면 그 시점까지의 컨텍스트 전체를 fast 모드 단가로 한 번 재처리해요. 쓸 거면 세션 시작부터 켜는 게 쌉니다.

켜져 있는 동안은 입력창 옆에 ↯ 아이콘이 보입니다.

/advisor: 결정적 순간에만 상급 모델

/advisor는 메인 모델에게 자문역을 붙이는 실험 기능입니다.

방향을 정하기 전, 같은 에러가 반복될 때, 완료를 선언하기 전. 이런 결정적 순간에 Claude가 알아서 더 강한 모델에게 물어봅니다. 자문 모델은 전체 대화를 받아 보고 조언을 돌려줘요.

/advisor opus

규칙은 하나입니다. 자문역은 메인 모델보다 약하면 안 됩니다. Sonnet 메인에 Opus 자문이 대표적인 조합이고, Fable 메인은 Fable 자문만 받아요.

비용은 API 과금이면 자문 모델 요율로 붙고, 구독 플랜이면 플랜 사용량에서 나갑니다. 그래도 매 턴이 아니라 결정 지점에만 부르니, 강한 모델을 상시 돌리는 것보다 대개 저렴합니다.

상황별 추천 조합

  • 일상 코딩: sonnet + 기본 effort. 필요하면 advisor로 opus를 얹기
  • 어려운 설계·긴 자율 작업: fable 또는 opus + high 이상
  • 급한 반복 수정·라이브 디버깅: fast 모드 + 낮은 effort
  • 단순 일괄 작업: haiku (effort 미지원이라 그대로 씁니다)
ASK THE ADVISOR 문구와 갈림길에서 큰 로봇에게 바통을 넘기는 작은 로봇 일러스트
갈림길에서만 상급자에게 바통을 넘깁니다

정리

/model은 누가 일할지, /effort는 얼마나 깊게 생각할지, /fast는 얼마나 빨리 답할지, /advisor는 언제 상급자에게 물어볼지를 정합니다.

넷은 겹치지 않는 다이얼이라 조합이 자유롭습니다. 작업 성격에 맞춰 돌려 보세요.

다음 편에서는 코드 품질을 지키는 /code-review를 다룹니다. low부터 ultra까지 리뷰 강도별 차이를 정리할게요.

출처 및 확인 기준

이어서 읽기

Claude Code 시리즈

관련 주제