Claude Code 클라우드 세션 크레딧 차감 원리 및 요금제 관계

이미 요금제를 결제했는데 클라우드 세션에서 크레딧이 차감되는 이유

클라우드 세션 크레딧은 요금제에 포함된 사용량을 사용하기 전에 먼저 차감되는 선불 잔액입니다. 클라우드 세션은 사용자의 노트북이 아닌 Anthropic의 머신에서 실행되는 Claude Code 세션을 의미합니다. 이 세션은 여전히 사용자의 구독 범위에 포함되며, Anthropic의 문서에 따르면 세션이 실행되는 가상 머신(VM)에 대한 별도의 컴퓨팅 비용은 청구되지 않습니다. 크레딧이 변경하는 것은 계량 방식의 우선순위입니다. 계정에 크레딧 잔액이 남아 있는 동안에는 클라우드 세션이 해당 잔액을 먼저 소진하며, 잔액이 모두 소진된 후에야 터미널 세션 및 채팅과 공유되는 기존 사용량 풀에서 차감되기 시작합니다.

따라서 "Pro나 Max 요금제를 결제했는데 왜 크레딧이 차감되는가"라는 질문에 대한 답은, 해당 크레딧이 요금제를 대체하는 것이 아니라 요금제 앞단에 위치한 추가적인 풀이기 때문입니다. 구독 내용에는 아무런 변경이 없으며, 단지 그 앞에 두 번째 계량기가 추가된 것입니다.

이 세션이 내 컴퓨터에서 실행 중입니까, 아니면 클라우드에서 실행 중입니까?

다른 모든 사항은 이 구분 방식에 따라 달라지며, 인터페이스에서 항상 명확하게 표시되는 것은 아닙니다. 브라우저의 claude.ai/code, Claude 모바일 앱의 Code 탭, Desktop 앱에서 Local 대신 Cloud를 선택한 경우, 터미널에서 claude --cloud를 사용하거나 예약된 루틴을 통해 세션을 시작하면 해당 세션은 클라우드에서 실행됩니다. 터미널, IDE 또는 Desktop 앱에서 Local을 선택하여 세션을 시작하면 해당 세션은 사용자의 컴퓨터에서 실행됩니다.

한 가지 사례는 예외처럼 보이지만 그렇지 않습니다. Remote Control을 사용하면 사용자의 컴퓨터에서 세션이 실행되는 동안 휴대폰이나 브라우저를 통해 해당 세션을 확인하고 제어할 수 있습니다. 이는 로컬 세션이므로 클라우드 크레딧을 전혀 소모하지 않으며, 작업은 이미 보유하고 있는 하드웨어에서 실행됩니다.

클라우드 세션은 Pro, Max, Team 플랜에서 사용할 수 있으며, 프리미엄 좌석 또는 Chat + Claude Code 좌석을 보유한 Enterprise 사용자도 사용할 수 있습니다.

클라우드 세션의 사용량은 어디에서 차감됩니까?

계정에 남아 있는 크레딧을 모두 소진한 후에는 계정의 일반 사용량 한도에서 차감됩니다. 클라우드 세션 문서에는 다음과 같이 명시되어 있습니다. "클라우드 세션은 계정 내의 다른 모든 Claude 및 Claude Code 사용량과 비율 제한(rate limits)을 공유합니다. 여러 작업을 병렬로 실행하면 그에 비례하여 더 많은 비율 제한을 소모합니다. 클라우드 VM에 대한 별도의 컴퓨팅 요금은 부과되지 않습니다."

두 번째 문장을 주의 깊게 읽어 보시기 바랍니다. 많은 사용자가 이 부분에서 혼동을 겪기 때문입니다. 각 claude --cloud 명령은 고유한 컨텍스트 윈도우를 가진 독립적인 세션을 생성합니다. 네 개의 작업을 동시에 시작하면 네 개의 세션이 각각 동시에 요청을 보내게 되며, 따라서 계정의 사용량은 단일 세션을 사용할 때보다 약 4배가량 증가합니다. VM은 무료이지만, 토큰은 유료입니다.

"credit"이라는 단어는 두 가지 의미를 가집니다

인터페이스에서 두 개의 서로 다른 메커니즘을 하나의 단어로 지칭하고 있으며, 이러한 용어의 중복 사용이 이 질문과 관련된 혼란의 주된 원인입니다.

사용 크레딧(Usage credits)은 영구적인 메커니즘입니다. 이는 Pro, Max 5x, Max 20x 요금제에서 사용할 수 있으며, Settings > Usage에서 직접 충전하는 선불 잔액입니다. 이 크레딧은 요금제에 포함된 한도에 도달하기 전까지는 아무런 역할을 하지 않습니다. 한도 도달 후 크레딧 기능이 켜져 있고 잔액이 있다면 작업은 계속되며, Anthropic의 표현을 빌리자면 "이후의 사용량은 표준 API 요금제로 청구"됩니다. API는 애플리케이션 프로그래밍 인터페이스를 의미하며, 표준 API 요금은 토큰 단위로 부과되므로 이는 정액제가 아닌 종량제 방식입니다. 월별 지출 한도를 설정할 수 있으며, /usage에서 해당 월의 지출 현황을 확인할 수 있습니다. 사용 크레딧은 Claude 대화와 Claude Code 모두에 적용됩니다. 이 단어가 가진 또 다른 무관한 의미를 포함한 전체 잔액에 대한 자세한 내용은 사용 크레딧의 정의와 용어 중복의 이유를 참조하십시오.

클라우드 세션 크레딧(Cloud session credit)은 프로모션용 잔액입니다. 이는 구매하는 것이 아니라 제공받는 것이며, 클라우드 세션에만 적용되고 클라우드 세션이 시작될 때 자동으로 차감됩니다. 이 크레딧은 요금제 사용량보다 먼저 소진되는데, 이것이 바로 Anthropic이 로컬에서 한도에 도달하더라도 크레딧이 소진될 때까지 클라우드에서 작업을 계속할 수 있다고 설명하는 이유입니다.

솔직히 말씀드리면, 이 두 가지는 서로 다른 기준에 따라 문서화되어 있으므로 이 요약을 포함한 그 어떤 정보보다 본인의 계정을 직접 확인하는 것이 정확합니다. 2026년 9월 27일 기준으로, code.claude.com의 클라우드 세션 페이지는 속도 제한 공유에 대해서만 다룰 뿐 프로모션 크레딧에 대해서는 언급하지 않으며, 사용 크레딧 도움말 문서는 선불 잔액에 대해서만 다룰 뿐 클라우드 세션에 대해서는 언급하지 않습니다. 프로모션 약관은 해당 제안 자체에 포함되어 있습니다. 2026년 9월 제안에 보고된 약관에는 2026년 10월 초까지의 신청 마감일과 2026년 11월 초까지 미사용 잔액이 소멸된다는 내용이 포함되어 있으나, 이는 해당 제안의 고유한 날짜이므로 이를 기준으로 계획을 세우기 전에 계정 내 신청 페이지에서 직접 확인하시기 바랍니다.

풀이 비어 있으면 어떻게 됩니까?

어떤 풀이 비었는지에 따라 세 가지 다른 상황이 발생합니다.

프로모션용 클라우드 세션 크레딧이 소진되면 아무것도 중단되지 않습니다. 클라우드 세션은 다시 일반 플랜 제한에 따라 계산됩니다. 이 경우는 주의 깊게 살펴봐야 합니다. 크레딧 덕분에 클라우드 작업을 무료로 느끼다가 전환이 조용히 이루어지기 때문입니다.

플랜에 포함된 제한에 도달하고 사용 크레딧이 활성화되어 있으며 잔액이 있는 경우, 작업은 계속되며 월간 지출 한도에 도달할 때까지 표준 API 요금으로 토큰당 과금됩니다. 그 시점에 Claude Code는 "You've hit your monthly spend limit"와 같이 도달한 제한을 명시하는 메시지를 보고하며, Pro 및 Max 플랜에서는 CLI를 벗어나지 않고 해당 한도를 상향하거나 제거하는 옵션을 제공합니다.

플랜 제한에 도달하고 사용 크레딧이 꺼져 있거나 잔액이 없는 경우, 작업이 중단됩니다. "You've hit your session limit" 또는 "You've hit your weekly limit" 메시지와 함께 해당 윈도우가 초기화되는 시간이 표시됩니다. 이러한 제한은 모든 모델에 적용되므로 /model를 사용해도 해결되지 않습니다. 모델별 제한 메시지는 다르게 동작합니다. "You've hit your Opus limit" 메시지가 표시된 후 /model sonnet을 사용하여 다른 모델 제품군으로 전환하면 작업을 계속할 수 있습니다. 제한에 도달했을 때의 옵션 및 초기화 윈도우 계산 방식은 제한이 발생한 상황보다 미리 읽어두는 것이 이해하기 쉽습니다.

이 과정에서 작업을 계속하기 위해 모델이 조용히 다운그레이드되거나 컨텍스트가 축소되는 일은 없습니다. 미터기에 사용할 수 있는 자원이 남아 있거나, 아니면 작업이 중단될 뿐입니다.

클라우드 세션의 사용량은 어디에서 확인합니까?

두 곳에서 확인할 수 있으며, 잘못 해석하면 오해할 수 있는 부분이 하나 있습니다.

claude.ai의 Settings > Usage가 공식적인 확인 경로입니다. 여기에서 요금제 사용량, 사용 크레딧 활성화 여부, 잔액, 이번 달 지출액, 월간 지출 한도를 확인할 수 있습니다. 터미널에서 /usage-credits을 실행하면 브라우저에서 해당 페이지가 바로 열립니다.

세션 내부의 /usage는 요금제 사용량 막대 그래프를 보여줍니다. Pro, Max, Team, Enterprise 요금제 사용자의 경우, 최근 사용량이 어디에 집중되었는지(기술, 서브 에이전트, 플러그인, 개별 MCP 서버 등)를 전체 대비 백분율로 상세히 보여줍니다. 또한 긴 컨텍스트나 캐시 미스처럼 최근 사용량의 큰 비중을 차지하는 동작도 표시합니다. d 또는 w을 눌러 최근 1일과 최근 1주 사이의 데이터를 전환할 수 있습니다.

이제 주의할 점입니다. 해당 일간 및 주간 수치는 명령어를 입력한 기기의 세션 기록을 바탕으로 계산됩니다. 문서에도 "다른 기기나 claude.ai에서 발생한 사용량은 포함되지 않습니다"라고 명시되어 있습니다. 따라서 오후 내내 클라우드에서 무거운 작업을 수행한 뒤 터미널에서 /usage를 실행하면, 클라우드 작업은 다른 곳에서 이루어졌기 때문에 사용량이 적게 표시됩니다. 정확한 클라우드 사용량을 확인하려면 클라우드 세션 내부에서 /usage을 실행하거나 Settings > Usage 페이지를 여십시오.

클라우드 세션의 비용이 발생하는 이유

Claude Code 세션의 비용은 전송하는 컨텍스트의 크기에 전송 횟수를 곱한 값으로 결정됩니다. 클라우드 세션은 VM과 무관한 이유로 이 두 가지 요소를 모두 증가시키는 경향이 있습니다.

백그라운드에서 긴 작업이 실행되면 매 턴마다 전체 대화 내용을 다시 전송하며, 각 도구 호출(tool call)은 해당 결과 배치를 포함한 추가 요청을 생성합니다. 따라서 한 시간 동안 실행되는 세션은 자신의 작업 기록에 대해 여러 번 비용을 지불하게 됩니다. 이는 Claude Code 세션에서 실제로 토큰을 소비하는 요소에서 설명한 메커니즘과 동일하며, 로컬 작업에도 똑같이 적용됩니다. 차이점은 클라우드 세션은 아무도 지켜보지 않기 때문에 누군가 중단시키기 전까지 훨씬 더 오래 실행된다는 점입니다.

저장소를 다시 읽는 것 또한 큰 비용 요인입니다. VM은 저장소를 새로 복제하며 어제 탐색했던 내용에 대한 기억 없이 시작합니다. "오류 처리를 정리해 줘"와 같은 모호한 지시는 Claude가 오류 처리가 어디에 있는지 찾기 위해 광범위하게 검색하고 많은 파일을 읽게 만듭니다. 반면 "src/http/retry.ts의 재시도 래퍼를 src/sync/의 세 호출자에게 추가해 줘"와 같은 구체적인 지시는 검색 과정을 생략하므로 토큰 사용량을 대폭 줄여줍니다.

클라우드 세션에는 /clear가 존재하지 않습니다. 로컬에서는 관련 없는 작업 사이에 세션을 초기화해도 비용이 들지 않으며 다음 작업의 컨텍스트를 작게 유지할 수 있습니다. 클라우드 세션에서는 사이드바에서 새 세션을 시작해야 하며, 계속 재사용하는 스레드는 이전의 모든 내용을 이후의 모든 요청으로 가져오게 됩니다.

유휴 상태의 공백도 비용을 발생시킵니다. 클라우드 세션은 일정 시간 동안 활동이 없으면 중단되고 VM은 회수됩니다. claude.ai/code에서 세션을 다시 열면 대화 기록이 복원된 상태로 새로운 VM이 프로비저닝되지만, VM이 종료될 때 실행 중이던 백그라운드 작업은 복원되지 않습니다. 해당 공백 이후의 첫 번째 메시지는 프롬프트 캐시를 활용하지 못하므로, 전체 컨텍스트를 저렴하게 읽어오는 대신 정가로 다시 처리하게 됩니다. 또한 사용량 크레딧을 소진하는 동안의 캐시 수명은 플랜 내에서 사용할 때보다 짧습니다.

클라우드 세션 내부에서 사용할 수 있는 제어 기능은 다음과 같습니다. /context로 창에 무엇이 있는지 확인하고, /compact keep the test output으로 원하는 초점에 맞춰 요약하며, /model sonnet 또는 /effort을 사용하여 기계적인 작업에 Opus 요금이 부과되는 것을 방지하십시오. /compact는 요약할 대화 내용을 읽어야 하므로, 매우 큰 컨텍스트를 압축하는 작업 자체가 큰 요청이 될 수 있다는 점에 유의하십시오. 하위 에이전트(subagent)는 장황한 출력을 별도의 컨텍스트 창에 보관하지만, 각 하위 에이전트가 자체적인 요청을 보내므로 전체 컨텍스트가 아닌 메인 컨텍스트를 축소하게 됩니다. 이러한 오버헤드의 형태는 에이전트 하네스가 모든 요청에 추가하는 요소에서 다룹니다.

로컬에서 동일한 작업 실행하기

이 작업을 수행하는 로컬 경로는 일반적인 CLI이며, 유용한 패턴은 한쪽을 선택하는 대신 작업을 분할하는 것입니다.

탐색을 중단하기 쉬운 로컬 머신에서 계획을 수립하십시오:

claude --permission-mode plan

계획 모드에서 Claude는 파일을 읽고 명령을 실행하여 탐색한 뒤, 소스 코드를 수정하지 않고 접근 방식을 제안합니다. 계획을 커밋하고 푸시한 다음, 실행을 클라우드 세션으로 넘기십시오:

claude --cloud "Execute the migration plan in docs/migration-plan.md"

모든 사용자가 한 번쯤 겪는 세부 사항이 있습니다. 클라우드 VM은 로컬 작업 복사본이 아닌 현재 브랜치의 GitHub 원격 저장소를 복제하므로, 푸시하지 않은 내용은 해당 세션에서 존재하지 않습니다. 먼저 푸시하십시오.

로컬 머신에서 클라우드 세션을 종료하려면 풀(pull)을 수행하십시오:

claude --teleport

Teleport는 세션의 브랜치를 가져와 체크아웃한 뒤, 전체 대화 기록을 터미널로 불러옵니다. 이를 위해서는 깨끗한 작업 트리와 포크가 아닌 동일한 저장소의 체크아웃 상태가 필요합니다. 그 후 터미널은 해당 세션의 자체 복사본을 가지게 되며, 그곳에서 수행하는 새로운 작업은 로컬에 유지되고 claude.ai에는 나타나지 않습니다.

로컬에서 실행한다고 해서 토큰 비용이 저렴해지지는 않습니다. 로컬 실행이 제공하는 것은 제어권입니다. 작업 간의 /clear, 나중에 다시 돌아올 수 있는 /resume, VM 만료 없음, 그리고 Claude가 잘못된 방향으로 향할 때 즉시 Escape 키를 누를 수 있는 능력이 그것입니다. 어차피 옆에 앉아서 작업해야 하는 경우라면, 이러한 제어권은 대개 편의성보다 더 가치가 있습니다. 20분이 소요되는 테스트 스위트나 노트북을 닫은 상태에서도 진행되어야 하는 작업의 경우 클라우드가 제 역할을 합니다. 컨텍스트를 작게 유지하는 것은 두 환경 모두에서 이점이 있으며, 이는 컨텍스트 윈도우를 의도적으로 관리하기의 주제입니다.

플랜 변경이 근본적인 해결책인 경우

크레딧은 토큰당 표준 요금으로 청구되므로 용량을 구매하는 가장 비싼 방법입니다. 반면 구독은 고정 요금제입니다. 매주 크레딧을 충전하고 있다면 이미 비용 효율성 측면에서 손해를 보고 있는 것입니다.

사용 습관의 문제가 아니라 플랜 자체가 문제라는 신호는 두 가지입니다. 첫 번째는 특별히 복잡한 작업을 시도하지 않았음에도 일상적인 업무 중에 한도에 도달하는 경우입니다. 두 번째는 매달 같은 주기로 크레딧 잔액이 소진되는 경우입니다. 프롬프트를 더 간결하게 다듬어도 이 문제는 해결되지 않습니다.

무엇을 비교해야 하는지, 그리고 각 플랜이 실제로 어떻게 다른지에 대한 상세 내용은 이곳에 나열하기보다 플랜 페이지를 참조하는 것이 좋습니다. 본인의 작업 방식에 맞는 플랜에서 시작하고, 이미 Max 플랜을 사용 중이라면 두 가지 Max 티어 간의 차이점을 확인하십시오. Settings > Usage 페이지를 열어 직접 확인한 수치를 바탕으로 결정하시기 바랍니다.

FAQ

클라우드 세션은 Claude 플랜 외에 추가 비용이 발생합니까?

아니요. 클라우드 세션 문서에 따르면 "클라우드 VM에 대한 별도의 컴퓨팅 요금은 없으며", 클라우드 세션은 "계정 내의 다른 모든 Claude 및 Claude Code 사용량과 요금 제한을 공유"합니다. 머신 비용은 포함되어 있습니다. 사용자가 소비하는 것은 토큰이며, 이는 터미널과 채팅에서 사용하는 것과 동일한 풀에서 차감됩니다. 단, 해당 풀보다 우선하는 크레딧 잔액이 있는 경우에는 크레딧이 먼저 차감됩니다.

왜 로컬 /usage에는 클라우드 세션에서 수행한 작업이 표시되지 않습니까?

해당 일간 및 주간 수치는 명령어를 실행한 머신의 세션 기록을 기준으로 계산되기 때문입니다. 문서는 "다른 기기나 claude.ai에서의 사용량은 포함되지 않는다"고 명시하고 있으므로, 클라우드 작업은 해당 수치에 나타나지 않습니다. 클라우드 세션 내부에서 /usage을 실행하거나, 플랜 사용량과 크레딧 지출을 모두 확인할 수 있는 공식적인 방법인 claude.ai의 설정(Settings) > 사용량(Usage) 메뉴를 확인하십시오.

크레딧이 소진되면 클라우드 세션이 중단됩니까?

어떤 크레딧인지에 따라 다릅니다. 프로모션용 클라우드 세션 크레딧이 소진되면, 클라우드 세션은 계속 실행되며 일반 플랜 제한에 따라 사용량이 계산됩니다. 플랜 제한에 도달하고 사용량 크레딧이 활성화되어 잔액이 있는 경우, 월간 지출 한도에 도달할 때까지 표준 API 요금으로 토큰당 비용이 청구되며 작업이 계속됩니다. 플랜 제한에 도달했으나 사용 가능한 크레딧이 없는 경우, "세션 제한에 도달했습니다(You've hit your session limit)"와 같은 메시지와 함께 초기화 시간이 표시되며 작업이 중단됩니다.

Claude Code는 클라우드보다 로컬에서 실행하는 것이 더 저렴합니까?

토큰당 비용은 동일합니다. 세션이 어디에서 실행되든 동일한 요청은 동일한 비용이 발생하며, VM은 어느 쪽이든 무료입니다. 실제로는 로컬 세션이 더 적은 비용을 사용하는 경우가 많습니다. 관련 없는 작업 간의 /clear에는 비용이 발생하지 않으며, 잘못 진행되는 실행을 즉시 중단할 수 있고, VM 만료로 인해 기록을 다시 처리해야 하는 재시작 과정이 없기 때문입니다. 클라우드 세션은 모호한 지시를 내린 채 방치할 경우 비용이 많이 발생할 수 있습니다.