Claude Code의 `opusplan` 모드 사용 시 고비용 Opus 서브에이전트 호출 주의

실용적 조언

사용량 소모가 빠르다고 느껴진다면 `/model opusplan` 대신 `/model opus`로 전환하여 로그를 비교해 보세요.
Anthropic 사용량 페이지에서 모델별 호출 횟수와 비용을 직접 대조하여 설정 모드의 효율성을 검증하세요.

섹션별 상세

01

사용자는 `/model opusplan` 모드에서 계획을 수립할 때 탐색(explore) 단계의 모든 요청이 Opus 모델로 처리되는 현상을 발견했다. 원래 이 모드는 계획 단계에서만 Opus를 사용하고 나머지는 Sonnet을 사용해야 하지만, 실제로는 탐색용 서브에이전트까지 Opus로 실행되어 토큰 소모가 극심해졌다. 공유된 사용량 로그에 따르면 모든 도구 호출이 `claude-opus-4-6` 모델로 기록되었음이 확인됐다.

opusplan 모드 사용 시의 상세 사용량 로그 화면 — Screenshot모든 요청이 claude-opus-4-6 모델로 처리되고 있으며, 각 요청당 비용이 $0.01~$0.06 수준으로 발생하고 있음을 보여준다. 이는 탐색 단계에서도 고비용 모델이 계속 사용되고 있다는 주장의 근거가 된다.

02

동일한 작업을 `/model opus` 모드에서 실행했을 때는 탐색 단계에서 저비용 모델인 Haiku 서브에이전트가 정상적으로 생성되는 차이를 보였다. 이는 Claude Code의 내부 로직이 설정된 메인 모델 모드에 따라 서브에이전트 할당 방식을 다르게 결정하고 있음을 시사한다. 로그상으로 `claude-haiku-4-5` 모델이 호출되면서 건당 비용이 $0.1168에서 $0.0036 수준으로 대폭 감소했다.

opus 모드 사용 시의 상세 사용량 로그 화면 — ScreenshotOpus 모델과 함께 claude-haiku-4-5 모델이 호출되는 것을 확인할 수 있다. Haiku 호출 시 비용이 $0.003 수준으로 급격히 낮아져, 특정 모드에서만 저비용 서브에이전트가 활성화됨을 증명한다.

03

Claude Code 터미널 인터페이스는 현재 어떤 모델이 서브에이전트로 사용되고 있는지 명시적으로 보여주지 않는다. 사용자가 직접 에이전트에게 어떤 모델을 사용했는지 질문했으나, 에이전트조차 시스템 정의에 따른 추측만 할 뿐 확답을 주지 못하는 투명성 문제가 제기됐다. 이는 사용자가 실시간으로 비용 발생 원인을 파악하기 어렵게 만드는 요소로 작용한다.

Claude Code 터미널의 탐색 에이전트 완료 메시지 — Screenshot탐색 에이전트가 수만 개의 토큰을 사용하며 작업을 마쳤음을 보여주지만, 어떤 모델이 사용되었는지는 인터페이스상에 나타나지 않음을 확인할 수 있다.

에이전트와 사용자의 모델 관련 대화 내용 — Screenshot사용자가 사용된 모델을 묻자 에이전트가 '확실히 알 수 없지만 Haiku일 것 같다'고 답변하는 장면이다. 에이전트 스스로도 자신이 어떤 모델 인스턴스로 실행되었는지 정확히 인지하지 못하는 한계를 보여준다.

04

Opus 모델은 Haiku에 비해 비용이 훨씬 높기 때문에 의도치 않은 Opus 서브에이전트 호출은 사용량 제한을 빠르게 소모시킨다. 사용자는 이를 버그 또는 의도된 설계상의 허점으로 보고 있으며, 비용 관리가 중요한 환경에서는 `opusplan` 모드 사용에 각별한 주의가 필요하다는 결론에 도달했다.

용어 해설

클로드 코드(Claude Code): — Anthropic에서 개발한 터미널 기반의 AI 코딩 에이전트로, 파일 시스템 접근, 코드 편집, 터미널 명령 실행 등을 자율적으로 수행한다. 복잡한 작업을 위해 여러 하위 에이전트를 생성하여 병렬로 작업을 처리하는 구조를 가진다.
서브에이전트(Subagent): — 메인 AI 모델이 복잡한 문제를 해결하기 위해 특정 작업(예: 코드베이스 탐색, 특정 파일 분석)을 할당하여 생성하는 하위 인스턴스다. 일반적으로 비용 절감을 위해 메인 모델보다 가벼운 모델을 사용하는 것이 권장된다.
오퍼스플랜(Opusplan): — Claude Code의 실행 모드 중 하나로, 작업 계획 수립 시에는 가장 강력한 Claude 3 Opus 모델을 사용하고 나머지 작업에는 Sonnet 모델을 사용하도록 설계된 설정이다. 하지만 실제 작동 방식에서 의도치 않은 고비용 모델 호출이 발생할 수 있음이 보고됐다.

언급된 도구

Claude Code중립

터미널 기반 AI 코딩 에이전트