Claude Code는 Claude Pro 구독에 포함되나요?

Claude Code는 Claude Pro에 포함되어 있습니까?

네, 포함되어 있습니다. Claude Code는 Claude Pro뿐만 아니라 Max, Team, Enterprise 계정에도 포함되어 있으므로 하나의 구독으로 채팅 앱과 터미널 도구를 모두 사용할 수 있습니다. 무료 Claude 플랜에는 포함되지 않습니다. Anthropic의 설정 문서에 따르면 Claude Code를 사용하려면 Pro, Max, Team, Enterprise 또는 Console 계정이 필요하며, 무료 플랜은 Claude Code 접근 권한을 제공하지 않습니다. API key(애플리케이션 프로그래밍 인터페이스 키, 토큰당 과금)는 구독이 없거나, 대화형 작업과 별도로 자동화된 실행에 대해 비용을 지불하려는 경우에만 필요합니다.

사용자들이 흔히 오해하는 부분은 다음과 같습니다. Claude Code는 별도의 사용량 한도를 가지고 있지 않습니다. 채팅 대화와 동일한 구독 사용량 예산을 공유하므로, 긴 코딩 세션을 진행하면 이후 사용할 수 있는 채팅 횟수가 줄어듭니다. Anthropic은 Pro와 Max 플랜 모두 Claude와 Claude Code 간에 공유되는 사용량 제한을 제공한다고 명시하고 있으며, 이는 두 도구에서의 모든 활동이 동일한 사용량 제한에 합산됨을 의미합니다.

각 플랜의 실제 제공 범위

• Free: Claude Code를 제공하지 않습니다. 웹과 앱에서 채팅만 가능하며, 터미널에서는 사용할 수 없습니다.
• Pro: Pro 사용량 수준에 맞춰 Claude Code가 포함됩니다. 2026년 8월 기준 미국 내 월 20달러이며, 연간 결제 시 더 저렴합니다.
• Max: 동일한 Claude Code를 더 많은 사용량으로 제공하며, 2026년 8월 기준 월 100달러와 200달러의 두 가지 등급으로 나뉩니다.
• Team and Enterprise: 좌석(seat)에 포함되어 제공됩니다. 사용량 한도는 좌석에 귀속되며, 프리미엄 좌석은 표준 좌석보다 더 많은 한도를 가집니다.

플랜 가격은 변동될 수 있으나 이 페이지는 업데이트되지 않으므로, 위 가격이 유일한 정보입니다. 현재 수치는 Claude Code 전체 비용 분석에서 확인할 수 있으며, 등급 간 선택은 Claude 구독 플랜별 비교를 통해 검토할 수 있습니다. 또한, 사용이 제한되었다고 단정하기 전에 무료 Claude 티어의 지원 범위를 확인하는 것이 좋습니다.

코딩 세션이 채팅 창을 짧게 만드는 이유

유료 구독에는 두 가지 창이 적용됩니다. 세션 제한은 5시간마다 초기화됩니다. 주간 제한은 계정에 할당된 매주 고정된 시간에 초기화되며, 사용자는 사용량 화면에서 자신의 초기화 시간을 확인할 수 있습니다. 두 제한 모두 미리 계산할 수 있는 메시지 수가 아닙니다. 대화의 길이와 실행 중인 모델에 따라 도달 범위가 달라지기 때문입니다. 이를 예산으로 책정할 수 있는 숫자가 아니라 관찰해야 할 동작으로 간주하십시오. 제한 메커니즘에 대한 자세한 내용은 제한에 도달하기 전에 한 번 읽어볼 가치가 있습니다.

Claude Code는 코딩 턴이 수반하는 작업 때문에 채팅보다 예산을 더 빨리 소진합니다. 모든 요청은 지금까지의 전체 대화를 전송합니다. 파일 읽기나 테스트 실행과 같은 각 도구 호출은 이전 결과가 포함된 또 다른 요청을 보냅니다. Anthropic의 관리자 가이드에서 코딩 좌석에 채팅 좌석보다 더 많은 예산을 책정하라고 권장하는 이유가 바로 이것입니다. 디버깅 세션 한 번이 하루치 채팅보다 더 많은 양을 소비할 수 있기 때문입니다.

프롬프트 캐싱은 이를 완화할 뿐 제거하지는 않습니다. 반복되는 컨텍스트는 캐시된 속도로 다시 읽히므로, 하루 종일 열려 있던 세션 내에서 한 줄짜리 질문을 해도 그 뒤에 있는 전체 대화에 대한 사용량이 발생합니다. 구독 시 캐시 수명은 1시간입니다. 점심 식사를 위해 자리를 비우면 돌아와서 보내는 첫 번째 메시지는 캐시를 놓치게 되며, 이는 전체 컨텍스트가 일반 속도로 다시 처리됨을 의미합니다. 그 메시지 하나가 앞선 20개의 메시지보다 더 많은 비용을 발생시킬 수 있습니다.

공유 예산 소진을 알리는 실질적인 징후

Claude Code 내에서 /usage를 실행하십시오. 유료 플랜을 사용 중이라면 플랜 한도에 대한 사용량 막대 그래프가 표시되며, 무엇이 예산을 소진하고 있는지 상세 내역을 확인할 수 있습니다. 최근 24시간 사용량은 d를, 최근 7일간의 사용량은 w를 눌러 확인하십시오.

상세 내역은 최근 사용량의 10퍼센트 이상을 차지하는 동작(예: 긴 컨텍스트나 캐시 미스)을 표시하며, 스킬, 하위 에이전트, 플러그인 및 개별 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을 수행하면 비용이 발생하지 않으며, 다음 요청 시 처리할 데이터가 줄어듭니다. 이미 사용이 제한된 경우, 한도 도달 시 선택할 수 있는 옵션은 대기, 업그레이드, 또는 사용 크레딧 활성화로 제한됩니다.

API 키가 사용자 동의 없이 요금을 청구하는 이유

이 문제는 서버 환경에서 가장 치명적입니다. ANTHROPIC_API_KEY 환경 변수가 설정되어 있으면, Claude Code는 구독 계정 대신 해당 키로 인증을 수행하며, 사용량에 따라 API 계정으로 토큰 비용이 청구됩니다. Pro 또는 Max 요금제의 사용량 한도는 그대로 유지되지만, 청구서 금액은 계속 늘어납니다. 또한 가입 시 제공되는 소액의 크레딧을 제외하면 Claude API에는 무료 티어가 없기 때문에, 무료 한도를 기대할 수도 없습니다.

VPS 환경에서는 노트북보다 이러한 실수가 더 자주 발생하는데, 이는 보통 셸 프로필에 다른 도구들을 위한 키가 함께 저장되어 있기 때문입니다. 시작하기 전에 다음 명령어로 확인하십시오.

printenv ANTHROPIC_API_KEY

아무것도 출력되지 않으면 키가 설정되지 않은 것이며, Claude Code는 구독 정보를 사용합니다. 키가 출력된다면 다음 세션부터는 API로 요금이 청구됩니다. 현재 셸에서 해당 변수를 삭제한 뒤, 변수를 계속 설정하고 있는 파일을 찾으십시오.

unset ANTHROPIC_API_KEY
grep -rn ANTHROPIC_API_KEY ~/.bashrc ~/.profile ~/.bash_profile 2>/dev/null

이제 Claude Code를 시작하고 구독 계정으로 로그인하십시오.

claude

첫 실행 시 브라우저 로그인이 진행됩니다. 세션 내에서 /login를 입력하면 계정을 전환할 수 있고, /usage을 입력하면 현재 어떤 과금 체계를 사용 중인지 확인할 수 있습니다. 구독자는 요금제 사용량 막대를 볼 수 있지만, API 계정은 토큰 비용에 대한 세션 블록만 표시되며 요금제 막대는 나타나지 않습니다. 연결을 끊은 후에도 세션을 유지하는 방법을 포함한 나머지 서버 측 설정은 tmux를 사용하여 VPS에서 Claude Code 실행하기에서, 권한 관련 내용은 직접 소유한 서버에서 안전하게 Claude Code 실행하기에서 다룹니다.

관련된 주의 사항이 하나 더 있습니다. 요금제 한도를 모두 소진하면 사용량 크레딧을 활성화하여 구독 요금 외에 추가 비용을 지불하고 작업을 계속할 수 있습니다. 크레딧을 사용하기 시작하면 프롬프트 캐시 유지 시간이 1시간에서 5분으로 단축되므로, 이전에는 무료였던 유휴 시간에도 비용이 발생하기 시작합니다. /usage-credits를 입력하면 Pro 또는 Max 구독자의 결제 설정 페이지가 열립니다.

어떤 요금제를 선택해야 할까요?

이 모든 내용은 먼저 비용을 지불하기로 결정했다는 전제에서 출발한다. Claude Code가 자신의 시간당 요율을 기준으로 비용을 회수하는지 여부를 계산하는 것이 그 결정의 근거가 된다. 터미널 도구가 아니라 구독 자체를 고민하고 있다면, 실제 Claude 사용 방식에 Claude Pro가 가치가 있는지 여부는 다른 질문에서 시작한다. 처음부터 무료 한도 때문에 작업이 중단되는 경우가 얼마나 잦은지가 기준이다.

• 가끔 또는 취미로 코딩하는 경우: Pro 요금제. 하나의 도구, 하나의 청구서로 주당 몇 차례의 세션을 진행하기에 충분합니다. 허용량에 대한 세부 정보는 Pro 요금제 가격 및 제한 사항에서 확인할 수 있습니다.
• 매일 지속적으로 코딩하는 경우: Max 요금제. 대부분의 날에 세션 제한에 도달한다면, 계정을 하나 더 만드는 것보다 더 큰 허용량을 제공하는 요금제를 선택하는 것이 더 저렴한 해결책입니다. 두 가지 Max 등급 간의 선택은 5시간 단위 제한보다는 주간 제한에 얼마나 자주 도달하는지에 따라 결정됩니다.
• 여러 명이 사용하는 경우: Team 또는 Enterprise 좌석을 고려하십시오. 이 경우 허용량은 좌석에 귀속되며 관리자가 사용자별 지출을 확인할 수 있습니다. 좌석당 비용과 동일한 작업을 토큰 단위로 수행할 때의 비용 비교는 좌석을 대량으로 구매하기 전에 반드시 수행해야 할 비교 분석입니다.
• 일시적으로 몰리거나 자동화된 실행이 필요한 경우: API 과금 방식을 사용하십시오. 야간 작업이나 CI(지속적 통합) 단계는 사용자의 대화형 작업과 동일한 허용량을 두고 경쟁할 이유가 없습니다.

마지막 두 가지 사례는 함께 활용하기 좋습니다. 직접 수행하는 작업은 구독 요금제를 유지하고, 자동화 작업에는 별도의 API 키를 부여하십시오. 이렇게 하면 야간 실행 작업이 다음 날 아침에 필요한 세션 허용량을 모두 소진하는 일을 방지할 수 있습니다. API와 구독 비용 비교를 통해 비용 효율적인 전환 지점을 확인해 보십시오.

FAQ

무료 Claude 플랜에서 Claude Code를 사용할 수 있습니까?

아니요. Claude Code를 사용하려면 Pro, Max, Team, Enterprise 또는 Console 계정이 필요합니다. Anthropic의 설정 문서에 따르면 무료 Claude 플랜에는 Claude Code 액세스 권한이 포함되어 있지 않습니다. 따라서 claude를 실행하면 유료 계정으로 로그인하거나 API 키를 사용하여 인증하라는 메시지가 표시됩니다. 무료 플랜은 웹 및 데스크톱 앱에서의 채팅을 지원하며, 이는 결제하기 전에 Claude가 귀하의 질문 유형에 적절히 답변하는지 테스트하기에 충분합니다.

Claude Code는 Claude 채팅과 동일한 사용량 제한을 공유합니까?

Pro 및 Max 플랜에서는 그렇습니다. Anthropic은 Claude와 Claude Code 간에 사용량 제한이 공유된다고 명시하고 있으므로, 두 도구에서의 모든 활동이 동일한 제한에 포함됩니다. 세션 제한은 5시간마다 초기화되며, 주간 제한은 계정에 할당된 매주 고정된 시간에 초기화됩니다. 실제로 오후 내내 집중적으로 리팩토링을 수행하면 저녁에는 채팅 가능 횟수가 줄어들 수 있습니다. /usage을 실행하여 사용량 막대와 다음 초기화 시간을 확인하십시오.

코딩 세션 중에 사용량이 왜 그렇게 빨리 줄어듭니까?

코딩 작업은 일반 채팅 메시지보다 훨씬 더 많은 컨텍스트를 포함하기 때문입니다. 모든 요청은 전체 대화 내용을 전송하며, 각 도구의 결과값은 이를 다시 포함하는 또 다른 요청을 생성합니다. /usage을 실행하여 동작 플래그를 읽어보십시오. 최근 사용량의 10퍼센트 이상을 차지하는 항목은 표시되며, 주로 긴 컨텍스트와 캐시 미스가 원인입니다. 하루 종일 열려 있는 세션은 전체 기록을 계속 다시 전송하며, 1시간인 캐시 수명보다 긴 유휴 시간이 발생하면 다음 메시지 처리 시 모든 내용을 일반 요금으로 다시 처리하게 됩니다. 관련 없는 작업 사이에 /clear을 사용하면 이 두 가지 문제를 모두 해결할 수 있습니다.

API 키가 Pro나 Max 구독보다 저렴한 경우는 언제입니까?

작업이 간헐적이거나 자동화된 경우입니다. API 요금은 월간 최소 비용 없이 토큰 단위로 부과되므로, 일주일에 두 번 실행되는 스크립트는 해당 토큰 비용만 지불하면 되지만, 구독은 사용하지 않는 기간에 대해서도 한 달 치 비용을 지불하게 됩니다. 매일 지속적으로 코딩하는 경우에는 반대입니다. 구독은 대용량 허용량에 대한 고정 가격이므로, 동일한 사용량을 토큰 단위로 결제하면 비용이 더 많이 듭니다. 직접 코딩도 수행하는 컴퓨터에 ANTHROPIC_API_KEY를 설정하는 것은 피해야 할 실수입니다. 이 경우 Claude Code가 API로 요금을 청구하여 구독 허용량을 사용하지 않게 되기 때문입니다.