비주얼 스튜디오 터미널에서 클로드 코드를 띄우고, 새로 나온 Fable 5 모델을 골랐는데 갑자기 빨간 에러가 뜹니다.

API Error: 400 tools.18.model: 'claude-opus-4-8' cannot be used as an advisor when the request model is 'claude-fable-5'.

처음 이 메시지를 보면 머리가 잠깐 멈춥니다. "Fable 5 모델이 문제인가? 내 계정이 막혔나? 결제가 잘못됐나?" 의심이 사방으로 흩어집니다.

결론부터 말씀드리면, Fable 5에는 아무 문제가 없습니다. 진짜 원인은 어드바이저advisor​라는 다른 기능에 있습니다. 이 글에서 그 정체를 풀고, 5분 안에 해결하는 세 가지 방법을 안내합니다.

어드바이저가 뭔가요

클로드 코드에는 v2.1.98부터 추가된 어드바이저 기능이 있습니다. 메인 모델이 어려운 결정을 앞두고 더 강한 모델에게 한 번 자문을 구하는 구조입니다. 예를 들어 메인 모델이 Sonnet인데 까다로운 아키텍처 결정을 만나면, 잠깐 Opus에게 의견을 물어보고 그 답을 반영해 계속 작업하는 식입니다.

작은 회사 한 명짜리 개발팀이 큰 결정 앞에서 외부 전문가에게 한 번 물어보는 그림과 비슷합니다. 평소엔 본인이 처리하다가 어려운 순간만 도움을 받습니다.

여기에 한 가지 규칙이 있습니다. 자문을 구하는 사람보다 자문을 주는 사람이 더 똑똑해야 합니다. 클로드 코드 공식 문서의 표현 그대로입니다. "어드바이저는 메인 모델보다 최소한 같거나 더 강한 능력이어야 합니다. 잘못된 조합을 요청하면 API가 400 오류로 거부합니다."

이게 지금 일어난 일입니다.

'claude-opus-4-8' cannot be used as an advisor when the request model is 'claude-fable-5'.

번역하면 이렇습니다. "Opus 4.8은 Fable 5의 어드바이저로 쓸 수 없습니다."

Fable 5는 최신 상위 모델입니다. Opus 4.8보다 한 단계 위입니다. 그런데 클로드 코드의 어드바이저는 Opus 4.8로 설정돼 있습니다. 더 약한 모델이 더 강한 모델에게 조언을 주려 하니, API가 "이건 말이 안 됩니다" 하고 거부한 것입니다.

쉽게 말해 "신입 사원이 대표에게 경영 자문을 해주려는 구도"라고 보면 됩니다. API 입장에서는 이 조합을 받을 수 없습니다.

해결법 세 가지

상황에 맞춰 셋 중 하나를 고르시면 됩니다.

방법 1. 어드바이저를 끄기 (가장 간단)

지금 당장 Fable 5를 쓰고 싶고, 어드바이저 기능은 아직 안 써본 분이라면 이 방법이 가장 깔끔합니다. 클로드 코드 세션 안에서 한 줄만 입력합니다.

/advisor

이 명령으로 어드바이저를 비활성화하면 즉시 Fable 5가 정상 작동합니다. 어드바이저는 평소에 꺼두고, 정말 필요할 때만 켜는 식으로도 충분합니다.

방법 2. 어드바이저 모델을 Fable로 올리기

어드바이저 기능을 계속 쓰면서 Fable 5도 쓰고 싶으시면, 어드바이저 자체를 Fable로 바꿔주면 됩니다. 같은 등급이면 API가 받아들입니다. 다만 Fable은 /advisor 선택 화면의 기본 목록에 안 나오므로 직접 입력해야 합니다. 그리고 클로드 코드 v2.1.170 이상이 필요합니다. 버전이 낮으면 먼저 업데이트하시면 됩니다.

/advisor fable

claude update

방법 3. 설정 파일에서 직접 정리

명령어 방식이 안 먹히거나 영구적으로 설정을 잡고 싶으시면 설정 파일을 직접 손보면 됩니다. 다음 경로의 파일을 열어주세요.

~/.claude/settings.json

이 안에 "advisorModel" 항목이 있을 겁니다. 두 가지 중 하나로 처리합니다.

  • 어드바이저 자체를 안 쓸 거라면 advisorModel 줄을 통째로 삭제합니다.
  • Fable로 바꿀 거라면 값을 "fable"로 수정합니다.

저장하고 세션을 다시 시작하면 적용됩니다.

한 가지 더 짚어드릴 함정

여기서 끝내면 되는데, 한 가지 꼭 알아두실 점이 있습니다. 이게 의외로 많은 사람을 헤매게 만드는 자리입니다.

settings.jsonfallbackModel 설정이 켜져 있으면, 위의 400 오류가 사용자에게 보이지 않게 가려집니다. 어드바이저 충돌이 발생하는 순간 클로드 코드가 자동으로 다른 모델(보통 Opus)로 전환되면서, 화면에는 이런 메시지만 뜹니다.

Switched to Opus 4.6 (1M context) because Fable 5 returned an error that could not be retried

이 메시지가 사람을 헷갈리게 합니다. "Fable 5가 망가졌나?" "내가 Fable을 쓸 권한이 없나?" 같은 오해를 만듭니다. 실제로는 어드바이저 충돌이 진짜 원인인데, fallback이 그걸 덮어버려서 진짜 원인이 보이지 않는 것입니다.

어드바이저를 정리한 뒤에도 모델이 의도와 다르게 자꾸 전환된다면, settings.jsonfallbackModel 항목도 함께 점검해 보세요. 일시적으로 fallback을 제거하면 진짜 오류가 화면에 드러나서 원인 파악이 쉬워집니다.

이 자동 fallback 동작은 GitHub에도 버그 리포트로 올라와 있는 알려진 문제입니다. 사용자가 진짜 원인을 못 보게 만든다는 지적이 누적되고 있어서, 다음 버전에서 동작이 개선될 가능성이 큽니다.

다시 한 번 정리

지금 상황을 한 줄로 요약하면 이렇습니다.

Fable 5는 멀쩡합니다. 

단지 클로드 코드에 설정된 어드바이저(Opus 4.8)가 Fable 5보다 약해서 

API가 그 조합을 거부한 것뿐입니다.

해결 순서를 정리하면 이렇습니다.

  1. 먼저 시도/advisor 입력해서 어드바이저 끄기. 가장 빠릅니다.
  2. 그래도 안 되면claude update로 최신 버전 확인 후, /advisor fable로 어드바이저를 Fable로 올리기.
  3. 여전히 이상하면~/.claude/settings.json에서 advisorModelfallbackModel을 둘 다 확인하기.

이 순서로 가면 5분 안에 Fable 5가 정상 작동하는 환경이 만들어집니다.