본문 바로가기

클로드 코드 클라우드 세션 입문: 내 컴퓨터 없이 맡기는 법과 판단 기준

Claude Code 클라우드 세션은 GitHub 저장소 작업을 클라우드의 가상 머신에서 대신 진행하고 결과를 풀 리퀘스트로 돌려주는 방식입니다. 어떤 일을 맡기고 어떤 일은 내 컴퓨터에서 해야 하는지 기준과 함께 정리했습니다.

글

클라우드 세션(cloud session) — 내 컴퓨터가 아니라 클라우드 환경에서 실행되는 Claude Code 작업 창구입니다. GitHub 저장소를 고르고 할 일을 적어 두면 Claude가 알아서 작업하고, 끝나면 검토할 수 있는 결과물을 돌려줍니다. 공식 문서에 따르면 작업을 시작한 뒤에는 페이지를 닫고 자리를 비워도 Claude가 계속 작업합니다.

🟢 현행 모델 라인업 일치 · 모델 안내 · Fable 구독 안내
🟢 현행 모델 라인업 일치 · Claude Opus 5.5 / Claude Sonnet 5.5 / Claude Haiku 5.5 (상위 티어: Claude Fable 5.2). 이 안내는 새 모델이 출시될 때만 바뀝니다.

Fable 구독 안내(2026년 11월 10일 갱신): 2026년 11월 9일 출시된 Claude Fable 5.2가 현행 Fable 모델이고, Fable 5.1과 Fable 5는 레거시로 전환됐습니다. 구독 조건은 세 모델이 같습니다 — Max·Ultra 플랜과 Team·좌석 기반 Enterprise의 프리미엄 시트는 주간 사용 한도의 50% 범위에서 포함되고, Pro 플랜과 표준 시트는 사용량 크레딧으로 이용합니다(Free 미제공). 출시 기념으로 2026년 11월 16일(PT)까지 Pro 플랜과 Team 표준 시트에도 Fable 모델이 주간 한도의 50% 범위에서 포함됩니다. API 요금은 Fable 5.2가 입력 100만 토큰당 $8·출력 $40, Fable 5.1·5는 $10·$50입니다. 일부 사이버보안·생물학 요청은 안전 분류기에 의해 Opus 모델로 대체 응답될 수 있습니다. 자세한 내용은 Fable 5.2 출시 소식과 Fable 5.2 가이드를 참조하세요.

1. 저장소 선택 GitHub 저장소 2. 할 일 설명 글로 요청 3. 클라우드 작업 가상 머신에서 진행 4. 새 브랜치 변경 내용 반영 5. 내가 검토 풀 리퀘스트 생성

이 글로 할 수 있게 되는 것

클라우드 세션이 무엇이고 어떤 일을 맡기면 좋은지 판단할 수 있게 됩니다. 읽는 데는 5~10분 정도 걸립니다. 이 글은 공식 도움말을 바탕으로 한 개념·판단 가이드이며, 화면의 버튼 이름 같은 세부 라벨은 바뀔 수 있어 직접 지정하지 않았습니다. 실제 화면에서 확인해 주세요.

시작 전 준비물

가장 필요한 것은 GitHub 저장소에 접근할 수 있는 권한입니다. 공식 문서에 따르면 내가 접근 권한이 있는 GitHub 저장소라면 내 컴퓨터에 복사(clone)해 두지 않아도 작업을 맡길 수 있습니다.

  • GitHub 저장소 — GitHub(코드를 올려 두고 함께 관리하는 온라인 서비스)에 있는 프로젝트 폴더입니다. 저장소(repository)는 코드와 변경 이력이 담긴 보관함이라고 보시면 됩니다.
  • Claude 계정 — 어떤 플랜에서 쓸 수 있는지는 이 글의 근거 자료에서 확인되지 않았습니다. 본인 계정에서 실제로 보이는지 확인해 주세요.
  • 시작 위치 한 곳 — Claude Desktop(컴퓨터용 앱), 웹의 claude.ai/code, Claude Mobile(휴대폰 앱), 터미널 중 하나입니다.

용어 빠른 풀이

  • 브랜치(branch) — 원본을 건드리지 않고 변경을 따로 쌓아 두는 작업 갈래입니다.
  • 풀 리퀘스트(pull request, PR) — "이 변경을 본 코드에 합쳐도 될지 검토해 주세요"라는 요청서입니다.
  • 가상 머신(virtual machine) — 클라우드 안에 만든 임시 컴퓨터입니다. 작업마다 따로 만들어집니다.
  • 터미널(terminal) — 명령어를 글자로 입력하는 창입니다.
  • IDE — 코드를 쓰고 고치는 전용 편집 프로그램입니다.

클라우드 세션은 어떻게 시작하나요?

네 가지 중 편한 곳에서 시작하면 됩니다. 공식 문서가 밝힌 시작 위치는 Claude Desktop, 웹의 claude.ai/code, Claude Mobile, 터미널입니다. 터미널에서는 아래 명령어를 사용합니다.

claude --cloud
  1. 시작 위치를 고릅니다 — 터미널을 쓴다면 위 명령어를 입력합니다. 이 명령은 Claude Code가 이미 터미널에 설치되어 있다는 전제입니다.
  2. GitHub 저장소를 선택합니다 — 내가 접근 권한을 가진 저장소여야 합니다.
  3. 할 일을 구체적으로 적습니다 — 예: "로그인 화면 안내 문구의 오타를 모두 찾아 고쳐 주세요"처럼 끝이 분명한 요청이 좋습니다.

이렇게 보이면 성공 — 작업이 진행 중이라는 표시가 나타나고, 웹 화면에서 진행 상황을 볼 수 있습니다. 공식 문서에 따르면 필요하면 진행 중에 안내를 덧붙일 수도 있습니다. 만약 시작이 되지 않는다면 저장소 접근 권한이 있는지, 사용하는 앱이나 계정에서 해당 기능이 보이는지부터 확인하고, 그래도 안 되면 공식 도움말 센터(support.claude.com)에서 같은 제목의 문서를 확인하세요.

시작하면 내부에서 어떤 일이 벌어지나요?

Claude가 임시 가상 머신을 만들고 그 안에서 작업한 뒤 결과를 새 브랜치로 돌려줍니다. 위 도식의 단계와 같은 순서로 정리하면 다음과 같습니다.

  • 저장소 선택 — 고른 GitHub 저장소가 격리된 가상 머신에 복제됩니다. 개발 도구와 언어 환경이 미리 갖춰져 있다고 문서에 설명되어 있습니다.
  • 할 일 설명 — 저장소 설정에 초기 준비 명령(의존성 설치, 데이터베이스 준비 등)을 정의해 두었다면 Claude가 먼저 실행해 환경을 준비합니다.
  • 클라우드 작업 — Claude가 코드를 읽고 수정하고, 테스트를 작성하고, 명령을 실행해 결과를 확인합니다. 패키지 설치나 자료 가져오기처럼 인터넷이 필요하면 환경의 인터넷 접근 수준을 설정할 수 있습니다.
  • 새 브랜치에 반영 — 작업이 끝나면 변경 내용이 GitHub 저장소의 새 브랜치로 올라가고 알림이 옵니다.
  • 내가 검토 — 변경을 확인한 뒤 화면에서 바로 풀 리퀘스트를 만들 수 있습니다.

보안과 관련해 문서는 작업마다 완전히 격리된 환경을 쓰고, 네트워크 접근 제한과 인증 정보 보호 같은 통제가 있다고 설명합니다. GitHub 인증은 보안 프록시(중간 대리 통로)를 통해 관리되어 인증 정보가 Claude가 일하는 환경 안에 직접 놓이지 않습니다.

주의 — 결과물은 자동으로 합쳐지지 않고 검토용으로 돌아옵니다. 풀 리퀘스트를 열어 변경 내용을 직접 훑어보는 단계를 건너뛰지 마세요.

클라우드 세션과 로컬 세션 중 무엇을 골라야 하나요?

요구사항이 분명해서 중간에 방향을 바꿀 일이 적다면 클라우드, 보면서 계속 조정해야 한다면 로컬이 맞습니다. 로컬 세션(local session)은 Claude Desktop, 터미널, IDE처럼 내 컴퓨터에서 실행하는 방식입니다. 공식 문서의 분류를 상황별로 정리하면 다음과 같습니다.

클라우드 세션이 어울리는 일 · 요구사항이 분명한 작업 · 쌓여 있는 버그 목록 병렬 처리 · 내 컴퓨터에 없는 저장소 · 나중에 결과만 보고 싶은 대기 작업 로컬 세션이 어울리는 일 · 수시로 방향을 고쳐야 하는 작업 · 요구사항이 아직 불분명한 탐색 · 즉각적인 피드백이 필요한 작업 (공식 문서 기준)
상황추천이유
"이 오타를 전부 고쳐 줘"처럼 목표가 분명하다클라우드중간에 개입할 일이 적어 시작해 두고 나중에 결과만 확인하면 됩니다.
버그 이슈가 여러 개 쌓여 있다클라우드작업마다 별도 환경에서 병렬로 돌고 각자 풀 리퀘스트가 생깁니다.
한 번도 내려받지 않은 저장소를 고쳐야 한다클라우드복제와 환경 설정을 대신 해 줍니다.
어떻게 풀지 아직 모르겠다로컬결과를 보며 요청을 다듬는 주고받기가 필요합니다.
Claude가 하는 일을 보면서 계속 방향을 바꾸고 싶다로컬즉각적인 피드백을 받으며 조정할 수 있습니다.

입문자라면 처음에는 "끝이 분명한 작은 일"을 하나만 클라우드에 맡겨 보세요. 문구 수정이나 작은 버그처럼 결과를 눈으로 확인하기 쉬운 일이 적당합니다. 한 번에 여러 개를 맡기는 것은 흐름에 익숙해진 뒤가 좋습니다.

자주 막히는 지점

  • 요청이 모호해서 결과가 기대와 다르다 — 원인은 대개 요구사항이 불분명한 경우입니다. 이런 일은 공식 문서도 로컬 세션을 권합니다. 요청을 구체적으로 다시 쓰거나 로컬에서 진행하세요.
  • 인터넷이 필요한 작업이 막힌다 — 패키지 설치나 자료 가져오기에는 환경의 인터넷 접근 수준 설정이 영향을 줍니다. 설정 화면에서 접근 수준을 확인하세요.
  • 한 저장소에 여러 작업을 동시에 시켰다 — 문서에 따르면 같은 저장소에서 여러 작업이 동시에 돌 수 있습니다. 각자 별도 풀 리퀘스트가 생기니 검토 때 서로 겹치는 변경이 없는지 살펴보세요.

자주 묻는 질문

Q. 작업을 시작한 뒤 컴퓨터를 꺼도 되나요?
공식 문서에 따르면 작업이 시작된 뒤에는 페이지를 완전히 떠나도 Claude가 계속 작업합니다. 끝나면 알림을 받고 돌아와 결과를 검토하면 됩니다.

Q. 저장소를 내 컴퓨터에 내려받아야 하나요?
아니요. 접근 권한이 있는 GitHub 저장소라면 복제하거나 개발 환경을 직접 만들지 않아도 작업을 맡길 수 있습니다.

Q. 여러 작업을 동시에 시킬 수 있나요?
네. 각 작업은 별도의 격리된 환경에서 독립적으로 진행되고, 끝나면 각자 자기 풀 리퀘스트를 만듭니다. 같은 저장소에서 여러 작업이 동시에 돌 수도 있습니다.

Q. 어떤 요금제에서 쓸 수 있나요?
이 글의 근거 자료에서는 확인되지 않았습니다. 가격과 제공 범위는 자주 바뀔 수 있으니 공식 요금 페이지(claude.com/pricing)와 본인 계정 화면에서 확인해 주세요.

관련 글

이 글이 도움이 됐나요?

이어서 읽어보세요

클로드 디자인 초보자 가이드 — 대화창에서 첫 디자인 만들고 PPT로 내보내기까지 5단계 (2026년 11월)

2026년 9월 16일부터 Claude 디자인은 평소 대화창에서 "이런 화면 만들어줘"라고 말하면 바로 만들어집니다. 디자인 도구를 처음 쓰는 분 기준으로 준비 설정 → 첫 요청 문장 쓰는 법 → 결과 확인 → 채팅·댓글·직접 조작으로 고치기 → PPTX·PDF·링크로 내보내기를 화면 순서대로 안내합니다. 공식 도움말 기준.

19

Claude Sheets 사용법: Claude 안에서 만드는 스프레드시트

Claude Sheets는 Claude에 내장된 스프레드시트입니다. 쓸 수 있는 요금제, 만드는 방법, 가져오기·내보내기 형식, 출시 시점의 제한을 공식 도움말 기준으로 정리했습니다.

10

Claude Docs 시작 가이드: 대화로 문서를 만들고 팀과 함께 고치는 법

Claude Docs는 Claude와 대화하며 문서를 초안부터 작성하고, 직접 고치고, 링크로 공유하는 기능입니다. 만드는 법, 고치는 법, 공유 범위의 제한과 쓸지 말지 고르는 기준을 정리했습니다.

10

Claude Whiteboards 사용법: 말로 그리는 공동 작업 보드

Claude Whiteboards는 설명한 내용을 Claude가 도형과 화살표로 그려 주는 공동 작업 보드입니다. 지원 요금제, 시작 방법, 팀 공유, 내보내기, 제한을 공식 도움말 기준으로 정리했습니다.

9