긴 Claude Code 작업에서 의외로 중요한 것은 모델 성능만이 아닙니다. 모델이 잠시 unavailable이거나 overloaded일 때 세션이 멈추지 않는지도 중요합니다.
Week 24 문서 ↗는 fallbackModel 설정이 최대 세 개의 fallback model을 순서대로 시도할 수 있고, --fallback-model이 interactive session에도 적용된다고 설명합니다. Week 22에서는 primary model을 찾지 못할 때 fallback model로 세션을 이어가도록 개선됐다고도 안내했습니다.
이 글은 작성 시점 2026-06-17 · Claude Code Week 24 문서 ↗, Week 22 문서 ↗ 스냅숏 기준으로 정리했습니다.
어떤 문제를 푸나
AI 코딩 세션은 생각보다 오래 갑니다. 테스트를 기다리고, 로그를 읽고, 리뷰 코멘트를 반영하고, 다시 검증합니다. 이때 primary model이 일시적으로 unavailable이면 작업 흐름이 끊깁니다.
fallback model은 이런 상황에서 예비 모델을 순서대로 시도합니다.
flowchart TD
A[Claude Code 요청] --> B{Primary model 가능?}
B -->|예| C[Primary model 사용]
B -->|아니오| D[Fallback 1 시도]
D --> E{가능?}
E -->|예| F[Fallback 1 사용]
E -->|아니오| G[Fallback 2 / 3 순서대로 시도]어디에 잘 맞나
fallbackModel은 다음 작업과 잘 맞습니다.
| 작업 | 이유 |
|---|---|
| Dynamic Workflows | subagent가 많아 중간 실패 비용이 큼 |
| Routines | 사람 없이 실행되는 반복 작업 |
| 긴 migration | 모델 일시 장애로 흐름이 끊기면 재시작 비용이 큼 |
| PR babysitting | 리뷰·CI를 기다리는 동안 세션 지속성이 중요 |
단, fallback model이 바뀌면 reasoning 품질과 응답 스타일도 달라질 수 있습니다. 중요한 변경은 모델이 바뀐 상태에서도 테스트와 리뷰를 유지해야 합니다.
블로그 대표 이미지 콘셉트
Claude Code 세션이 primary model을 호출하다가 실패하면 fallback model 1, 2, 3으로 순서대로 넘어가는 회로도형 이미지가 좋습니다. 각 모델은 신호등처럼 상태가 표시되고, 최종적으로 세션이 끊기지 않고 계속 이어지는 흐름을 보여줍니다.
하단에는 “Availability is part of agent operations”라는 문구를 넣으면 운영 관점이 살아납니다.
마무리
fallbackModel은 화려하지 않지만, Claude Code를 실제 작업 큐처럼 쓰기 시작하면 중요해지는 기능입니다. 에이전트가 길게 일할수록 “잘 답하는가”만큼 “중간에 끊기지 않는가”도 중요합니다.
큰 작업을 자주 맡긴다면 fallback strategy를 모델 선택의 일부로 봐야 합니다. 좋은 에이전트 운영은 모델 성능과 가용성을 함께 설계하는 데서 시작합니다.