Claude -p 자동화 20달러 크레딧, 6월 15일 바뀌는 비용선

AI 요약

• 무슨 일: Anthropic이 2026년 6월 15일부터 Claude Agent SDK와 claude -p 사용량을 별도 월간 크레딧으로 뺍니다.
  • Pro는 20달러, Max 5x는 100달러, Max 20x는 200달러 크레딧을 받습니다.
  • 대화형 Claude Code와 Claude 앱 대화는 기존 구독 한도에 남습니다.
• 개발자 영향: CI, GitHub Actions, headless 스크립트, 서드파티 Agent SDK 앱은 비용 추적 대상이 됩니다.
• 주의점: 크레딧이 떨어지면 usage credits가 켜진 계정만 표준 API 요율로 계속 실행됩니다.
• 기술 경계: Claude Code 문서는 --bare를 scripted/SDK 호출 권장 모드로 두고, 향후 -p 기본값으로 예고합니다.

Anthropic이 Claude Code 자동화의 비용 경계를 다시 그었습니다. Claude Help Center의 "Use the Claude Agent SDK with your Claude plan" 문서는 2026년 6월 15일부터 Claude Agent SDK와 claude -p 사용량이 기존 Claude 구독 한도에서 빠진다고 설명합니다. 이 사용량은 별도의 월간 Agent SDK 크레딧을 먼저 차감합니다. Pro 사용자는 20달러, Max 5x 사용자는 100달러, Max 20x 사용자는 200달러 크레딧을 받습니다.

이 변경은 새 모델 출시나 에디터 기능 추가보다 덜 화려하지만, AI 개발 자동화를 실제로 돌리는 팀에는 더 직접적입니다. 그동안 claude -p는 빌드 로그 요약, PR diff 리뷰, nightly 코드 점검, GitHub Actions 자동 수정 같은 작업에 쉽게 붙었습니다. 6월 15일 이후 같은 호출은 "내 Claude Code 구독 한도 안에서 돌아가는 스크립트"가 아니라 "월간 크레딧과 API식 초과 사용량을 가진 자동화 호출"로 계산됩니다.

공식 문서가 분리한 대상은 꽤 명확합니다. Agent SDK로 만든 Python/TypeScript 프로젝트, Claude Code의 비대화형 claude -p, Claude Code GitHub Actions integration, Agent SDK를 통해 Claude 구독으로 인증하는 서드파티 앱이 월간 크레딧 대상입니다. 반대로 터미널이나 IDE에서 사람이 쓰는 대화형 Claude Code, Claude 웹/데스크톱/모바일 대화, Claude Cowork는 기존 구독 한도에 남습니다.

문서에서 가장 비용 감각이 필요한 문장은 크레딧 소진 뒤 동작입니다. 월간 크레딧은 먼저 차감되고, 그다음 추가 Agent SDK 사용량은 usage credits가 켜진 계정에서만 표준 API 요율로 넘어갑니다. usage credits가 꺼져 있으면 Agent SDK 요청은 다음 크레딧 갱신까지 멈춥니다. 개인이 하루 몇 번 claude -p를 호출하는 수준과, CI가 모든 PR에 대해 diff 리뷰와 테스트 실패 수정을 반복하는 수준은 같은 20달러 크레딧 안에서 전혀 다른 결과를 냅니다.

이 변경은 4월 OpenClaw 논쟁의 연장선에 있습니다. HN에는 Anthropic이 서드파티 harness에 extra usage를 요구한다는 안내가 올라왔고, 구독 인증으로 claude -p 또는 OpenClaw류 도구를 돌리던 사용자는 "어제 되던 자동화가 오늘 막힌다"는 반응을 남겼습니다. 다른 댓글은 구독 상품이 사람이 직접 쓰는 Claude Code와 Claude 앱 기준으로 설계됐고, 기계가 반복 호출하는 자동화는 API 요율로 분리하는 편이 용량 관리에 맞다고 주장했습니다.

GeekNews 프랑스어 요약은 이번 문서를 "프로그래밍 사용량의 월간 크레딧 구조"로 정리했습니다. 거기서 인용된 개발자 반응은 두 갈래입니다. 하나는 Anthropic이 무료 크레딧처럼 표현하지만 실제로는 claude -p 자동화 한도를 줄이는 변화라는 비판입니다. 다른 하나는 구독 한도, extra usage, API key, 서드파티 앱의 경계가 적어도 문서상 더 명확해졌다는 평가입니다.

Claude Code programmatic usage 문서는 비용 변경보다 더 기술적인 단서를 줍니다. 문서는 Agent SDK가 Claude Code를 CLI, Python, TypeScript에서 비대화형으로 실행하게 해 주며, -p 또는 --print 플래그로 프롬프트를 실행할 수 있다고 설명합니다. 예시는 claude -p "Find and fix the bug in auth.py" --allowedTools "Read,Edit,Bash"처럼 파일 읽기, 편집, Bash 실행 권한을 붙인 형태입니다.

같은 문서의 --bare 설명은 앞으로 자동화가 어떤 모양으로 정리될지 보여줍니다. --bare는 hooks, skills, plugins, MCP servers, auto memory, CLAUDE.md 자동 탐색을 건너뛰고, 스크립트나 CI에서 같은 결과를 내기 위한 모드입니다. 문서는 --bare가 scripted/SDK 호출의 권장 모드이며 향후 -p의 기본값이 된다고 적습니다.

여기서 인증 경계가 중요합니다. --bare는 OAuth와 keychain을 읽지 않습니다. Anthropic 인증은 ANTHROPIC_API_KEY 환경 변수나 settings JSON의 apiKeyHelper에서 와야 하고, Bedrock, Vertex, Foundry는 각 provider credential을 사용합니다. 사용자가 로컬에서 Claude Code에 로그인해 둔 상태를 CI나 원격 VM이 그대로 빌려 쓰는 방식은 장기적으로 권장 경로가 아닙니다.

비용 관측성도 문서에 들어왔습니다. --output-format json 응답에는 total_cost_usd와 모델별 비용 breakdown이 포함되어, scripted caller가 usage dashboard를 열지 않고도 호출별 비용을 추적할 수 있다고 설명합니다. 이 문장은 작은 기능 설명처럼 보이지만, Agent SDK 자동화가 "실행되면 좋고 아니면 말고"인 개인 스크립트에서 예산과 실패 모드를 가진 작업 단위로 넘어간다는 뜻입니다.

개발팀이 바로 점검해야 할 첫 항목은 claude -p 호출 위치입니다. 로컬 alias, GitHub Actions workflow, pre-commit hook, nightly job, Slack bot, internal admin script에 숨어 있는 호출을 찾지 않으면 6월 15일 이후 어떤 작업이 20달러 또는 200달러 크레딧을 쓰는지 알 수 없습니다. 특히 여러 저장소가 같은 개인 계정으로 headless 작업을 돌리는 경우, 크레딧은 팀 공용 풀이 아니라 사용자별 예산이라는 점이 병목이 됩니다.

둘째 항목은 초과 사용량 설정입니다. 문서상 usage credits가 꺼져 있으면 Agent SDK 요청은 크레딧이 떨어진 뒤 멈춥니다. 비용 폭주를 막는 데는 유리하지만, PR 리뷰 자동화나 릴리스 직전 테스트 보조처럼 실패가 배포 지연으로 이어지는 작업에는 다른 위험을 만듭니다. 반대로 usage credits를 켜면 작업은 계속되지만, 표준 API 요율의 비용 상한을 별도로 두지 않으면 반복 실패 job이 예상보다 큰 청구서를 만들 수 있습니다.

셋째 항목은 자동화 단위의 재설계입니다. 예전에는 git diff main | claude -p ...처럼 간단히 붙인 호출이 충분했습니다. 이제는 입력 크기, 재시도 횟수, 권한 목록, 출력 형식, 비용 로그를 함께 설계해야 합니다. Claude Code 문서는 piped stdin에 10MB cap이 있다고 적고, 더 큰 입력은 파일 경로를 참조하라고 안내합니다. 대형 monorepo에서 모든 diff와 로그를 한 번에 넣는 방식은 비용뿐 아니라 입력 제한에서도 약합니다.

넷째 항목은 권한과 비용의 결합입니다. 문서 예시는 --allowedTools "Bash,Read,Edit"로 테스트 실행과 수정 권한을 자동 승인할 수 있다고 설명하지만, 같은 호출이 실패 루프에 빠지면 도구 실행, 토큰, 재시도가 모두 비용을 만듭니다. 자동 승인 범위를 넓힐수록 성공률은 올라갈 수 있지만, 실패했을 때의 비용과 변경 범위도 커집니다. CI에서는 read-only 리뷰와 write-capable 수정 job을 분리하는 편이 추적하기 쉽습니다.

Anthropic 입장에서 이 분리는 이해 가능한 선택입니다. 구독 한도는 예측 가능한 사람의 사용량을 전제로 가격이 붙고, Agent SDK와 claude -p는 기계가 반복 호출할 수 있습니다. HN 댓글 중 일부가 말한 것처럼 "human scale" 사용과 API형 사용은 용량 관리 기준이 다릅니다. 다만 사용자가 이미 구독 한도 안의 자동화를 제품이나 내부 workflow에 붙인 뒤라면, 6월 15일 전환은 단순한 문구 변경이 아니라 운영 비용 변경입니다.

경쟁사와 비교하면 이 지점은 더 민감합니다. OpenAI Codex, GitHub Copilot coding agent, Google Antigravity 같은 도구도 각자 구독, seat, usage, action minute, API key 경계를 다시 조정하고 있습니다. 개발자 입장에서는 "어느 모델이 더 잘 고치나"만 비교할 수 없습니다. 같은 PR 리뷰를 한 달 동안 500번 실행할 때 seat 요금, token 요금, Actions minute, 실패 재시도, 정책 변경 위험이 함께 들어갑니다.

서드파티 harness 생태계도 영향을 받습니다. Agent SDK 기반 앱이 Claude 구독으로 인증할 수 있더라도, 그 사용량은 이제 월간 Agent SDK 크레딧의 대상입니다. 사용자는 앱이 "내 Claude 구독으로 동작한다"고 들었을 때 대화형 Claude Code 한도를 쓰는지, Agent SDK 크레딧을 쓰는지, usage credits를 쓰는지 확인해야 합니다. 앱 개발자는 onboarding 화면에서 인증 방식과 비용 경계를 설명하지 않으면 6월 15일 이후 지원 문의를 받을 가능성이 높습니다.

이번 변경을 실무적으로 정리하면, Claude Code 자동화는 세 가지 계층으로 나뉩니다. 사람이 터미널/IDE에서 쓰는 interactive layer, claude -p와 Agent SDK가 차감하는 monthly credit layer, 초과분이 넘어가는 API usage layer입니다. 이 세 계층을 한 계정 안에서 함께 쓰는 팀은 "누가 어떤 자동화로 얼마를 쓰는가"를 사용자별로 나눠 봐야 합니다.

가장 보수적인 전환 방법은 6월 15일 전에 모든 headless 호출에 비용 로그를 붙이는 것입니다. --output-format json을 쓰고 total_cost_usd를 job summary나 로그 저장소에 남기면, 크레딧 전환 뒤 어느 workflow가 예산을 많이 쓰는지 알 수 있습니다. 동시에 --bare를 CI 호출에 붙여 로컬 hooks, plugin, MCP 설정이 결과에 섞이지 않도록 하는 것도 필요합니다.

다음으로는 크레딧 소진 시 실패 전략을 정해야 합니다. 개인 실험용 script는 usage credits를 끄고 멈추는 편이 낫습니다. 운영 repo의 PR gate라면 비용 상한을 둔 usage credits, job timeout, retry 제한, fallback reviewer를 함께 설정해야 합니다. Anthropic 문서가 "production automation at scale은 Claude Platform API key를 쓰라"고 안내한 부분은 이 분기와 맞닿아 있습니다.

이 뉴스의 결론은 Claude Code가 약해졌다는 식의 단순 평가가 아닙니다. 6월 15일 이후 Claude 자동화는 제품 기능보다 회계 단위가 먼저 달라집니다. claude -p를 한 줄짜리 유틸리티처럼 쓰던 팀은 여전히 같은 명령을 실행할 수 있지만, 그 명령은 이제 월간 크레딧, usage credits, API key, --bare, JSON 비용 로그를 가진 운영 대상입니다. 코딩 에이전트 경쟁에서 다음 비교 기준은 모델 이름뿐 아니라 자동화 호출의 과금 단위와 실패 모드입니다.