[Claude Code] 모델 막히면 대체 모델로 자동 넘어가요

[Claude Code] 모델 막히면 대체 모델로 자동 넘어가요

Claude Code의 6월 8~12일(Week 24) 업데이트에 fallbackModel 설정이 들어갔어요. 주력으로 쓰던 모델이 과부하거나 응답이 안 될 때, 미리 정해둔 대체 모델로 자동으로 넘어가는 기능이에요. 공식 문서 기준으로 대체 모델은 최대 3개까지 순서대로 지정할 수 있어요.

01. 첫 모델이 안 되면 다음 모델로 차례로 넘어가요

Anthropic 공식 문서에는 "주력 모델이 overloaded이거나 unavailable일 때 순서대로 시도한다"고 나와 있어요. 첫 모델이 안 되면 두 번째, 그래도 안 되면 세 번째 모델로 차례로 넘어가는 방식이에요.

지금까지는 모델 하나를 정해두고 그게 막히면 작업이 거기서 멈췄는데, 이번 변경으로 장애 상황에 대비한 우회로를 걸어둘 수 있게 됐어요.

02. 설정 파일에 대체 모델을 순서대로 적어둬요

설정에서 fallbackModel 항목에 대체 모델 목록을 순서대로 넣는 방식이에요. 정확한 작성 형식은 공식 문서의 model-config 안 fallback model chains 항목에 정리돼 있어요.

한 번만 쓰고 싶으면 명령행 플래그도 있어요. 이번 주 변경으로 --fallback-model 플래그가 대화형 세션에도 적용되기 시작했다고 해요(이전에는 비대화형 실행 위주였어요).

claude --fallback-model claude-sonnet-4-6,claude-haiku-4-5

03. 과부하 시간대에 작업이 안 끊기는 게 핵심이에요

한국에서 미국 피크 시간대와 겹치면 과부하 응답을 만나는 경우가 있는데, 대체 모델 체인을 걸어두면 그때 세션이 멈추지 않고 다른 모델로 이어질 수 있어요. 한국 사용자한테는 이 부분이 실용적으로 의미 있는 변화예요.

다만 대체 모델은 주력 모델과 성능이나 비용이 다를 수 있어서, 무엇을 백업으로 둘지는 미리 정해두는 게 좋아요. 실제로 폴백이 얼마나 자주 발동하고 결과 품질이 어떤지는 직접 써보고 판단할 부분이에요.

출처: Claude Code — Week 24 digest, Claude Code Docs — model-config

이 글은 공식 발표 내용을 정리한 것이고, Anthropic으로부터 어떤 형식의 협찬도 받지 않았습니다.