Switch얼리 액세스클로드 코드 요금: Claude 구독과 API 결제 비교
Claude Code는 Claude 구독 또는 API 결제로 사용할 수 있습니다. 구독(Pro, Max, Team, Enterprise)을 쓰면 요금제의 한도 안에서 사용량이 포함됩니다. API 키를 쓰면 토큰당 비용을 내며 요금제 한도는 없습니다. ANTHROPIC_API_KEY가 설정되어 있고 사용이 승인되면, Claude Code는 구독 대신 이 키를 사용합니다.
다른 언어: English · Español · Deutsch · Français · 日本語 · 简体中文 · Português (Brasil) · Italiano · Nederlands · 繁體中文
독립적인 Claude Desktop 프로필 관리 앱 Switch가 작성한 가이드입니다. Switch는 정식 출시를 앞두고 얼리 액세스 중입니다.
Claude Code 요금을 내는 두 가지 방법
구독 로그인. claude.ai 계정으로 로그인합니다. Claude Code는 모든 유료 요금제에 포함되며 그 한도를 함께 사용합니다. 5시간마다 초기화되는 세션 한도와 주간 한도입니다. 2026년 10월 기준 Pro는 월 $20, Max는 월 $100 또는 $200입니다(claude.com/pricing).
API 결제. Claude Console 계정, API 키 또는 클라우드 제공업체를 사용합니다. 사용량은 토큰당 종량제로 해당 계정에 청구되며, 사용이 강제로 멈추는 지점이 없습니다(Models, usage, and limits in Claude Code). API 가격은 모델마다 다르며 입력 토큰과 출력 토큰 100만 개 단위로 청구됩니다. 최신 요금은 Anthropic의 가격 페이지에서 확인하세요.
어떤 방식이 나에게 맞을까
구독은 매달 비용을 예측할 수 있습니다. 대신 한도에 도달하면 작업을 멈추거나 유료 크레딧으로 전환해야 합니다. API 결제는 종량제이므로 비용이 사용량에 따라 달라집니다. 다만 API 계정에는 속도 제한(rate limit)이 있고, 관리자가 워크스페이스에 지출 한도를 설정할 수 있습니다.
규모를 가늠해 보면, Anthropic의 비용 페이지에 따르면 엔터프라이즈 환경 전체에서 평균 비용은 개발자 1명당 활동일 하루 약 $13, 월 $150~$250이며, 사용자의 90%는 활동일 하루 $30 미만입니다. 실제 비용은 모델 선택, 코드베이스 크기, 사용 습관에 따라 달라집니다.
구독은 예측 가능한 청구서가 중요하고 매일 꾸준히 사용하는 경우에 적합합니다. Anthropic은 집중적인 코딩 스프린트에는 API 크레딧이 있는 Console 계정도 권합니다.
현재 어떤 방식이 활성화되어 있는지 확인하기
Claude Code에서 /status를 실행하세요. Anthropic의 인증 문서에 따르면 이 명령은 어떤 방식이 활성화되어 있는지 확인해 주며, 로그인과 API 키가 모두 설정되어 있으면 사용하지 않는 쪽을 표시해 줍니다.
다른 단서도 있습니다. 구독을 쓰는 경우 /usage에 요금제 사용량 막대가 표시되고, API 결제를 쓰는 경우 Session(세션) 블록에 예상 비용이 달러로 표시됩니다. API 사용자는 /cost를 실행해 지금까지의 지출을 확인할 수도 있습니다.
ANTHROPIC_API_KEY는 구독보다 우선합니다
예상치 못한 요금이 나오는 가장 흔한 원인입니다. Claude Code의 인증 우선순위에서 ANTHROPIC_API_KEY 환경 변수는 구독 로그인보다 우선합니다. 대화형 모드에서는 Claude Code가 이 키를 사용할지 한 번 묻고 선택을 기억합니다. 비대화형 모드(-p)에서는 항상 키를 사용합니다. Anthropic 고객센터는 이 경우 요금제에 포함된 사용량 대신 API 요금이 청구된다고 경고합니다.
구독으로 되돌리려면 다음을 실행합니다.
unset ANTHROPIC_API_KEY그런 다음 셸 프로필에서 이 변수를 설정하는 줄을 지우고, Claude Code를 다시 시작한 뒤 /status를 확인하세요. 변수가 설정되어 있는 동안에는 /config의 "Use custom API key"(사용자 지정 API 키 사용) 토글로 이전 선택을 바꿀 수도 있습니다. Claude Desktop은 이 변수를 읽지 않으며 OAuth로 로그인합니다.
요금제 안에서만 사용하기
구독으로 한도에 도달하면 Claude Code가 API 크레딧으로 계속할지 제안할 수 있습니다. Anthropic에 따르면 이를 거절하고 초기화를 기다려도 됩니다. 이 제안이 나타나지 않게 하려면 로그아웃한 뒤 Pro 또는 Max 자격 증명으로만 다시 로그인하고, Console 자격 증명은 추가하지 마세요(Use Claude Code with your Pro or Max plan). API 크레딧 자동 충전은 Console 설정이므로, 이전에 API 결제를 사용한 적이 있다면 그곳에서 확인하세요.
업무용 계정과 개인 요금제의 결제 방식이 서로 다르다면, 로그인이 섞이지 않도록 각각 별도의 CLAUDE_CONFIG_DIR를 지정하세요. Mac 한 대에서 여러 Claude Code 계정 쓰기를 참고하거나, Claude Desktop 안에서 Claude Code를 사용한다면 Claude Code용 Switch를 확인하세요.