Claude Code Advisor Tool: 긴 코딩 작업에 전략 조언 모델 붙이는 법 | DAKER 커뮤니티

Claude Code Advisor Tool: 긴 코딩 작업에 전략 조언 모델 붙이는 법

Claude Code의 Advisor Tool은 빠른 실행 모델이 긴 작업 중 더 강한 조언 모델을 호출하게 만드는 기능입니다. Advisor tool이란 실행 모델 옆에 전략 검토용 advisor model을 붙이는 서버사이드 도구입니다. 확인할 곳은 Claude Code의 --advisor, settings의 advisorModel, 그리고 API 베타 헤더 문서입니다.

클로드 코드 Advisor Tool 대표 카드

이미지: 클로드 코드 Advisor Tool이 실행 모델과 조언 모델을 나눠 쓰는 대표 카드.

문제 상황: 빠른 모델만 쓰면 긴 작업의 큰 방향을 놓치지 않을까?

한 줄 요약: Advisor Tool은 "실행은 빠르게, 중요한 분기 판단은 더 신중하게" 가져가는 구조입니다.

코딩 에이전트 작업은 대부분 파일 읽기, 작은 수정, 테스트 반복처럼 기계적인 단계입니다. 하지만 아키텍처 선택, 마이그레이션 순서, 실패 원인 재가설화 같은 순간에는 더 높은 지능의 모델 판단이 유리할 수 있습니다. Anthropic의 Advisor Tool 문서는 이 패턴을 빠른 executor model과 높은 지능의 advisor model 조합으로 설명합니다.

DAKER 클로드 코드 디렉터리에서는 권한, 설정, IDE, 상태표시줄처럼 실행 환경을 다룬 글을 이어왔습니다. 이번 글은 모델 선택을 "한 모델 고정"이 아니라 "실행 모델과 조언 모델 분리"로 보는 실무 관점입니다.

핵심 개념: Advisor Tool은 언제 호출되나?

핵심 포인트는 네 가지입니다.

공식 문서에 따르면 advisor tool은 beta 기능이며, coding agents, computer use, multi-step research pipelines처럼 long-horizon agentic workloads에 적합합니다. Claude Code CLI 문서는 --advisor가 v2.1.98 이상에서 필요하고, v2.1.170 이상에서는 opus, sonnet, fable alias 또는 전체 model ID를 받을 수 있다고 설명합니다.

클로드 코드 Advisor Tool 비교 흐름

이미지: 클로드 코드 Advisor Tool에서 executor model과 advisor model이 협업하는 비교 흐름.

단계별 사용법: Claude Code에서 advisor를 어떻게 붙이나?

  1. Claude Code 버전을 확인합니다. --advisor는 공식 CLI 문서 기준 v2.1.98 이상이 필요합니다.

  2. 한 세션에서 실험하려면 CLI 실행 시 advisor를 붙입니다.

  3. 반복 사용하려면 settings의 advisorModel을 설정합니다.

  4. 조직에서 모델 제한을 쓴다면 availableModels와 enforceAvailableModels가 advisor model에도 영향을 주는지 확인합니다.

  5. API에서 직접 사용할 때는 beta header advisor-tool-2026-03-01을 포함합니다.

claude --advisor opus
{
  "advisorModel": "opus"
}

중요한 제한도 있습니다. availableModels가 특정 모델을 막으면 advisor override가 상속값이나 기본값으로 떨어질 수 있습니다. 즉, 팀 정책에서 허용한 모델 범위와 advisor 설정을 함께 봐야 합니다.

짧은 예시: 리팩터링 중간에 전략 검토를 받게 하기

claude --model sonnet --advisor opus

결제 모듈의 테스트 실패를 고쳐줘.
단, 수정 범위가 5개 파일을 넘거나 public API를 바꿔야 하면
advisor 관점에서 대안과 위험을 먼저 검토한 뒤 진행해줘.

이 예시는 빠른 모델에게 반복 작업을 맡기되, 범위가 커지는 순간 advisor 판단을 기대하는 형태입니다. 실제 호출 여부와 결과 블록은 제품/세션 상태에 따라 달라질 수 있으므로, 중요한 변경 전에는 로그와 결과를 확인하세요.

팀 적용 체크리스트: Advisor Tool을 어디에 쓰면 좋을까?

공식 API 문서는 advisor tool 오류가 나도 executor가 조언 없이 계속 진행할 수 있다고 설명합니다. 따라서 "advisor를 켰으니 항상 검토됐다"라고 가정하면 안 됩니다. max_uses_exceeded, too_many_requests, overloaded, prompt_too_long, execution_time_exceeded, unavailable 같은 에러 가능성을 운영 로그에서 볼 수 있게 해야 합니다.

공식 출처: 2026년 6월 19일 기준 확인한 문서

FAQ: Claude Code Advisor Tool을 적용할 때 자주 묻는 질문

Advisor Tool은 모델을 자동으로 바꾸는 기능인가요?

아닙니다. 기본 실행은 executor model이 계속 맡고, 필요한 시점에 advisor model의 전략 조언을 받아 이어가는 구조입니다.

--advisor opus를 쓰면 모든 답변이 Opus로 나오나요?

그렇게 이해하면 안 됩니다. --advisor는 서버사이드 advisor tool을 세션에 활성화하는 옵션이고, 일반 실행 모델은 --model 또는 설정을 따릅니다.

API와 Claude Code 설정은 같은 방식인가요?

개념은 이어지지만 설정 경로는 다릅니다. API는 beta header와 tool 정의가 필요하고, Claude Code는 CLI 옵션이나 advisorModel 설정을 사용합니다.

Advisor Tool은 언제 꺼두는 편이 좋나요?

짧은 수정, 비용 민감한 자동화, advisor 오류를 관찰할 로깅이 없는 환경에서는 먼저 끄고 시작하는 편이 안전합니다.

다음 장기 작업을 시작할 때는 실행 모델과 advisor model을 분리할 가치가 있는 분기 조건부터 한 줄로 적어보세요.

Redirecting to Claude Code Advisor Tool: 긴 코딩 작업에 전략 조언 모델 붙이는 법 | DAKER 커뮤니티...