Claude Agent SDK 크레딧: 6월 15일 이후 claude -p, GitHub Actions, 서드파티 에이전트 도구에 달라지는 것

2026년 6월 15일, Anthropic은 헤드리스 Claude의 경제 구조를 바꾼다. claude -p, Claude Agent SDK 호출, Claude Code GitHub Actions, 그리고 Agent SDK 기반 서드파티 앱은 더 이상 일반 Claude 구독 한도에서 차감되지 않고, 대신 별도의 월간 Agent SDK 크레딧에서 차감된다(Anthropic Help Center).

언뜻 보면 결제 각주처럼 들린다. 아니다. cron 작업, CI 리뷰어, 로컬 스크립트, Zed식 에이전트 통합, 혹은 claude -p를 감싼 래퍼 CLI를 쓰고 있다면, 여기서 “내 요금제에 포함됨”은 “달러 크레딧 기준으로 과금됨”으로 바뀐다.

내 생각은 이렇다. 제품 경계 자체는 맞다. 하지만 Anthropic의 rollout은 너무 많은 개발자가 깨진 멘탈 모델과 Reddit 스레드를 통해 이 사실을 알게 만든다. 대화형 코딩과 자동화 에이전트는 다른 워크로드다. 같은 quota를 공유해서는 안 된다. 다만 팀이 구독 인증된 Claude Code 위에 조용히 자동화를 쌓아왔다면, 6월 15일은 가격 발표가 아니라 마이그레이션 마감일이다.

실제로 새 크레딧으로 넘어가는 것

Anthropic의 도움말 문서는 이 경계를 명확히 적고 있다. 6월 15일부터 Claude 구독 요금제에서 Agent SDK와 claude -p 사용량은 대화형 사용 한도와 별개인 새로운 월간 Agent SDK 크레딧에서 차감된다(Anthropic Help Center). Agent SDK 문서도 개요 페이지 맨 위에서 같은 경고를 반복한다(Claude Docs).

새 크레딧 대상:

요금제 크레딧은 달러 단위다:

Anthropic은 또한 크레딧이 사용자별이며 pooling되지 않고, 결제 주기에 맞춰 갱신되며, 미사용 크레딧은 이월되지 않고, 크레딧은 한 번 claim해야 하며 이후 자동으로 갱신된다고 말한다(Anthropic Help Center).

마지막 부분은 팀에게 중요하다. 적격 엔지니어가 20명 있는 Team 계정이라고 해서 공유 자동화 버킷 하나를 받는 게 아니다. 각자가 자기 크레딧을 받는다. 공유 GitHub Action이 한 명의 사용자로 인증되어 있다면, 그 한 명의 크레딧이 병목이 된다.

실질적인 단절: claude -p는 더 이상 “그냥 CLI 사용”이 아니다

사람들을 놀라게 할 명령은 claude -p다.

Anthropic의 CLI reference는 --print / -p를 “Print response without interactive mode”라고 설명하며, --output-format json, --output-format stream-json, --max-turns, --json-schema, --max-budget-usd 같은 자동화 친화적 플래그를 제공한다(Claude Code CLI reference). 그래서 스크립트용 접착제로 딱이었다:

git diff --staged |
  claude -p "Review this diff for security issues. Return JSON." \
  --output-format json \
  --max-turns 3 \
  --max-budget-usd 2

6월 15일 이후, 이것은 구독 인증 계정에서 Agent SDK 크레딧을 쓰는 사용량이다. 대화형 Claude Code 사용량이 아니다. 일반 채팅 사용량도 아니다. 요금제 quota로 들어가는 공짜 옆문도 아니다.

그래서 커뮤니티 반응이 날카롭다. 현재 r/ClaudeCode 스레드에서 개발자들은 이 크레딧이 토큰/모델 기반인지, $200가 현실적으로 얼마나 버티는지, opt-in이 필요한지, prompt caching은 어떻게 계산되는지, GitHub Actions도 포함되는지 묻고 있다(Reddit). 한 댓글의 “oh… I didn’t realise it was GH actions too”는 정확히 이 리스크를 보여준다. 사람들은 이 변화를 SDK 라이브러리에만 대응시켰지, 모든 헤드리스 Claude Code 워크플로로 보지 않았다.

토큰 질문에 대한 답은 사실상 그렇다. Anthropic은 크레딧을 초과한 사용량이 usage credits가 활성화되어 있을 경우 표준 API rates의 usage credits로 넘어간다고 말한다. 현재 Claude API pricing 페이지에는 Fable 5가 입력 $10 / 출력 $50 per million tokens, Opus 4.8이 $5 / $25, Sonnet 4.6이 $3 / $15, Haiku 4.5가 $1 / $5로 표시되어 있다(Claude API pricing). 정확한 소진 속도는 모델, turns, tool use, cache reads, cache writes, 그리고 에이전트가 불러오는 저장소 context 양에 달려 있다.

$20나 $200를 “시간”으로 환산하지 마라. 단위가 틀렸다. 실제 작업을 토큰과 비용 traces로 환산해야 한다.

GitHub Actions: YAML은 그대로, 예산은 다르게

Claude Code GitHub Actions는 명확히 범위 안에 있다. Anthropic의 GitHub Actions 문서는 이 action이 Claude Agent SDK 위에 만들어졌고 @claude mentions에 응답하거나, PR을 만들거나, 기능을 구현하거나, 버그를 고치거나, 커스텀 자동화를 실행할 수 있다고 말한다(Claude Code GitHub Actions docs). 문서는 또한 각 Claude interaction이 API tokens를 소비한다고 경고하며 비용 관리를 위해 --max-turns, timeouts, concurrency controls를 권장한다.

이 가이드는 이제 더 중요해졌다.

이런 일일 예약 리포트는:

name: Daily Claude Report
on:
  schedule:
    - cron: "0 9 * * *"
jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Summarize yesterday's commits and open issues"
          claude_args: "--model sonnet --max-turns 3"

두 가지 결제 스토리를 가진다:

1. Claude Platform API 키를 사용한다면 Anthropic이 말하듯 달라지는 것은 없다. 일반 종량제 API 결제로 유지된다.
2. 구독 인증된 Agent SDK 크레딧을 사용한다면, 이제 사용자별 Agent SDK 크레딧을 먼저 소진한 뒤, 활성화되어 있다면 usage credits로 넘어간다.

action setup 문서는 여전히 직접 API 사용을 위한 ANTHROPIC_API_KEY, 그리고 Bedrock과 Vertex AI용 cloud-provider 옵션을 강조한다(Claude Code GitHub Actions docs). production CI에서는 저장소 자동화를 한 인간의 구독에 묶는 것보다 이쪽이 더 깔끔하다. Anthropic도 admin guidance에서 같은 말을 한다. 규모 있는 production automation은 예측 가능한 종량제 결제를 위해 API 키와 함께 Claude Platform을 써야 한다(Anthropic Help Center).

내 권장사항은 이렇다. 코드를 merge하거나, PR에 comment하거나, schedule로 무인 실행되는 워크플로라면 명시적 budget이 걸린 API 키에 올려라. 구독 Agent SDK 크레딧은 개인 자동화, 실험, 로컬 도구용으로 남겨라.

서드파티 에이전트 도구: Zed식 질문

혼란스러운 사례는 서드파티 tooling이다. 개발자들은 묻는다. editor, local harness, coding assistant가 Agent SDK를 통해 통합되고 내 Claude 구독으로 인증하게 해준다면, 새 크레딧을 쓰는가?

Anthropic의 도움말 문서는 이 크레딧이 “Agent SDK를 통해 Claude 구독으로 인증하는 서드파티 앱”을 포함한다고 말한다(Anthropic Help Center). Agent SDK 개요 역시 Anthropic이 일반적으로 사전 승인 없이는 서드파티 개발자에게 claude.ai login이나 rate limits 제공을 허용하지 않으며, 대신 API-key 인증 방식을 사용하라고 안내한다고 말한다(Claude Docs).

여기서 실용적인 규칙이 나온다:

• 도구가 Claude Platform API 키를 사용한다면, 이 변화가 무료 월간 크레딧을 주지 않는다. 여전히 API 결제다.
• 도구가 승인된 구독 인증 Agent SDK 앱이라면, Agent SDK 크레딧에서 차감된다.
• 도구가 Anthropic이 승인하지 않은 방식으로 Claude Code login, OAuth tokens, hidden PTYs, 혹은 구독 한도를 우회하려 한다면, 취약하다고 봐야 한다.

커뮤니티는 이미 그 모호함 위에서 무언가를 만들고 있다. 한 r/ClaudeCode 게시물은 작업을 대화형 Claude Code 안에 유지하며 SDK credits를 피한다고 주장하는 hook 기반 “drop-in -p replacement”를 설명한다(Reddit). 또 다른 r/ClaudeAI 게시물은 내부적으로 대화형 Claude Code를 실행해 claude -p 출력을 흉내 내는 로컬 CLI clarp를 설명한다(Reddit). 작성자는 이를 로컬 호환성이라고 설명하지만, 댓글은 곧바로 계정 리스크를 묻는다.

진짜 논쟁은 이것이다. 이것이 정당한 로컬 워크플로 보존인가, 아니면 tooling으로 포장한 quota bypass인가? 나는 이런 wrappers 위에 회사 인프라를 짓지 않겠다. 지금 동작하더라도, Anthropic이 적극적으로 제거하려는 결제 가정을 코드화하고 있기 때문이다.

오늘 내 워크플로를 감사하는 법

실패한 job을 기다리지 말고 지금 하라.

먼저 claude -p와 Agent SDK imports를 찾는다:

rg 'claude\s+(-p|--print)|@anthropic-ai/claude-agent-sdk|claude_agent_sdk' .

그다음 CI를 찾는다:

rg 'claude-code-action|ANTHROPIC_API_KEY|claude_args|@claude' .github .gitlab .circleci

각 hit를 분류하라:

SDK 사용자라면 result stream에 cost tracking을 연결하라. Anthropic의 cost-tracking 문서는 total_cost_usd와 costUSD가 권위 있는 billing data가 아니라 client-side estimates라고 말하지만, 개발 중 insight에는 유용하다(Claude Docs). 같은 페이지는 SDK가 per-step token usage, per-model usage, cache read tokens, cache creation tokens, 그리고 cumulative totals를 노출한다고 말한다.

이를 사용해 burn profile을 만들어라:

import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "Review this repo for flaky tests",
  options: { maxTurns: 3 },
})) {
  if (message.type === "result") {
    console.log({
      estimatedCostUsd: message.total_cost_usd,
      modelUsage: message.modelUsage,
    });
  }
}

client-side cost estimates를 자기 사용자에게 청구하는 데 쓰지 마라. Anthropic은 권위 있는 billing에는 Usage and Cost API나 Claude Console을 쓰라고 명확히 말한다(Claude Docs).

hard stop도 추가하라. claude -p에는 --max-turns와 --max-budget-usd를 써라. GitHub Actions에는 workflow timeouts, GitHub concurrency controls, 좁은 prompts를 써라. SDK agents에서는 tools를 제한하라. read-only reviewer가 기본적으로 Bash, Edit, Write를 가져서는 안 된다.

Opt-In과 초과 사용 질문

가장 중요한 미해결 운영 질문은 opt-in이다. Anthropic은 이 크레딧이 일회성 opt-in이며, Claude 계정에서 한 번 claim하면 이후 자동 갱신된다고 말한다. Team 및 Enterprise admins의 경우, 적격 사용자는 2026년 6월 15일 이전에 세부 정보와 안내가 담긴 이메일을 받을 예정이었다(Anthropic Help Center).

현재 r/Anthropic 스레드는 당연한 후속 질문을 던지고 있다. opt in하지 않으면 어떻게 되는가? claude -p가 일반 구독 한도로 계속 동작하는가, claim할 때까지 멈추는가, 아니면 usage credits로 실패 전환되는가? 해당 문서는 그 fallback을 명확히 말하지 않는다(Reddit).

그러니 추측한 fallback을 전제로 설계하지 마라. 자격이 있다면 크레딧을 claim하라. admin이라면 사용자에게 어디서 claim하는지, 어떤 자동화가 이를 사용할 수 있는지 알려라. 공유 워크플로를 운영한다면 API 키로 옮겨라.

초과 사용에 대해서는 Anthropic이 더 명확하다. Agent SDK 사용량은 월간 크레딧을 먼저 소진한다. 그 이후에는 usage credits가 활성화되어 있을 때만 표준 API rates의 usage credits로 넘어간다. usage credits가 활성화되어 있지 않으면 Agent SDK 요청은 크레딧이 갱신될 때까지 중단된다(Anthropic Help Center).

지출 통제 관점에서는 좋다. 동시에 자동화가 fail closed할 수 있다는 뜻이기도 하다. 그에 맞게 만들어라. CI는 “Agent SDK credit exhausted”를 flaky model error가 아니라 billing/configuration failure로 드러내야 한다. 로컬 스크립트는 명확한 메시지를 출력하고 non-zero로 종료해야 한다. 장기 실행 agents는 비싼 turn마다 작업을 checkpoint해야 한다.

개발자를 위한 결론

이 변화는 claude -p의 죽음이 아니다. 헤드리스 에이전트 loop가 IDE에 앉아 있는 사람과 같은 비용 구조를 가진 척하던 시대의 끝이다.

개인 개발자에게 새 크레딧은 유용하다. Pro 사용자는 스크립트용 월 $20의 여유를 얻는다. Max 20x 사용자는 $200를 얻는다. 신중한 자동화에는 충분하지만, 무제한 always-on agents에는 충분하지 않다.

팀에게 답은 지루하지만 맞다. production automation에는 API 키를 써라. 구독 Agent SDK 크레딧은 개인용으로 유지하라. cost logging을 추가하라. turns를 cap하라. 작업에 frontier model이 필요하지 않다면 Haiku나 Sonnet을 선호하라. 새 경계를 우회하는 wrapper 도구는 인프라가 아니라 실험으로 취급하라.

6월 15일의 분리는 하나의 실제 문제를 해결한다. 야간 스크립트가 대화형 코딩에 필요한 quota를 조용히 먹어치워서는 안 된다. 대신 또 다른 문제를 만든다. 이제 개발자는 Claude가 인간 없이 loop 안에서 실행될 때마다 API 사용자처럼 생각해야 한다.

공정한 trade-off다. 하지만 meter가 물기 시작하기 전에 감사해야만 작동한다.

Claude Fable 5를 직접 써보고 싶은 독자는 OneHop을 통해 사용할 수 있다. drop-in endpoint, 정가보다 약 30% 저렴한 가격, 신규 계정 $10 무료, 카드 불필요. Claude Fable 5 on OneHop 또는 $10 무료로 시작하기를 보면 된다.

더 읽을거리: Claude Fable 5 시작하기.