@Xterbase 클로드 코드로 활용할 수 있더라구요.
요약
본 글은 Claude Code 환경과 Messages API를 활용하여 복잡한 작업을 수행하는 효율적인 방법을 제시합니다. 특히 '조언자(advisor)'와 '서브에이전트' 개념을 도입하여, 메인 모델(Sonnet 5)이 주도하고 다른 전문 모델(Fable 5 등)이 계획 및 자문 역할을 분담하도록 설계할 수 있습니다.
핵심 포인트
- Claude Code에서 조언자/지휘관 방식으로 에이전트 활용 가능
- 서브에이전트는 독립된 컨텍스트로 병렬 작업 수행 용이
- Messages API의 advisor tool을 사용해 계획 및 수정안 생성 최적화
- 비용 효율성을 위해 역할별 모델과 요율 분리 집계
@Xterbase 클로드 코드로 활용할 수 있더라구요.
아쉽게도 클로드.ai에서는 수동으로 번갈아 가면서 쓰는 수 밖엔
아래는 Fable에게 짜달라고 요청한 내용입니다.
방법은 세 가지 경로가 있습니다. 난이도가 낮은 순서로 정리합니다.
1. Claude Code에서 (가장 간단)
조언자 방식 (Sonnet 5 실행 + Fable 5 자문)
/model claude-sonnet-5
/advisor ← 목록에서 Fable 5 선택
/advisor를 인수 없이 실행하면 사용 가능한 조언자 모델 목록이 뜨고, 선택하면 설정(advisorModel)에 저장되어 다음 세션에도 유지됩니다. 세션 1회만 쓰려면 실행 시 --advisor 플래그를 씁니다. Claude Code Docs 호출 시점은 Claude가 스스로 판단하며(접근 방식 확정 전, 같은 오류 반복 시, 완료 선언 전), 프롬프트에 "계속하기 전에 advisor에게 상담해"라고 쓰면 명시적으로 유도할 수 있습니다. Claude Code Docs 조건: Claude Code v2.1.98 이상 + Anthropic API 연결이 필요하고, Bedrock·Google Cloud·Microsoft Foundry에서는 안 됩니다. 구독 계정과 API 과금 계정 모두 사용 가능합니다. Claude Code Docs
지휘관 방식 (Fable 5 오케스트레이터 + Sonnet 5 서브에이전트)
/model claude-fable-5
/agents ← 서브에이전트 생성
또는 .claude/agents/researcher.md 파일을 직접 만듭니다:
---
name: researcher
description: 웹 조사와 자료 수집 담당
model: sonnet
---
너는 조사 담당이다. 결과만 요약해 보고한다.
서브에이전트 정의에는 description, tools, model, permissionMode 등의 프런트매터 필드를 쓸 수 있습니다. Claude Code Docs 부모 에이전트가 Agent 도구로 서브에이전트를 띄우고, 각 서브에이전트는 독립된 컨텍스트에서 작업한 뒤 최종 메시지만 반환합니다. Kyle Redelinghuys 이후 "서브에이전트 3개로 나눠서 병렬 조사해"라고 지시하면 Fable 5가 분배합니다.
2. Messages API — advisor tool (beta)
tools 배열에 advisor를 선언하고 베타 플래그를 넣으면 됩니다: GitHub
response = client.beta.messages.create(
model="claude-sonnet-5", # 실행자
betas=["advisor-tool-2026-03-01"],
tools=[
{"type": "advisor_20260301",
"name": "advisor",
"model": "claude-fable-5", # 조언자
"max_uses": 3},
# ...일반 도구들
],
messages=messages,
)
조언자는 전체 대화를 읽고 400~700토큰 정도의 계획·수정안만 생성하며, 실행자가 나머지 출력을 저렴한 요율로 처리합니다. 전부 단일 /v1/messages 요청 안에서 서버 측으로 동작합니다. Claude API Docs 청구는 usage.iterations에서 advisor_message는 조언자 요율, message는 실행자 요율로 분리 집계됩니다. Claude API Docs max_uses로 요청당 조언 횟수 상한을 걸 수 있습니다. Claude
3. Claude Managed Agents — 지휘관 구조 (beta)
님이 언급한 sub-agent·캐시 구조가 이 제품입니다. 모든 엔드포인트에 managed-agents-2026-04-01 베타 헤더가 필요하고, 프롬프트 캐싱·컴팩션은 하네스에 내장되어 있습니다. Claude Platform Docs 흐름은 agent 생성(모델·시스템 프롬프트·도구 정의) → environment 생성(샌드박스) → session 생성 → 이벤트 스트리밍 순서이며, Claude Code에서 /claude-api managed-agents-onboard를 실행하면 대화형 가이드로 세팅할 수 있습니다. Claude Platform Docs
Fable 5 지휘관 + Sonnet 5 워커 구현 예제는 공식 쿡북 노트북(anthropics/claude-cookbooks의 managed_agents/CMA_plan_big_execute_small.ipynb)에 있습니다. 이 예제에서 팀 구성은 $1.61·194초, Fable 5 단독은 $4·608초가 나왔습니다. 36Kr 다만 에이전트가 서브에이전트를 직접 띄우는 멀티에이전트 조정 기능은 아직 research preview 단계라 불안정할 수 있습니다. Verdent AI
선택 기준
개인 코딩·문서 작업은 1번(Claude Code)으로 충분하고 오늘 바로 됩니다. 자동화 파이프라인을 코드로 짜려면 2번, 장시간 자율 실행과 샌드박스가 필요하면 3번입니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 X AI 사용법/팁의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기