Claude Code는 Claude Pro에 포함되나요?
Claude Code는 Pro, Max, Ultra, Team, 현재 Enterprise에 포함되며 무료 plan은 제외됩니다. chat과 사용량 한도를 공유하고, API key 사용 시 token당 과금됩니다.
Claude Code는 Claude Pro에 포함됩니까?
예. Claude Code는 Claude Pro, Max, Ultra, 모든 Team seat 및 현재 Enterprise seat에 포함됩니다. 따라서 하나의 subscription으로 chat app과 terminal tool을 모두 사용할 수 있습니다. 이전 Enterprise contract에서는 seat type에 따라 다릅니다. Premium seat와 Chat + Claude Code seat만 Claude Code를 포함하므로, 자신이 어떤 seat을 사용하는지 확인해야 합니다. 무료 Claude plan에는 Claude Code가 포함되지 않습니다. Anthropic의 설정 문서에도 명시되어 있듯이 Claude Code에는 Pro, Max, Ultra, Team, Enterprise 또는 Console account가 필요합니다. 무료 plan에서는 Claude Code에 액세스할 수 없습니다. subscription을 사용하면 API key(application programming interface key, token당 과금)가 필요하지 않습니다. API key는 선택 사항입니다. ANTHROPIC_API_KEY가 설정되어 있고 사용자가 이를 승인하면 해당 session은 대신 token당 과금됩니다. 이는 대화형 작업과 별도로 자동 실행 비용을 청구하려는 경우나, 특정 key로 청구할 간헐적인 session에 적합합니다. subscription이 없으면 Console account를 사용해야 하며, token당 과금됩니다.
다음 부분에서 많은 사용자가 잘못 이해합니다. Claude Code에는 별도의 사용량 한도가 없습니다. Claude Code는 chat conversation과 동일한 subscription usage budget을 사용합니다. 따라서 긴 coding session을 실행하면 그 뒤에 사용할 수 있는 chat window가 줄어듭니다. Anthropic은 Pro, Max 및 Ultra plan의 usage limit이 Claude와 Claude Code 간에 공유된다고 설명합니다. 즉, 두 tool에서 수행한 모든 활동이 동일한 usage limit에 합산됩니다. 예외는 현재 usage-based Enterprise plan입니다. 이 plan에는 공유할 포함 usage budget이 없습니다. seat별 usage limit이 없으며, 어느 tool에서든 발생한 모든 request에 API 요율이 적용됩니다.
각 요금제별 제공 사항
- Free: Claude Code를 사용할 수 없습니다. 웹과 앱에서 채팅만 가능하며 터미널에서는 아무것도 지원하지 않습니다.
- Pro: Pro 사용량 수준의 Claude Code가 포함됩니다. 2026년 11월 기준 미국 내 월 20달러이며, 연간 결제 시 더 저렴합니다.
- Max: Pro 사용량의 5배를 5시간 및 매주 단위로 제공하는 Claude Code가 포함됩니다. 2026년 11월 기준 웹 결제 시 월 100달러이며, 월간 결제만 가능합니다. 월 100달러 상당의 API 크레딧이 포함됩니다.
- Ultra: Pro 사용량의 10배를 매주 단위로 제공하는 Claude Code가 포함됩니다. 2026년 11월 기준 웹 결제 시 월 200달러이며, 월간 결제만 가능합니다. 월 200달러 상당의 API 크레딧이 포함됩니다. Max와 Ultra의 모바일 가격은 다를 수 있습니다.
- Team 및 Enterprise: 모든 Team 좌석에 포함됩니다. 허용량은 좌석에 귀속되며, 프리미엄 좌석이 표준 좌석보다 더 많은 허용량을 가집니다. 현재 Enterprise 요금제는 Claude Code가 포함된 단일 좌석 유형을 사용하며, 좌석별 허용량은 없습니다. 모든 사용량은 관리자가 설정한 지출 한도 내에서 API 요금으로 청구됩니다. 구형 Enterprise 계약은 별도의 좌석 유형을 사용합니다. 프리미엄 좌석과 Chat + Claude Code 좌석에만 Claude Code가 포함되며, 좌석 기반 계약에만 포함된 허용량이 존재합니다.
요금제 가격은 변동될 수 있고 이 페이지는 실시간으로 업데이트되지 않으므로, 위 가격이 유일한 정보입니다. 현재 수치는 Claude Code 전체 비용 분석에서 확인할 수 있으며, 요금제 간 선택은 Claude 구독 요금제별 비교를 통해 검토할 수 있습니다. 또한, 제한 상황이라고 단정 짓기 전에 무료 Claude 티어의 제공 범위를 확인하는 것이 좋습니다.
코딩 세션 하나가 채팅 창 사용량을 줄이는 이유
Pro, Max 또는 Team 구독과 기존 좌석 기반 Enterprise 계약의 좌석에는 두 개의 창이 적용됩니다. 세션 한도는 5시간마다 초기화됩니다. 주간 한도는 계정에 지정된 매주 고정된 시각에 초기화되며, 사용량 화면에서 자신의 초기화 시각을 확인할 수 있습니다. 인증된 Ultra 계정에는 5시간 한도가 없고, 인증되지 않은 계정에는 임시 한도가 적용됩니다. Ultra에도 모든 모델에 걸쳐 적용되는 주간 한도가 있으며, Max와 Ultra는 Fable에 일반 주간 허용량의 절반만 배정합니다. 이 사용량은 동일한 예산에서 차감되며 다른 모델보다 더 빠르게 소진됩니다. 현재 사용량 기반 Enterprise 요금제에는 두 창이 모두 없습니다. 이 요금제는 사용량에 따라 과금되며, 관리자가 지출 한도로 제한합니다. 대화가 얼마나 길어지는지와 어떤 모델을 실행하는지에 따라 실제 사용량이 달라지므로 어느 창도 미리 계산할 수 있는 메시지 수가 아닙니다. 이를 예산으로 관리할 숫자가 아니라 모니터링해야 할 사용 패턴으로 보십시오. 한도에 도달하기 전에 한도 작동 방식 자세히 알아보기를 한 번 읽어 두는 것이 좋습니다.
Claude Code는 코딩 요청에 포함되는 내용 때문에 채팅보다 해당 예산을 더 빠르게 소진합니다. 모든 요청은 그때까지의 전체 대화를 전송합니다. 각 도구 호출, 파일 읽기 또는 테스트 실행은 이전 결과를 포함한 추가 요청을 전송합니다. Anthropic이 관리자를 위한 지침에서 코딩 좌석에 채팅 좌석보다 더 많은 예산을 책정하라고 안내하는 이유도 같습니다. 디버깅 세션 하나가 채팅 하루 사용량을 초과할 수 있습니다.
프롬프트 캐싱은 이 문제를 완화하지만 없애지는 않습니다. 반복되는 컨텍스트는 캐시 요율로 다시 읽히므로, 하루 종일 열린 세션 안에서 한 줄짜리 질문을 하더라도 그 뒤에 있는 전체 대화에 대한 사용량이 발생합니다. 구독 요금제에서 요금제에 포함된 사용량 범위 안에 있는 동안에는 기본 대화의 캐시 수명이 1시간입니다. 하위 에이전트, 압축 작업 및 Claude Code가 해당 대화 외부에서 수행하는 대부분의 요청은 기본값이 5분입니다. 1시간보다 오래 자리를 비우면 돌아온 뒤 첫 번째 메시지는 캐시를 적중하지 못합니다. 따라서 전체 컨텍스트가 캐시 쓰기 요율로 캐시에 다시 기록됩니다. 이 요율은 일반 입력 요율과 같지 않고 더 높습니다. Anthropic은 1시간 캐시 쓰기에 기본 입력 가격의 2배를, 5분 캐시 쓰기에 1.25배를 부과합니다. 해당 메시지 하나의 비용이 그 전에 보낸 20개의 메시지보다 클 수 있습니다.
공유 예산을 소진하고 있다는 실질적인 징후
Claude Code 내에서 /usage을 실행하십시오. 유료 요금제 사용 시 요금제 한도에 대한 사용량 막대 그래프가 표시되며, 무엇이 예산을 소진하고 있는지에 대한 분석이 제공됩니다. 최근 24시간 내역은 d를, 최근 7일 내역은 w를 눌러 확인하십시오.
분석 결과는 긴 컨텍스트나 캐시 미스(cache miss) 등 최근 사용량의 10퍼센트 이상을 차지하는 동작을 표시하며, 기술(skills), 하위 에이전트(subagents), 플러그인 및 개별 MCP (model context protocol) 서버별로 사용량을 분류합니다. 한 가지 주의할 점이 있습니다. 해당 수치는 현재 사용 중인 기기의 로컬 세션 기록을 기반으로 계산되므로, 다른 기기나 claude.ai에서 수행한 작업은 분석에 포함되지 않습니다. 요금제 막대 그래프는 전체 계정 기준이지만, 사용량 분류는 로컬 기준입니다.
사용량이 한도에 도달하면 메시지에 어떤 제한에 걸렸는지 표시됩니다.
You've hit your session limit
You've hit your weekly limit위 두 창은 모든 모델에 공통으로 적용되므로 /model를 사용하여 모델을 전환해도 사용 권한이 복구되지 않습니다. You've hit your Opus limit와 같은 모델별 메시지는 다른 경우이며, 이 상황에서는 /model를 통해 다른 모델로 작업을 계속할 수 있습니다. 컨텍스트 경고나 자동 요약 알림은 사용량 한도가 아닙니다. 이는 대화가 세션의 컨텍스트 윈도우에 근접하여 이전 기록이 요약될 예정임을 의미합니다. Anthropic의 비용 가이드는 컨텍스트 관리를 최우선으로 하며, 컨텍스트 윈도우를 작게 유지하는 것이 예산 소진 속도에 가장 확실한 영향을 미칩니다. 관련 없는 작업 간에 /clear을 수행하면 비용이 발생하지 않으며, 다음 요청을 더 가벼운 상태로 시작할 수 있습니다. 이미 차단된 상태라면 한도 도달 시 선택할 수 있는 옵션은 대기, 업그레이드, 또는 사용량 크레딧 활성화로 요약됩니다. Anthropic이 계정에 무료 한도 초기화를 제공했다면 네 번째 옵션이 있습니다. 웹, Claude Desktop 또는 Claude 모바일 앱의 설정(Settings > Usage)에서 초기화하십시오(터미널이나 IDE의 Claude Code에서는 불가능합니다). 한도는 계정 전체에서 공유되므로 초기화된 사용량은 Claude Code에도 적용됩니다. 초기화되는 내용은 초기화 유형에 따라 다릅니다. 5시간 또는 주간 초기화는 해당 한도를 다시 최대로 복구합니다. Fable 한도 초기화는 Fable 모델에 사용한 주간 사용량만 복구하므로, 다른 모델에 사용한 사용량은 주간 한도에 계속 합산됩니다. 단, 계정에 5시간 한도가 있는 경우 해당 한도는 완전히 복구됩니다.
API 키가 청구 금액을 모두 부담하게 되는 이유
이 문제는 서버에서 가장 심각하게 발생한다. ANTHROPIC_API_KEY 환경 변수가 설정되어 있고 사용을 승인하면 Claude Code는 구독 대신 해당 키로 인증한다. 그러면 작업 비용이 토큰 단위로 API 계정에 청구된다. 대화형 세션에서는 키를 사용할지 한 번 묻고 응답을 기억한다. 따라서 몇 달 전에 승인한 키가 추가 확인 없이 계속 사용될 수 있다. 나중에 이 선택을 변경하려면 /config에 표시되는 "Use custom API key" 토글을 사용한다. 이 토글은 변수가 설정된 동안에만 표시된다. 비대화형 모드(claude -p)에서는 키가 있으면 아무런 확인 없이 사용한다. Pro, Max 또는 Ultra의 사용량 한도는 그대로 남아 있는 동안 청구 금액만 증가한다. 반대편에 무료 사용량이 제공되는 것도 아니다. Claude API에는 무료 요금제가 없기 때문이다. 가입 시 제공되는 소액 크레딧만 예외다. Max, Ultra 및 Team 요금제에 포함된 월간 API 크레딧은 대화형 Claude Code에 사용할 수 없다. 이 크레딧은 claude -p 실행과, 요금제에 연결된 Console 조직에서 API 키를 사용해 직접 시작한 Agent SDK 작업에는 사용할 수 있다.
VPS에서는 다른 도구의 키를 같은 셸 프로필에 보관하는 경우가 많기 때문에 노트북보다 이런 일이 더 자주 실수로 발생한다. Anthropic은 구독으로 결제하려면 ANTHROPIC_API_KEY을 설정하지 않은 상태로 두고, 키가 필요한 터미널 세션에서만 키를 설정하라고 안내한다. 로그인한 뒤에는 구독 로그인과 API 키가 모두 활성화되어 있을 때 Claude Code에도 알림이 표시된다. 시작하기 전에 확인한다.
printenv ANTHROPIC_API_KEY아무것도 출력되지 않으면 이 셸에는 API 키가 설정되지 않은 것이다. 그렇다고 Claude Code가 구독을 사용한다는 뜻은 아니다. 자격 증명은 ANTHROPIC_AUTH_TOKEN, apiKeyHelper 스크립트 또는 설정 파일의 env 블록에서도 가져올 수 있다. 관리자가 관리하는 설정도 여기에 포함된다. 이러한 설정은 모두 claude.ai 로그인보다 우선한다. Claude Code 내부에서 /status을 실행하면 현재 활성화된 인증 방식을 확인할 수 있다. 키가 출력되면 이전에 해당 키 사용을 승인했거나 claude -p을 실행한 경우 다음 세션에서 API 사용량이 청구된다. 그렇지 않으면 Claude Code가 먼저 확인하며, 거부하면 구독을 계속 사용한다. 이 셸에서 변수를 지운 다음 변수를 계속 설정하는 파일을 찾는다.
unset ANTHROPIC_API_KEY
grep -rn ANTHROPIC_API_KEY ~/.bashrc ~/.profile ~/.bash_profile 2>/dev/null이제 Claude Code를 시작하고 구독 계정으로 로그인한다.
claude처음 실행하면 브라우저 로그인 과정이 시작된다. 세션 내부에서 /login은 계정을 전환하고, /status는 현재 사용 중인 인증 방식을 표시하며, /usage은 어떤 결제 방식이 적용되었는지 확인한다. 구독자는 요금제 사용량 막대를 보고, API 계정은 토큰 비용이 표시된 세션 블록을 보며 요금제 사용량 막대는 표시되지 않는다. 연결이 끊긴 뒤에도 세션을 유지하는 방법을 포함한 나머지 서버 설정은 tmux 안에서 VPS의 Claude Code 실행에서 설명한다. 권한 관련 내용은 자신이 소유한 서버에서 Claude Code를 안전하게 실행에서 설명한다.
관련된 함정이 하나 더 있다. 요금제 사용량 한도에 도달하면 사용량 크레딧을 활성화해 한도를 초과하여 계속 작업할 수 있다. 이 비용은 구독 요금에 추가로 청구된다. 크레딧을 사용하기 시작하면 Claude Code는 기본 대화의 프롬프트 캐시 유지 시간을 1시간에서 5분으로 줄인다. 따라서 이전에는 무료였던 동일한 유휴 시간이 비용으로 청구되기 시작한다. promptCacheTtl 설정을 직접 1h로 지정하면 이를 방지할 수 있다. /usage-credits은 Pro, Max 또는 Ultra 구독자의 Settings > Usage를 연다.
무엇에 비용을 지불해야 하는가?
이 내용은 먼저 비용을 지불하기로 결정했다는 전제에서 출발한다. Claude Code가 자신의 시간당 요율을 기준으로 비용을 회수하는지가 그 결정을 위한 산술적 근거다. 터미널 도구가 아니라 구독 자체를 비교하는 경우에는 실제 Claude 사용 방식에 Claude Pro가 가치가 있는지를 판단하는 출발점이 다르다. 우선 무료 한도에 얼마나 자주 막히는지를 확인해야 한다.
- 가끔 코딩하거나 취미로 코딩하는 경우: Pro가 적합하다. 도구 1개와 청구서 1개로, 일주일에 몇 차례 세션을 사용하기에 충분하다. 제공량에 관한 자세한 내용은 Pro 요금제의 가격과 한도를 참고한다.
- 매일 지속적으로 코딩하는 경우: Max 또는 Ultra가 적합하다. Max는 두 사용량 구간 모두에서 Pro의 5배 사용량을 제공한다. Ultra는 매주 Pro의 10배 사용량을 제공하며, 인증된 계정에서는 5시간 제한도 없앤다. Max와 Ultra 중 선택하는 기준은 주간 한도에 얼마나 자주 도달하는지, 그리고 5시간 제한 없이 작업해야 하는지에 따라 결정된다.
- 여러 사람이 사용하는 경우: Team 또는 Enterprise seat를 사용한다. 이 경우 제공량은 seat를 기준으로 적용된다. 단, 현재의 사용량 기반 Enterprise 요금제에서는 모든 요청이 API 요율로 청구되며 admin 지출 한도가 적용된다. 또한 admin은 사용자별 지출을 확인할 수 있다. seat 비용과 동일한 작업의 token 비용 비교를 통해 seat를 대량으로 구매하기 전에 비교해야 한다.
- 간헐적으로 집중되거나 자동화된 실행: API 청구가 적합하다. 야간 작업이나 CI(continuous integration) 단계가 대화형 작업과 동일한 제공량을 두고 경쟁할 이유는 없다.
마지막 두 경우는 함께 사용하기 좋다. 직접 수행하는 작업에는 구독을 유지하고, 자동화에는 별도의 API key를 사용한다. 그러면 야간 실행이 다음 날 아침에 필요한 사용량 구간을 모두 소진하지 않는다. API와 구독 비용 비교에서 손익분기점이 어디에 있는지 확인할 수 있다.
FAQ
무료 Claude 요금제에서 Claude Code를 사용할 수 있습니까?
아니요. Claude Code를 사용하려면 Pro, Max, Ultra, Team, Enterprise 또는 Console 계정이 필요합니다. Anthropic의 설정 문서에 따르면 무료 Claude 요금제에는 Claude Code 사용 권한이 포함되지 않습니다. 따라서 claude을 실행하면 유료 계정으로 로그인하거나 API key로 인증하라는 메시지가 표시됩니다. 무료 요금제에서도 웹 및 데스크톱 앱의 채팅은 사용할 수 있습니다. 따라서 비용을 지불하기 전에 Claude가 질문 유형에 적절히 답하는지 테스트할 수 있습니다.
Claude Code는 Claude 채팅과 동일한 사용량 제한을 적용합니까?
Pro, Max 및 Ultra에서는 그렇습니다. Anthropic에 따르면 Claude와 Claude Code는 사용량 제한을 공유합니다. 따라서 두 도구에서 수행한 모든 활동이 동일한 제한에 합산됩니다. Pro와 Max에는 5시간마다 재설정되는 세션 제한이 있습니다. 세 요금제 모두 계정에 지정된 고정 시각에 매주 재설정되는 주간 제한이 있습니다. 인증된 Ultra 계정에는 5시간 제한이 없습니다. 인증되지 않은 계정에는 임시 제한이 적용됩니다. Max와 Ultra에서는 Fable의 한도가 일반 주간 허용량의 절반으로 제한됩니다. 이 한도는 동일한 예산에서 차감되므로 다른 모델보다 더 빠르게 소진됩니다. 실제로 오후 내내 대규모 리팩터링을 수행하면 저녁에 사용할 수 있는 채팅 한도가 얼마 남지 않을 수 있습니다. /usage을 실행하면 사용량 막대와 다음 재설정 시각을 확인할 수 있습니다.
한 번의 코딩 세션에서 사용량이 너무 빠르게 줄어든 이유는 무엇입니까?
코딩 요청 한 번에는 채팅 메시지보다 훨씬 많은 컨텍스트가 포함되기 때문입니다. 모든 요청에는 전체 대화가 포함됩니다. 각 도구 결과는 이를 다시 포함하는 추가 요청을 만듭니다. /usage를 실행하고 동작 플래그를 확인하십시오. 최근 사용량의 10 percent 이상을 차지하는 항목에는 표시가 추가됩니다. 일반적인 원인은 긴 컨텍스트와 cache miss입니다. 하루 종일 열어 둔 세션은 전체 기록을 계속 다시 전송합니다. 또한 cache 수명보다 긴 유휴 시간이 지나면 다음 메시지에서 전체 기록을 cache에 다시 기록합니다. 구독 요금제의 요금제 내 사용량에서는 주 대화의 cache 수명이 1 hour입니다. subagent의 cache 수명은 5 minutes이며, usage credits를 사용하기 시작한 뒤에도 5 minutes입니다. 이때 cache-write 요금은 일반 input 요금보다 높습니다. 1-hour cache write에는 기본 input 요금의 2배가 적용되고, 5-minute cache write에는 1.25배가 적용됩니다. 서로 관련 없는 작업 사이에 /clear를 사용하면 두 문제를 모두 줄일 수 있습니다.
API key가 Pro 또는 Max 구독보다 저렴한 경우는 언제입니까?
작업이 간헐적으로 실행되거나 자동화된 경우입니다. API 과금은 월별 최소 요금 없이 token 단위로 이루어집니다. 따라서 일주일에 두 번 실행되는 script는 사용한 token 비용만 발생하고 추가 비용은 없습니다. 반면 구독은 실제로 사용하지 않는 용량에 대해서도 한 달 요금을 지불합니다. 매일 지속적으로 코딩한다면 반대입니다. 구독은 많은 허용량을 고정 가격으로 제공하지만, 동일한 사용량을 token 단위로 지불하면 비용이 더 커집니다. 직접 코딩하는 컴퓨터에서 ANTHROPIC_API_KEY를 설정하는 것은 피해야 할 실수입니다. 프롬프트에서 key 사용을 승인하거나 해당 key가 설정된 상태로 claude -p를 실행하면 Claude Code가 API에 과금하고 구독 허용량은 사용하지 않기 때문입니다.