클로드 코드 클라우드 세션 크레딧: 받는 방법과 쓰는 방법
Claude Code의 클라우드 세션은 내 컴퓨터 밖에서 작업을 실행합니다. Pro 100달러, Max 250달러로 소개된 체험 크레딧의 조건과 일반 사용량의 차이, 계정에서 확인할 항목과 첫 읽기 실습을 정리했습니다.
목차
세 줄로 먼저 읽기
이번 방문에서 한 편은 바로 볼 수 있습니다.
9월 말 Claude Code 시작 화면에 다음과 같은 안내가 나타났습니다.
※ Claim a $250 bonus credit for cloud sessions, on top of your plan limits · /claim-credit클라우드 세션에 쓸 보너스 크레딧을 신청하라는 뜻입니다. 크레딧 신청, 외부 저장소 연결, 작업 시작은 서로 다른 단계입니다. 안내를 받았다고 작업이 자동으로 시작되는 것은 아닙니다.
이 글에서 소개하는 혜택은 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 계정 잔액과 하나로 합쳐지는 돈은 아닙니다.
| 구분 | 무엇을 확인하나요? |
|---|---|
| 클라우드 체험 크레딧 | 대상 클라우드 세션, 남은 금액, 만료일 |
| 구독 사용량 한도 | 5시간과 주간 등 계정에 표시되는 한도 |
| 유료 사용 크레딧 | 포함 한도 뒤에 추가 비용을 지불하는 설정과 지출 한도 |
| 한도 초기화 혜택 | 계정 카드에 표시된 특정 한도를 다시 사용할 조건 |
| API 결제 | 구독과 별도로 모델을 호출하는 비용 |
프로모션 소개 자료는 대상 클라우드 세션에서 체험 잔액을 먼저 사용하고, 소진 뒤 일반 플랜 한도로 돌아간다고 설명합니다. 그러나 잔액이 있다고 모든 한도와 실행 제한을 무시하고 계속 작업할 수 있다는 뜻은 아닙니다. 적용이 안 되거나 한도 메시지가 나오면 세션 종류와 계정 상태부터 확인합니다.
클라우드 세션은 평소 다른 Claude 작업과 사용량 한도를 공유하며, 공식 문서상 별도 VM 컴퓨팅 요금은 없습니다. 체험 크레딧이 끝난 뒤의 처리는 계정의 사용 크레딧 설정도 함께 확인해야 합니다. 추가 결제를 켜 둔 계정과 꺼 둔 계정을 같은 조건으로 보지 않습니다.
신청할 때 확인할 금액과 날짜
9월 소개 당시의 조건은 다음과 같습니다. 아래 날짜를 기다려 신청하기보다 계정에 표시되는 대상 여부와 기한을 먼저 확인합니다.
| 항목 | 소개된 조건 | 적용 전에 확인할 것 |
|---|---|---|
| 대상 | 기존 Pro와 Max 사용자 | 내 계정에 혜택이 표시되는지 |
| 금액 | Pro 100달러, Max 250달러 | 실제 지급 금액 |
| 신청 | /claim-credit 또는 신청 링크 | 계정과 약관 |
| 연결 조건 | GitHub 연결 | 저장소 접근 범위 |
| 신청 마감 | 2026년 10월 7일 | 정확한 시각과 시간대 |
| 사용 만료 | 미국 태평양 시간 11월 4일 23:59로 보도 | 계정에 표시된 만료일 |
ClaudeDevs 발표와 신청 안내가 원래 안내의 출처입니다. 프로모션 소개 보도는 신청 마감을 10월 7일 23:59 PT로 제시합니다. 이 시각이라면 한국은 10월 8일 15:59입니다. 11월 4일 23:59 PT는 한국 11월 5일 16:59이며, 두 날짜 사이에 미국 서머타임이 끝나 시차가 달라집니다. 계정의 실제 약관과 표시 날짜를 우선합니다.
Team이나 Enterprise에서 클라우드 기능을 쓸 수 있다는 것과 이번 개인용 크레딧의 대상이라는 것은 다릅니다. 또 시작 화면의 금액만으로 구독 플랜을 판단하지 말고 설정의 구독 정보를 확인합니다. 크레딧을 받으려고 새로 결제하거나 플랜을 올리기 전에 대상 여부부터 확인해야 합니다.
2025년 11월에도 체험 크레딧 안내가 있었습니다. 기존 기록에서는 Max 1,000달러와 Pro 250달러로 소개됐지만, 그 금액과 만료 조건을 이번 혜택에 적용하지 않습니다. 당시 Boris Cherny 안내
처음에는 브라우저에서 짧은 파일을 읽게 합니다
GitHub는 코드와 변경 이력을 온라인에 보관하는 서비스입니다. 저장소는 한 프로젝트의 파일과 이력을 모아 둔 공간이며, 브랜치는 변경을 따로 진행하는 작업 이력입니다. 커밋은 파일 변경을 이력으로 기록한 단위이고, push는 내 컴퓨터의 커밋을 원격 저장소에 보내는 동작입니다.
GitHub를 아직 써 본 적이 없다면 기존 회사 저장소부터 연결하지 않습니다. GitHub의 저장소 만들기 안내를 따라 개인 연습용 저장소를 만들고 README를 추가합니다. 공개할 필요가 없으면 Private을 선택합니다. 다른 사람의 파일이 없는 새 저장소에서 README.md를 열고 연필 모양 편집 버튼을 누릅니다. 내용을 다음처럼 바꿉니다.
# 독서 모임 연습
날짜: 2026-10-12
장소: 도서관 2층GitHub 웹에서는 Commit changes를 누르고 변경 설명에 연습 메모 추가를 적습니다. 이 새 개인 연습 저장소에서는 현재 브랜치에 저장하도록 선택하고 Commit changes를 한 번 더 누릅니다. 이것은 GitHub 서버에 내용을 저장하는 작업이며, 공개 여부는 저장소 설정에 따릅니다. 저장 후 파일 페이지에 위 내용이 보이는지 확인합니다.
claude.ai/code에 구독 계정으로 로그인합니다. 크레딧 안내가 있으면 조건을 읽고 신청한 뒤 잔액과 만료일을 기록합니다. 안내가 없거나 대상이 아니라면 신청을 반복하거나 결제부터 하지 말고 계정 조건을 확인합니다.
GitHub 연결 안내에서 계정과 저장소 접근 범위를 읽습니다. 비공개 연습 저장소에는 Claude GitHub App 설치가 필요할 수 있으므로 해당 저장소를 선택해 연결합니다. 조직 저장소는 관리자의 허용이 필요할 수 있습니다. 첫 실습은 브라우저 연결만 사용합니다. 저장소 앱을 설치하면 PR의 오류와 검토 의견에 반응하는 Auto-fix 기능도 사용 가능한 상태가 되므로 연결 화면의 범위를 확인합니다.
작업 입력칸에서 연습 저장소와 README가 있는 브랜치를 선택합니다. 환경 설정이 요구되면 기본 환경을 확인합니다. 시작 전에 계정의 크레딧 잔액과 유료 사용 크레딧 설정을 확인합니다. 읽기 요청에도 AI 사용량이 발생하며 혜택이 없으면 일반 구독 조건이 적용됩니다. 첫 읽기 작업은 권한 모드에서 Plan을 선택하고 다음을 요청합니다.
README.md를 읽고 독서 모임의 날짜와 장소를 두 줄로 알려 줘.
원문에 없는 내용은 확인 필요로 표시해 줘.
파일 수정, 커밋, push, PR 생성은 하지 마.PR은 수정 내용을 다른 브랜치에 반영해 달라는 검토 요청입니다. 이번 실습은 읽기이므로 PR을 만들 필요가 없습니다. 날짜가 2026-10-12, 장소가 도서관 2층인지 GitHub 파일과 대조합니다. 작업이 끝나면 계정의 사용량과 크레딧 화면도 다시 확인합니다. 금액 변화가 바로 보이지 않는다고 적용됐거나 무료라고 단정하지 않습니다.
혼자 반복할 때는 GitHub 웹에서 날짜를 2026-10-19로 바꾸어 저장하고 새 클라우드 세션에서 같은 요청을 합니다. 새 날짜와 기존 장소를 답하면 현재 저장소를 읽은 것입니다. 예전 날짜가 나오면 선택한 브랜치와 GitHub 파일의 저장 상태를 먼저 확인합니다.
저장소가 목록에 없다면 연결한 GitHub 계정과 해당 저장소의 앱 접근 권한을 확인합니다. 환경 준비에 실패하면 오류 내용을 기록해 공식 시작 안내를 따라 해결합니다. 원인을 모른 채 모든 저장소 접근이나 네트워크 권한을 넓히지 않습니다.
터미널 명령은 다음에 익혀도 됩니다
CLI에서 /claim-credit과 /web-setup은 Claude 대화 입력칸에 쓰는 명령입니다. 반면 아래 명령은 일반 터미널의 실제 연습 저장소 폴더에서 실행하며 새 클라우드 세션을 만듭니다. 브라우저의 기존 대화를 이어가는 명령이 아니며, 새 세션의 권한 모드를 따로 확인합니다. 첫 실습에서는 위의 브라우저 경로만 완료해도 됩니다.
claude --cloud "README.md의 날짜와 장소만 읽어 알려 줘. 파일 수정과 PR 생성은 하지 마."/web-setup은 이미 GitHub CLI를 쓰는 사람을 위한 연결 방법입니다. GitHub 토큰은 계정 대신 접근 권한을 증명하는 비밀값입니다. 이 명령은 로컬 GitHub 토큰을 Claude 계정에 전달하고, 기존 연결을 바꿀 수 있으므로 브라우저 연결을 마쳤다면 반드시 추가로 실행할 단계가 아닙니다.
일반적인 GitHub 복제 방식에서는 서버의 브랜치를 읽습니다. 내 컴퓨터에만 저장한 내용은 자동으로 따라오지 않습니다. 다만 로컬 저장소를 묶어 업로드하는 별도 경로도 있어, “GitHub를 연결하지 않았으니 아무것도 올라가지 않는다”고 판단해서는 안 됩니다.
로컬 묶음 업로드는 커밋 이력과 추적 중인 파일의 미커밋 변경까지 포함할 수 있습니다. macOS, Linux와 WSL에서 일부 비밀 파일의 미커밋 변경을 제외하는 처리도 있지만, 이미 커밋한 비밀값까지 지워 주지는 않습니다. 일반 Windows에서는 추적 중인 파일의 미커밋 변경을 이름과 관계없이 업로드할 수 있습니다. 중요한 자료가 없는 새 연습 저장소를 쓰는 이유입니다. 공식 업로드 범위
멈춘 작업과 결과 가져오기를 구분합니다
클라우드 세션도 질문이나 승인 답변이 필요하면 기다립니다. 오래 대기하면 실행 환경이 회수될 수 있습니다. 다시 열어 대화가 복구되더라도 당시 실행 중이던 명령까지 그대로 이어지는 것은 아닙니다.
브라우저 탭을 닫는 것만으로 작업을 중지한 것으로 보지 않습니다. 더 진행할 필요가 없으면 세션에서 중단하고 실제 상태를 확인합니다. 반복 작업을 예약했다면 예약도 따로 확인합니다.
claude --teleport는 클라우드 대화와 해당 브랜치를 로컬로 가져오는 기능입니다. 같은 계정과 같은 저장소에서 사용하며, 로컬 변경이 있으면 먼저 확인합니다. 단순히 결과 글만 보는 기능이 아니라 브랜치 상태도 바뀔 수 있습니다. 반대로 기존 로컬 대화를 CLI에서 그대로 클라우드로 옮기는 것과 --cloud로 새 세션을 만드는 것은 다릅니다.
익숙해진 뒤 맡길 업무 예시
첫 읽기와 사용량 확인을 마친 뒤에는 결과를 검증할 방법이 있는 작업으로 확장합니다. 아래 예시는 실제 실행 결과가 아니라 요청을 구성하는 방법입니다.
| 업무 | 처음 요청할 범위 | 결과 확인 |
|---|---|---|
| 광고 CSV 정리 스크립트 | 가상 데이터의 빈 값과 열 이름 오류를 다루는 테스트 제안 | 기대 숫자와 실제 출력 대조 |
| GA4 측정 기획서 대조 | 문서의 이벤트와 코드의 호출 이름을 비교해 표로 정리 | 실제 수집은 별도로 DebugView에서 확인 |
| 라이브러리 업데이트 | 현재 버전과 목표 버전의 변경 사항 및 영향 파일 정리 | 승인한 작은 변경 뒤 빌드, 테스트와 화면 확인 |
GA4는 웹과 앱 이용 행동을 분석하는 서비스입니다. DebugView는 테스트 기기에서 보낸 이벤트를 확인하는 화면입니다. 예를 들어 저장소에 docs/tracking-plan.md가 실제로 있다면 다음처럼 요청할 수 있습니다.
docs/tracking-plan.md의 이벤트 목록과 코드의 gtag, dataLayer 호출을 대조해 줘.
빠진 항목과 이름이 다른 항목을 근거 파일과 함께 표로 정리해 줘.
코드와 기획서는 아직 수정하지 마.이 연결만으로 GA4 계정의 실제 수집 데이터까지 볼 수 있는 것은 아닙니다. 표에 오류가 있다면 근거 파일을 확인해 수정하고, 코드 변경을 맡길 범위를 따로 정합니다. 여러 일을 동시에 시작하면 사용량과 결과 검토량도 늘어나므로 첫 시험은 한 세션이면 충분합니다.
참고 자료
제대로 이해했는지 한 문제로 확인해 볼까요?
답을 고르면 바로 풀이가 나와요.
클라우드 크레딧이 남았는데 로컬 Claude Code에서 한도 메시지가 나옵니다. 무엇부터 확인하나요?
이 글이 도움이 되었나요?
CLAUDE.md, 권한 모드, 스킬, 훅, 비용 관리까지 클로드 코드를 실무에서 쓰는 순서입니다
코스 전체 보기 →
새 글과 AI 소식을 메일로 받아 보세요
AI가 바꾸는 일과 도구, 측정 실무 이야기를 매주 한 번 보내 드려요.