긴 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를 작업 큐처럼 쓰면 fallbackModel이 필요해집니다. 에이전트가 오래 일할수록 답의 품질과 함께 세션이 중간에 끊기지 않는지가 결과를 좌우합니다.
큰 작업을 자주 맡긴다면 모델을 고를 때 fallback 순서도 함께 정합니다. 에이전트 운영에서는 모델 성능과 가용성을 함께 설계합니다.