클로드 코드의 advisor 도구는 계획을 정하기 전, 같은 오류가 반복될 때, 완료를 선언하기 전에 더 강한 모델에게 전체 대화를 보여 주고 조언을 받는 실험 기능이에요. API 쪽 advisor 도구는 4월 9일 베타로 나왔고 클로드 코드에는 늦어도 4월 22일 v2.1.117 에 실험 기능으로 들어 있었으며, 현재 공식 문서의 조합표에는 소넷 5.5 도 올라 있어요. 소넷 5.5·소넷 5 가 주 모델이면 조언자로 페이블·오푸스 4.7 이상·소넷 5 이상만 받고, 소넷 4.6 은 클로드 코드가 아예 붙이지 않으며, 오푸스 4.6 은 API 가 거절해 조언자 없는 요청으로 다시 보내므로 오류 없이 조언자 호출만 사라져요. 앤트로픽 API 에서만 쓸 수 있어 베드록 등에서는 안 되고, DISABLE_TELEMETRY 처럼 기능 플래그 조회를 끄는 변수가 있으면 꺼진 채로 있어요.
용어 풀이
- API
- 프로그램끼리 기능을 주고받는 호출 규격. 여기선 앤트로픽이 직접 제공하는 모델 호출 창구
- 기능 플래그
- 서버에서 받아 오는 설정값으로 기능을 켜고 끄는 장치(feature flag)
운영자 인사이트
주 모델을 소넷 5.5 로 바꿨다면 /advisor 로 저장해 둔 조언자가 조합표에 맞는지 먼저 확인하세요. API 가 거절하는 조합은 오류 없이 조언자 호출만 사라지고, 조언자를 고쳐도 /clear 나 /compact 뒤에야 반영돼요. 조언자는 호출마다 전체 대화를 캐시 없이 새로 읽으니 긴 세션에서는 /usage 로 사용량도 함께 보세요.
여러 관점으로 보기
- API 원본 도구 advisor 도구는 앤트로픽 API 의 서버 도구로, 지금도 베타 헤더 advisor-tool-2026-03-01 을 붙여야 쓸 수 있어요. Claude Platform Docs
- 도입 배경 앤트로픽이 4월 9일 소넷·하이쿠가 일을 하고 오푸스가 어려운 판단만 돕는 조합을 소개하며, 하이쿠에 오푸스 조언자를 붙이면 BrowseComp 점수가 19.7% 에서 41.2% 로 올랐다고 밝혔어요. Anthropic
- 최근 수정 v2.1.282 에서 advisor 를 지원하지 않는 프록시·게이트웨이 뒤에서 매 턴 400 오류가 나던 문제를 고쳐, 이제는 조언자 없이 다시 보내요. Claude Code Docs