조언자 도구는 실험적이며 Anthropic API가 필요합니다. Amazon Bedrock, Claude Platform on AWS, Google Cloud의 Agent Platform 또는 Microsoft Foundry에서는 사용할 수 없습니다. 동작, 가격 책정 및 가용성은 변경될 수 있습니다.
조언자를 사용할 때
조언자는 대부분의 턴이 일상적이지만 계획 품질이 결과를 결정하는 길고 다단계 작업에 적합합니다. 예시로는 대규모 리팩토링, 오류가 계속 반복되는 디버깅 세션, Claude가 완료를 선언하기 전에 독립적으로 확인하고 싶은 작업이 있습니다. 계획할 것이 거의 없는 짧은 작업이나 모든 턴에 가장 강력한 모델이 필요한 작업에서는 가치가 적습니다. 이러한 경우 주 모델을 전환하거나 조언자와 opusplan 및 서브에이전트 비교를 참고하여 두 번째 의견을 얻는 다른 방법을 확인하세요.조언자 활성화
조언자 모델을 세 가지 방법으로 설정할 수 있습니다:/advisor명령: 세션 중간에 조언자를 설정 또는 변경하고 기본값으로 저장advisorModel설정: 설정 파일에서 지속적인 기본값 구성--advisor플래그: 시작 시 단일 세션에 대해 조언자 설정
Advisor Tool (experimental) is on and may use more tokens · /advisor 알림을 표시합니다. 사용을 중지하려면 조언자 끄기를 참고하세요.
일부 플랜에서 Fable을 조언자로 사용하려면 Fable 사용량을 사용 크레딧으로 청구하는 것에 대한 일회성 동의도 필요합니다. 동의를 제공하기 전에 발생하는 상황에 대해서는 Fable 조언자 및 사용 크레딧을 참고하세요.
/advisor 명령 사용
인수 없이 /advisor를 실행하여 사용 가능한 조언자 모델을 나열하는 선택기를 열거나 모델을 직접 전달하세요:
Advisor set to로 확인한 후 조언자 모델 이름을 표시합니다. 선택 항목은 사용자 설정의 advisorModel에 저장되고 세션 전체에서 유지됩니다. 단, advisorModel 항목이 현재 세션에만 적용되는 경우는 제외됩니다.
이 명령은 터미널 선택기가 없는 곳에서도 작동합니다: 비대화형 모드에서 -p를 사용할 때, Agent SDK에서, 데스크톱 앱에서, 그리고 원격 제어를 통해서입니다. 이는 Claude Code v2.1.260 이상이 필요합니다. 이러한 환경에서:
- 인수 없이
/advisor를 실행하여 현재 조언자 모델과 이를 허용하는 별칭을 출력합니다. /advisor opus와 같이 모델을 사용하여/advisor를 실행하여 설정합니다./advisor off를 실행하여 끕니다.
availableModels 허용 목록이 제외하는 저장된 조언자를 호출하지 않습니다. 조언자를 사용하려면 /advisor로 허용된 모델을 선택하세요. Claude Code는 현재 주 모델이 지원하지 않는 조언자를 여전히 저장합니다. 해당 조언자는 /model을 사용하여 호환되는 주 모델로 전환한 후 활성화됩니다.
일부 플랜에서 Fable을 조언자로 사용하려면 Fable 사용량을 사용 크레딧으로 청구하는 것에 대한 일회성 동의도 필요합니다. /advisor fable이 동의를 제공하기 전에 수행하는 작업에 대해서는 Fable 조언자 및 사용 크레딧을 참고하세요.
설정에서 advisorModel 설정
세션을 열지 않고 조언자를 기본값으로 구성하려면 설정 파일에서 설정하세요:
--advisor 플래그 사용
저장된 설정을 변경하지 않고 단일 세션에 대해 조언자를 설정하려면 플래그를 사용하여 시작하세요:
advisorModel 설정 대신 플래그를 사용합니다. claude --help에 --advisor를 나열하지 않습니다. Claude Code는 다음의 경우 시작 시 오류로 종료됩니다:
- 세션의 주 모델이 조언자를 지원하지 않음
- Haiku와 같은 요청된 모델이 조언자로 작동할 수 없음
- 조직의
availableModels허용 목록이 요청된 모델을 제외함 - Fable을 요청했고 계정이 여전히 사용 크레딧 동의를 필요로 함
--advisor로 시작하고 이 중 하나가 적용되면 Claude Code는 종료하는 대신 조언자 없이 세션을 시작합니다.
조언자 모델 선택
조언자는 주 모델 이상의 기능을 가져야 합니다. 각 주 모델에 대해 허용되는 조언자는 다음과 같습니다:
Fable 5.1은 Claude Code v2.1.257 이상이 필요합니다. 둘 다 Fable 액세스가 필요합니다.
조언자를
fable, opus, 또는 sonnet으로 설정하세요. 이러한 별칭은 Claude Code의 각 모델 제품군에 대한 기본 제공 기본 버전으로 확인되며, 새로운 Claude Code 릴리스와 함께 발전합니다. claude-opus-5와 같은 전체 모델 ID를 전달할 수도 있습니다.
하위 에이전트는 구성된 조언자를 상속하고 자신의 모델에 대해 동일한 쌍 확인을 적용합니다.
Claude Code는 요청을 보내기 전에 쌍을 검증하며, API는 다시 한 번 검증합니다:
- 표에서 거부된 것으로 나열된 조언자의 경우, Claude Code는 이를 주 모델의 요청에 첨부하지 않습니다.
/advisor명령 출력과 알림에 이것이 표시됩니다. 자신의 모델이 쌍 확인을 만족하는 하위 에이전트는 여전히 조언자를 사용할 수 있습니다. - 표에서 API 오류로 실패하는 것으로 나열된 조언자의 경우, Claude Code는 이를 첨부하고 API가 이를 거부합니다. 모든 요청이
'<advisor model>'은(는) 요청 모델이 '<main model>'일 때 조언자로 사용될 수 없습니다로 실패하며,/advisor로 조언자를 변경하거나 끌 때까지 계속됩니다. - 주 모델 또는 조언자가 Claude Code가 인식하지 못하는 모델이면 조언자가 첨부되지 않습니다.
Fable 조언자 및 사용 크레딧
일부 플랜에서는 Fable 사용이 사용 크레딧으로 청구되며, Fable을 조언자로 사용하는 경우도 동일하게 청구됩니다. 계정에 Fable 사용을 사용 크레딧으로 청구하기 위한 일회성 동의가 필요한 경우, Claude Code는/model로 Fable 모델을 선택할 때 이를 요청하며 동의를 수락할 때까지 Fable을 조언자로 적용하지 않습니다.
동의를 수락하기 전에 Claude Code는 /advisor fable을 입력하거나 /advisor 선택기에서 Fable을 선택할 때 Fable을 조언자로 저장하지 않습니다. 대신 /model fable로 안내합니다. claude --advisor fable을 사용하면 Claude Code는 /model fable을 가리키는 메시지와 함께 시작 시 종료됩니다. 백그라운드 세션에서는 종료하는 대신 조언자 없이 세션을 시작합니다. Fable이 이미 advisorModel로 저장된 경우 Claude Code는 조언자 없이 요청을 보냅니다. 주 모델이 조언자를 지원하는 대화형 세션에서는 /model fable을 가리키는 알림도 표시됩니다.
동의를 수락하려면 /model fable을 실행하고 Fable을 계속 사용하도록 선택하세요. Claude Code는 동의를 기록하고 Fable을 선택한 모델로 저장합니다. 그런 다음 Fable을 조언자로 선택하세요.
일반적인 모델 쌍
허용되는 모든 쌍이 작동합니다. 이러한 조합은 비용과 기능을 다양한 방식으로 균형을 맞춥니다:Claude가 조언자를 참고할 때
Claude는 조언자를 호출할 시기를 결정합니다. 접근 방식을 확정하기 전, 오류가 계속 반복될 때, 작업 완료를 선언하기 전에 참고하는 경향이 있지만 타이밍은 규칙 기반이 아닌 모델 기반입니다. 프롬프트에서consult the advisor before you continue와 같이 다른 도구를 요청하는 것과 같은 방식으로 상담을 요청할 수 있습니다. 조언자 호출을 제한하거나 강제하는 설정은 없습니다. 작업 중에 Claude가 더 자주 또는 덜 자주 참고하기를 원하면 지침에서 말하세요.
세션 중에 표시되는 내용
Claude가 조언자를 호출하면 대화 기록에 호출이 진행 중인 동안 조언자 모델 이름이 있는Advising 줄이 표시됩니다. 결과가 반환되면 줄은 조언자가 지침을 제공했는지 여부를 보고합니다:
- Reviewed: 줄은 조언자가 대화를 검토했음을 확인합니다. 조언자가 읽을 수 있는 지침을 반환한 경우
Ctrl+O를 눌러 읽으세요. - Declined: 줄은
Advisor declined to advise on this request로 표시됩니다. 조언자가 이유를 제공한 경우Ctrl+O를 눌러 읽으세요.
비용
Claude가 조언자를 호출할 때 조언자 모델이 대화를 읽으므로 각 호출은 주 모델의 사용 외에도 조언자 모델의 요금으로 토큰을 소비합니다. 이러한 조언자 토큰이 청구되는 방식은 결제 방식에 따라 달라집니다:- API 청구: 조언자 토큰에 대해 조언자 모델의 입력 및 출력 요금을 지불합니다
- 구독 계획: 조언자 사용은 계획의 사용 한도에 포함되며, Fable 조언자가 Fable 사용이 하는 계획에서 사용 크레딧으로 청구되는 경우는 예외입니다
/usage에 표시된 세션 합계에 포함됩니다.
조언자 토큰이 API 응답에서 보고되는 방식에 대해서는 Claude API 설명서의 사용량 및 청구를 참고하세요.
프롬프트 캐싱에 미치는 영향
세션 중간에 조언자를 활성화하거나 비활성화해도 주 모델의 프롬프트 캐시가 무효화되지 않습니다. 모델 전환과 달리/advisor 토글은 캐시된 접두사를 유지하고 조언자가 반환한 지침은 나중의 턴에서 대화 기록의 일부로 캐시됩니다.
조언자 모델 자체의 대화 읽기는 캐시되지 않습니다. 각 조언자 호출은 전체 대화를 새로 처리하며 호출 간에 재사용이 없습니다.
요구 사항
조언자 도구는 다음 모두를 요구합니다:- Anthropic API만: 조언자는 서버 실행 도구입니다. Amazon Bedrock, Claude Platform on AWS, Google Cloud의 Agent Platform 또는 Microsoft Foundry에서는 사용할 수 없습니다.
ANTHROPIC_BASE_URL로 구성된 LLM 게이트웨이를 통해 가용성은 게이트웨이가 요청을 Anthropic API로 그대로 전달하는지 여부에 따라 달라집니다. - 지원되는 주 모델: Fable, Opus 4.6 이상, Sonnet 4.6 이상 또는 Haiku 4.5. 조언자 모델 선택을 참조하여 각 조언자가 어떤 모델을 지원하는지 확인하십시오.
- 기능 플래그 가져오기: Claude Code는 Anthropic에서 가져온 기능 플래그를 통해 조언자를 켭니다.
DISABLE_TELEMETRY와 같이 플래그 가져오기를 끄는 변수가 설정된 세션에서는 조언자가 꺼진 상태로 유지됩니다. 기능 플래그 가져오기가 필요한 기능을 참조하십시오.
조언자 끄기
조언자 사용을 중지하려면/advisor off를 실행하거나 /advisor 선택기에서 No advisor를 선택하세요:
CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1을 설정하세요. /advisor 명령을 사용할 수 없게 되며 구성된 advisorModel은 무시됩니다. --advisor 플래그는 허용되지만 효과가 없습니다. 환경 변수를 참고하세요.
관련 기능과 비교
조언자는 모델 강점을 결합하는 여러 방법 중 하나입니다. 더 강력한 모델을 언제 포함할지에 따라 선택하세요.참고 항목
- 모델 구성: 모델 전환, 노력 수준 설정,
opusplan사용 - 비용 효과적으로 관리: 모델 전체의 토큰 사용량 추적
- Claude API의 조언자 도구: 기본 서버 도구 이해 또는 Messages API에서 직접 사용
- 조언자 전략: 빠른 주 모델을 더 강력한 조언자와 쌍으로 만드는 이유