본문으로 건너뛰기

© 2026 Molayo

Dev.to헤드라인2026. 05. 30. 16:30

Anthropic의 Agent SDK 과금 분리까지 16일 남았습니다: 기업 팀이 지금 해야 할 일

요약

Anthropic이 6월 15일부터 Claude Code의 헤드리스 호출(`claude -p`)을 구독 모델에서 Agent SDK 과금 방식으로 전환합니다. 기업들은 자동화 파이프라인 내 호출 패턴을 감사하고 예상 비용을 산출해야 합니다.

핵심 포인트

  • 6월 15일부터 헤드리스 호출은 호출당 비용이 발생함
  • CI/CD, cron, 배치 작업 등 자동화 워크플로우가 주요 대상
  • 대화형 세션 및 OAuth 인증 기반 사용은 기존 구독 유지
  • 기업은 즉시 자동화 스택 내 헤드리스 호출 사용량을 감사해야 함

기업 팀이 지금 무엇을 해야 할까요?

[2026-05-30] claude -p 워크플로우는 여전히 Pro 구독에 포함됨
[2026-06-15] claude -p 워크플로우는 Agent SDK 크레딧으로 과금됨
[delta] 16일. 기업의 노출 범위(exposure) 미확인.

지금으로부터 16일 후, Anthropic은 과금 스위치를 전환합니다.

Pro 및 Max 구독은 대화형(interactive) Claude Code 세션을 계속해서 지원합니다. 하지만 헤드리스 호출(claude -p, claude --print)은 Agent SDK 과금 방식으로 이동합니다. 구독이 아닌 호출당 비용(Per-call cost)이 적용됩니다.

프로덕션 환경에서 Claude Code를 실행 중인 대부분의 기업 팀은 최소 하나 이상의 cron, 야간 배치(nightly batch), 또는 프리커밋(pre-commit) 파이프라인에서 claude를 헤드리스로 호출하고 있습니다. 대부분은 아직 감사를 수행하지 않았습니다.

이 글은 기업의 CTO와 자동화 책임자(Heads of Automation)들이 향후 16일 동안 반드시 읽어야 할 내용입니다.

실제로 무엇이 중단되는가

6월 15일에 다섯 가지 워크플로우 패턴이 "구독 포함"에서 "호출당 과금"으로 전환됩니다.

어제의 티켓을 요약하는 야간 자동화. cron이 프롬프트와 함께 claude를 호출합니다. 현재는 무료이지만, 분리 이후에는 호출당 비용이 발생합니다.

스테이징된 diff(차이점)에 대해 claude를 실행하는 프리커밋 훅(pre-commit hook). 동일한 패턴입니다.

입력 큐(queue)를 통해 claude를 실행하는 예약된 보고서 생성기. 동일한 패턴입니다.

PR(Pull Request)을 검토하거나 릴리스 노트(release note)를 생성하도록 claude에게 요청하는 CI 단계. 동일한 패턴입니다.

쉘 래퍼(shell wrapper)를 통해 정해진 일정에 따라 스스로 깨어나는 자율 에이전트(autonomous agent). 동일한 패턴입니다.

이들의 공통점은 claude -p 또는 claude --print 호출입니다. 대화형이 아닌, 헤드리스(headless)로 실행되는 모든 것이 해당됩니다.

중단되지 않는 것.

사람이 직접 여는 대화형 Claude Code 세션. 대화형 세션 '내부'에서 병렬 서브 에이전트(subagents)를 디스패칭하는 Agent 도구. 활성 부모 세션에서 시작된 claude agents 백그라운드 세션. 포그라운드 REPL에서 귀하의 활성 OAuth 토큰 하에 실행되는 모든 것.

차이점은 인증 경로(auth path)에 있습니다. OAuth는 대화형 사용에 대해 Pro 및 Max 구독 범위를 유지합니다. Agent SDK 크레딧은 헤드리스 작업을 담당합니다.

기업 팀이 지금 해야 할 일

지금부터 6월 15일 사이에 기업 팀이 활용할 수 있는 세 가지 패턴이 있습니다. 어떤 것도 새로운 도구를 필요로 하지 않습니다.

패턴 1. 헤드리스 (headless) 영역을 감사(Audit)하십시오. crontab, launchd plists, GitHub Actions YAML, 그리고 모든 야간 셸 래퍼(shell wrapper)에서 "claude -p" 또는 "claude --print"를 grep으로 검색하십시오. 하루당 호출 횟수를 집계하십시오. 6월 15일 이후의 예상 지출액을 추산하십시오.

제가 5월에 감사했던 기업 팀들은 자동화 스택 전반에 걸쳐 하루 평균 40회에서 200회 사이의 헤드리스 호출을 수행하고 있었습니다. Agent SDK 요율을 적용하면, 이는 환경당 하루에 12달러에서 60달러 사이의 새로운 지출로 전환됩니다.

패턴 2. LLM (Large Language Model) 이전의 작업을 claude 없이 실행되는 셸 전용 스크립트로 이동시킨 다음, 사람이 또는 포그라운드 세션 (foreground session)이 준비된 데이터를 소비하게 하십시오. cron은 데이터 수집을 담당합니다. 사람은 아침에 Claude Code를 엽니다. 포그라운드 세션이 LLM 의존적인 추론을 수행합니다.

여기에는 확실한 트레이드오프 (trade-off)가 있습니다. 야간 처리 능력을 일부 포기하는 대신, 구독 전용 과금 방식을 되찾게 됩니다.

패턴 3. 진정으로 야간 LLM 처리가 필요한 워크로드의 경우, 비용을 산정해 볼 만한 세 가지 옵션이 있습니다.

프롬프트 캐싱 (prompt caching)을 사용하여 Anthropic API로 직접 전환하십시오. 토큰당 비용을 지불하지만, 구독 제한 (subscription gating)에서 완전히 벗어날 수 있습니다.

포그라운드 세션에서 파견되는 claude agents 백그라운드 세션을 사용하십시오. 구독 권한을 상속받고 REPL 포커스 없이 실행되지만, 부모 세션이 이를 시작해야 합니다.

Agent SDK 청구서를 수용하되, 야간에 이를 사용하지 않음으로써 발생하는 인적 비용이 호출당 요율을 초과하는 워크로드에 대해서만 적용하십시오.

제가 협업하는 대부분의 팀은 패턴 1과 패턴 2를 결합하여 헤드리스 영역의 80%를 커버합니다. 패턴 3은 나머지를 처리합니다.

시장이 실제로 요구하고 있는 것

5월 마지막 주 동안, 저는 동일한 질문의 변형을 던지는 기업 팀들과 세 차례의 인바운드 상담을 진행했습니다. "7월에 우리의 Claude Code 청구서가 어떻게 나올까요?"

그들 중 누구도 감사를 수행하지 않았습니다. 누구도 자동화 프로세스에서 헤드리스 패턴을 grep으로 찾아내지 못했습니다. 그들 모두는 과금 방식이 바뀔 줄 몰랐던 워크로드를 최소 하나 이상 보유하고 있었습니다.

향후 30일 동안 시장이 필요로 하는 것은 구체적입니다. 기업 팀이 단 한 번의 엔지니어링 오후 세션만으로 실행하여, 어떤 워크플로(Workflow)가 전환되는지, 그리고 6월 15일 이후의 청구서가 어떤 모습일지 정확히 파악할 수 있는 감사(Audit) 및 마이그레이션(Migration) 프레임워크입니다.

현재 모든 논의는 바로 이 지점으로 모이고 있습니다. 단순한 도구가 아닙니다. 새로운 프레임워크도 아닙니다. 첫 번째 인보이스(Invoice)가 도착하기 전에 헤드리스(Headless) 영역을 잡아내는 진단 도구입니다.

이를 통해 최선의 결과를 얻는 방법

가장 먼저 움직이는 팀은 두 가지 이점을 얻습니다.

첫 번째 이점은 비용 통제(Cost discipline)입니다. 분리 전 감사(Pre-split audit)를 통해 자동 항법 장치처럼 돌아가고 있지만 더 이상 가치를 창출하지 못하는 워크로드를 제거할 수 있습니다. 대부분의 팀은 1년 동안 아무도 결과물을 읽지 않은 채 실행되어 온 야간 작업(Nightly job)을 최소 하나 이상 발견하게 됩니다. 그 작업은 비용 부담 없이 종료될 수 있습니다.

두 번째 이점은 아키텍처의 명확성(Architecture clarity)입니다. 이번 분리는 구독 기반의 인터랙티브(Interactive) 작업과 호출당 과금되는 헤드리스(Headless) 작업 사이의 깔끔한 분리를 강제합니다. 이 경계를 지금 문서화하는 팀은 남은 한 해 동안 더 깨끗한 내부 계약(Internal contracts)을 배포할 수 있습니다.

아무것도 하지 않는 팀은 6월 16일 인보이스에서 뜻밖의 상황을 맞이하게 됩니다. 재무 부서와의 대화는 엔지니어링 부서와의 선제적인 대화보다 훨씬 더 어렵습니다.

이 문제로 기업 고객들에게 제가 하는 일

과금 분리에 대해 저와 감사(Audit) 일정을 잡는 팀의 경우, 첫 한 시간은 그들의 자동화 스택(Automation stack)을 살펴보는 데 사용합니다. grep으로 찾고, 개수를 세고, 분류합니다. 결과물은 한 페이지짜리 히트맵(Heat map)입니다. 전환되는 워크플로, 전환되지 않는 워크플로, 그리고 6월 15일 이후의 예상 지출액이 담깁니다.

두 번째 시간은 의사 결정 시간입니다. 어떤 워크플로를 PATTERN TWO로 옮길 것인가. 어떤 것을 PATTERN THREE에 유지할 것인가. 비용 대비 효율이 더 이상 맞지 않아 어떤 것을 은퇴(Retired)시킬 것인가.

이 단계에서의 대부분의 프로젝트는 짧습니다. 감사와 마이그레이션 계획을 수립하는 데 1~2일 정도의 작업이 소요됩니다. 그 이후에는 스프린트(Sprint) 기간 동안 마이그레이션을 감독하는 과정이 남습니다.

마지막 질문

16일이라는 시간이 짧다는 것을 알고 있습니다.

저는 이전에도 기업 팀들을 대상으로 정확히 이와 같은 마이그레이션을 안내한 적이 있으며, 대개 범위를 산정하는 데 비용이 들지 않는 짧은 감사(Audit) 대화부터 시작하곤 했습니다. 첫 번째 대화를 통해 저는 귀사의 자동화 스택(Automation stack)에서 어떤 패턴이 가장 많이 나타나는지, 그리고 6월 15일 변경 사항에 얼마나 노출되어 있는지를 파악합니다.

만약 귀사가 Claude Code를 프로덕션(Production) 환경에서 실행 중이며 아직 헤드리스(Headless) 인터페이스를 감사하지 않았다면, 아래 댓글을 이용해 주세요. 현재 실행 중인 구체적인 워크플로우(Workflow) 패턴 하나를 남겨주시면 됩니다. 해당 패턴이 6월 15일에 전환되는지 여부를 확인하기 위해 보통 어떤 질문이 발생하는지 답변해 드리겠습니다.

패턴 라이브러리는 더 많은 기업 팀이 프로덕션에서 무엇을 실행하고 있는지 밝힐 때만 성장합니다.

AI 자동 생성 콘텐츠

본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
1

댓글

0