Claude Code /advisor 설정으로 모델 분업화해 비용 3.4배 절감하는 워크플로우
Claude Code v2.1.321 이상에서 Fable 5.2(판단), Sonnet 5.5(구현), Opus 5.5(코드 리뷰), Haiku 5.5(스웜 검색)를 /advisor 명령어로 분업 배치해 비용을 최적화하는 설정 가이드입니다.
터미널 기반 코딩 에이전트인 Claude Code 환경에서 여러 특화 모델을 유기적으로 엮어 토큰 비용을 3.4배 줄이는 워크플로우가 공개되었습니다. 인공지능 개발자 @thedelost가 공유한 이번 팁은 앤트로픽(Anthropic)이 공식 지원하는 /advisor 명령어를 활용해 추론, 구현, 코드 검토, 정보 탐색을 서로 다른 모델에 분업시키는 구성법을 다룹니다.

이미지 출처: https://x.com/thedelost/status/2121720755192799480
단일 최상위 모델에 전체 작업을 맡기면 단순 검색이나 반복 수정 작업에도 값비싼 토큰 요금이 청구됩니다. 반면 이 워크플로우는 1분의 설정만으로 비싼 고지능 모델을 필수 판단 지점에만 제한 호출하고, 대량의 탐색과 구현은 상대적으로 저렴한 모델들에 분산시켜 전체 파이프라인의 효율을 극대화합니다.
4개 모델 분업 구조와 토큰 비용 절감 원리
이 분업 체계의 핵심은 작업 특성에 맞게 4가지 Claude 모델을 각각 제자리에 배치하는 설계에 있습니다. 단일 모델이 전체 개발 과정을 도맡는 대신, 각 모델의 장점과 토큰 단가를 고려해 역할을 분리합니다.
- Fable 5.2 (총괄 어드바이저): 코드 작성은 일절 하지 않으며 오직 고차원 의사결정만 담당합니다. 전체 과정 중 세 가지 시점(초기 실행 계획 확정 직전, 동일한 오류가 반복 발생할 때, 작업 완료를 선언하기 직전)에만 호출됩니다. Fable의 고비용 토큰은 이 판단 단계에만 소모됩니다.
- Sonnet 5.5 (메인 빌더): 실제 코드베이스를 분석하고 로직을 작성하며 기능을 구현하는 주 작업자 역할을 맡습니다.
- Opus 5.5 (현장 코드 리뷰어): 작성된 코드를 그 자리에서 검토하여 논리적 결함이나 사이드 이펙트를 즉각 짚어냅니다.
- Haiku 5.5 (스웜 에이전트 조율 및 검색): 대규모 정보 검색, 문서 탐색, 리서치 작업을 맡는 보조 에이전트 군단을 조율합니다. Haiku는 토큰당 비용이 Fable에 비해 80분의 1 수준으로 매우 저렴해, 대량의 컨텍스트를 소모하는 검색 작업에 최적입니다.
결과적으로 무거운 탐색과 보조 작업은 단가가 80배 저렴한 Haiku가 처리하고, 구현은 균형 잡힌 Sonnet이 담당하며, 고비용 Fable 모델은 병목 판단에만 개입합니다. 이를 통해 품질 저하 없이 전체 작업 비용을 기존 대비 3.4배 절감할 수 있습니다.
단계별 환경 설정 절차
이 워크플로우를 시스템에 적용하려면 Claude Code 최신 버전을 설치하고 사용자 전역 설정으로 분업 팀을 구성해야 합니다.
1단계: Claude Code 업데이트
Fable 5.2 및 신규 어드바이저 기능을 쓰려면 Claude Code v2.1.321 이상이 필요합니다. 터미널에서 다음 명령어를 실행해 최신 버전으로 갱신합니다.
claude update
버전 확인 후 정상적으로 업데이트가 완료되었는지 확인합니다.
2단계: 공식 어드바이저 문서 참조 및 설정 프롬프트 주입
Claude Code를 실행한 뒤, 앤트로픽의 공식 어드바이저 모드 문서를 직접 읽고 설정을 구성하도록 안내하는 설정 프롬프트를 입력창에 붙여넣습니다. 프롬프트를 전달받은 Claude Code는 문서를 해석해 올바른 구조의 매개변수를 파악합니다.
3단계: 유저 레벨(전역) 팀 구성 적용
특정 디렉터리에 한정되지 않고 개발자의 모든 프로젝트에서 이 분업 체계가 상시 동작하도록 사용자 레벨(User Level) 환경 설정에 팀을 등록합니다.
- 메인 모델(Main): Sonnet 5.5
- 어드바이저(Advisor): Fable 5.2
- 서브에이전트 군단(Subagents): Haiku 5.5
- 코드 리뷰어(Reviewer): Opus 5.5
4단계: 설정 백업 및 사전 변경사항 비교
Claude Code는 기존 설정 파일을 자동으로 백업한 뒤, 변경 전과 변경 후의 설정 차이(Diff)를 화면에 표시합니다. 사용자 확인을 거친 후 실제 환경 설정에 반영되므로 예기치 않은 설정 손실을 방지합니다.
필수 유의점: 명시적 트리거 조건 작성
설정 과정에서 가장 주의해야 할 요소는 Sonnet 5.5가 Fable 5.2 어드바이저에게 자문을 구하는 **호출 조건(Trigger Conditions)**을 명시하는 일입니다.
앤트로픽이 진행한 198건의 테스트에 따르면, Sonnet에게 Fable을 언제 호출해야 하는지 구체적인 조건을 적시하지 않았을 때 어드바이저 모드가 단 한 번도 활성화되지 않았습니다. 즉 모델이 임의로 어드바이저를 호출할 것으로 기대해서는 안 됩니다.
따라서 설정 시 다음과 같은 세 가지 트리거 시점을 반드시 프롬프트와 규칙에 못 박아 두어야 합니다.
- 계획 확정 전(Before finalizing a plan): 초기 요구사항을 분석하고 작업 단계별 계획을 확정하기 직전 Fable에게 아키텍처 타당성을 점검받도록 지정합니다.
- 반복 에러 발생 시(When an error keeps recurring): 동일한 테스트 실패나 빌드 에러가 연속으로 재현될 때 디버깅 돌파구를 찾도록 Fable을 개입시킵니다.
- 완료 선언 전(Before declaring the work done): 모든 구현이 끝났다고 판단하고 태스크를 종결하기 직전, 빠진 요구사항이나 잠재적 결함이 없는지 Fable의 최종 승인을 받도록 만듭니다.
이 세 가지 호출 기준을 프롬프트에 명확히 기재해야만 어드바이저 모드가 의도대로 작동하며 불필요한 모델 공회전이나 과도한 호출을 방지할 수 있습니다.
원문 출처
- @thedelost X 포스트: Claude Code /advisor workflow