Claude Ultra-code 워크플로우에서 토큰 낭비 줄이기 — 프롬프트 기반 오케스트레이션과 Skill 커맨드

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

TL;DR

작성자는 Opus Ultra 코드 모드에서 Claude가 워크플로우를 실행할 때 발생하는 과도한 토큰 소모를 줄이기 위해 30회 이상의 세션을 분석했다. Ultra-code 모드는 먼저 결정론적 JavaScript를 생성하고 그 안에서 서브에이전트를 호출하며 중간 결과를 스크립트 변수에 저장하므로, 작은 작업이 불필요하게 확장되거나 동일 파일을 여러 에이전트가 반복적으로 읽을 경우 토큰 낭비가 심해진다는 점을 확인했다. 프롬프트 구조를 개편해 각 서브에이전트의 책임·결과 목표·검증·승인 절차·사전 모델 위임·서브에이전트 상한을 명시하면 Claude가 제안하는 워크플로우가 더 적절한 크기로 쪼개지고 사용자가 제안된 분할을 승인하거나 수정한 뒤 실행할 수 있었다. 이러한 흐름을 skill 명령으로 자동화해 GitLab에 공개했고, 사전 위임과 검증 루프 제어를 병행하면 토큰 소비와 지연이 줄어드는 실무적 이점이 나타났다. 다만 Ultra-code가 처음 생성하는 오케스트레이션 JavaScript 특성상 프롬프트 준수 확률은 높지만 여전히 확률적 행동을 보이므로 완전 자동화는 아니고, 검증이 열린 루프가 되면 다시 비용이 증가하는 트레이드오프가 존재한다. 따라서 프롬프트 오케스트레이션과 수동 승인 지점을 결합해 비용·정확성 균형을 맞춰야 한다.

실용적 조언

프롬프트에 작업 정의·출력 목표·검증 기준·승인 절차·서브에이전트 상한·모델 위임 정책을 명시해 Claude의 오케스트레이션을 제어하라.
작업 분해 후 Claude가 제안한 서브에이전트 수를 사용자가 검토·승인하도록 구성해 불필요한 에이전트 생성을 막으라.
단순·반복적 작업은 프롬프트에서 사전 위임 규칙을 설정해 저비용 모델로 처리하게 하라.
검증 단계는 별도의 검증 에이전트를 두되, 재검증 루프를 제한해 열린루프 비용 증가를 방지하라.
작성자는 GitLab에 공개한 skill 명령(프롬프트 재작성 도구)을 활용해 프롬프트 오케스트레이션을 자동화하라고 권장한다.

섹션별 상세

Opus Ultra 코드 모드에서 토큰 소모가 문제라서 원인을 분석했고, 30회 이상의 세션 로그를 검토해 패턴을 찾았다; Claude는 작업을 실행하기 위해 결정론적 JavaScript를 먼저 생성하고 그 안에서 서브에이전트를 호출하며 중간 결과를 스크립트 변수에 보관하는 방식으로 작동하므로 각 호출과 자기검토가 곧 토큰 소모로 직결됐다; 분석에서 작은 작업이 크게 확장되는 사례와 동일 파일을 여러 에이전트가 반복 읽는 점이 토큰 버닝의 주요 원인으로 지목되었고, 이는 비용 최적화 필요성을 부각했다.

프롬프트 구조를 바꿔 오케스트레이션 규칙을 명확히 하자 실행 효율이 크게 개선됐다; 구체적으로 프롬프트에 각 서브에이전트의 책임·목표 결과·검증·승인 절차·사전 모델 위임 정책·서브에이전트 상한을 명시하면 Claude가 작업을 쪼갤 때 제안하는 서브에이전트 수를 작업의 독립 단위에 맞춰 산정하고 사용자가 승인하거나 수정한 뒤 최종 실행하는 흐름이 생성된다; 이 접근법을 skill 명령으로 자동화해 프롬프트를 워크플로우 지시문으로 재작성하는 도구를 GitLab에 공개한 점이 재현 가능한 실무 대안으로 제시됐다.

검증 에이전트를 분리해 자기검토 편향을 줄였으나 검증이 열린 루프가 되면 반복 확인·수정으로 또다시 비용이 발생했다; Claude의 Ultra-code는 먼저 JavaScript 오케스트라팅 코드를 생성하는 특성 때문에 프롬프트에 따른 동작 확률이 높지만 본질적으로 확률적 행동을 보이므로 완벽한 제어는 불가능하다; 따라서 검증 정책과 서브에이전트 캡을 병행해 자동화의 비용-정확성 균형을 맞추는 실무적 절충이 필요하다는 점이 강조됐다.

모델 위임과 introspection(자기성찰) 제한이 비용 절감에서 핵심으로 지목되었고, 프롬프트 단계에서 저비용 모델(본문에서 언급한 sonnet 또는 haiku 형태)으로 사전 위임을 명시하면 불필요한 고비용 호출을 줄일 수 있다; 이 방법은 프롬프트가 입력 → 작업 분해 → 서브에이전트 지정 → 승인 → 실행 순으로 처리되도록 유도하므로 반복적 검토와 중복 파일 접근을 감소시켜 토큰과 지연을 줄인다는 실무적 이점이 도출됐다.

용어 해설

Ultra-code 모드(Ultra-code mode): — Ultra-code 모드는 Claude가 자연어 대신 결정론적 JavaScript 스크립트를 생성해 작업을 실행하고, 스크립트 변수에 중간 결과를 저장하며 외부 서브에이전트를 호출해 처리를 분산시키는 실행 모드이다. 이렇게 하면 채팅 메시지 대신 코드 기반으로 워크플로우를 구성할 수 있고, 반복적 토큰 소비를 줄이려면 프롬프트로 실행 규칙과 검증 절차를 엄격히 정의해야 한다.
서브에이전트(Subagent): — 서브에이전트는 전체 워크플로우 내에서 특정 단계만 수행하도록 생성되는 하위 에이전트로, 주 에이전트가 JavaScript에서 호출해 독립적으로 작업을 처리하고 결과를 반환한다. 작업을 잘게 쪼개면 병렬화와 전문화 이점이 있으나 과도한 서브에이전트 호출은 토큰 소비와 I/O 중복을 초래한다.
프롬프트 오케스트레이션(Prompt orchestration): — 프롬프트 오케스트레이션은 LLM에게 단일 작업을 수행시키기보다 작업 정의·결과 목표·검증 규칙·모델 위임 계획·서브에이전트 한도 등을 구조화된 프롬프트로 명시해 실행 흐름을 제어하는 방법이다. 이렇게 하면 모델이 무분별하게 서브에이전트를 생성하거나 과도한 자기검토를 반복하는 것을 막아 비용과 지연을 줄인다.
검증 에이전트(Verification agent): — 검증 에이전트는 산출물을 생성한 동일 에이전트가 아닌 별도의 에이전트로 결과의 정확성·완전성·목표 적합성을 점검하는 역할을 수행한다. 검증을 독립화하면 자기상호검증으로 인한 편향을 줄이지만 검증 루프가 열리면 반복 확인으로 비용이 증가할 수 있다.

언급된 도구

workflow-prompt (GitLab)추천링크

단순 프롬프트를 워크플로우 지시문으로 재작성해 Claude Ultra-code 모드의 오케스트레이션과 실행 규칙을 명시하는 skill 명령

언급된 리소스

GitHubworkflow-prompt — GitLab