안녕하세요! 재니미입니다.

Claude Code의 클라우드 세션(Cloud sessions)이 리서치 프리뷰를 끝내고 정식 출시됐습니다. Claude Code를 제 컴퓨터가 아니라 Anthropic이 관리하는 클라우드 VM에서 돌리는 기능이라, PC를 켜 두거나 별도로 서버를 준비할 필요가 없습니다. 이번 글에서는 클라우드 세션을 위한 프로모션으로 제공하는 크레딧을 얻는 방법과 함께, 클라우드 세션을 어디서 시작하는지와 쓰기 전에 알아둘 점을 정리해서 알려드립니다.

발표 내용

Claude 개발자 공식 계정의 발표에 따르면 클라우드 세션이 정식 출시됐고, 기존 구독자에게 체험용 크레딧을 한 번 지급합니다. 크레딧은 Pro 플랜이 100달러, Max 플랜이 250달러입니다.

클라우드 세션은 원래 Pro나 Max 플랜 사용량으로 돌아가는 기능이고, 이번 크레딧은 선택해서 받는 일회성 프로모션입니다. 받으면 클라우드 세션이 크레딧을 먼저 쓰고, 다 쓰면 평소 플랜 사용량으로 넘어갑니다.

크레딧 조건은 다음과 같습니다.

• 받는 방법: Claude Code에서 /claim-credit을 실행합니다.
• 사용량 한도 밖에서 씁니다. 크레딧은 플랜과 별도로 얹어주는 것이라 사용량 한도에 포함되지 않습니다. 로컬에서 한도에 걸려도 크레딧이 남아 있으면 클라우드 세션은 계속 돌아갑니다.
• 수령 기한: 태평양 시간 10월 7일 오후 11시 59분까지입니다. 한국 시간으로는 10월 8일 오후 3시 59분입니다.
• 만료: 태평양 시간 11월 4일 오후 11시 59분입니다. 한국 시간으로는 11월 5일 오후 4시 59분입니다.

GitHub 계정도 사실상 필요합니다. 클라우드 세션은 GitHub 저장소를 클론해서 작업하고, 처음 설정할 때 GitHub을 연결하게 되어 있습니다.

공식 문서에 따르면 클라우드 세션은 Pro, Max, Team 플랜과 Enterprise의 일부 좌석에서 쓸 수 있습니다.

어디서 시작하나

시작할 수 있는 곳이 여러 군데입니다.

• 브라우저: claude.ai/code
• 모바일: Claude 앱의 Code 탭
• 데스크톱 앱: 세션을 만들 때 Local 대신 Cloud 선택
• 터미널: claude --cloud

터미널에서 쓰는 방법은 이렇습니다.

claude --cloud "Fix the authentication bug in src/auth/login.ts"

이 명령은 현재 디렉터리의 GitHub 원격 저장소를 현재 브랜치 기준으로 클라우드 VM에 클론해서 새 세션을 만듭니다. 로컬 체크아웃을 가져가는 게 아니므로 로컬 커밋이 있으면 먼저 푸시해야 합니다. 예전 이름인 --remote도 아직 동작합니다.

--cloud를 여러 번 실행하면 세션이 각각 따로 만들어져 동시에 돌아갑니다. 진행 상황은 claude.ai나 모바일 앱에서 확인하고 지시를 더 줄 수도 있습니다.

클라우드에서 하던 작업을 로컬로 가져오고 싶으면 --teleport를 씁니다.

claude --teleport              # 세션 목록에서 선택
claude --teleport <session-id> # 특정 세션 바로 가져오기

반대 방향은 안 됩니다. CLI에서 이미 돌고 있는 로컬 세션을 클라우드로 올릴 수는 없습니다.

쓰기 전에 알아둘 것

• 사용량 한도를 공유합니다. 클라우드 세션은 계정의 다른 Claude 사용량과 한도를 같이 씁니다. 여러 세션을 병렬로 돌리면 그만큼 빨리 소진됩니다. 크레딧을 받았다면 크레딧이 남아 있는 동안은 크레딧부터 씁니다. VM 자체에 대한 별도 컴퓨팅 요금은 없습니다.
• GitHub 중심입니다. 저장소 클론과 PR 생성은 GitHub가 필요합니다. 다른 저장소는 CCR_FORCE_BUNDLE=1로 로컬 저장소를 묶어 올릴 수 있지만 결과를 원격으로 푸시할 수는 없습니다.
• 오래 쉬면 VM이 회수됩니다. 다시 열면 대화 기록은 복원되지만, 돌던 백그라운드 작업은 복원되지 않습니다.
• 네트워크는 기본적으로 제한됩니다. 클라우드 환경마다 네트워크 접근 수준, 환경 변수, 설정 스크립트를 따로 정할 수 있습니다.
• 원격 제어(Remote Control)와는 다른 기능입니다. --remote-control은 내 컴퓨터에서 도는 로컬 세션을 폰이나 브라우저로 조종하는 기능이고, --cloud는 세션 자체를 클라우드에서 돌립니다.

제가 써온 방식과의 차이

저는 지금까지 VM에 Claude Code를 얹고 tmux 세션 위에서 원격으로 제어하는 방식을 써왔습니다. 로컬 컴퓨터를 꺼도 에이전트가 계속 돌게 한다는 목적은 클라우드 세션과 같습니다.

차이는 누가 환경을 관리하느냐입니다. VM 방식은 서버와 tmux 세션을 제가 직접 준비하고 유지해야 하는 대신 환경을 마음대로 구성할 수 있습니다. 클라우드 세션은 그 준비가 필요 없지만, 위에 적은 대로 GitHub 저장소 기준으로 돌아가고 오래 쉬면 VM이 회수됩니다.

감사합니다.