클로드 코드 클라우드 세션 크레딧: 받는 방법과 쓰는 방법
Claude Code의 클라우드 세션은 내 컴퓨터 밖의 서버에서 작업을 실행합니다. Pro 100달러, Max 250달러로 소개된 체험 크레딧의 조건과 차감 순서, 브라우저에서 첫 세션을 여는 순서와 서버로 올라가는 파일의 범위를 정리했습니다.

세 줄로 먼저 읽기
- 클라우드 세션은 Anthropic이 관리하는 서버의 가상 머신에 저장소를 복사해 작업하므로 노트북을 닫아도 계속 진행됩니다.
- 2026년 9월 정식 제공과 함께 기존 Pro 사용자에게 100달러, Max 사용자에게 250달러의 1회 체험 크레딧이 소개됐고 신청 마감은 10월 7일입니다.
- 체험 크레딧은 대상 클라우드 세션에서 먼저 차감되며 로컬 터미널 작업과 API 결제에는 쓰이지 않습니다.
9월 말 Claude Code 시작 화면에 다음과 같은 안내가 나타났습니다.
※ Claim a $250 bonus credit for cloud sessions, on top of your plan limits문장 끝에는 신청 명령 /claim-credit이 함께 붙어 있었습니다. 클라우드 세션에 쓸 보너스 크레딧을 플랜 한도와 별도로 신청하라는 뜻입니다. 크레딧 신청, GitHub 저장소 연결, 작업 시작은 각각 따로 하는 단계여서 안내를 받았다고 작업이 저절로 시작되지는 않습니다.
이 혜택은 2026년 9월 클라우드 세션 정식 제공 발표와 함께 나온 1회 체험 크레딧이며, Pro는 100달러, Max는 250달러로 소개됐습니다. 기능 사용법은 2026년 10월 4일 공식 문서 기준입니다.
클라우드 세션은 다른 컴퓨터에서 실행하는 작업입니다
평소 터미널에서 claude로 연 로컬 세션은 내 컴퓨터에서 작업합니다. 컴퓨터가 잠자기 상태가 되거나 꺼지면 작업도 멈춥니다. 클라우드 세션은 기본적으로 Anthropic이 관리하는 서버에서 실행되므로 노트북을 닫아도 계속 진행됩니다. 조직이 따로 운영하는 실행 환경에 연결했다면 그 환경에서 실행됩니다.
서버 안에서는 가상 머신(VM)이 작업을 맡습니다. 가상 머신은 서버 안에서 별도 컴퓨터처럼 작동하는 실행 환경이고, 클라우드 세션은 여기에 저장소를 복사해 읽고 수정합니다. 내 컴퓨터의 다른 파일이나 로그인 상태는 옮겨지지 않습니다.
여는 방법별 실제 실행 위치
| 여는 방법 | ||
|---|---|---|
| 일반 터미널의 claude | 제공 | 제공하지 않음 |
| 휴대폰에서 조작하는 Remote Control | 제공 | 제공하지 않음 |
| 브라우저의 claude.ai/code | 제공하지 않음 | 제공 |
| 앱의 Code 탭, Desktop의 Cloud | 제공하지 않음 | 제공 |
| 터미널의 claude --cloud | 제공하지 않음 | 제공 |
예약이나 조건에 맞춰 작업을 시작하는 Routines도 클라우드 세션에서 실행됩니다.
크레딧은 어떤 순서로 차감되나요?
크레딧은 특정 사용분에서만 차감되는 잔액입니다. 구독 사용량 한도나 API 계정 잔액과 합쳐지지 않습니다. 프로모션 소개 자료는 대상 클라우드 세션에서 체험 잔액을 먼저 쓰고, 잔액이 떨어지면 일반 플랜 한도로 돌아간다고 설명합니다.
클라우드 세션의 사용량이 빠지는 순서
1. 체험 크레딧대상 클라우드 세션에서
만료일까지 먼저 차감
2. 플랜 사용량 한도5시간, 주간 한도를
다른 Claude 작업과 공유
3. 유료 사용 크레딧켜 둔 계정만
지출 한도까지 추가 결제
클라우드 세션은 다른 Claude 작업과 플랜 사용량 한도를 함께 쓰고, 공식 문서 기준으로 VM 컴퓨팅 요금은 따로 붙지 않습니다. 3단계는 유료 사용 크레딧을 켜 둔 계정에서만 생기므로, 같은 작업이라도 이 설정에 따라 추가 비용 여부가 달라집니다. API 결제는 구독과 별도로 모델을 호출하는 비용이라 이 순서에 들어가지 않습니다.
로컬 터미널에서 한도 메시지가 나왔다면 체험 크레딧이 남아 있어도 쓰이지 않습니다. 지금 연 세션이 로컬인지 클라우드인지부터 봅니다.
신청 조건과 날짜
9월 발표 당시 소개된 조건입니다.
클라우드 세션 체험 크레딧
100달러Pro 사용자1회 지급
250달러Max 사용자1회 지급
10월 7일신청 마감미국 태평양 시간 23:59, 한국 10월 8일 15:59
11월 4일사용 만료미국 태평양 시간 23:59, 한국 11월 5일 16:59
신청은 Claude Code 대화 입력칸에 /claim-credit을 입력하거나 발표에 붙은 신청 링크로 합니다. 두 날짜 사이에 미국 서머타임이 끝나서, 신청 마감은 한국과 16시간, 사용 만료는 17시간 차이가 납니다.
Team이나 Enterprise에서 클라우드 기능을 쓸 수 있는 것과 이번 개인용 크레딧의 대상이 되는 것은 서로 다른 조건입니다. 시작 화면에 뜬 금액만 보고 내 구독 플랜을 판단하지 말고, 설정의 구독 정보에서 플랜을 확인합니다. 크레딧을 받으려고 새로 결제하거나 플랜을 올리기 전에 계정에 혜택이 표시되는지부터 봅니다.
2025년 11월에도 Max 1,000달러, Pro 250달러의 체험 크레딧이 있었습니다. 그때의 금액과 만료 조건은 이번 혜택과 관계가 없습니다.
브라우저에서 첫 세션 열기
GitHub는 코드와 변경 이력을 온라인에 보관하는 서비스입니다. 저장소는 한 프로젝트의 파일과 이력을 모아 둔 공간이고, 브랜치는 변경을 따로 진행하는 작업 이력입니다. 클라우드 세션은 GitHub 서버에 있는 저장소의 브랜치를 복사해서 작업합니다.
claude.ai/code에서 첫 세션을 여는 순서
1. 로그인claude.ai/code에
구독 계정으로
2. 크레딧 신청안내가 보이면 신청하고
잔액과 만료일 기록
3. GitHub 연결계정과
저장소 접근 범위 선택
4. 저장소와 브랜치작업 입력칸에서
저장소와 브랜치 고르기
5. Plan 모드로 요청첫 요청은
읽기만 하는 작업
3단계에서 비공개 저장소를 쓰려면 Claude GitHub App을 그 저장소에 설치해야 할 수 있고, 조직 저장소는 관리자가 허용해야 연결됩니다. 저장소 앱을 설치하면 PR의 오류와 검토 의견에 반응하는 Auto-fix 기능도 함께 켜질 수 있으므로 연결 화면의 범위를 읽고 진행합니다. PR은 수정 내용을 다른 브랜치에 반영해 달라는 검토 요청입니다.
5단계의 Plan은 파일을 바꾸지 않고 계획만 세우는 권한 모드입니다. 이미 쓰고 있는 저장소라면 첫 요청은 구조를 읽고 정리하는 일로 시작하면 결과를 바로 대조할 수 있습니다.
이 저장소의 README.md와 package.json을 읽고 설치와 실행 방법을 세 줄로 정리해 줘.
파일 수정, 커밋, push, PR 생성은 하지 마.읽기만 하는 요청에도 AI 사용량이 차감됩니다. 작업이 끝나면 계정의 사용량과 크레딧 화면에서 잔액이 어떻게 바뀌었는지 봅니다.
저장소가 목록에 없으면 연결한 GitHub 계정과 그 저장소의 앱 접근 권한부터 확인합니다. 환경 준비가 실패하면 오류 문구를 적어 두고 공식 시작 안내의 해결 순서를 따릅니다. 원인을 모르는 상태에서 모든 저장소 접근이나 네트워크 권한을 넓히지 않습니다.
터미널에서 클라우드 세션 시작하기
/claim-credit과 /web-setup은 Claude 대화 입력칸에 쓰는 명령입니다. 반면 아래 명령은 일반 터미널에서 저장소 폴더로 이동해 실행하며, 새 클라우드 세션을 만듭니다. 브라우저에서 하던 대화를 이어 가지 않으므로 새 세션의 권한 모드를 다시 고릅니다.
claude --cloud "README.md의 설치 방법만 읽어 알려 줘. 파일 수정과 PR 생성은 하지 마."/web-setup은 이미 GitHub CLI를 쓰는 사람을 위한 연결 방법입니다. 이 명령은 내 컴퓨터의 GitHub 토큰(계정 대신 접근 권한을 증명하는 비밀값)을 Claude 계정에 넘기고 기존 연결을 바꿀 수 있습니다. 브라우저에서 GitHub를 연결했다면 따로 실행하지 않아도 됩니다.
GitHub를 거치지 않고 로컬 저장소를 묶어 올리는 방법도 있어서, 무엇이 서버로 가는지는 연결 방식에 따라 다릅니다.
서버로 올라가는 범위
| 내 저장소의 내용 | |||
|---|---|---|---|
| push한 커밋 | 제공 | 제공 | 제공 |
| 내 컴퓨터에만 있는 커밋 | 제공하지 않음 | 제공 | 제공 |
| 추적 중인 파일의 미커밋 변경 | 제공하지 않음 | 제공 | 제공 |
| 비밀 파일의 미커밋 변경 | 제공하지 않음 | 일부 제외 | 제공 |
| 이미 커밋한 비밀값 | push했다면 포함 | 제공 | 제공 |
Windows에서는 추적 중인 파일이면 이름과 관계없이 미커밋 변경까지 올라갑니다. 비밀번호나 API 키가 커밋 이력에 남은 저장소라면 어느 방식이든 그 값이 서버로 갑니다.
멈춘 작업과 결과 가져오기
클라우드 세션도 내 답변이나 승인이 필요하면 멈춰서 기다립니다. 오래 기다리면 실행 환경이 회수될 수 있고, 다시 열어 대화가 복구돼도 그때 실행 중이던 명령은 이어지지 않습니다.
세션을 닫고 끝내고 가져오는 방법
| 하는 일 | ||
|---|---|---|
| 브라우저 탭 닫기 | 제공하지 않음 | 제공하지 않음 |
| 세션에서 중단 | 제공 | 제공하지 않음 |
| claude --teleport | 제공하지 않음 | 제공 |
더 진행할 필요가 없으면 세션 화면에서 중단하고 실제로 작업이 멈췄는지 확인합니다. 반복 작업을 예약해 두었다면 예약도 따로 끕니다.
claude --teleport는 클라우드 대화와 그 브랜치를 내 컴퓨터로 가져오는 명령입니다. 같은 계정, 같은 저장소에서 쓰며 결과 글만 보여 주는 것이 아니라 로컬 브랜치 상태도 바꿀 수 있습니다. 그래서 로컬에 아직 커밋하지 않은 변경이 있으면 먼저 정리해 둡니다. 반대 방향으로 기존 로컬 대화를 클라우드로 옮기는 것과 --cloud로 새 세션을 만드는 것은 서로 다른 동작입니다.
익숙해진 뒤 맡길 업무 예시
결과를 검증할 방법이 있는 작업부터 맡깁니다. 아래 표는 요청 범위를 정하는 예시입니다.
| 업무 | 처음 요청할 범위 | 결과 확인 |
|---|---|---|
| 광고 CSV 정리 스크립트 | 빈 값과 열 이름 오류를 다루는 테스트 제안 | 기대 숫자와 실제 출력 대조 |
| GA4 측정 기획서 대조 | 문서의 이벤트와 코드의 호출 이름을 비교한 표 | 실제 수집은 DebugView에서 확인 |
| 라이브러리 업데이트 | 현재 버전과 목표 버전의 변경 사항과 영향받는 파일 | 승인한 작은 변경 뒤 빌드, 테스트, 화면 확인 |
GA4는 웹과 앱의 이용 행동을 분석하는 구글 서비스이고, DebugView는 테스트 기기에서 보낸 이벤트를 실시간으로 보여 주는 화면입니다. 저장소에 측정 기획서 docs/tracking-plan.md가 있다면 다음처럼 요청할 수 있습니다.
빠진 항목과 이름이 다른 항목을 근거 파일과 함께 표로 정리해 줘.
코드와 기획서는 아직 수정하지 마.
이름이 다른 항목은 기획서 줄과 코드 파일 위치를 함께 적었습니다.
이 대조는 저장소의 코드만 다룹니다. GA4 계정에 실제로 수집된 데이터는 볼 수 없으므로 수집 여부는 DebugView에서 확인합니다. 표에 틀린 곳이 있으면 근거 파일을 열어 고치고, 코드 변경을 맡길 범위는 그다음에 정합니다. 여러 세션을 동시에 시작하면 사용량과 검토할 결과도 함께 늘어나므로 처음에는 세션 하나로 시작합니다.
참고 자료

제대로 이해했는지 한 문제로 확인해 볼까요?
답을 고르면 바로 풀이가 나와요.
클라우드 크레딧이 남았는데 로컬 Claude Code에서 한도 메시지가 나옵니다. 무엇부터 확인하나요?

새 글과 AI 소식을 메일로 받아 보세요
AI가 바꾸는 일과 도구, 측정 실무 이야기를 매주 한 번 보내 드려요.
이 글이 도움이 되었나요?
CLAUDE.md, 권한 모드, 스킬, 훅, 비용 관리까지 클로드 코드를 실무에서 쓰는 순서입니다
코스 전체 보기 →