Claude Agent SDK 6/15부터 따로 청구

claude -p를 cron에 두고 야간 빌드를 돌리거나, Agent SDK로 자체 도구를 운영 중이라면 한 달 안에 청구 구조가 바뀝니다. 6월 15일부터 Claude 구독 한도와 SDK 사용량이 분리돼요. 대화형으로 쓰는 영역은 그대로지만, 스크립트로 자동 호출하는 영역은 별도 크레딧에서 빠지고 그 크레딧은 API 정가 환산입니다.

Anthropic이 5월 13일에 공식 발표했고, Help Center article 15036540에 정책 본문이 올라가 있어요. 시행일은 6월 15일, 크레딧 클레임 안내 이메일은 6월 8일 발송 예정. 한 번만 클레임하면 이후 매월 자동 갱신이에요. 양도·풀링·이월은 다 막혀 있고 per-user 1인분.

청구가 두 갈래로 분리된다

Help Center에 화이트리스트가 정확히 명시돼 있어요. 어떤 진입점으로 Claude를 호출했는지가 분기점입니다.

"

"Claude Agent SDK and claude -p usage no longer counts toward your Claude plan's usage limits. Your subscription usage limits stay the same and stay reserved for interactive use of Claude Code, Claude Cowork, and Claude."

"

— Anthropic Help Center, article 15036540

구독 한도 유지 — 대화형

터미널·IDE에서 직접 키보드로 치는 Claude Code, Claude.ai 채팅, Claude Cowork. 5월 이전과 동일하게 흘러갑니다. Anthropic의 Claude Code 책임자 Boris Cherny가 The Register 인터뷰에서 "interactive Claude Code in the terminal or your IDE continues to use your subscription usage limits exactly as before"라고 강조한 영역이에요.

$200 크레딧에서 차감 — 프로그래머틱

Agent SDK 라이브러리 직접 호출(Python·TypeScript), claude -p 비대화형 명령, Claude Code GitHub Actions 통합, Agent SDK로 구독 인증하는 3rd-party 도구(Conductor·OpenClaw·T3 Code·Zed 등).

플랜별 월 크레딧

플랜에 따라 한 달에 받는 크레딧이 10배 차이 나요.

예외 한 줄 — Enterprise Standard seat은 크레딧 클레임 자체가 불가예요. 크레딧 소진 후에는 extra usage라는 옵션이 있는데, default OFF 상태로 들어와요. 켜면 그 시점부터 API 정가로 pay-as-you-go가 흐르고, 안 켜면 SDK 요청이 그냥 정지돼요.

$200으로 무엇을 사는가 — 토큰 경제

핵심은 $200이라는 숫자가 얼마짜리 사용량을 사는가입니다. Anthropic API 정가표 기준 환산이에요. 한 회당 5만 토큰, 입력·출력 50:50 가정.

보정 요소 두 개. 프롬프트 캐싱을 잘 쓰면 실효 용량이 2~3배 확장되고, 반대로 Opus 4.7 tokenizer는 동일 텍스트에 토큰을 32~47% 더 쓴다는 BigGo·CloudZero 분석이 있어요. 실제 운영 폭은 표 절반에서 두 배 사이 어딘가입니다.

"보조가 약 25배 사라진다" — 커뮤니티 비판

발표 직후 X에서 Anthropic의 Lydia Hallie가 올린 clarification이 Community Note 정정을 받았어요. 정정된 합의 표현은 — 기존엔 claude -p 같은 프로그래머틱 사용이 보조 수준의 구독 한도에서 차감됐고, 6/15부터는 별도 $20~$200 크레딧에서 API 정가로 차감된다, 대화형은 그대로.

기존 보조 수준은 외부 보도로 추정 가능해요. The Register는 OpenClaw 사용자가 $20 Pro 플랜으로 월 약 $236 어치 API 가치를 추출하던 사례를 보도했고, Sonnet 무거운 power user는 Max 20x의 주 240~480시간 쿼터로 150~175배까지 추출이 가능했습니다. 6/15 이후엔 프로그래머틱 영역에서 사실상 1:1 환산이에요. 핵심: $200 = 약 $200 API 가치. power user 입장에서는 보조가 약 25배 줄어드는 셈입니다.

Boris Cherny는 VentureBeat 인터뷰에서 "our subscriptions weren't built for the usage patterns of these third-party tools"라며 정책 동기를 짚었어요.

그레이존 4가지 — unconfirmed

Help Center 본문에 명시되지 않은 영역이 있어요. 5월 14일 dev.to에 올라온 Väinämöinen 분석이 네 가지를 unconfirmed로 표시했습니다.

• 대화형 세션에서 Task tool로 spawn하는 sub-agent
• 대화형 세션에서 발화되는 hooks (PreToolUse·PostToolUse·SessionStart 등)
• 대화형 세션 내부 MCP tool 호출
• Scheduled·remote agents (routines) — 거의 SDK 청구로 확정 분위기

"

"Watch the help center for revisions before June 15. The hooks/subagents/MCP boundary is most likely to move."

"

— Väinämöinen, dev.to

해석 단서는 두 개. 화이트리스트가 엔트리 포인트 기반으로 명시됐다는 점, 그리고 대화형 한도가 "exactly as before" 표현으로 명시된 점. 6/15 이전 대화형 세션의 sub-agent는 구독에 묶여 있었으니 동일하게 유지된다는 게 자연스러운 읽기지만, 단정은 금물이에요 — 6월 8~15일 사이 Help Center 추가 명시 가능성이 남아 있어요.

6/15 전 액션 체크리스트

한 달 남았어요. 다섯 단계로 끊으면 사고 없이 넘어갑니다.

1. Inventory — 레포에서 claude -p, Claude Code GitHub Actions 워크플로, third-party Agent SDK 도구 사용처를 grep으로 추려요.
2. Estimate — 대표 1주일 토큰 소비량을 측정해서 4.3을 곱하면 월간 폭이 나와요. 위 토큰 경제표로 환산해서 본인 플랜 크레딧 안에 들어오는지 확인.
3. Decide — 세 갈래입니다. Cap (extra usage 켜고 월 cap 명시 → 예측 가능) / Hybrid (사람 driven 작업은 Claude, 배치·cron은 다른 모델로 라우팅) / Pure API (별도 API key로 이미 운영 중이면 영향 없음 — 크레딧은 구독 한정).
4. Extra usage 설정 — ⚠️ default OFF + cap 미지정은 가장 사고 잦은 조합이에요. 켤 거면 cap을 숫자로 지정해두는 게 안전.
5. Validate — Hybrid를 골랐다면 모델 swap이 매끄럽지 않다는 걸 기억해두면 좋아요. 프롬프트 동작·tool-call schema·실패 모드가 모델별로 달라서 시행 전 검증 사이클 한 번은 필수예요.

지금 처음 할 일

검토 단계 의사결정자라면 한 가지만 먼저 하면 돼요. 레포 안에서 `claude -p`와 Agent SDK 호출처를 grep으로 한 번 추리는 것. 한 달 뒤에 그 호출들이 어떤 크레딧 라인을 타게 되는지 봐두면, 6월 8일 클레임 이메일이 도착한 날 패닉이 안 옵니다. 대화형으로 쓰는 부분은 그대로니까 손댈 필요가 없어요. 프로그래머틱 호출만 분리해서 측정·예산화하는 한 달이라고 생각하면 됩니다.

자주 묻는 질문

내가 쓰는 Claude는 6월 15일부터 어떻게 바뀌나요?

대화형 사용(claude.ai 채팅, 터미널·IDE Claude Code, Cowork)은 구독 한도 그대로예요. claude -p와 Agent SDK 직접 호출만 6월 15일부터 별도 크레딧에서 차감됩니다.

크레딧은 어떻게 받나요?

6월 8일 안내 이메일을 받은 뒤 한 번 클레임하면 이후 매월 자동 갱신돼요. 양도·풀링·이월은 다 막혀 있고 per-user 1인분 한정입니다. 일부 Enterprise Standard seat은 예외로 클레임 불가예요.

크레딧이 소진되면 어떻게 되나요?

default OFF인 extra usage 옵션 그대로면 SDK 요청이 정지돼요. 켜면 API 정가로 pay-as-you-go가 흐르니, 켤 거면 월 cap을 숫자로 지정해두는 게 안전합니다.

API key로 따로 쓰는 사용자도 영향받나요?

API key 사용자는 영향 없어요. Claude Developer Platform pay-as-you-go 그대로입니다. 단 크레딧도 받지 않아요 — 크레딧은 구독 플랜 한정이에요.

Task tool sub-agent나 hooks는 어디로 청구되나요?

공식 화이트리스트엔 명시되지 않은 그레이존이에요. 대화형 한도가 '그대로'로 명시돼 유지될 가능성이 높지만, 6/15 전 Help Center 추가 명시 가능성이 남아 있어요.

Hybrid 라우팅이 실무에서 합리적인가요?

사람 driven 작업은 Claude, 배치·cron은 다른 모델로 나누면 보조 손실을 줄일 수 있어요. 단 프롬프트 동작·tool-call schema가 모델별로 달라서 시행 전 검증 사이클은 필수입니다.

대화형으로 우회해서 cron에 박으면 안 되나요?

TTY+tmux로 기술적으로는 가능합니다. 단 Anthropic이 차후 막을 가능성·stdout 캡처 불가 두 함정이 있어요. 임시방편이지 안정적 운영 아키텍처는 아닙니다.

작성: Bruce Choe · agenticworkflows.club