Claude Agent SDK 크레딧, 쉽게 설명 (2026년 6월 15일)
아마 5월 13일에 Anthropic으로부터 새로운 Agent SDK 크레딧에 대한 이메일을 받고 바로 "잠깐, 이게 나한테도 해당되나?"라고 생각하셨을 겁니다. 짧게 답하자면, Claude를 상대로 스크립트나 GitHub Actions를 실행하지 않는 한 아마 해당되지 않습니다. 저희는 Claude 2 시절부터 Claude를 고객사의 프로덕션 워크플로에 연동해 왔으므로, 터미널에서 사는 것을 전제로 하지 않는 언어로 이번 변화를 설명드리겠습니다. Claude.ai 채팅이나 터미널의 Claude Code만 사용하신다면 2026년 6월 15일에 달라지는 것은 없습니다.
빠른 답변:
- Pro 플랜은 월 $20, Max 5x는 $100, Max 20x는 $200의 Agent SDK 크레딧을 구독료와 별도로 받습니다.
- 프로그램적 Claude 사용(Agent SDK,
claude -p, GitHub Actions, 서드파티 에이전트)에만 영향을 미치며, Claude.ai 채팅과 터미널의 Claude Code는 변함이 없습니다. - 크레딧은 매월 초기화되고 이월되지 않으며, 2026년 6월 15일 이후에 한 번 옵트인하여 활성화해야 합니다.
2026년 6월 15일에 실제로 무엇이 바뀌나요?
2026년 6월 15일부터 Anthropic은 Claude 유료 플랜을 두 개의 별도 청구 풀로 나눕니다. 기존 구독은 대화형 사용(Claude.ai 채팅, 터미널의 Claude Code)을 계속 커버하고, 새로운 월간 Agent SDK 크레딧이 프로그램적 사용을 커버합니다: Pro는 $20, Max 5x는 $100, Max 20x는 $200입니다. 기본 플랜 가격은 오르지 않습니다.
Anthropic은 2026년 5월 13일에 이 변화를 발표했습니다. 2026년 5월 속도 제한 2배 증가를 주시해 오셨다면, 이것은 그 이야기의 후반부입니다. 같은 달, 다른 레버입니다.
2026년 6월 15일부터 Claude 구독은 두 개의 풀로 나뉩니다: 하나는 Claude와 채팅하는 용도, 다른 하나는 코드가 여러분을 대신해 Claude와 채팅하게 하는 용도입니다.
잠깐, "SDK"가 뭔가요?
당연한 질문입니다. 대부분의 뉴스 보도는 이를 건너뛰었습니다. SDK(Software Development Kit, 소프트웨어 개발 키트)는 여러분이 작성한 프로그램이 Claude와 대화할 수 있게 해주는 도구 모음입니다. TV 본체의 버튼을 직접 누르는 대신 리모컨을 쓰는 것과 비슷합니다. 여러분의 코드가 타이핑을 합니다.
여기서 "에이전트"란? 루프 안에서 Claude를 호출하고, 다음에 무엇을 할지 결정하며, 도구를 사용하는 스크립트로, 사람이 개입하지 않습니다. 여러분이 자는 동안 이슈를 읽고, 답글 초안을 작성하고, 팀원을 태그하는 지칠 줄 모르는 인턴이라고 생각하세요.
claude -p는 무엇인가요? "출력 모드(print mode)"입니다. 명령줄에서 질문 하나를 입력하면 Claude가 한 번 답하고 세션이 종료됩니다. 주고받기도, 채팅 기록도 없습니다. 바로 그 일회성 특성이 이를 프로그램적으로 만듭니다: 사람이 아닌 다른 소프트웨어가 호출하도록 설계된 것입니다.
터미널을 열어본 적도, 스크립트를 작성해 본 적도 없다면, 이 내용은 여러분과 무관합니다. 다음 섹션으로 건너뛰어 확인하세요.
SDK는 Claude용 리모컨입니다. 채팅 창에서 버튼을 누르는 대신, 여러분이 작성한 프로그램에서 버튼을 누릅니다.
대화형 vs 프로그램적: 중요한 유일한 구분
Anthropic의 청구 분리는 하나의 아이디어에 달려 있습니다: 누가 프롬프트를 타이핑하는가? 사람이 자리에 앉아 있다면 대화형입니다. 스크립트나 서비스가 하고 있다면 프로그램적입니다. 어느 풀에서 지불할지 결정하는 기준선이 바로 이것입니다. 예시들이 어떻게 분류되는지 보겠습니다:
| 유형 | 의미 | 예시 | 지불 풀 |
|---|---|---|---|
| 대화형 | 여러분이 자리에 앉아 타이핑 | Claude.ai 채팅, 터미널/IDE의 Claude Code, claude.ai/code | 기존 구독 |
| 프로그램적 | 스크립트나 서비스가 타이핑 | Agent SDK 호출, claude -p, Claude Code GitHub Actions, OpenClaw, 서드파티 에이전트 | 새로운 Agent SDK 크레딧 풀 |
주의할 점: 파일 저장이나 커밋 시 실행되는 작은 스크립트인 Claude Code hooks조차도 스스로 Claude를 호출하면 프로그램적으로 간주됩니다. 사람이 프롬프트를 타이핑하면 구독에서 지불합니다. 스크립트가 프롬프트를 타이핑하면 새로운 Agent SDK 크레딧에서 지불합니다.
Agent SDK 크레딧은 얼마나 받나요?
기존 구독에 더해 각 플랜이 매월 받는 크레딧은 다음과 같습니다:
| 플랜 | 월간 Agent SDK 크레딧 | 이월 | 시트별 또는 풀링 |
|---|---|---|---|
| Pro ($20/월) | $20 | 안 됨 (매월 초기화) | 시트별 |
| Max 5x ($100/월) | $100 | 안 됨 | 시트별 |
| Max 20x ($200/월) | $200 | 안 됨 | 시트별 |
| Team / Enterprise | Anthropic에 문의 | Anthropic 문서 기준 | 시트 간 풀링 |
크레딧은 청구일에 초기화되고 이월되지 않으며, 구독의 추가 "메시지"가 아닌 별도 항목으로 표시됩니다. 따라서 놀고 있는 Pro 플랜도 사용 여부와 관계없이 월 $20의 프로그램적 크레딧이 내장되어 있습니다. 수치는 Anthropic 도움말 센터 페이지에서 확인했습니다.
여러분에게 해당되나요? 3가지 질문 체크
다음 세 가지 간단한 질문을 살펴보세요:
- 터미널에서
claude -p를 실행한 적이 있나요? - 저장소에 Claude Code GitHub Actions를 설정한 적이 있나요?
- OpenClaw, Zed AI 기능, 커스텀 스크립트, 또는 Zapier-Claude 브리지 같은 자동화 접착제처럼 여러분을 대신해 Claude를 호출하는 서드파티 도구를 사용하나요?
세 가지 모두 아니오로 답했다면, 6월 15일에 여러분의 Claude 사용은 바뀌지 않습니다. 하던 대로 계속하시면 됩니다. 하나라도 예라고 답했다면 다음 섹션을 읽으세요. 계산이 실제로 여러분의 지갑에 중요합니다.
Claude.ai와 채팅만 하거나 터미널에서 Claude Code를 사용한다면, 6월 15일에 아무것도 바뀌지 않습니다. 끝입니다.
실제 예시: $20은 얼마나 빨리 소진되나요?
하루에 20개의 이슈를 분류하는 GitHub Action을 설정했다고 가정해 봅시다. 각 실행은 Claude에 약 15,000 입력 토큰(이슈 본문과 저장소 컨텍스트)을 보내고 약 2,000 출력 토큰을 돌려받으며, Sonnet 4.5를 사용합니다. Sonnet의 API 요금(입력 토큰 백만 개당 $3, 출력 토큰 백만 개당 $15)에서 각 실행 비용은 대략 $0.075입니다. 하루 20회 실행이면 $1.50입니다. 30일 한 달이면 약 $45입니다.
$20 Pro 크레딧은 처음 13일을 커버합니다. 그 후에는 추가 사용 요금(표준 API 가격 적용)에 도달하거나, 다음 달 초기화 시점까지 Action이 중단됩니다.
claude -p "Summarize this issue in 3 bullets" < issue.md일회성 claude -p 호출. 이런 종류의 프로그램적 사용이 새로운 Agent SDK 크레딧에서 차감됩니다.
전문가 팁: 더 저렴한 모델로 충분한 작업에서는 Sonnet을 Haiku로 교체해 소진 속도를 줄일 수 있습니다. 저희는 분류형 자동화에서 이렇게 하여 월 소진량을 대략 절반으로 줄입니다. 더 완전한 플레이북은 LLM API 비용 절감 가이드에서 프롬프트 캐싱, 모델 라우팅, 컨텍스트 정리 트릭을 다룹니다.
숨겨진 함정 (일회성 옵트인, 소진, 그리고 2026년 5월 3종 세트)
공지 문구에서 놓치기 쉬운 세 가지.
1. 일회성 옵트인 플래그
Anthropic 도움말 센터 페이지에 따르면, 크레딧은 자동으로 활성화되지 않습니다. 2026년 6월 15일 이후에 계정 설정에서 한 번 켜야 합니다. 그렇게 하기 전까지 스크립트 호출은 이전 동작에 도달하는데, 6월 15일에는 실패하거나 실행을 거부할 수 있습니다. 캘린더 알림을 설정하세요. Anthropic이 이메일을 보냈다는 이유로 워크플로가 "그냥 작동한다"고 착각한 구독자들을 이미 봤습니다.
2. 크레딧이 소진되면 어떻게 되나요
기본적으로 프로그램적 호출은 다음 월간 초기화 시점까지 중단됩니다. 예상 밖의 청구는 없습니다. 계속 실행하고 싶다면 추가 사용에 옵트인하면 되며, 표준 API 요금(Sonnet 입력 $3 / 출력 백만 토큰당 $15, Opus는 더 높음)으로 청구됩니다. 여러분이 그 토글을 켜지 않으면 아무것도 청구되지 않습니다.
3. 다른 2026년 5월 변화와 어떻게 겹치나
이번 달에 세 가지 Claude 변화가 함께 출시되었습니다: (a) Agent SDK 크레딧(이 글), (b) 10배 API 속도 제한 증가, (c) 같은 입력에 대해 최대 35% 더 많은 토큰을 생성할 수 있는 Opus 4.7의 새 토크나이저. 함정은: 토큰이 많아지면 같은 스크립트가 크레딧을 더 빨리 소진한다는 것입니다. Pro와 Max 사용자는 세 가지를 한꺼번에 체감합니다. 스택에 Claude Skills도 구축했다면 그 호출도 고려하세요.
6월 15일 전에 할 일
이번 주에 실행할 5단계 체크리스트:
- 워크플로 중 프로그램적인 것이 있는지 파악하세요(위 3가지 질문 체크 참조).
- Anthropic 계정에 로그인하여 2026년 6월 15일 이후 나타나는 Agent SDK 크레딧 토글을 찾으세요.
- 추가 사용에 옵트인할지, 월간 크레딧에서 하드 캡을 할지 결정하세요.
- Team이나 Enterprise를 사용 중이라면 관리자와 시트별 vs 풀링 설정을 확인하세요.
/usage대시보드를 즐겨찾기에 추가해 소진 속도를 실시간으로 관찰하세요. Anthropic의 Agent SDK 문서에 링크가 있습니다.
그게 전부입니다. 대부분 10분 안에 이 체크를 마칠 것입니다.
Techsy가 도와드리는 방법
저희는 팀이 Claude(와 Agent SDK)를 실제 프로덕션 워크플로에 연동하도록 돕습니다. 적절한 플랜 규모 산정, 소진 속도 추정, 월간 크레딧을 초과하지 않는 자동화 구축까지. 이 청구 변화를 보며 6월 15일에 팀의 Claude 사용 예산을 어떻게 짤지 막막하다면, 30분 통화로 함께 설계해 드릴 수 있습니다. 반복 가능하고 저소진 에이전트 실행을 위한 CLAUDE.md 설정과 함께하면 좋습니다. 무료 상담 받기 →
자주 묻는 질문
Claude Agent SDK 크레딧은 가격 인상인가요? 아닙니다. Pro는 $20/월 그대로, Max 5x는 $100/월 그대로, Max 20x는 $200/월 그대로입니다. Agent SDK 크레딧은 기존 구독과 별도로 추가됩니다. Claude.ai 채팅이나 Claude Code를 대화형으로만 사용한다면 이전과 같은 금액을 지불하며 얻는 것도 없지만 잃는 것도 없습니다.
Agent SDK 크레딧이 터미널의 Claude Code에 영향을 미치나요?
아니요, 대화형으로 사용할 때는 그렇지 않습니다. 터미널이나 IDE에서 Claude Code에 타이핑하는 것은 여전히 일반 구독에서 차감됩니다. 프로그램적 호출, 즉 claude -p, GitHub Actions, Agent SDK를 임포트하는 스크립트만 2026년 6월 15일부터 새로운 크레딧 풀에서 차감됩니다.
claude -p는 무엇이며 제가 사용하나요?
claude -p는 "출력 모드"로, 명령줄에서 하는 일회성 호출입니다. Claude에게 무언가 물으면 한 번 답하고 세션이 종료됩니다. 터미널에 claude -p를 입력해 본 적도, 셸 스크립트에 연동한 적도 없다면 사용하고 있지 않은 것입니다. 대부분의 비개발자 구독자는 절대 건드리지 않습니다.
사용하지 않으면 Agent SDK 크레딧이 이월되나요? 아닙니다. 월간 크레딧은 청구일에 초기화되고 이월되지 않습니다. 이번 달에 Pro $20 크레딧 중 $5를 사용했다면 다음 달을 $35로 시작하지 않습니다. 다시 $20으로 시작합니다. 자동화를 계획할 때 이를 고려하세요.
Agent SDK 크레딧이 소진되면 어떻게 되나요? 기본적으로 프로그램적 호출은 다음 초기화 시점까지 중단됩니다. 예상 밖의 청구는 없습니다. 계속 실행하고 싶다면 계정 설정에서 추가 사용에 옵트인하면 되며, 표준 API 요금(Sonnet 토큰 백만 개당 입력 $3 / 출력 $15, Opus는 더 높음)이 청구됩니다. 자동으로 청구되는 것은 없습니다.
워크플로를 계속 실행하려면 2026년 6월 15일 전에 해야 할 일이 있나요?
예, 한 가지: 6월 15일 이후에 계정 설정에서 Agent SDK 크레딧 토글을 켜야 합니다. 일회성 옵트인입니다. 켜기 전까지 프로그램적 호출이 실패할 수 있습니다. claude -p 크론 잡이나 GitHub Action을 실행 중이라면 6월 15일에 알림을 설정하세요.
Agent SDK 크레딧을 얼마나 사용했는지 볼 수 있나요?
예. Anthropic은 계정에 월간 크레딧 대비 현재 기간 소진량을 보여주는 /usage 대시보드를 제공합니다. 주말에 $20을 소진할 수 있는 것을 시작하기 전에 즐겨찾기에 추가하세요. Agent SDK 문서에 링크와 필드 이름이 포함되어 있습니다.
Team과 Enterprise 플랜에도 같은 방식으로 영향을 미치나요? 완전히 같지는 않습니다. Pro와 Max 플랜은 시트별 크레딧(각각 $20, $100, $200)을 받습니다. Team과 Enterprise 플랜은 시트 간 크레딧을 풀링하며 금액은 협상 대상입니다. Anthropic은 직접 문의하도록 안내합니다. 조직이 어떻게 설정되어 있는지 6월 15일 전에 계정 관리자와 확인하세요.