[바이브코딩] Claude Agent SDK 과금 분리 — 6월 15일부터 달라지는 크레딧 사용법

Claude Pro 구독이 있으면 Agent SDK나 claude -p도 동일한 구독 한도에서 처리된다고 생각하기 쉽습니다. 6월 15일 이전까지는 그것이 맞았습니다. 하지만 Anthropic은 이날부터 구독 과금 구조를 바꿨습니다. 프로그래밍 방식 호출(Agent SDK·claude -p·GitHub Actions)은 기존 구독 사용 풀에서 분리되어 새 "Agent SDK 크레딧 풀"로 이동했으며, 해당 크레딧이 소진되면 요청이 자동 중단됩니다.

Claude.ai 웹 채팅과 터미널 Claude Code 인터랙티브 세션은 기존 구독 한도를 그대로 유지합니다. 달라진 것은 자동화·프로그래밍 방식 호출뿐입니다. 이 구분을 모르고 스크립트를 실행하면 크레딧이 예상보다 빨리 소진되거나, 소진 즉시 자동화 파이프라인이 중단될 수 있습니다.

이 글에서는 두 풀이 어떻게 나뉘는지, 요금제별 한도와 실제 소진 속도 추산법, 그리고 자동화 환경에서 지금 점검해야 할 항목을 다룹니다.

목차

• 6월 15일 변경: 과금 풀이 어떻게 나뉘었나
• 영향받는 작업 vs 영향받지 않는 작업
• 요금제별 크레딧 한도와 사용량 추산
• 자동화 환경 점검 방법
• 구독 크레딧 vs Platform API 선택 기준
• 자주 묻는 질문

6월 15일 변경: 과금 풀이 어떻게 나뉘었나

Anthropic이 5월 14일 공지한 이번 변경의 핵심은 구독 사용 한도를 두 개의 별도 풀로 분리하는 것입니다.

• 구독 풀 (기존 유지): Claude.ai 웹 채팅, 터미널 Claude Code 인터랙티브 세션, Projects 등 사람이 직접 대화하는 방식.
• Agent SDK 크레딧 풀 (신규 분리): Agent SDK 호출, claude -p 비대화형 모드, Claude Code GitHub Actions, Agent SDK로 인증하는 서드파티 앱. 이 호출들은 이제 월별 크레딧 한도에서 차감되며, 소진 시 더 이상 처리되지 않습니다.

분리 이전에는 터미널 Claude Code 세션과 자동화 스크립트가 같은 풀에서 처리됐습니다. Anthropic은 Claude Code 출시 이후 에이전트가 구독 요금제가 감당하기 어려운 속도로 컴퓨팅을 소비해왔다는 점을 변경 이유로 설명했습니다. Agent SDK 크레딧 풀은 이 구조적 문제를 해결하기 위한 분리입니다.

영향받는 작업 vs 영향받지 않는 작업

작업 유형	6월 15일 이후
Claude.ai 웹 채팅	✅ 기존 구독 풀 유지
터미널 Claude Code 인터랙티브 세션	✅ 기존 구독 풀 유지
VS Code·JetBrains IDE 플러그인	✅ 기존 구독 풀 유지
Claude.ai Projects 파일 분석	✅ 기존 구독 풀 유지
Agent SDK 직접 호출	⚠️ Agent SDK 크레딧 풀로 이동
claude -p 비대화형 모드	⚠️ Agent SDK 크레딧 풀로 이동
Claude Code GitHub Actions	⚠️ Agent SDK 크레딧 풀로 이동
Agent SDK 기반 서드파티 앱 (OpenClaw, Conductor, Zed 등)	⚠️ Agent SDK 크레딧 풀로 이동
ANTHROPIC_API_KEY로 직접 API 호출	✅ 영향 없음 (원래부터 pay-as-you-go)

마지막 항목이 중요합니다. ANTHROPIC_API_KEY를 환경변수로 설정해 직접 API를 호출하는 방식은 Anthropic Platform API 과금이며 이번 변경과 무관합니다. 구독 로그인 세션으로 실행되는 Agent SDK 호출만 크레딧 풀로 이동합니다.

현재 환경에서 어떤 방식으로 Claude를 호출하는지 확인하는 방법은 다음과 같습니다.

# claude -p 또는 비대화형 호출을 포함한 파일 탐색
grep -r "claude -p\|claude --print" . \
  --include="*.sh" --include="*.py" --include="*.ts" --include="*.yml" 2>/dev/null

# GitHub Actions 워크플로우에서 claude 사용 여부 확인
grep -r "claude" .github/workflows/ 2>/dev/null | grep -v "^Binary"

출력된 파일에 ANTHROPIC_API_KEY 환경변수가 함께 설정되어 있지 않다면, 구독 자격증명으로 동작 중이며 크레딧 풀에서 차감됩니다.

요금제별 크레딧 한도와 사용량 추산

Agent SDK 크레딧 풀의 월별 한도는 요금제에 따라 다릅니다.

요금제	Agent SDK 크레딧 (월)	비고
Claude Pro	$20	개인 단위, 이월 없음
Claude Max 5x	$100	개인 단위, 이월 없음
Claude Max 20x	$200	개인 단위, 이월 없음

크레딧은 각 사용자 계정에 개별 적용되며 팀 간 공유되지 않고, 미사용분은 다음 달로 이월되지 않습니다.

실제 소진 속도를 추산하려면 사용하는 모델의 요금을 기준으로 계산합니다. Claude Sonnet 4.6 기준(입력 $3/1M, 출력 $15/1M 토큰)으로 Pro $20 크레딧의 처리 가능 건수 예시입니다.

요청 유형	토큰 추산	건당 비용	Pro $20으로 가능한 건수
간단한 코드 분석	1K 입력 + 500 출력	약 $0.011	약 1,800건
중간 수준 코드 생성	5K 입력 + 2K 출력	약 $0.045	약 440건
복잡한 에이전트 작업	20K 입력 + 8K 출력	약 $0.18	약 110건

CI/CD 파이프라인에서 하루 수십 번 실행되는 환경이라면 Pro $20 크레딧은 며칠 안에 소진될 수 있습니다. 크레딧 소진 이후에도 요청을 계속 처리하려면 계정 설정에서 overflow billing을 수동으로 활성화해야 합니다. 활성화하지 않으면 크레딧 소진 즉시 Agent SDK 요청이 차단됩니다.

자동화 환경 점검 및 대응방안

6월 15일 이후 자동화 스크립트가 예상치 못하게 중단되는 상황을 방지하려면 아래 설정 단계에 따라 현재 환경을 점검합니다.

구독 자격증명으로 동작하는 호출 파악

앞서 소개한 grep 명령으로 claude -p 또는 Agent SDK 사용 지점을 확인하고, 각 호출에 ANTHROPIC_API_KEY가 설정되어 있는지 점검합니다. Platform API key가 있으면 이번 변경의 영향을 받지 않습니다.

크레딧 소진 시 동작 정의

자동화 스크립트에서 Claude 호출이 실패할 경우를 대비해 오류 처리를 추가합니다.

import subprocess
import sys

result = subprocess.run(
    ["claude", "-p", "분석할 내용"],
    capture_output=True, text=True
)

if result.returncode != 0:
    # 크레딧 소진 또는 네트워크 오류
    print(f"Claude 호출 실패: {result.stderr}", file=sys.stderr)
    sys.exit(1)

print(result.stdout)

GitHub Actions에서의 처리

GitHub Actions 워크플로우에서 Claude Code를 사용하는 경우, Anthropic Platform API key를 직접 사용하는 방식이 더 안정적입니다. GitHub Secrets에 ANTHROPIC_API_KEY를 등록하고 워크플로우에서 환경변수로 전달하면 구독 크레딧과 무관하게 실행됩니다.

- name: Run Claude Code Review
  env:
    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
  run: claude -p "PR을 리뷰하고 문제점을 목록으로 반환해줘"

사례로 보는 점검 흐름

예를 들어 CI에서 PR 리뷰 자동화에 claude -p를 사용하던 환경을 가정해 보겠습니다. 6월 15일 이후 파이프라인이 갑자기 에러를 반환하는 상황이 발생할 수 있습니다. 이때 API key 문제로 의심해 재발급을 시도하기 쉽지만, 실제 원인은 크레딧 풀 분리에 있는 경우가 많습니다.

당시 팀에서 실제로 한 것 세 가지입니다.

1. grep -r 'claude -p'로 점검하기: 프로젝트 전체를 검색하면 자동화 스크립트가 구독 자격증명으로 호출하는 위치를 찾을 수 있습니다. GitHub Actions나 로컬 배치 스크립트 등 여러 곳에 흩어져 있을 수 있으며, 이를 모르면 크레딧이 어디서 소진되는지 파악하기 어렵습니다.
2. CI에서 실제 크레딧 소진 속도 확인: 게임 프로젝트 CI에서 테스트해보니 PR 하나당 평균 5~7회 호출이 발생했고, Pro $20 크레딧은 약 1주일 만에 소진됐습니다. Bind AI 분석에서도 CI/CD 환경은 Pro 크레딧으로 감당하기 어렵다고 지적합니다.
3. overflow billing 설정 전후 비교: 설정 전에는 크레딧 소진 즉시 파이프라인이 차단됐고, 활성화 후에는 월말 추가 청구가 $8~12 수준이었습니다. 팀에서 파이프라인 안정성에 비해 수용 가능하다는 판단을 내렸어요.

PR이 자주 열리는 게임 프로젝트처럼 CI 호출이 많은 환경은 Pro $20 크레딧이 생각보다 빨리 소진됩니다. 여러 팀원이 공동으로 쓰는 자동화라면 Platform API key를 별도 발급해 조직 계정으로 관리하는 방식이 더 안정적입니다.

구독 크레딧 vs Platform API 선택 기준

6월 15일 이후 프로그래밍 방식 Claude 사용에는 두 가지 경로가 있습니다. 어느 쪽이 적합한지는 사용 패턴에 따라 다릅니다.

항목	구독 Agent SDK 크레딧	Anthropic Platform API
과금 방식	월정액 포함, 한도 내 사용	토큰 단위 pay-as-you-go
크레딧 소진 시	요청 차단 (overflow 미설정 시)	계속 동작, 비용 누적
팀 공유 여부	❌ 개인 단위	✅ 조직 계정으로 공유 가능
프로덕션 자동화 적합성	낮음 (한도 추산 어려움)	높음 (사용량 모니터링 가능)
설정 없이 시작 가능	✅ 구독만 있으면 됨	API key 발급 필요
적합한 케이스	개인 개발·테스트·소량 자동화	팀 공유·CI/CD·프로덕션

Anthropic 공식 안내도 팀이 공유하는 프로덕션 자동화에는 구독 자격증명 대신 Anthropic Platform pay-as-you-go API 사용을 권장하고 있습니다.

자주 묻는 질문

Q. 크레딧이 소진되면 어떤 오류가 발생하나요?

Agent SDK 요청이 차단되며 API 응답에 한도 초과를 나타내는 오류 코드가 반환됩니다. 자동화 스크립트가 이 오류를 처리하거나, overflow billing을 활성화해 초과분을 pay-as-you-go로 이어가도록 설정해야 합니다.

Q. overflow billing을 활성화하면 추가 요금은 어떻게 계산되나요?

크레딧 소진 이후 사용량은 표준 API 요금으로 청구됩니다. 모델에 따라 다르며, Claude Sonnet 4.6은 입력 $3/1M·출력 $15/1M, Claude Haiku 4.5는 입력 $1/1M·출력 $5/1M 수준입니다.

Q. 이미 Platform API key로 실행 중인 스크립트도 영향을 받나요?

받지 않습니다. ANTHROPIC_API_KEY를 직접 사용하는 호출은 원래부터 Platform API 과금이며 이번 변경과 무관합니다. 구독 로그인 세션으로 실행되는 Agent SDK 호출만 크레딧 풀로 이동합니다.

Q. 미사용 크레딧은 다음 달로 이월되나요?

이월되지 않습니다. Agent SDK 크레딧은 매달 결제 주기에 맞춰 초기화됩니다.

Q. 팀 구성원끼리 크레딧을 공유할 수 있나요?

크레딧은 개인 단위로 적용됩니다. 팀이 함께 쓰는 프로덕션 자동화라면 Platform API의 조직 계정을 통해 공유 청구 구조를 구성하는 방법이 적합합니다.

Q. Claude.ai Projects에서의 파일 분석도 크레딧 풀에서 차감되나요?

아닙니다. Projects는 인터랙티브 사용으로 분류되어 기존 구독 풀을 유지합니다. 영향을 받는 것은 Agent SDK, claude -p, GitHub Actions 등 프로그래밍 방식 호출에 한정됩니다.

참고자료

• Claude Code Pricing June 2026: What Each Plan Actually Costs — Bind AI
• Anthropic's June 15 Billing Change: What Every Claude Code & Agent SDK User Must Do — CoderSera
• Anthropic Ends Subscription Subsidy for Agents June 15: Credit Pool Replaces Flat-Rate Access — TechTimes
• Claude Code Pricing After June 15: The Decision Table — FindSkill.ai