Claude Code로 돌리는 자동화가 하나둘 늘었는데 API 비용이 갑자기 늘었다면, 새 기능을 켜서가 아니라 재실행·긴 컨텍스트·모델 선택 세 가지 중 하나가 원인일 확률이 높다. 콘솔 사용량 대시보드에서 시간대별 호출량부터 확인하고, 원인을 잡기 전에 자동화 스케줄에 상한선부터 걸어두는 게 순서다.
자동화가 늘어나는 사이 조용히 벌어지는 일
자동화를 하나만 돌릴 때는 비용이 눈에 잘 안 띈다. 그런데 블로그 발행, SNS 공유, 리서치 스크립트를 각각 스케줄러에 올려두고 나면 어느 순간 청구 금액이 눈에 들어오는 시점이 온다. 문제는 그 시점에 "어떤 작업이 얼마를 썼는지"를 바로 알기 어렵다는 것이다. 스크립트는 여러 개인데 API 키는 하나로 묶어 쓰는 경우가 많아서, 늘어난 비용을 특정 자동화 하나로 좁히는 데 시간이 걸린다.
Claude Code 비용이 갑자기 느는 가장 흔한 원인은 뭘까?
가장 흔한 원인은 새 기능 추가가 아니라 스크립트 재실행이다. 스케줄러 작업이 실패했는지 확인하려고, 또는 결과물이 마음에 안 들어서 같은 프롬프트로 두세 번 다시 돌리면 토큰 비용도 그대로 두세 배가 된다. 여기에 다음 두 가지가 겹치면 체감 증가폭이 커진다.
- 매번 같은 긴 컨텍스트(운영 원칙 문서, 이전 대화 전체)를 새로 붙여 보내는 경우
- 단순 반복 작업에도 가장 비싼 모델을 기본값으로 쓰는 경우
비용이 새는 세 가지 지점
원인을 구조로 보면 다음과 같다.
- 재실행 결과 확인: 디버깅 목적으로 같은 요청을 반복 / 로그에 같은 타임스탬프대 요청이 여러 건
- 컨텍스트 길이: 매 호출마다 긴 문서·이전 대화를 통째로 재전송 / 요청 하나의 입력 토큰이 유독 큼
- 모델 선택: 단순 분류·요약에도 상위 모델을 기본 사용 / 작업 난이도 대비 응답 품질이 과한 편
자동화 스케줄러에 비용 상한선을 어떻게 걸어야 할까?
가장 간단한 방법은 스크립트 단에 최대 토큰 수와 타임아웃을 명시적으로 지정해두는 것이다. 상한을 코드에 박아두면 프롬프트가 의도치 않게 길어지거나 무한 루프에 가까운 재시도가 걸려도 비용이 한도 밖으로 튀지 않는다.
여러 채널의 자동화를 운영하다 보면, "종료 코드 0을 받았는데 산출물이 안 보여서 다시 돌려본다"는 패턴이 특히 비용을 키운다. 재실행 자체가 나쁜 게 아니라, 확인 목적의 재실행과 실패 복구용 재실행을 구분하지 않고 습관적으로 다시 돌리는 게 문제다. 스크립트가 성공 여부를 로그나 상태 파일로 남기게 해두면, 재실행 전에 "정말 실패했는지"부터 파일로 확인할 수 있어 불필요한 재호출이 줄어든다.
단계별 점검 방법
- 콘솔 사용량 대시보드에서 최근 7일 호출량과 토큰 수를 날짜·시간대별로 확인한다.
- 호출량이 튄 시간대와 스케줄러 작업 실행 시각을 대조해 어떤 자동화인지 좁힌다.
- 해당 스크립트의 입력 프롬프트 길이를 확인한다 — 매번 같은 긴 문서를 새로 붙이고 있다면 반복되는 부분만 캐싱하거나 요약본으로 교체한다.
- 작업 난이도별로 모델을 나눈다. 단순 분류·요약·짧은 변환은 가벼운 모델로, 판단이 필요한 작업만 상위 모델로 보낸다.
- 스크립트에
max_tokens와 타임아웃을 명시하고, 실패·성공을 상태 파일이나 로그로 남겨 "확인용 재실행"을 없앤다. - 일정 금액을 넘으면 알림이 오도록 콘솔 사용량 알림을 걸어둔다.
주의사항
- 모델을 무조건 저가형으로 바꾸면 품질이 떨어져 결과를 다시 만들어야 하는 재작업 비용이 더 커질 수 있다. 작업 난이도에 맞춰 나누는 게 핵심이다.
- 프롬프트 캐싱은 매번 완전히 다른 내용을 보내는 작업에는 효과가 없다. 반복되는 고정 부분(시스템 프롬프트, 운영 원칙 문서 등)이 있는 자동화에만 유효하다.
- 상한선을 너무 낮게 걸면 작업이 중간에 잘려 오히려 재시도가 늘어난다. 실제 작업에 필요한 토큰 수를 먼저 가늠하고 여유를 조금 둔다.
체크리스트
1) 콘솔 사용량 대시보드 - 최근 7일 시간대별 호출량 확인
2) 스케줄러 작업 실행 시각과 호출량 급증 시간대 대조
3) 각 스크립트의 입력 프롬프트 길이(반복되는 고정 문서 유무) 점검
4) 작업 난이도별 모델 배정 확인 (단순 작업에 상위 모델 쓰고 있지 않은지)
5) max_tokens·타임아웃 명시 여부 확인
6) 성공/실패를 상태 파일·로그로 남기고 있는지 확인 (확인용 재실행 방지)
7) 사용량 알림 임계값 설정 여부 확인
요약하면, Claude Code 자동화 비용이 갑자기 늘었을 때는 새 기능보다 재실행·긴 컨텍스트·모델 선택 세 가지를 먼저 의심하고, 콘솔 사용량 대시보드로 시간대를 좁힌 뒤 스크립트에 상한선과 상태 기록을 넣는 순서로 접근하면 된다.
[FAQ 형태 질문 소제목]
- Claude Code 비용이 갑자기 느는 가장 흔한 원인은 뭘까?
- 자동화 스케줄러에 비용 상한선을 어떻게 걸어야 할까?
이 글은 《나는 AI를 마케팅팀장으로 앉혔다》(PDF 전자책, 520쪽)의 본문을 바탕으로 만들었습니다. 작은 회사가 AI에게 마케팅 일을 나눠 맡기며 겪은 과정을 정리한 책입니다. AI가 초안을 만들어도 어떤 고객에게 무엇을 제안할지는 여전히 사람이 판단해야 한다는 점도 함께 적었습니다.이 책은 이 블로그 운영자가 직접 쓴 책입니다.
- 책 구매: 《나는 AI를 마케팅팀장으로 앉혔다》 구매 페이지 링크
