Claude Code 구독과 API 과금, 누구에게 무엇이 맞을까

먼저 “누가 실행하는가”를 가릅니다

구독과 API는 단순히 선불과 후불의 차이가 아닙니다. 구독은 사람이 자신의 계정으로 Claude Code를 열고 질문과 수정을 이어 가는 흐름에 가깝습니다. 사용량 과금은 호출한 토큰과 기능에 따라 비용이 생기며, 프로그램이 정해진 시점에 실행하고 결과를 다른 시스템으로 넘기기 쉽습니다.

따라서 첫 질문은 월 사용 시간이 아닙니다. 실행 버튼을 사람이 누르는지, 실패했을 때 사람이 바로 판단하는지, 아니면 저장소 이벤트가 자동으로 작업을 시작하는지부터 봐야 합니다. 사람이 없는 실행에 개인 로그인 자격을 억지로 붙이면 퇴사·계정 잠금·다중 인증 변경 때 파이프라인까지 멈춥니다.

개인 개발자는 대화형 구독에서 시작하는 편이 낫습니다

저녁마다 한두 시간씩 저장소를 읽고, 수정 방향을 대화로 좁히며, 테스트 결과를 보고 다음 지시를 고르는 개인을 생각해 봅시다. 호출 횟수와 토큰을 매번 예측하기 어렵고 실행 중간에 사람이 계속 개입합니다. 이런 사용에는 현재 Claude Code가 포함된 개인용 구독을 먼저 검토하는 편이 단순합니다.

다만 구독은 무제한 사용권이 아닙니다. 포함량과 사용 제한은 플랜, 모델, 수요와 정책에 따라 달라질 수 있습니다. 업무가 자주 제한에 막히거나 매달 추가 사용이 반복된다면 더 높은 구독으로 즉시 옮기기 전에 기록을 봐야 합니다. 긴 로그를 되풀이해 넣는지, 서로 다른 작업을 한 세션에 섞는지, 비싼 모델이 필요 없는 기계적 작업까지 같은 방식으로 처리하는지부터 고치는 편이 비용과 품질 모두에 도움이 됩니다.

다섯 명 팀은 가격보다 개인별 책임을 남겨야 합니다

작은 팀에서 가장 쉬워 보이는 방법은 API 키 하나를 만들어 모두에게 전달하는 것입니다. 이 방법은 누가 비용을 만들었는지 알기 어렵고, 한 사람이 나간 뒤 키를 회수하려면 전원이 쓰는 자격을 바꿔야 합니다. 유출된 키의 영향 범위도 팀 전체가 됩니다.

다섯 명이 각자 터미널에서 대화형으로 개발한다면, 현재 조직용 상품에서 Claude Code 사용이 가능한 좌석과 관리 기능을 확인해 개인별로 배정하는 방식을 권합니다. Console 과금을 쓴다면 Claude Code 전용 워크스페이스의 개인별 키와 한도를 활용할 수 있습니다. 별도의 제품 API나 배치 작업은 개발·스테이징·운영 워크스페이스로 나누면 비용과 자원을 서로 섞지 않을 수 있습니다.

팀이 이미 AWS나 Google Cloud의 IAM, 비용 센터, 감사 정책을 표준으로 삼고 있다면 Bedrock이나 Vertex AI 같은 승인된 클라우드 경로가 더 자연스러울 수 있습니다. 반대로 그런 기반이 없는 작은 팀이 “기업용처럼 보인다”는 이유만으로 클라우드 경로를 추가하면 권한과 청구 체계만 하나 더 생깁니다. 기존 통제 체계가 있을 때 선택하는 것이 좋습니다.

CI에는 지원되는 전용 자격을 넣습니다

PR이 열릴 때마다 변경 파일을 읽는 자동 검토는 대화를 이어갈 사람이 없습니다. Console API는 Anthropic 개발자 콘솔에서 사용량에 따라 과금되는 호출 경로입니다. 공식 GitHub Actions가 지원하는 OAuth는 비밀번호를 넘기지 않고 개인 구독의 제한된 사용 권한을 토큰으로 주는 인증 방식입니다. 이 사용량은 토큰을 발급한 개인에게 귀속되므로 조직 공용 자격처럼 다루면 안 됩니다.

정적 API 키는 비밀 저장소, 만료일과 교체 책임자가 필요합니다. 워크로드 신원은 특정 CI 작업 자체에 짧은 권한을 주어 개발자의 로컬 자격을 복사하지 않는 방식입니다. 실제 지원 여부는 조직의 클라우드와 Claude Code 문서에서 확인하고, 개발자 로컬 실행과 CI의 비용·감사 기록을 분리합니다.

가격표 대신 실제 작업 한 건의 토큰으로 계산합니다

API 비용은 모델별 입력·출력, 캐시와 도구 사용 가격을 현재 공식 가격표에서 가져와 계산합니다. 아래 숫자는 상품 가격이 아니라 계산법을 보여 주는 가상 사용량입니다. CI가 근무일 20일 동안 하루 12회 실행되고, 한 번에 입력 6만 토큰과 출력 8천 토큰을 쓴다고 가정했습니다.

월 실행 수 = 20일 × 12회 = 240회
월 입력량 = 240 × 60,000 = 14.4M tokens
월 출력량 = 240 × 8,000 = 1.92M tokens

월 기본 모델 비용
= 14.4 × 현재 입력 단가(USD / MTok)
+ 1.92 × 현재 출력 단가(USD / MTok)

별도 확인
+ 캐시 쓰기·읽기
+ 웹 검색 등 서버 도구
+ 클라우드 사업자별 가격 차이
+ 세금과 환율

평균값 하나로 예산을 잡으면 긴 작업이 사고를 만듭니다

평균 실행 비용만 계산하면 큰 PR, 반복 실패, 긴 세션이 가려집니다. 첫 주에는 실행별 입력·출력 토큰과 비용을 기록하고 중앙값과 상위 95퍼센트를 함께 봅니다. 월 예산은 “평균 비용 × 예상 횟수”와 “상위 95퍼센트 비용 × 최대 횟수” 사이에서 정하되, 장애 대응에 필요한 여유를 별도로 둡니다.

Console에서는 조직과 워크스페이스 단위의 사용량·비용을 조회할 수 있고, 워크스페이스에는 조직 한도보다 낮은 지출·속도 제한을 둘 수 있습니다. 이 수치는 로컬 로그 추정치가 아니라 청구 경로의 기록으로 확인해야 합니다. 클라우드 경로를 쓴다면 해당 사업자의 비용 보고와 예산 알림을 기준 원장으로 삼습니다.

자동화는 금액 한도만으로 안전해지지 않습니다

CI 작업에는 비용 상한과 행동 상한이 함께 있어야 합니다. 아래는 읽기 전용 검토 작업의 실행 계약입니다. 실제 명령과 옵션은 설치된 Claude Code의 현재 CLI 도움말과 공식 문서를 확인해 맞춥니다.

인증: CI 전용 워크로드 자격
범위: 변경 파일 읽기와 정적 분석 결과 요약
허용 도구: Read, Grep
금지: 파일 쓰기, 셸의 네트워크 호출, 배포, 비밀 출력
실행 제한: 최대 턴 수와 작업 시간
비용 제한: CI 전용 워크스페이스 월 상한과 50%·80% 알림
감사 기록: 커밋 SHA, 실행 주체, 모델, 토큰, 결과 상태
실패 처리: 재시도 1회 뒤 사람 검토로 전환

이 신호가 보이면 멈추거나 경로를 바꿉니다

개인 구독은 포함 사용량에 반복적으로 막혀 중요한 작업을 끝내지 못하거나, 대화형 작업보다 예약 실행이 더 많아지는 시점에 다시 판단합니다. API는 월 상한의 절반을 예상보다 훨씬 이른 시점에 넘거나, 실행당 상위 비용이 기준선의 두 배를 넘으면 새 호출을 늘리지 말고 원인을 확인합니다.

CI에서는 자격증명 오류가 반복되거나, 예상하지 않은 도구 호출이 나타나거나, 처리할 변경 범위가 정한 파일 수를 넘으면 즉시 중단해야 합니다. 비용 한도에 닿았을 때 자동으로 다른 개인 키로 우회하는 방식은 금지합니다. 작업을 건너뛰고 사람에게 알리는 편이 비용 통제를 무력화하지 않습니다.

세 경우의 추천은 이렇게 정리됩니다

개인 대화형 사용자에게는 적격 구독이 첫 선택입니다. 월 비용을 예측하기 쉽고 로그인과 터미널 사용이 자연스럽기 때문입니다. 소규모 팀에는 개인별 자격과 중앙 청구가 가능한 좌석 또는 Console 기반 구성을 권합니다. 공용 API 키를 돌려 쓰는 선택은 제외합니다.

CI 자동화에는 별도 워크스페이스의 API 과금, 조직이 승인한 클라우드 경로, 공식 GitHub Actions가 지원하는 구독 OAuth가 후보입니다. 구독 OAuth는 발급한 사람의 구독에 묶이므로 여러 저장소가 공유하는 조직 비밀에는 Console API 키나 워크로드 신원을 사용합니다. 인증 수명, 비용 귀속과 조직 정책을 비교하고 실행 횟수·도구·시간을 제한합니다.

플랜 이름과 단가는 바뀔 수 있습니다. 결제 직전에는 공식 가격과 계정 화면에서 지역별 금액, Claude Code 포함 여부, 사용 제한을 다시 확인해야 합니다. 반면 사람과 기계의 자격을 분리하고 비용을 작업 단위로 귀속하는 원칙은 그대로 남습니다.

결제 수단보다 실행 주체를 먼저 묻습니다

다음은 가격표를 복사하는 세션이 아니라 현재 공식 문서에서 인증과 비용 통제 방식을 확인하는 예시입니다. 가격과 플랜 이름은 고정 사실로 저장하지 않습니다.

cd /path/to/project
claude --permission-mode plan

CLAUDE.md와 CI 설정을 읽고 사람의 대화형 실행과 기계 실행을 구분하세요.
code.claude.com 비용 문서와 공식 Platform 인증 문서만 확인하세요.
파일 수정과 결제·키 발급은 금지합니다.
반환 형식: 실행 주체 / 인증 소유자 / 예산 통제 / 감사 필요 / 권장 경로 / 확인이 필요한 현재 가격

반환표를 조직 규칙과 대조합니다

선택표에 공용 키나 개인 구독 자격의 자동 재사용이 나오면 해당 안을 제외합니다. CI 안에는 최대 작업 횟수, 허용 도구와 출력 형식만 남기고 비밀값이나 확인하지 않은 월 금액은 넣지 않습니다.

비대화형 예시는 제한을 코드로 보여 줍니다

실제 호출 전 현재 CLI 명세를 확인합니다. 아래 명령은 형태를 설명하는 예시이며 키 발급이나 청구 변경을 수행하지 않습니다.

claude -p --max-turns 4 --allowedTools 'Read' 'Grep' --output-format json '변경 없이 실패 원인만 요약하세요.'
git diff --exit-code

선택을 보류해야 하는 경우

현재 공식 가격과 조직 계약을 확인할 권한이 없거나 자격 회수 주체가 정해지지 않으면 결론을 내리지 않습니다. 같은 예산 설계는 재개할 수 있지만 사람용 터미널에서 CI 자동화로 실행 주체가 바뀌면 별도 세션에서 권한 모델부터 다시 읽습니다.

구독과 API는 같은 한도로 움직이지 않는다

Claude 앱 구독으로 로그인한 사용량과 Anthropic Console의 API 사용량은 별도로 계산됩니다. Bedrock, Vertex AI 같은 클라우드 제공자를 연결한 경우에는 해당 제공자의 청구 체계를 따릅니다. 팀이 어떤 인증 경로로 로그인했는지 모르면 사용량과 비용을 비교해도 결론이 틀릴 수 있습니다.

개인 대화형 작업은 예측 가능한 구독이 편하고, 자동화·서비스 통합은 호출량을 계측할 수 있는 API 경로가 맞을 수 있습니다. 다만 요금과 사용 한도는 바뀌므로 숫자를 글에 고정하기보다 공식 가격 페이지와 조직의 실제 청구 데이터를 함께 봅니다.