한 달 사이 분리 예고에서 철회까지
Anthropic은 5월 14일, 6월 15일부터 Claude Agent SDK와 claude -p 헤드리스 실행, GitHub Actions, 서드파티 앱의 구독 경유 사용을 별도 월 크레딧으로 떼어 낸다고 공지했습니다. 기준선은 명확했습니다. 사람이 직접 입력하면 종전 구독 한도에서 차감하고, 코드가 스스로 호출하면 Pro $20·Max 5x $100·Max 20x $200의 크레딧에서 빼는 방식이었습니다. 그런데 시행일인 6월 15일 당일 이 분리안은 보류·철회됐고, 현재는 자동화 호출도 종전대로 구독 한도에서 차감되며 수정안이 준비 중입니다.
철회로 끝났어도 리스크는 남는다
과금 모델이 원위치됐다고 안심할 일은 아닙니다. 한 달 사이 예고와 철회가 오간 이 사건은 구독 기반 자동화의 과금 구조가 언제든 바뀔 수 있다는 사실을 그대로 보여 줍니다. cron 에이전트와 CI 훅에 구독 인증을 하드코딩해 둔 팀은, 다음 수정안이 발표되는 순간 자기 자동화가 구독 한도 안에 있는지 크레딧 밖으로 밀려나는지조차 즉시 계산하지 못합니다. 지반이 흔들릴 때 버티는 힘은 요금제가 아니라 계측·폴백·상한이라는 세 가지 준비에서 나옵니다.
계측·폴백·상한, 세 가지를 먼저 심는다
세트의 첫째는 사용량 계측입니다. 자동화 경로별로 호출량과 추정 API 환산 비용을 남겨 두지 않으면, 요금제가 바뀌었을 때 영향 산정 자체가 불가능합니다. 둘째는 API 폴백으로, 구독 인증이 막히거나 크레딧이 소진돼도 API 키 경로로 무중단 전환할 수 있어야 합니다. 셋째는 비용 상한이며, 월 예산 임계에서 자동으로 알림이 울리고 한도를 넘기면 호출을 끊는 안전장치가 필요합니다.
48시간 대응 런북: 계측에서 전환 결정까지
(a) 기획·목표 수치: 세 가지를 먼저 숫자로 못 박습니다. 자동화 경로별 호출량은 100% 로깅하고, 구독에서 API 키 경로로의 전환 리허설 소요 시간은 30분 이내, 월 비용 상한 알림은 예산의 80%·100% 두 지점에서 발동, 요금 변경 공지부터 전환 결정까지의 대응 완료 시간은 48시간 이내를 출발선으로 둡니다. 이 네 숫자가 없으면 "지켜보자"는 판단이 곧 지연이 됩니다.
(b) 실패 패턴: 6월 15일 예고가 그대로 시행됐다면 곧장 터졌을 세 가지 구멍이 있습니다. 첫째는 cron 에이전트·CI 훅에 구독 인증만 하드코딩해 둔 구조 — 자동 호출이 크레딧으로 밀려나는 순간 인증 방식을 통째로 갈아야 합니다. 둘째는 자동화 호출량을 아예 계측하지 않아, Pro·Max 5x·Max 20x 어느 등급의 크레딧으로도 감당되는지 산정할 근거가 없는 경우입니다. 셋째는 API 키 전환을 문서로만 적어 두고 한 번도 돌려 본 적 없는 상태로, 실제 전환 시점에 환경 변수·레이트리밋·응답 포맷 차이에서 막힙니다.
(b') 복구 분기: 크레딧 소진이나 인증 거부가 감지되면 사람 승인을 기다리지 않고 API 키 경로로 자동 폴백하도록 설계합니다. 폴백을 코드 재배포가 아니라 인증 소스 스위치 하나로 구현해야 전환이 분 단위로 묶이고, 폴백이 발동한 경로와 그때의 호출량·환산 비용을 자동으로 적재해 다음 요금제 판단의 근거로 씁니다.
(c) 운영 체크리스트: 배포 전에 구독 인증을 끊은 상태에서 헤드리스 claude -p 작업이 API 키로 정상 완주하는지 시나리오 테스트를 돌립니다. 로그에는 자동화 경로 ID, 인증 소스(구독/API), 호출 건수, 토큰, 추정 환산 비용, 상한 알림 발동 여부를 필수 필드로 남겨야 요금 공지가 떴을 때 같은 대시보드에서 영향 범위를 즉시 읽을 수 있습니다. 시크릿은 구독 세션 토큰과 API 키를 분리 보관하고, 둘 다 마스킹 처리합니다.
(d) 지속 개선 루프: 벤더 요금 변경 공지는 예외가 아니라 정기 이벤트로 취급합니다. 공지→영향 산정→전환 결정의 48시간 런북을 분기마다 한 번은 리허설로 돌려 실제 소요 시간을 재고, 폴백 전환 시간이 목표 30분을 넘기면 그 병목을 개선 항목으로 등록합니다. 이번처럼 예고가 철회된 경우에도 리허설에서 얻은 호출량·환산 비용 데이터는 다음 수정안이 나왔을 때 그대로 판단 근거가 됩니다.
바로 쓰는 대응 포인트
6월 15일의 분리 예고와 당일 철회가 남긴 교훈은 요금제를 예측하려 들지 말고 지반을 갖추라는 것입니다. 경로별 호출량을 100% 계측하고, 구독에서 API 키로 30분 안에 무중단 전환하는 폴백을 리허설로 검증하며, 예산 80%·100%에서 상한 알림을 걸어 두면, 다음 수정안이 어떤 방향으로 나오든 48시간 안에 영향을 산정하고 전환을 결정할 수 있습니다.
참고 링크
Use the Claude Agent SDK with your Claude plan — Claude Help Center
What Anthropic's New Claude Billing Means for Zed Users — Zed's Blog