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 및 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 요금제의 사용량은 차감되지 않고 청구서 금액만 늘어납니다.

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 구독자의 결제 설정 페이지가 열립니다.

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

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

마지막 두 가지 경우는 함께 사용하기 좋습니다. 직접 수행하는 작업은 구독을 유지하고, 자동화 작업에는 별도의 API key를 부여하십시오. 이렇게 하면 야간 실행 작업이 다음 날 아침에 필요한 세션 허용량을 모두 소진하는 일을 방지할 수 있습니다. 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로 요금을 청구하여 구독 허용량을 사용하지 않게 만들기 때문입니다.