Claude Code Agent SDK 과금 분리와 자동화 비용 운영

구독 안의 대화형 사용, 별도로 계산되는 자동화

Anthropic이 2026년 5월 14일 발표한 Claude Code 과금 구조 변경은 6월 15일부터 적용된다. 핵심은 가격표의 조정이 아니라 사용 방식에 따라 과금 경로를 나누는 데 있다. 사람이 직접 다루는 Claude와 자동화 워크플로우에서 호출되는 Claude가 더 이상 같은 한도를 공유하지 않는다.

Claude.ai 웹 채팅, Claude Code 터미널 세션, Claude Cowork처럼 사람이 직접 상호작용하는 사용은 대화형 채널로 분류된다. 이 사용량은 기존 Pro와 Max 구독의 사용 제한 안에서 처리된다.

반면 Agent SDK 호출, claude -p 명령, Claude Code GitHub Actions, Agent SDK 기반 서드파티 앱은 프로그래매틱 채널에 속한다. Agent SDK 인증 흐름이 감지되면 요청 출처와 인증 경로에 따라 자동화 요청으로 라우팅된다.

⤢✕

플랜과 함께 배정되는 Agent SDK 크레딧

프로그래매틱 사용에 쓰이는 크레딧은 플랜의 월 구독료에 상응하는 달러 금액으로 책정된다.

플랜	월 구독료	Agent SDK 월 크레딧
Pro	$20	$20
Max 5x	$100	$100
Max 20x	$200	$200

크레딧은 사용자별로 할당되며 팀 단위로 합칠 수 없다. 매월 청구 주기에 맞춰 초기화되고 남은 금액도 다음 달로 넘어가지 않는다.

잔액이 모두 소진된 뒤에도 자동화 요청을 계속 처리하려면 Extra Usage를 명시적으로 활성화해야 한다. 활성화한 이후의 초과분은 표준 API 요금으로 청구된다. 이 옵션이 꺼져 있으면 요청이 차단되고 오류가 반환된다.

계정에는 결과적으로 서로 독립된 사용량 버킷이 생긴다. 대화형 버킷은 기존의 사용 제한을 따르고, 에이전트 버킷은 달러 단위 크레딧을 차감한다. Agent SDK 크레딧이 바닥나더라도 대화형 Claude 사용이 함께 중단되지는 않는다.

토큰이 크레딧으로 바뀌는 경로

Agent SDK 크레딧 풀은 표준 API 요금표를 기준으로 미터링된다.

Claude Sonnet 4.6: 입력 토큰 $3/백만, 출력 토큰 $15/백만
Claude Opus 4.7: 입력 토큰 $5/백만, 출력 토큰 $25/백만
컨텍스트 캐싱: 캐시 쓰기 비용은 별도로 가산되며 캐시 히트에는 할인이 적용된다

요청이 들어오면 인증 유형을 판별하고 채널을 선택한 뒤 토큰을 집계해 크레딧에서 차감한다. 잔액은 실시간으로 갱신되며 소진이 가까워지면 알림이 발송된다.

코드 리뷰 자동화 비용을 계산해 보면

Pro 플랜의 $20 크레딧으로 Claude Sonnet 4.6 코드 리뷰 파이프라인을 운영한다고 가정한다. 코드 리뷰 1회에 평균 입력 5,000토큰과 출력 1,500토큰을 사용하면 비용은 다음과 같다.

입력 비용: 5,000 × $3/1,000,000 = $0.015
출력 비용: 1,500 × $15/1,000,000 = $0.0225
1회 리뷰 비용: 약 $0.0375

이 조건에서는 월 $20 크레딧으로 약 533회의 코드 리뷰를 처리할 수 있다. 영업일을 월 22일로 두면 하루 약 24회의 자동 리뷰에 해당한다. 이보다 많은 리뷰가 지속되는 팀은 Max 5x 플랜의 $100 크레딧이나 Extra Usage 활성화를 검토해야 한다.

일부 분석은 특정 헤비유저 워크로드에서 종전 구독 방식보다 실효 가격이 12배에서 175배까지 높아질 수 있다고 본다. Max 플랜의 사실상 무제한 프로그래매틱 사용을 전제로 자동화 파이프라인을 구성했다면 영향을 크게 받을 수 있는 구조다.

⤢✕

Codex 경쟁 속에서 늘어난 대화형 한도

OpenAI가 Codex 에이전트를 내놓으면서 AI 코딩 도구 시장의 비용 경쟁도 거세졌다. Codex는 동등한 작업에서 최대 4.2배 적은 토큰을 소비한다는 점을 비용 효율성의 근거로 내세웠다.

Anthropic은 Claude Code의 대화형 주간 사용 한도를 7월 13일 오후 6시(PDT)까지 50% 높였다. Pro, Max, Team, Enterprise 유료 플랜이 적용 대상이며 무료 플랜은 제외된다. 이 조치는 Agent SDK 크레딧 변경과 별도로 운영되므로 프로그래매틱 사용량에는 적용되지 않는다.

한도 확대의 배경에는 Anthropic과 SpaceX의 컴퓨트 계약이 있다. Colossus 1 데이터센터에 300메가와트 이상의 전력과 220,000개 이상의 NVIDIA GPU가 투입되면서 Anthropic의 서빙 용량도 확대됐다.

Claude Code와 Codex의 비용 구조 차이

Anthropic은 대화형 사용을 구독에 남겨 두고 자동화에 크레딧과 종량제를 결합했다. OpenAI Codex는 API 사용량에 비례하는 과금 방식을 중심에 둔다.

구분	Anthropic Claude Code	OpenAI Codex
기본 접근 방식	구독 + 크레딧 하이브리드	API 종량제 기반
대화형 사용	Pro/Max 한도 내 포함	별도 과금
자동화/에이전트	크레딧 풀 + 초과 종량제	순수 토큰 과금
예측 가능성	월정 크레딧 상한선 존재	사용량 완전 비례
캐싱 지원	프롬프트 캐싱으로 반복 비용 절감	유사한 캐싱 메커니즘

Claude Code의 구조는 개발자가 직접 사용하는 대화형 환경을 구독으로 유지하면서, 자동화 비용은 실제 사용량에 연결한다. 구독 한도만으로 비선형적으로 증가하는 자동화 워크로드를 수용하기 어려운 문제를 하이브리드 과금으로 다룬 셈이다.

이 변화는 IT 서비스 과금 관점에서도 읽을 수 있다. 에이전트 자동화에는 사용량 기반 과금의 “사용한 만큼 지불(Pay-as-you-go)” 원칙이 적용되고, Pro·Max·Team·Enterprise에는 서로 다른 크레딧 한도를 부여해 서비스 등급화와 업셀링 경로를 구성한다.

운영 조직에는 비용 예측과 거버넌스가 남는다. CI/CD 파이프라인의 토큰 소비량을 관찰하고 월별 자동화 예산을 미리 정해야 하므로, AI 에이전트 비용도 클라우드 FinOps와 비슷한 관리 대상이 된다.

운영 중인 파이프라인에서 먼저 확인할 것

6월 15일 전에 claude -p, Agent SDK 호출, Claude Code GitHub Actions가 현재 파이프라인에서 어느 정도 사용되는지 파악해야 한다.

최근 30일간 claude -p 호출 횟수와 토큰 소비량 집계
Agent SDK 기반 서드파티 앱 사용 목록 정리
플랜별 크레딧 한도인 $20/$100/$200와 예상 월 소비액 비교

예상 소비액이 크레딧을 넘는다면 플랜과 자동화 구조를 함께 조정할 수 있다.

Pro에서 Max 5x, Max 20x로 플랜을 단계적으로 올린다.
Extra Usage를 활성화해 크레딧 소진 후 종량제 청구로 전환한다.
프롬프트 캐싱과 배치 처리를 적용하고 불필요한 Agent SDK 호출을 제거한다.
대량 처리를 직접 API 호출로 분리해 비용 예측성을 확보하는 하이브리드 아키텍처를 구성한다.

이번 변경으로 대화형 사용은 구독 한도에 남지만 프로그래매틱 자동화는 독립된 크레딧 풀에서 계산된다. Codex와의 경쟁에 따라 대화형 주간 한도가 7월 13일까지 50% 확대됐어도 Agent SDK의 비용 경로는 달라지지 않는다. 개발팀은 자동화 파이프라인의 토큰 소비량을 확인하고 6월 15일 전에 플랜, Extra Usage 설정, 호출 구조를 월별 비용 계획에 맞춰야 한다.