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

클로드 코드 루프 비용 줄이기, 맨몸 호출과 파이썬 검사로 설계

클로드 코드 루프 비용은 "한 번에 얼마나 싣고, 몇 번 다시 싣느냐"로 정해집니다. 이 글은 같은 일("유튜브 제목 10개 뽑기")을 일곱 가지 방식으로 돌린 실측 사례를 따라가며, 한 판 비용이 약 1달러에서 1센트 아래까지 내려간 이유와 그 구조를 내 작업에 옮기는 17단계 절차를 설명합니다.

클로드 코드 루프 비용 줄이기, 맨몸 호출과 파이썬 검사로 설계 삽화
삽화 · 쓸모연구소

비용이 커지는 이유

일곱 판 모두 결과물은 같은 검사를 통과했습니다. 이 사례는 클로드 코드 2.1.310에서 2026년 10월 26일에 잰 것이고, 모든 업무에서 같은 절감률이나 품질을 보장하지는 않습니다. 설치한 설정, 스킬, 플러그인, 모델 응답에 따라 비용과 통과율이 달라집니다. 구독 한도를 줄이는 일반 방법은 "클로드 토큰 아끼는 법"과 "클로드 크레딧 줄이는 법" 글에 있고, 여기서는 클로드 코드를 스크립트로 반복 호출할 때의 설계만 다룹니다.

요청마다 앞 내용을 통째로 다시 보낸다

AI 모델은 앞 대화를 기억하지 못합니다. 그래서 클로드 코드는 요청할 때마다 시스템 프롬프트, 도구 설명서, CLAUDE.md, 지금까지의 대화를 통째로 다시 보냅니다. 반복되는 앞부분은 프롬프트 캐시에서 읽어 값이 싸집니다. 앤트로픽 공식 가격표 기준으로 캐시를 읽는 값은 기본 입력가의 0.1배이고(Opus 5.5와 Sonnet 5.5는 0.05배), 캐시에 처음 쓰는 값은 5분 캐시가 1.25배, 1시간 캐시가 2배입니다. 싸지만 공짜는 아니라서, 큰 앞부분을 여러 번 싣는 구조는 여전히 비쌉니다.

한 단어 실험

터미널에서 "하늘이 무슨 색이냐"를 한 단어로 답하라고 보내 봅니다.

  • 기본 호출: 답은 "파랑" 한 단어인데 함께 보낸 토큰이 53,000개로 찍혔습니다.
  • 맨몸 호출: 도구를 끄고, 설정 파일을 읽지 못하게 막고, 기본 시스템 프롬프트 대신 한 줄짜리 지시만 줬습니다. 답은 똑같이 "파랑"이었고 토큰은 574개였습니다.

차이는 클로드 코드가 기본으로 싣는 짐입니다. 파일을 읽고 쓰고 명령을 실행하는 도구 설명서, 에이전트로 일하는 법을 적은 긴 시스템 프롬프트, 깔아 둔 스킬과 플러그인 목록, 그리고 CLAUDE.md입니다. CLAUDE.md 하나만 재 보니 약 2만 토큰이었습니다. 에이전트로 일할 때는 다 필요한 짐이지만, 한 단어 답에는 전부 군더더기입니다.

일주일 사용 기록

콘텐츠 기획 폴더에서 일주일 동안 쓴 대화 기록을 모아 보면 이렇습니다.

  • 대화 103개, 모델 호출 7,923번, 토큰 합계 32억 8천만 개
  • 이 가운데 99%에 가까운 양이 앞 내용을 다시 읽은 캐시 읽기이고, AI가 실제로 써 준 글은 0.2%도 안 됩니다.
  • API 정가로 바꾸면 일주일에 150달러입니다. 구독으로 쓰면 청구서 대신 사용량 한도에서 빠집니다.
  • 비용의 60% 넘게가 캐시 읽기, 캐시에 새로 쓰는 값이 27% 정도, 출력이 11% 정도입니다.
  • 모델 호출의 99% 넘게를 가장 비싼 모델(Opus)로 돌렸습니다.

CLAUDE.md가 불어난 이야기

지적받은 내용을 그때그때 CLAUDE.md에 한 줄씩 적는 건 좋은 습관입니다. 하지만 이 파일은 대화가 오갈 때마다 같이 실립니다. 10월 21일에 6,000바이트였던 파일이 43,000바이트(약 7배)로 불어났고, 지금 크기라면 일주일 7,900번 호출에 2만 토큰씩 다시 실리는 셈입니다. 그렇다면 이 파일만 줄이면 비용이 확 줄까요. 실험으로 확인합니다.

실험 조건

  • 과제: 제목 후보 10개와 썸네일 문구 뽑기. 제목 50자, 썸네일 30자 같은 원칙을 코드로 보는 "타이틀 체크"에서 실패가 하나도 없어야 통과입니다.
  • 판마다 작업 폴더를 새로 만들고 자동 메모리를 껐습니다. 비용은 클로드 코드가 계산한 정가 기준입니다.
  • 같은 일을 판마다 세 번 돌렸습니다. 한 번은 우연일 수 있기 때문입니다. 아래 평균 비용은 세 판 평균입니다.

일곱 가지 루프

1. 통째로 맡기기, 평균 1.0071달러

폴더를 열고 할 일을 한 번에 적어 맡기는 평소 방식입니다. 브리프를 읽고 제목을 쓰고 검사에서 저장까지 맡깁니다. 터미널에서 세 번 돌린 판들은 턴(AI가 한 번 답하고 도구를 쓰는 한 바퀴)을 9번에서 11번 돌았고, 턴마다 앞 내용을 통째로 다시 읽었습니다. 이 1달러가 기준선입니다.

2. 평가만 코드로, 평균 0.8192달러

합격 여부를 AI에게 묻지 않고 파이썬 스크립트가 정합니다. 스크립트가 루프를 돌며 AI에게는 후보만 쓰게 하고, 검사는 타이틀 체크가 맡고, 떨어진 것만 다시 시킵니다. 검사를 코드가 하면 토큰이 0이니 비용이 확 줄 줄 알았지만 결과는 19% 감소에 그쳤습니다.

일꾼(후보를 쓰는 AI) 안을 들여다보니 후보만 쓰라고 했는데 제목 공식 파일을 열어 읽고 스스로 타이틀 체크까지 돌리고 있었습니다. CLAUDE.md에 "후보를 보여 주기 전에 반드시 타이틀 체크를 돌린다"는 규칙이 있었기 때문입니다. 규칙을 충실히 지키느라 11턴을 돌았고, 턴마다 4만에서 58,000토큰을 다시 읽었습니다. 평가를 코드로 옮겨도 일꾼이 무거운 짐을 지고 오면 소용이 없습니다.

3. 도구만 끔, 평균 0.7161달러

일꾼이 파일을 읽지도 명령을 돌리지도 못하게 도구만 껐습니다. 턴은 한두 번으로 줄었는데 비용은 43센트에서 1달러 넘게까지 들쭉날쭉했습니다. 기록을 보니 기본 시스템 프롬프트와 CLAUDE.md를 거의 매번 캐시에 새로 쓰고 있었고, 캐시에 쓰는 값은 일반 입력보다 비싸서 오히려 비용이 올랐습니다. 도구만 빼고 무거운 기본 짐은 그대로 들려 보낸 셈입니다.

4. 맨몸 Opus, 평균 0.0740달러

일꾼을 완전히 맨몸으로 보냈습니다. 도구와 설정 파일을 막고, 기본 시스템 프롬프트도 한 줄로 바꾸고, 모델은 그대로 Opus로 두고, 꼭 필요한 규칙 다섯 줄만 질문에 넣었습니다. 첫 호출에서는 10개 중 9개가 통과하고 1개가 떨어졌습니다. 썸네일에 같은 조사를 두 번 써서 탈락했습니다. 두 번째 호출에는 그 하나만 떨어진 이유와 함께 다시 보냈고, 세 판 평균은 7센트 남짓이었습니다. 같은 Opus로 1달러짜리 작업이 약 7센트로 줄었습니다.

핵심은 두 번째 호출에 첫 번째 대화를 이어 붙이지 않은 것입니다. 통과한 9개는 파이썬이 따로 적어 두고, 새 호출에는 남은 1개와 떨어진 이유만 넣었습니다. 대화를 이어 가면 턴마다 앞 내용이 통째로 다시 실리지만, 실패만 들고 새로 부르면 매번 작은 짐으로 시작합니다. 무엇이 끝났고 무엇이 남았는지는 파일과 코드가 기억하게 합니다.

5. 맨몸 Sonnet, 평균 0.0397달러

제목 후보만 쓰는 일은 가장 비싼 모델이 아니어도 됩니다. 일꾼 모델을 Sonnet으로 낮추자 평균 약 4센트가 나왔습니다.

6. 맨몸 Haiku, 평균 0.0038달러

가장 싼 Haiku를 넣으니 한 번 호출에 10개가 전부 통과했습니다. 비용은 1센트의 절반도 안 됐습니다.

7. CLAUDE.md 다이어트, 평균 0.9316달러

통째로 맡기는 방식은 그대로 두고 CLAUDE.md에서 "배운 건 목록"만 파일로 빼서 필요할 때 읽게 했습니다. 약 1달러에서 93센트까지밖에 줄지 않았습니다. 턴이 11번에서 13번 사이로 오히려 늘어 아낀 걸 거의 도로 썼기 때문입니다. 통째로 맡기는 방식의 비용은 짐 무게보다 오가는 횟수가 좌우합니다. 그래도 수천 토큰을 덜 싣는 건 분명한 이득이라 CLAUDE.md 정리는 해 둘 만합니다.

한눈에 비교

방식 평균 비용
통째로 맡기기 약 1달러
CLAUDE.md 줄이기 93센트
평가만 코드로 82센트
도구만 끄기 72센트
맨몸 Opus 7센트 남짓
맨몸 Sonnet 4센트
맨몸 Haiku 1센트의 절반 아래

여기까지 반토막도 안 나다가, 일꾼을 맨몸으로 보낸 줄에서 단숨에 7센트로 떨어졌습니다. 일곱 줄 모두 30개 중 30개가 검사를 통과했고, 갈린 지점은 하나, 한 번에 얼마나 싣고 그걸 몇 번 다시 싣느냐였습니다.

비용이 갈리는 구조

모델에게 가는 요청 한 번은 이 순서로 이어 붙습니다. 맨 앞에 도구 정의, 그다음 시스템 프롬프트와 CLAUDE.md 같은 설정, 지금까지 대화, 맨 끝에 새 질문입니다. 캐시는 앞부분이 글자 하나까지 같을 때만 읽기로 처리되고, 앞쪽이 조금만 달라져도 그 뒤는 전부 새로 써야 합니다.

기본 호출은 이 띠가 5만 토큰이 넘지만, 맨몸 호출은 질문과 한 줄 지시가 거의 전부입니다. 에이전트 방식은 턴이 하나 늘 때마다 띠가 길어지고, 그 긴 띠를 처음부터 다시 보냅니다. 11턴이면 같은 앞부분을 11번 보내는 셈입니다. 파이썬 루프는 이 고리를 끊습니다. 검사와 기억은 파이썬이 맡고, 모델에는 짧은 띠를 한 번만 보내며, 다음에는 남은 일만 추려 다시 짧은 띠로 보냅니다.

비용 공식은 이렇게 쓸 수 있습니다.

  • 한 번에 싣는 양 × 다시 싣는 횟수 × 모델 단가

실험은 이 셋을 하나씩 깎아낸 것입니다.

내 작업에 옮기는 17단계

순서는 체크 함수에 통과 기준을 코드로 적고, 일꾼 호출은 도구와 기본 시스템 프롬프트를 끈 맨몸으로 보내고, 모델은 Haiku부터 시작해 통과율이 낮으면 한 단계씩 올리고, 떨어진 것만 이유와 함께 새 호출에 넣는 구조입니다. 시작 전에 루프로 바꿀 일인지부터 따집니다.

준비물은 Python 3, 설치하고 로그인한 Claude Code CLI, 자동화하고 싶은 자주 반복하는 일 하나(예: 제목 10개 뽑기)입니다. 구독으로 쓰면 사용량 한도에서 빠지고, API로 쓰면 정가대로 청구됩니다.

1. 루프로 바꿀 일인지 따져 보기 (1~4단계)

1단계. 바꾸려는 일의 "할 일이 정해져 있는지" 확인합니다. 머릿속 판단입니다. 확인: 무엇을 해야 할지부터 찾아야 하는 일이면 이 방식이 맞지 않습니다.

2단계. 바꾸려는 일의 "합격 기준을 코드로 쓸 수 있는지" 확인합니다. 확인: 글자 수나 형식처럼 코드로 평가되는 기준이 하나 이상 적힙니다.

3단계. 바꾸려는 일이 "자주 반복하는지" 확인합니다. 확인: 1~3단계가 모두 맞으면 루프로 바꿀 후보입니다.

4단계. 파일 여러 곳을 뒤져야 하는 일인지 확인합니다. 대안: 그렇다면 지금처럼 에이전트에게 맡기는 게 맞습니다. 확인: 해당하면 이 절차를 여기서 멈춥니다.

2. 합격 기준을 코드로 적기 (5~6단계)

5단계. 체크 함수에 통과 기준을 코드로 적습니다. 확인: 합격 여부를 AI에게 묻지 않고 코드가 정합니다.

6단계. 코드가 맞은 것과 떨어진 것을 가르게 합니다. 확인: 떨어진 것만 다시 시킬 수 있게 목록이 나뉩니다.

3. 일꾼을 맨몸으로 호출하기 (7~10단계)

7단계. 일꾼 호출에서 도구를 끕니다. 확인: 일꾼이 파일을 열거나 명령을 돌리지 않습니다. 주의: 도구만 끄면 비용이 들쭉날쭉했으니, 다음 단계까지 같이 합니다.

8단계. 일꾼 호출에서 기본 시스템 프롬프트를 한 줄짜리 지시로 바꿉니다. 확인: 기본 짐 대신 한 줄짜리 지시만 갑니다.

9단계. 일꾼 호출에서 설정 파일(CLAUDE.md 등)을 읽지 않게 합니다. 확인: CLAUDE.md 규칙을 일꾼이 따르지 않습니다.

10단계. 꼭 필요한 규칙만 질문에 직접 적어 넣습니다. 실험에서는 규칙 다섯 줄이었습니다. 확인: 규칙이 질문 안에 들어 있습니다.

호출 옵션의 모양은 아래와 같습니다. …는 질문 자리 표시입니다.

명령어
claude -p … --tools "" --system-prompt "한 줄" --setting-sources "" --strict-mcp-config

각 옵션은 클로드 코드 공식 CLI 문서(2026년 10월 기준)에 있는 것입니다. --tools ""는 내장 도구를 모두 끄고, --system-prompt는 기본 시스템 프롬프트를 통째로 바꾸고, --setting-sources는 불러올 설정 범위를 정하고, --strict-mcp-config는 지정한 것 말고 다른 MCP 설정을 무시합니다. 버전에 따라 빈 값이 받아들여지는 방식이 다를 수 있으니 한 건으로 먼저 시험하고 claude --help로 확인합니다. 설정 파일, 스킬, 플러그인, MCP, 자동 메모리를 한꺼번에 건너뛰는 --bare 옵션도 있지만, 이 모드는 구독 로그인을 쓰지 않아서 ANTHROPIC_API_KEY가 필요합니다.

파이썬에서 부르는 뼈대는 아래처럼 쓸 수 있습니다. 모델 이름과 규칙은 내 작업에 맞게 바꾸고, 먼저 한두 건으로 시험합니다.

프롬프트
import json, subprocess

def worker(prompt, model="haiku"):
    out = subprocess.run(
        ["claude", "-p", prompt, "--model", model,
         "--tools", "", "--system-prompt", "시키는 일만 한다.",
         "--setting-sources", "", "--strict-mcp-config",
         "--output-format", "json"],
        capture_output=True, text=True, check=True).stdout
    data = json.loads(out)
    return data["result"], data.get("total_cost_usd", 0)

def check(item):          # 합격 기준을 코드로 적는 자리
    return len(item) <= 50

todo, done, cost = ["제목 후보를 써 줘"], [], 0
for _ in range(3):        # 최대 3번까지만 다시 시킨다
    failed = []
    for task in todo:
        text, c = worker(task)
        cost += c
        if check(text):
            done.append(text)
        else:             # 통과한 것은 done에 두고, 떨어진 것만 이유와 함께 다시 보낸다
            failed.append(task + " (앞선 답이 50자를 넘었으니 50자 이하로)")
    todo = failed
    if not todo:
        break
print(done, cost)

4. 모델을 싼 것부터 쓰기 (11~13단계)

11단계. 모델을 Haiku로 정합니다. 확인: 이 실험에서 Haiku는 한 번 호출에 10개가 전부 통과했습니다.

12단계. 통과율이 낮은지 확인합니다. 확인: 통과율이 낮으면 다음 단계로 갑니다.

13단계. 통과율이 낮으면 모델을 한 단계 올립니다. 모델은 Haiku(가장 쌈), Sonnet, Opus(가장 비쌈) 순입니다. 확인: 올린 모델로 다시 돌려 통과율이 오르는지 봅니다.

5. 떨어진 것만 새 호출로 보내기 (14~15단계)

14단계. 첫 호출에서 통과한 결과를 파이썬이 따로 적어 둡니다. 확인: 통과한 것이 파일이나 변수에 저장돼 있습니다.

15단계. 떨어진 것과 떨어진 이유만 새 호출에 넣습니다. 주의: 첫 번째 대화를 이어 붙이지 않습니다. 확인: 새 호출이 작은 짐으로 시작합니다.

6. 사람이 확인하기 (16~17단계)

16단계. AI가 쓴 숫자와 사실을 사람이 직접 확인합니다. 확인: 브리프에 없는 숫자가 글에 들어 있는지 봅니다. 실험에서 Haiku판 썸네일 문구에 "비용이 세 배"라는 숫자가 박혀 있었고, 비싼 Opus판에서도 같은 숫자가 나왔습니다.

17단계. 최종 선택은 사람이 직접 합니다. 확인: 마지막 제목은 직접 고릅니다.

마무리 체크리스트

  • 합격 기준이 코드로 적혀 있다. AI에게 "검사해 봐"라고 하지 않는다.
  • 일꾼 호출은 도구, 기본 시스템 프롬프트, 설정 파일 없이 맨몸이다.
  • 실패한 것만 이유와 함께 새 호출로 보낸다.
  • 쓰기는 싼 모델부터 시작한다. 사실 확인과 최종 선택은 사람(또는 비싼 모델)이 한다.
  • 같은 일을 몇 번 돌려 평균을 본다. 실험에서는 판마다 3번 돌렸습니다.

막히기 쉬운 곳

  • 평가를 코드로 바꿨는데 비용이 별로 안 줄었다: 일꾼이 무거운 기본 짐을 지고 CLAUDE.md 규칙대로 스스로 검사를 돌려 11턴을 돌았기 때문입니다. 일꾼 자체를 맨몸으로 만듭니다.
  • 도구만 껐더니 비용이 들쭉날쭉하다: 기본 시스템 프롬프트와 CLAUDE.md를 거의 매번 캐시에 새로 쓰고, 캐시 쓰기는 일반 입력보다 비싸기 때문입니다. 도구뿐 아니라 시스템 프롬프트와 설정 파일도 뺍니다.
  • CLAUDE.md만 줄였는데 비용이 거의 안 줄었다: 턴 수가 오히려 늘어 아낀 걸 거의 도로 썼기 때문입니다. 짐 무게보다 오가는 횟수를 줄입니다.
  • 통과했는데 글에 이상한 숫자가 있다: 검사가 글자 수와 형식만 보기 때문입니다. 사람이 사실을 확인합니다.

한계와 주의

  • 검사는 글자 수와 형식만 봅니다. 모델이 싸든 비싸든 AI가 쓴 숫자는 그대로 믿으면 안 되고, 사실 확인과 최종 선택은 사람이 합니다. 브리프에 없는 숫자를 지어낸 제목이 Opus, Sonnet, Haiku 판 모두에서 나왔습니다.
  • 모든 일을 루프로 바꿀 수는 없습니다. 무엇을 해야 할지부터 찾아야 하거나 파일 여러 곳을 뒤져야 하는 일은 지금처럼 에이전트에게 맡기는 편이 맞습니다.
  • 자동 실행에는 상한을 겁니다. --max-turns와 --max-budget-usd로 한 번에 쓰는 턴과 금액을 제한할 수 있습니다.
  • 기획부터 업로드까지처럼 여러 단계가 이어지는 작업은, 단계마다 통과 기준을 스크립트가 검사하고 어디까지 끝났는지 상태 파일 하나가 기억하게 합니다. 중간에 끊겨도 대화를 다시 읽지 않고 그 단계부터 이어 갈 수 있습니다. 루프를 지휘하는 대화까지 비싼 모델 하나가 맡고 있다면 그 부분도 줄일 여지가 남아 있습니다.

자주 묻는 질문

클로드 코드 비용을 줄이려면 CLAUDE.md부터 줄이면 되나요?

줄여 둘 만하지만 그것만으로는 크게 줄지 않았습니다. 이 사례에서 CLAUDE.md를 정리해도 비용은 약 1달러에서 93센트로 내려갔을 뿐입니다. 에이전트가 턴을 여러 번 도는 구조가 그대로면 앞 내용을 다시 싣는 횟수가 비용을 좌우하기 때문입니다.

어떤 일이 루프로 바꾸기에 맞나요?

해야 할 일이 정해져 있고, 합격 기준을 코드로 쓸 수 있고, 자주 반복하는 일입니다. 제목 후보 만들기, 정해진 형식의 요약, 분류처럼 결과를 글자 수나 형식으로 검사할 수 있는 작업이 예입니다. 코드를 여러 파일에 걸쳐 찾아 고치는 일은 에이전트에게 맡기는 편이 맞습니다.

Haiku 같은 싼 모델을 써도 품질이 괜찮은가요?

이 사례에서는 제목 10개 작성에서 Haiku도 검사를 모두 통과했습니다. 다만 검사가 보는 것은 글자 수와 형식뿐이라 사실 오류는 못 잡습니다. 싼 모델로 시작하되 통과율이 낮으면 모델을 한 단계씩 올리고, 사실 확인은 사람이 합니다.

구독으로 쓰는데도 이 방법이 도움이 되나요?

도움이 됩니다. 구독은 청구서 대신 사용량 한도에서 빠지므로, 같은 일에 드는 토큰이 줄면 한도를 덜 씁니다. 다만 --bare 모드는 구독 로그인을 쓰지 않으니, 구독으로 쓸 때는 앞의 옵션 조합을 씁니다.

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

원본 영상 보러가기 ↗