쓸모 쓸모연구소 · 실전 노트
제 825 호이번 주 새 글 49 편2026 · 11 · 14
클로드 코드
Claude

클로드 코드 advisor 설정, 필요할 때만 상위 모델 부르는 법

클로드 코드 advisor는 평소에는 가벼운 모델로 일하다가 중요한 순간에만 더 강한 모델의 조언을 받게 해 주는 실험 기능입니다. 이 글은 /advisor 설정 방법과 쓸 수 있는 모델 조합, 요청 한 번만 깊게 생각시키는 ultrathink와의 차이를 정리했습니다. 기준은 2026년 11월 공식 문서입니다.

클로드 코드 advisor 설정, 필요할 때만 상위 모델 부르는 법 삽화
삽화 · 쓸모연구소

필요할 때만 깊게 생각시키는 두 가지 방법

모델을 늘 가장 좋은 것으로 쓰면 비용도 들고 간단한 요청까지 느려집니다. 클로드 코드에는 이를 줄이는 방법이 둘 있습니다.

  • ultrathink: 요청문에 이 단어를 넣으면 그 요청 한 번에만 더 깊게 생각합니다.
  • advisor: 기본 모델은 그대로 두고, 중요한 시점에 더 강한 모델에게 조언을 구합니다.

둘 다 평소에는 낮은 단계로 쓰다가 까다로운 일에서만 힘을 더 쓰는 방식입니다.

ultrathink: 요청 한 번만 추론 단계 올리기

ultrathink는 프롬프트 어디에든 넣으면 그 턴에서만 더 깊이 추론하라는 지시를 붙이는 키워드입니다. 세션에 설정한 에포트(답하기 전에 얼마나 오래 생각할지 정하는 설정)는 바뀌지 않습니다. "think", "think hard" 같은 표현은 키워드로 인식되지 않고 평범한 문장으로 넘어갑니다.

클로드 코드 v2.1.311 이상에서는 터미널 입력창에 입력한 ultrathink가 그 턴을 한 단계 위인 xhigh까지 올릴 수 있습니다. 올릴 수 있을 때는 입력창에서 단어가 무지개색으로 보입니다. 예를 들어 평소 에포트를 낮게 두고 쓰다가 원인을 못 찾는 버그를 만났을 때만 이렇게 씁니다.

프롬프트
ultrathink 결제 화면에서 가끔 금액이 0원으로 찍히는 원인을 찾아 줘.

무지개색이 나오지 않으면 다음을 확인합니다.

  • 단어가 따옴표, 괄호, 경로, 명령어 안에 들어 있거나 프롬프트가 /로 시작하면 인식되지 않습니다. 따옴표 밖에서 다시 입력합니다.
  • 환경 변수 CLAUDE_CODE_EFFORT_LEVEL이 xhigh보다 낮게 정해져 있으면 해제합니다.
  • 지원하는 모델이어야 합니다. /model에서 Opus 5.5, Sonnet 5.5, Haiku 5.5 같은 모델을 고릅니다. Amazon Bedrock에서는 이 단어로 올릴 수 없어 에포트를 직접 정해야 합니다.

에포트 단계는 모델에 따라 low, medium, high, xhigh, max가 있고, 현재 Opus 5.5의 기본값은 medium입니다. 세션 전체를 바꾸려면 /effort로 슬라이더를 열거나 /effort high처럼 직접 정합니다. ultrathink는 동적 워크플로를 켜는 ultracode 설정과도 다릅니다.

advisor: 중요한 순간에만 상위 모델에게 묻기

advisor는 기본 모델이 작업하다가 계획을 확정하기 전, 같은 오류가 되풀이될 때, 작업 완료를 선언하기 전 같은 시점에 더 강한 모델에게 조언을 구하게 하는 도구입니다. advisor는 대화 전체와 도구 호출 결과를 받아 지침을 돌려주고, 기본 모델이 그 지침을 반영해 이어 갑니다. 언제 부를지는 클로드가 판단합니다.

실험 기능이라 동작과 요금이 바뀔 수 있고, Anthropic API로 연결된 세션에서만 됩니다. Amazon Bedrock, Google Cloud, Microsoft Foundry 경로에서는 쓸 수 없습니다. 구독 계정과 API 과금 계정 모두 쓸 수 있습니다.

긴 여러 단계 작업, 같은 오류가 되풀이되는 디버깅, 끝내기 전에 한 번 더 점검받고 싶은 작업에 어울립니다. 계획이 거의 필요 없는 짧은 작업이나 매 턴마다 가장 강한 모델이 필요한 일에는 효과가 작습니다. 그런 때는 기본 모델 자체를 바꾸는 편이 낫습니다.

설정하는 세 가지 방법

  • /advisor 명령: 세션 중에 바로 정하고 기본값으로도 저장됩니다. 인자 없이 /advisor만 입력하면 모델 선택창이 열립니다.
  • 설정 파일: ~/.claude/settings.json에 "advisorModel": "opus"를 적어 항상 켭니다.
  • 실행 옵션: claude --advisor opus로 그 세션에서만 켭니다.

쓸 수 있는 모델 조합

advisor는 기본 모델과 같거나 더 높은 등급이어야 합니다. 자주 쓰는 조합은 다음과 같습니다.

  • Sonnet 5.5 기본 모델에 Opus advisor: 일상 작업은 Sonnet이 하고, 계획과 모호한 실패, 완료 점검은 Opus에게 넘깁니다.
  • Haiku 5.5 기본 모델에 Opus advisor: 가장 저렴한 기본 모델에 강한 계획 능력을 붙입니다.
  • Opus 5.5 기본 모델에 Opus advisor: 두 번째 Opus가 첫 번째를 점검합니다. 비용보다 독립 검토가 중요한 일에 씁니다.

opus, sonnet, fable 같은 별칭은 클로드 코드 업데이트에 따라 가리키는 버전이 달라집니다. 정확한 모델을 쓰고 싶으면 claude-opus-5-5처럼 모델 ID를 넣습니다. Fable을 advisor로 쓰려면 Fable 접근 권한이 필요합니다.

따라 하는 순서

  1. 클로드 코드를 시작하고 /model로 기본 모델을 Sonnet처럼 가벼운 모델로 정합니다. 확인: 고른 모델로 바뀌었다는 안내가 나옵니다.
  2. 입력창에 아래 명령을 입력합니다. 확인: Advisor set to 뒤에 Opus 모델 이름이 나옵니다.
명령어
/advisor opus
  1. 세션 시작 알림을 봅니다. 확인: Advisor Tool (experimental) is on and may use more tokens 알림이 보입니다.
  2. 작업을 요청하면서 필요하면 advisor에게 물어보라고 적습니다. 확인: 대화에 Advising 줄이 나타나고, 끝나면 조언을 검토했다는 표시가 붙습니다.
프롬프트
계획을 확정하기 전에 advisor에게 물어보고 진행해 줘.
  1. 조언 내용을 읽고 싶으면 Ctrl+O를 누릅니다. 확인: advisor가 돌려준 지침이 펼쳐집니다.
  2. 쓰지 않을 때는 아래 명령으로 끕니다. 확인: advisor가 꺼졌다는 안내가 나옵니다.
명령어
/advisor off

advisor를 부르는 횟수를 정하거나 강제하는 설정은 없습니다. 더 자주 또는 덜 자주 부르게 하고 싶으면 요청문에 그렇게 적습니다.

비용과 한계

advisor를 부를 때마다 advisor 모델이 대화를 읽으며 토큰을 씁니다. 구독 계정은 사용량 한도에서 차감되고, API 계정은 advisor 모델의 요금이 붙습니다. 다만 매 턴이 아니라 결정 지점에서만 부르므로, 강한 모델을 처음부터 끝까지 쓰는 것보다 대체로 적게 듭니다. 사용량은 /usage로 확인합니다.

텔레메트리를 끄는 환경 변수(DISABLE_TELEMETRY 등)가 설정된 세션에서는 advisor가 켜지지 않습니다. 완전히 없애려면 CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1을 설정합니다.

자주 묻는 질문

ultrathink와 advisor는 무엇이 다른가요?

ultrathink는 같은 모델이 그 요청 한 번만 더 오래 생각하게 하는 것이고, advisor는 다른 더 강한 모델에게 조언을 받는 것입니다. 모델을 바꾸지 않고 생각의 깊이만 올릴 때는 ultrathink, 계획과 점검에 상위 모델의 판단이 필요할 때는 advisor가 맞습니다.

advisor는 Pro나 Max 구독에서도 쓸 수 있나요?

구독 계정과 API 과금 계정 모두 쓸 수 있습니다. 구독에서는 advisor가 쓴 토큰도 사용량 한도에서 차감됩니다. 다만 Anthropic API로 연결된 세션이어야 하고, 기능이 켜지는 방식이 바뀔 수 있는 실험 기능입니다.

advisor가 실제로 호출됐는지 어떻게 아나요?

대화창에 Advising 줄이 나타나고 advisor 모델 이름이 함께 보입니다. 조언을 받은 뒤에는 검토했다는 표시가 붙고, Ctrl+O로 내용을 열어 볼 수 있습니다. 호출이 거절되거나 실패하면 Advisor declined to advise on this request나 Advisor unavailable 같은 줄이 나옵니다.

ultrathink가 xhigh까지 올라가려면 어떤 조건이 필요한가요?

클로드 코드 v2.1.311 이상이어야 하고, 터미널 입력창에 따옴표 밖에서 입력해야 합니다. 환경 변수로 에포트 상한이 낮게 잡혀 있거나 지원하지 않는 모델이면 올라가지 않습니다. 단어가 무지개색으로 보이면 올라갈 수 있는 상태입니다.

이 글의 본문은 아래 원본 유튜브 영상의 내용을 바탕으로 쓸모연구소가 다시 정리해 쓴 것입니다. 세부 내용과 최신 정보는 원본 영상과 공식 안내에서 확인해 주세요.

원본 영상 보러가기 ↗