TAU-HOME.COM
LOADING

클로드 코드(Claude Code) v2.1.292 팁: 서브에이전트 실행 시 작업별 effort(추론 강도) 지정하기

클로드 코드 v2.1.292부터 Agent 도구에 effort 파라미터가 추가되어, 자료 정리와 코드 검토 등 작업 성격에 맞춰 서브에이전트의 추론 강도(low/high)를 동적으로 지정할 수 있습니다.

tau · 2026년 10월 9일

#ClaudeCode #클로드코드 #Subagent #Effort #AI팁

클로드 코드(Claude Code) v2.1.292 팁: 서브에이전트 실행 시 작업별 effort(추론 강도) 지정하기

X의 루샨(@lucian__03) 님이 2026년 10월 7일 업데이트된 클로드 코드(Claude Code) v2.1.292 릴리즈에서 추가된 유용한 서브에이전트 제어 팁을 공유했습니다.

클로드 코드 터미널에서 서브에이전트 실행 시 effort 파라미터를 설정하는 작업 화면

이미지 출처: @lucian__03 (X)

이번 v2.1.292 업데이트부터 메인 클로드 코드 세션에서 서브에이전트를 호출할 때 작업 성격에 맞는 effort(추론 강도)를 프롬프트로 직접 지정할 수 있게 되었습니다.

Agent 도구의 effort 인자 확장

기존 클로드 코드 환경에서도 에이전트 전역 설정 파일을 통해 모델의 추론 강도(effort)를 사전에 구성할 수 있었습니다. 하지만 이번 버전부터는 내부 Agent 도구의 파라미터에 effort 인자가 공식 추가되어, 매 작업(Task)을 디스패치할 때마다 작업 단위로 세분화된 추론 강도를 지정할 수 있습니다.

이를 활용하면 단순 텍스트 분류나 파일 탐색 같은 경량 작업에는 불필요한 추론 토큰 소모를 줄이고, 복잡한 로직 분석이나 보안 코드 검토에는 높은 추론 깊이를 할당하는 식의 최적화가 가능합니다.

실전 프롬프트 활용 예시

메인 클로드 코드에게 여러 서브에이전트를 위임할 때 아래와 같이 프롬프트에 구체적인 강도를 명시하여 요청할 수 있습니다:

1. 자료 정리용 서브에이전트는 low effort로 실행해.
2. 최종 코드 검토용 서브에이전트는 high effort로 실행해.

서브에이전트 기반 오케스트레이션이나 멀티에이전트 파이프라인을 자주 운용하는 사용자라면 토큰 효율과 작업 품질을 동시에 제어할 수 있는 실용적인 팁입니다.

원문 출처