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

클로드 코드 하이쿠 서브에이전트, 모델 안 바꾸고 토큰 아끼기

클로드 코드로 오퍼스 5.5를 주력으로 쓰다 보면 일이 많아질 때 모델을 바꾸고 싶어집니다. 하지만 작업 도중 모델을 바꾸면 쌓아 둔 캐시를 잃습니다. 이 글은 메인 세션은 그대로 두고 병렬 작업만 하이쿠 서브에이전트에게 맡기는 방법과, 평소에는 에포트를 medium으로 두고 어려운 일에만 ultrathink를 쓰는 습관을 공식 문서 기준으로 정리했습니다.

클로드 코드 하이쿠 서브에이전트, 모델 안 바꾸고 토큰 아끼기 삽화
삽화 · 쓸모연구소

메인 세션의 모델을 바꾸면 안 되는 이유

클로드 코드는 메시지를 보낼 때마다 지금까지의 대화 전체를 다시 보냅니다. 이때 앞부분이 이전 요청과 똑같으면 프롬프트 캐시(한 번 처리한 앞부분을 싸게 다시 읽는 장치)가 적용됩니다. 그런데 모델마다 캐시가 따로 있습니다. 공식 문서(2026년 11월 2일 확인)에 따르면 /model로 모델을 바꾸면 다음 요청은 내용이 똑같아도 대화 전체를 캐시 없이 다시 읽습니다. 대화가 길수록 이 한 번의 비용이 큽니다.

서브에이전트(메인 대화와 따로 일하는 보조 에이전트)는 이 문제를 피하게 해 줍니다. 서브에이전트는 자기 시스템 프롬프트와 도구, 자기 컨텍스트로 시작해서 자기 캐시를 따로 쌓습니다. 메인 세션 쪽에는 서브에이전트를 부른 기록과 돌아온 결과가 덧붙을 뿐이라 메인의 캐시가 그대로 유지됩니다. 또 서브에이전트가 읽은 파일과 긴 출력은 서브에이전트의 컨텍스트에 남고 요약만 돌아오므로, 메인 대화가 부풀지 않습니다.

그래서 요령은 이렇습니다. 메인 세션은 오퍼스 5.5로 두고, 단순하고 반복적인 일이 많아지면 서브에이전트를 새로 만들어 하이쿠로 돌립니다.

따라 하기: 하이쿠 서브에이전트에게 일 맡기기

준비물은 클로드 코드와 오퍼스 5.5를 쓸 수 있는 계정입니다. 구독이나 API 키 모두 됩니다. 공식 문서의 기본 모델은 Anthropic API 기준으로 오퍼스 5.5이고, haiku 별칭은 하이쿠 5.5를 가리킵니다. 클라우드 제공자(Amazon Bedrock, Google Cloud 등)를 쓰면 별칭이 가리키는 버전이 다릅니다.

  1. 터미널에서 claude를 입력해 클로드 코드를 켭니다.
    • 확인: 입력창이 뜹니다.
  2. 세션을 시작하자마자 모델과 에포트를 정합니다. /model로 오퍼스 5.5를 고르고 /effort로 현재 수준을 봅니다.
    • 확인: 오퍼스 5.5의 에포트가 기본값인 medium입니다. 공식 문서도 세션 맨 처음에 모델과 에포트를 정해 두면 캐시 적중률이 높아진다고 안내합니다.
  3. 일이 많아져 병렬로 돌려야겠다 싶으면, 모델을 바꾸지 말고 메인 세션에 서브에이전트를 만들어 하이쿠로 돌리라고 입력합니다. 아래는 예시 문장입니다. 맡길 일 부분은 내 작업에 맞게 바꿉니다.
프롬프트
서브에이전트를 하나 만들어서 그 서브에이전트는 haiku로 작업해. 맡길 일은 src 폴더의 모든 파일에서 TODO 주석을 찾아 파일별 목록으로 정리하는 거야.
  • 확인: 서브에이전트가 따로 일하고, 끝나면 결과 요약이 메인 대화로 돌아옵니다. 공식 문서에 따르면 클로드가 서브에이전트를 부를 때 모델 별칭(haiku, sonnet, opus)을 함께 넘길 수 있습니다.
  1. 메인 세션에서 /usage를 입력해 캐시 상태를 봅니다.
    • 확인: Session 구획의 Prompt cache (main) 줄에 적중 비율과 캐시가 따뜻한지가 나옵니다(클로드 코드 2.1.251 이상). 서브에이전트를 돌린 뒤에도 적중 비율이 크게 떨어지지 않았다면 메인 캐시가 유지된 것입니다.
  2. 같은 일을 자주 시킨다면 서브에이전트를 파일로 만들어 둡니다. ~/.claude/agents/(모든 프로젝트) 또는 프로젝트의 .claude/agents/ 폴더에 마크다운 파일을 만들고 맨 위에 모델을 적습니다.
프롬프트
---
name: todo-scanner
description: 코드에서 TODO 주석을 찾아 파일별로 정리합니다.
tools: Read, Grep, Glob
model: haiku
---
src 폴더에서 TODO 주석을 찾아 파일별 목록으로 정리해 돌려 줘.
  • 확인: 클로드 코드에서 "todo-scanner 서브에이전트로 TODO를 정리해 줘"처럼 부르면 하이쿠로 돌아갑니다. name과 description만 필수이고 model을 빼면 메인 대화의 모델을 따릅니다.
  1. 하이쿠가 어려운 일에서 자꾸 막히면 같은 방식으로 model: sonnet을 지정합니다. 단순한 검색, 목록 정리, 요약에는 하이쿠, 코드를 고치는 일에는 소넷, 설계 판단은 메인의 오퍼스로 나누는 식입니다.
    • 확인: 서브에이전트 결과를 읽고 쓸 만한지 판단합니다. 작은 모델의 결과는 메인이 검토합니다.

모든 서브에이전트를 한 모델로 묶고 싶다면 환경 변수 CLAUDE_CODE_SUBAGENT_MODEL과 CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1을 함께 설정합니다(클로드 코드 2.1.257 이상). 다만 이러면 서브에이전트마다 따로 모델을 고르는 유연성이 없어지므로, 처음에는 위처럼 필요할 때만 지정합니다.

평소에는 에포트 medium, 어려운 일만 ultrathink

에포트(답하기 전에 얼마나 깊이 생각할지 정하는 설정)는 low, medium, high, xhigh, max 다섯 단계입니다. 오퍼스 5.5, 소넷 5.5, 하이쿠 5.5의 기본값은 medium입니다. 공식 문서는 앤트로픽 테스트에서 오퍼스 5.5를 medium으로 돌린 결과가 오퍼스 5를 high로 돌린 결과와 같거나 더 낫게 나왔다고 소개하고, 오퍼스 5에서 옮기는 사람은 이전 수준을 가져오지 말고 medium에서 시작하라고 권합니다.

어려운 작업이 있을 때는 세션 설정을 바꾸지 않고 ultrathink라는 단어를 프롬프트에 넣습니다. 그 한 번의 답만 더 깊이 생각하게 하고, 터미널에서는 에포트를 xhigh로 올린 것처럼 동작합니다. 가능하면 단어가 무지개색으로 표시됩니다(클로드 코드 2.1.311 이상). "think hard"나 "think more" 같은 표현은 이 키워드로 인식되지 않고 평범한 글로 처리됩니다.

  1. 어려운 작업을 시킬 때 프롬프트에 ultrathink를 넣습니다.
프롬프트
이 인증 로직의 레이스 컨디션을 ultrathink 해서 찾아줘.
  • 확인: 입력창에서 ultrathink가 무지개색으로 표시되고, 그 한 번의 답이 더 깊게 생각해서 나옵니다. 다음 질문은 다시 medium으로 돌아갑니다.
  1. 어려운 일이 끝나면 별도 조치 없이 평소처럼 씁니다. 에포트를 high로 올려 둔 채로 두면 모든 답에 토큰이 더 듭니다.
    • 확인: /effort status로 현재 수준이 medium인지 봅니다.

오퍼스 5.5, 소넷 5.5, 하이쿠 5.5, Fable 5.1은 구독이나 API 키로 쓸 때 에포트를 바꿔도 캐시가 유지됩니다. 모델을 바꾸는 것보다 에포트를 바꾸는 쪽이 캐시 손실이 없다는 뜻입니다. 에포트의 자세한 기준은 오퍼스 5.5 에포트 설정에 정리돼 있습니다.

작은 모델부터 시작해서 안 되는 것만 올리기

낮은 에포트나 작은 모델로 먼저 시도하고 잘 안 되는 일만 한 단계 올리는 방식도 있습니다. 토큰을 줄일 가능성이 있지만, 공식 문서가 이 방식의 절감 폭을 밝힌 것은 아니므로 내 작업에서 /usage로 전과 후를 비교해야 합니다. 올릴 때도 메인 세션의 모델을 바꾸기보다 새 서브에이전트에 sonnet이나 opus를 지정하는 쪽이 캐시를 지킵니다.

계획과 실행에 다른 모델을 쓰는 opusplan은 주의합니다. 계획 모드에 들어가고 나올 때마다 모델이 바뀌어서, 그때마다 캐시가 새로 만들어집니다.

서브에이전트도 공짜는 아니다

  • 서브에이전트의 요청도 사용량을 씁니다. 하이쿠 단가가 싸서 부담이 줄 뿐입니다.
  • 서브에이전트의 프롬프트 캐시는 기본으로 5분만 유지됩니다. 구독 한도 안에서도 메인 대화는 1시간, 서브에이전트는 5분입니다. 오래 쉬었다 같은 서브에이전트에게 다시 일을 시키면 캐시를 새로 만듭니다.
  • 서브에이전트는 메인 대화의 기록을 보지 못하고, 메인이 작성한 위임 메시지만 보고 일합니다. 필요한 파일 경로와 기준을 위임 문장에 적어야 합니다.
  • 한 번에 많은 서브에이전트를 병렬로 돌리면 그만큼 요청이 쌓입니다. 사람이 지켜보지 않는 자동 실행에는 상한을 거는 방법이 클로드 크레딧 줄이는 법 총정리에 있습니다.

선택: 여러 컴퓨터의 에이전트를 한눈에 보는 Claw Office

에이전트를 여러 컴퓨터에서 동시에 돌리면 누가 일하고 누가 쉬는지 한눈에 보기 어렵습니다. Claw Office(jkf87/claw-office)는 각 컴퓨터에서 도는 에이전트와 세션을 3D 사무실의 책상에 앉은 직원처럼 보여 주는 플러그인입니다. 일하는 중, 완료, 대기, 확인 필요 상태를 보여 주고, 새 일을 맡기거나 권한 요청에 허용⁠·거부 버튼으로 답할 수 있습니다. MIT 라이선스입니다.

초기 단계의 프로젝트라는 점을 먼저 알아야 합니다. 저장소 별이 15개 수준(2026년 11월 2일 확인)이고, README가 밝히는 제약이 많습니다.

  • 요구사항: OpenClaw 2026.9.8 이상, Node 24.16 이상, 각 컴퓨터에 로그인된 claude(와 codex), 클로드 코드⁠·코덱스 세션 연결용 Paseo(@getpaseo/cli)입니다. OpenClaw Control UI 안에서 도는 플러그인이라 OpenClaw를 이미 쓰는 사람에게 맞습니다.
  • 컴퓨터 목록이 코드에 하드코딩되어 있어서 내 환경에 맞게 src/machines.ts 등을 고치고 다시 빌드해야 합니다.
  • 다른 컴퓨터를 연결하려면 SSH, Tailscale 주소, 데몬 비밀번호 설정이 필요합니다. 컴퓨터를 원격으로 제어하는 도구이므로 보안 설정을 꼼꼼히 확인합니다.
  • Paseo로 가져온 세션을 터미널에서 claude --resume으로 동시에 열면 대화가 갈라질 수 있습니다.

설치는 README 안내를 따릅니다. 저장소를 받아 업데이트 스크립트를 실행하는 방식입니다.

명령어
git clone https://github.com/jkf87/claw-office.git ~/claw-office
명령어
cd ~/claw-office
프롬프트
./update-plugin.sh

이 스크립트가 Paseo 데몬 실행, 플러그인 설치, 게이트웨이 재시작을 처리합니다. 이후 OpenClaw Control UI에서 Custom plugin UI 옵션을 켜고 사이드바의 Claw Office를 엽니다. 안 되는 부분은 저장소 이슈로 남깁니다.

자주 묻는 질문

하이쿠 서브에이전트를 쓰면 토큰이 정말 줄어드나요?

단가가 낮은 모델이 반복 작업을 처리하고, 긴 출력이 메인 대화에 쌓이지 않아 대체로 유리합니다. 하지만 줄어드는 폭은 작업마다 다릅니다. 서브에이전트를 쓰기 전후로 /usage의 사용률을 비교해 확인합니다.

세션 도중 /model로 모델을 바꾸면 얼마나 손해인가요?

바꾼 직후의 요청 한 번은 대화 전체를 캐시 없이 다시 읽습니다. 대화가 짧으면 거의 티가 안 나지만, 길게 이어 온 세션에서는 그 한 번이 크게 느껴집니다. 클로드 코드는 캐시가 따뜻할 때 /model로 바꾸기 전에 확인을 먼저 묻습니다.

ultrathink는 켜 두는 설정인가요?

아닙니다. 프롬프트에 넣은 그 한 번의 답에만 적용되고, 세션의 에포트 설정은 그대로입니다. 평소 수준을 올리고 싶다면 /effort로 바꿉니다.

서브에이전트에는 어떤 모델이 맞나요?

파일 검색, 목록 정리, 요약처럼 단순한 일에는 하이쿠를 쓰고, 코드를 고치는 일에는 소넷을 씁니다. 판단이 어렵다면 메인의 오퍼스가 직접 하는 편이 낫습니다. 공식 비용 문서도 대부분의 코딩 작업은 소넷으로 충분하다고 안내합니다.

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

원본 영상 보러가기 ↗