클로드 코드 클라우드 세션과 원격 사용 (웹, Remote Control, SSH)

이 글은 2026년 10월 25일 기준 Claude Code 공식 문서(Use Claude Code in the cloud, Configure cloud environments, Remote Control, Claude Code on mobile, Desktop의 SSH sessions)와, 같은 날 macOS 터미널에서 Claude Code v2.1.310으로 연습 폴더 원격-연습을 다뤄 본 화면을 근거로 씁니다.

연습 폴더에는 주간보고.txt 한 파일만 두었습니다. 클라우드 세션은 계정의 사용량을 쓰고 저장소를 클라우드로 보내는 일이라 이 글에서는 만들지 않았고, 클라우드 세션 부분은 공식 문서 원문으로 설명합니다.

클로드 클라우드 세션이란?

Claude Code를 내 노트북이 아니라 Anthropic의 클라우드 컴퓨터에서 실행하는 방식이 클라우드 세션입니다. 공식 문서는 "A cloud session is a Claude Code session that runs on cloud infrastructure instead of on your machine"이라고 정의합니다. 세션마다 새 가상 머신(Ubuntu 24.04, 대략 가상 CPU 4개, 메모리 16GB, 디스크 30GB, 바뀔 수 있음)이 할당되고, 그 안에 GitHub 저장소를 복제해 작업합니다. 조직이 자체 운영하는 실행 환경(self-hosted environment)을 지정했다면 그 환경에서 실행됩니다.

클라우드 세션은 Pro, Max, Team 플랜과 Enterprise의 premium 좌석 또는 Chat + Claude Code 좌석에서 쓸 수 있습니다. Claude Code를 처음 만나는 단계라면 클로드 코드란에서 내 컴퓨터에서 실행하는 방식을 먼저 익히면 이 글의 비교가 쉬워집니다.

클라우드 세션, Remote Control, SSH 세션의 차이

세 방식은 휴대폰이나 다른 컴퓨터에서 Claude Code 작업을 보고 지시한다는 점이 같고, 작업을 실행하는 컴퓨터가 다릅니다.

공식 문서는 노트북에서 하던 일을 다른 기기에서 이어 갈 때 Remote Control을, 노트북 설정 없이 일을 시작하거나 여러 작업을 동시에 돌릴 때 클라우드 세션을 쓰라고 나눠 안내합니다. 휴대폰 문서도 "If your computer will be off, use cloud sessions"라고 적어, 컴퓨터를 꺼 둘 예정이면 클라우드 세션을 고르게 합니다.

클로드 클라우드 세션 사용법

클라우드 세션은 아래 다섯 곳에서 시작합니다.

• 브라우저: claude.ai/code. 공식 문서는 이 화면을 Claude Code on the web이라고도 부릅니다.
• 휴대폰: Claude 앱(iOS, 안드로이드)의 Code 탭
• 데스크톱 앱: 세션을 시작할 때 Local 대신 Cloud를 고릅니다.
• 터미널: claude --cloud "주간보고 표를 정리해 줘"처럼 할 일을 붙여 실행합니다.
• 예약 작업: 정해진 시각에 실행되는 클라우드 예약 작업도 클라우드 세션으로 실행됩니다.

처음 쓸 때는 클라우드 세션이 저장소를 복제하고 브랜치를 올릴 수 있도록 GitHub을 연결합니다. 브라우저의 첫 설정 화면에서 Claude GitHub App을 승인하거나, 이미 GitHub 명령줄 도구 gh를 쓰고 있다면 터미널의 Claude Code에서 /web-setup을 실행합니다. Anthropic이 관리하는 환경에서는 GitHub 자격 증명이 Anthropic 서버에 암호화되어 남고 클라우드 컴퓨터 안으로 들어가지 않습니다.

터미널에서 claude --cloud를 실행하면 지금 폴더의 저장소로 새 클라우드 세션이 만들어지고, 클라우드 컴퓨터는 노트북의 작업 폴더가 아니라 GitHub에 올라간 현재 브랜치를 복제합니다. 노트북에서만 만든 커밋이 있다면 먼저 push합니다. claude --cloud를 여러 번 실행하면 작업마다 다른 클라우드 세션이 동시에 돌아갑니다. 커밋과 브랜치가 낯설다면 클로드 코드 Git 작업 흐름을 먼저 봅니다.

클라우드 세션에서도 /compact, /context, /clear는 쓸 수 있습니다. /clear는 같은 클라우드 세션 안에서 빈 대화를 새로 시작합니다. 터미널 화면에서만 동작하는 /plugin, /resume은 쓸 수 없고, /model처럼 고르는 창을 여는 명령은 /model sonnet처럼 값을 붙여 입력합니다.

활동이 몇 분 없으면 클라우드 컴퓨터는 파일을 저장한 채 일시 중지되고, 나중에 회수될 수 있습니다. 회수된 세션을 claude.ai/code에서 다시 열면 대화 기록은 돌아오지만, 실행 중이던 셸 명령과 서브에이전트는 돌아오지 않으므로 Claude에게 다시 실행해 달라고 요청합니다.

클라우드 세션 사용량과 사용 크레딧

클라우드 세션은 계정의 다른 Claude, Claude Code 사용과 같은 사용 한도를 쓰고, 클라우드 컴퓨터 요금은 따로 붙지 않습니다. 여러 클라우드 세션을 동시에 돌리면 그만큼 사용량이 함께 쌓입니다.

한도를 다 쓴 뒤에도 계속하려면 사용 크레딧(usage credits, 예전 이름 extra usage)을 켭니다. 사용 크레딧은 한도를 넘은 사용분에 표준 API 요금을 매기는 종량제이고, 구독료와 따로 청구됩니다. Pro, Max는 claude.ai 웹의 Settings > Usage에서 켜고(휴대폰 앱 스토어에서 구독한 계정도 웹에서 켭니다), Team과 Enterprise는 관리자가 조직 설정(Organization settings > Usage)에서 켭니다. 플랜별 한도와 사용량을 보는 방법은 클로드 코드 비용과 한도 관리에 있습니다.

클라우드 세션으로 가져가는 파일과 설정

클라우드 세션은 GitHub 저장소를 새로 복제해 시작하므로, 저장소에 커밋한 것은 있고 노트북에만 설치하거나 설정한 것은 없습니다. 공식 문서 Configure cloud environments의 표를 줄이면 다음과 같습니다.

클라우드 세션에서도 쓸 MCP 서버는 claude mcp add --scope project로 저장소의 .mcp.json에 넣어 커밋합니다. 범위 옵션은 클로드 코드 MCP 서버 연결에, CLAUDE.md 쓰는 법은 CLAUDE.md 작성법에 있습니다. claude.ai에서 켠 스킬은 클라우드 세션이 자동으로 불러옵니다.

클로드 세션 불러오기: 텔레포트로 클라우드 작업을 노트북에 가져오기

클라우드 세션에서 하던 작업을 노트북의 터미널에서 이어 가려면 같은 저장소 폴더에서 claude --teleport를 실행합니다. 세션 목록이 나오면 이어 갈 세션을 고르고, 세션 ID를 알면 claude --teleport 세션ID로 바로 엽니다. 이미 Claude Code를 쓰는 중이라면 /teleport(줄인 이름 /tp)를 입력합니다. Claude Code가 저장소가 맞는지 확인하고, 클라우드 세션의 브랜치를 가져와 꺼낸 뒤, 대화 기록 전체를 터미널에 불러옵니다.

텔레포트하려면 네 조건이 맞아야 합니다.

• 노트북의 작업 폴더에 커밋하지 않은 변경이 없어야 합니다(있으면 Claude Code가 stash로 잠시 치워 두자고 묻습니다).
• 클라우드 세션과 같은 저장소의 폴더에서 실행해야 합니다(포크한 저장소는 안 됩니다).
• 클라우드 세션의 브랜치가 GitHub에 올라가 있어야 합니다.
• 클라우드 세션을 만든 claude.ai 계정으로 로그인해 있어야 합니다.

텔레포트한 뒤 터미널에서 한 작업은 클라우드 세션에 반영되지 않고, 터미널의 세션을 클라우드로 올리는 기능도 터미널(CLI)에는 없습니다. 데스크톱 앱은 Open in 메뉴로 노트북 세션을 클라우드에 보낼 수 있습니다. claude --resume은 이 컴퓨터에 남은 대화만 다시 열고 클라우드 세션은 보여 주지 않습니다.

Remote Control 사용법과 휴대폰 연결

Remote Control은 Pro, Max, Team, Enterprise 플랜에서 claude.ai 계정으로 로그인해야 쓸 수 있고, API 키로는 쓸 수 없습니다. Team과 Enterprise는 조직의 Owner가 관리 설정에서 먼저 켭니다. 켜는 방법은 세 가지입니다.

휴대폰에서는 Claude 앱을 설치하고 Claude Code와 같은 claude.ai 계정과 조직으로 로그인한 뒤 Code 탭의 세션 목록에서 이름으로 고릅니다. Claude Code 전용 휴대폰 앱은 따로 없고, 클라우드 세션과 Remote Control 모두 Claude 앱의 Code 탭에서 씁니다. 코드는 휴대폰에서 실행되지 않습니다. 앱이 없다면 Claude Code에서 /mobile을 입력해 앱 스토어로 가는 QR 코드를 띄웁니다.

연결된 동안에는 노트북의 Claude Code 화면 위쪽에 /rc 표시가 붙고, /rc를 다시 입력하면 주소와 QR 코드, 연결 끊기가 있는 상태 화면이 열립니다. 모든 세션을 자동으로 연결하려면 /config의 Enable Remote Control for all sessions를 켜거나 사용자 설정 파일에 "remoteControlAtStartup": true를 넣습니다.

노트북은 Anthropic API로 나가는 HTTPS 요청만 보내고 바깥에서 들어오는 포트를 열지 않습니다. 연결된 동안 대화 기록은 Anthropic 서버에 저장되어 기기 사이에서 맞춰지고, 파일 실행과 접근은 노트북에서만 이루어집니다.

휴대폰 알림을 받으려면 노트북의 Claude Code에서 /config를 열고 Push when Claude decides(긴 작업이 끝났을 때처럼 Claude가 정한 때 알림)나 Push when actions required(허락이나 답이 필요할 때 알림)를 켭니다. 휴대폰 앱에서 고를 수 있는 권한 모드는 Remote Control 세션이 Manual, Accept edits, Plan, Auto이고, 클라우드 세션이 Accept edits, Plan, Auto입니다. 권한 모드는 클로드 코드 권한 모드와 권한 규칙에 있습니다.

SSH로 다른 컴퓨터에서 Claude Code 쓰기

SSH는 다른 컴퓨터에 암호화된 연결로 접속하는 방법입니다. Claude 데스크톱 앱에서는 프롬프트 아래 환경 선택 메뉴의 New environment를 열고 SSH 탭에서 Add SSH connection을 고른 뒤 이름, SSH host(사용자@주소), 포트(비우면 22), 키 파일 경로를 적습니다. 원격 컴퓨터는 Linux, macOS, Windows 모두 되고, 처음 연결할 때 데스크톱 앱이 원격 컴퓨터에 Claude Code를 설치합니다. SSH 세션은 원격 컴퓨터 홈 폴더의 ~/.claude/skills/를 읽습니다.

데스크톱 앱 v2.31226.0 이상에서는 노트북이 절전에 들어가거나 앱을 닫아도 원격 컴퓨터의 작업이 계속됩니다. 다만 Claude 계정으로 로그인했다면 로그인이 만료되어 작업이 멈출 수 있어서, 공식 문서는 밤새 실행을 기대하지 말라고 경고합니다.

터미널에서 ssh로 접속해 Claude Code를 실행할 때는 tmux(터미널 연결과 상관없이 세션을 유지하는 프로그램) 안에서 시작하면 SSH 연결이 끊겨도 Claude Code가 계속 실행됩니다. 집 컴퓨터에 tmux 세션을 두고 밖에서 접속하는 구성은 맥 tmux, SSH, 테일스케일 원격 AI 작업 환경에, SSH 기초는 SSH 원격 접속 입문에 있습니다.

클라우드 환경의 네트워크와 보안

클라우드 세션이 실행되는 설정 묶음을 클라우드 환경(cloud environment)이라고 하고, 환경마다 네트워크 수준을 하나 고릅니다.

None으로 두어도 Claude Code 자신은 Anthropic API와 통신하므로, 공식 문서는 이 통신으로 데이터가 클라우드 컴퓨터 밖으로 나갈 수 있다고 적습니다. 비밀 키는 저장소에 쓰지 않고, 환경 설정의 network secrets(요청이 클라우드 컴퓨터를 떠난 뒤에 붙는 키) 같은 공식 방법을 씁니다.

직접 해 보기: Remote Control로 주간보고 요약 이어 쓰기

Pro 이상 플랜의 claude.ai 계정으로 Claude Code에 로그인되어 있고, 휴대폰에 Claude 앱이 같은 계정으로 로그인되어 있다면 다음 순서로 연습합니다. 요청을 보내면 계정의 사용량이 듭니다.

1. 빈 폴더 원격-연습을 만들고, 텍스트 편집기(Windows는 메모장, 맥은 텍스트 편집기)로 주간보고.txt에 주간보고, 날짜: 10월 27일, 매출: 120만 원 세 줄을 저장합니다.
2. 터미널에서 원격-연습 폴더로 이동해 claude를 실행하고, 폴더 신뢰 창에서 Yes, I trust this folder를 고릅니다. 터미널을 여는 법은 터미널과 CLI에 있습니다.
3. "주간보고.txt를 두 줄로 요약해 줘. 파일은 고치지 마"를 보냅니다.
4. /rc를 입력합니다. 처음 켤 때 Enable Remote Control 확인 창이 뜨면 Enable Remote Control을 고릅니다. /remote-control is active 줄이 나오면 /rc를 한 번 더 입력해 상태 화면을 열고, Show QR code를 골라 휴대폰 카메라로 QR 코드를 찍습니다.
5. 휴대폰의 Claude 앱에서 3번의 요약이 보이면, 휴대폰에서 "매출 줄만 다시 알려 줘"를 보냅니다. 노트북의 Claude Code 화면에도 같은 요청과 답이 나타나는지 봅니다.
6. 노트북에서 /rc를 다시 입력해 Disconnect this session을 고르고, Remote Control disconnected.가 나오면 /exit로 Claude Code를 마칩니다.

메뉴에 Remote Control이 없거나 조직 정책 오류가 나오면 설정을 우회하지 않고, 아래 표의 문구와 로그인 방식을 확인합니다.

막혔을 때

자주 묻는 질문

클라우드 세션은 추가 요금이 드나요?

클라우드 컴퓨터 요금은 따로 붙지 않고, 클라우드 세션은 계정의 다른 Claude와 Claude Code 사용과 같은 사용 한도를 씁니다(2026년 10월 25일 공식 문서 기준). 한도를 넘어 쓰려면 사용 크레딧을 켜야 합니다. Pro, Max는 claude.ai 웹의 Settings > Usage에서 켜고, Team과 Enterprise는 관리자가 조직 설정에서 켭니다. 사용 크레딧을 켜면 그때부터 넘은 사용분에 표준 API 요금이 붙습니다.

GitHub에 올리지 않은 저장소도 클라우드 세션에서 쓸 수 있나요?

쓸 수 있습니다. 원격 저장소가 없거나 Claude GitHub App이 설치되지 않은 저장소에서 claude --cloud를 실행하면, Claude Code가 노트북의 저장소를 묶어 클라우드 세션에 직접 올립니다. 커밋이 하나 이상 있어야 하고 묶음은 100MB보다 작아야 하며, Git이 추적하지 않는 새 파일은 빠집니다.

이 묶음에는 모든 브랜치의 커밋 기록과 추적 중인 파일의 커밋하지 않은 변경이 들어갑니다. macOS, Linux, WSL에서는 .env나 id_rsa처럼 비밀 키 이름을 가진 파일의 커밋하지 않은 변경을 빼고 Left on this machine:으로 알려 주지만, 네이티브 Windows에서는 그대로 올라갑니다. 이미 커밋한 내용은 빠지지 않으므로, 올려도 되는 연습 저장소로 시작합니다.

정해진 시간마다 클라우드에서 작업을 돌릴 수 있나요?

클라우드 예약 작업(Scheduled tasks, 예전 이름 routines)으로 돌릴 수 있습니다. Pro, Max, Team, Enterprise 플랜에서 claude.ai/code/routines나 Claude Code의 /schedule로 만들고, 매시간, 매일, 매주처럼 반복하거나 한 번만 실행하게 정합니다. 1시간보다 자주 실행하는 일정은 만들 수 없습니다.

클로드 코드 휴대폰 앱이 따로 있나요?

따로 없습니다. 휴대폰에서는 Claude 앱(iOS, 안드로이드)의 Code 탭에서 클라우드 세션을 시작하거나, Remote Control로 연결한 노트북 세션을 엽니다. 어느 쪽이든 코드는 휴대폰이 아니라 클라우드 컴퓨터나 노트북에서 실행됩니다.

참고 자료

• Claude Code 공식 문서: Use Claude Code in the cloud(정의, --cloud, 텔레포트, 오류)
• Claude Code 공식 문서: Configure cloud environments(가져가는 설정, 네트워크 수준, 사양)
• Claude Code 공식 문서: Remote Control(켜는 방법, 조건, 오류)
• Claude Code 공식 문서: Claude Code on mobile(Code 탭, 권한 모드)
• Claude Code 공식 문서: Desktop의 SSH sessions
• Claude Code 공식 문서: Scheduled tasks(클라우드 예약 작업)
• Claude 고객센터: 유료 플랜의 사용 크레딧