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

이 글은 앤트로픽이 운영하는 code.claude.com/docs의 Claude Code on the web, Remote Control, Cloud environments, Mobile 문서를 한국어 사용자가 실무에 바로 옮길 수 있도록 정리한 글입니다. 요금제 조건과 사양은 2026년 9월 28일 공식 문서 기준이고, 원문 링크는 글 끝 참고 자료에 모았습니다.

🤔 노트북을 닫고 이동하면서도 작업을 이어 가고 싶을 때

클로드 코드에 긴 작업을 맡겨 두고 퇴근하려면 노트북을 켜 둬야 하는지, 이동 중에 휴대폰으로 진행을 보고 한마디 더 지시할 수 있는지가 궁금해집니다. 방법은 여러 가지인데 이름이 비슷해서 헷갈립니다. 웹에서 쓰는 클로드 코드, Remote Control, 모바일 앱의 Code 탭, SSH 연결이 각각 어디에서 실행되는지가 다르기 때문입니다.

지금부터 세 가지 원격 사용 방식의 차이, 클라우드 세션이 가져가는 설정과 사용량, 로컬로 가져오는 텔레포트, 휴대폰에서 쓰는 법, 클라우드 환경의 보안 제한을 정리합니다.

🔑 클라우드 세션과 Remote Control의 정의

클로드 코드의 클라우드 세션은 앤트로픽이 관리하는 가상 머신에서 도는 세션이고, Remote Control은 내 컴퓨터에서 도는 세션을 웹과 휴대폰에서 조작하는 연결입니다.

둘을 가르는 질문은 하나입니다. 코드가 어느 컴퓨터에서 실행되느냐입니다. 클라우드 세션은 앤트로픽의 가상 머신에서 돌고, Remote Control은 내 컴퓨터에서 돌면서 화면만 다른 기기로 보여 줍니다.

☁️ 클라우드 세션: 웹에서 쓰는 클로드 코드

클라우드 세션은 Pro, Max, Team과 Enterprise(프리미엄 좌석 등)에서 씁니다. 시작하는 곳은 브라우저의 claude.ai/code, Claude 앱의 Code 탭, 데스크톱 앱의 Cloud 선택, 터미널의 claude --cloud "작업 내용"입니다.

공식 문서가 설명하는 실행 순서는 이렇습니다.

1. 저장소를 앤트로픽이 관리하는 가상 머신에 복제합니다
2. 설정 스크립트가 있으면 실행하고 네트워크 제한을 적용합니다
3. 작업을 진행하고 결과를 브랜치로 올립니다
4. 올린 뒤에도 세션은 닫히지 않아 같은 대화에서 PR을 만들고 추가 수정을 이어 갑니다

가상 머신은 우분투 24.04, 약 4 vCPU, 16GB 메모리, 30GB 디스크이고 바뀔 수 있다고 적혀 있습니다. 명령 하나는 기본 2분, 최대 10분까지 기다립니다. 한동안 쓰지 않은 세션은 멈추고, 다시 열면 대화는 돌아오지만 돌던 셸 명령과 서브에이전트는 복원되지 않습니다.

클라우드로 가져가는 것과 가져가지 않는 것을 알아 두면 "로컬에선 되는데 클라우드에선 안 된다"는 상황이 줄어듭니다.

• 가져감: 저장소의 CLAUDE.md, .claude/rules/, .claude/skills/, .claude/agents/, 단일 저장소 세션의 .claude/settings.json과 .mcp.json
• 가져가지 않음: ~/.claude/CLAUDE.md, 사용자 스킬과 에이전트, 로컬과 사용자 범위 MCP 서버, 대화형 로그인이 필요한 인증

그래서 클라우드에서도 써야 하는 규칙과 스킬은 저장소에 둡니다. 클라우드 세션에서는 /clear 대신 사이드바에서 새 세션을 만들고, /model sonnet처럼 모델은 인자로 바꿉니다.

💳 사용량과 사용 크레딧

클라우드 세션은 별도 컴퓨팅 요금 없이 계정의 다른 클로드, 클로드 코드 사용과 같은 한도를 씁니다. 여러 세션을 병렬로 돌리면 사용량도 그만큼 늘어납니다. 한도에 닿은 뒤에도 이어 가려면 사용 크레딧(예전 이름 extra usage)을 켭니다.

• 켜는 곳: claude.ai 설정의 Usage 화면. 모바일 앱에서 구독했더라도 웹에서 설정합니다
• 요금: 한도를 넘은 사용분에 표준 API 요금이 붙습니다
• 관리: 월 지출 한도를 정하거나 선불 충전을 하고, 하루 충전 한도는 2,000달러입니다
• 합산: 클로드 대화와 클로드 코드 사용이 함께 계산됩니다

요금제별 가격과 한도는 코딩 에이전트 요금과 한도 비교에, 캐시와 모델 선택으로 사용량을 아끼는 방법은 클로드 코드 비용과 한도 관리에 정리했습니다.

🔁 텔레포트: 클라우드 작업을 내 터미널로 가져오기

클라우드에서 하던 작업을 내 컴퓨터로 가져오려면 claude --teleport로 세션 목록을 열고 고릅니다. 세션 안에서는 /teleport(별칭 /tp)를 씁니다. 조건이 네 가지 있습니다.

• 내 폴더에 커밋하지 않은 변경이 없어야 합니다
• 같은 저장소여야 합니다(포크는 안 됨)
• 클라우드 브랜치가 원격 저장소에 올라가 있어야 합니다
• 같은 claude.ai 계정으로 로그인해야 합니다(API 키 로그인은 안 됨)

방향은 한쪽입니다. 텔레포트한 뒤의 로컬 작업은 클라우드 세션에 반영되지 않고, 터미널 세션을 클라우드로 밀어 올리는 기능도 CLI에는 없습니다. claude --cloud "작업"은 지금 저장소로 새 클라우드 세션을 만드는데, 로컬 파일이 아니라 원격 저장소의 현재 브랜치를 복제하므로 먼저 올려 둡니다. 로컬 세션을 클라우드로 넘기는 기능은 데스크톱 앱의 Continue in 메뉴에 있습니다.

📱 Remote Control과 휴대폰에서 쓰기

Remote Control은 내 컴퓨터에서 도는 세션에 claude.ai/code나 Claude 앱을 연결합니다. 실행과 파일 접근은 계속 내 컴퓨터에 남고, 웹과 휴대폰은 그 세션을 보는 창입니다.

• 시작: 터미널에서 claude remote-control(서버 모드, 스페이스바로 QR 코드 표시), 대화형으로 claude --rc, 세션 안에서 /rc로 지금 대화를 넘깁니다
• 조건: Pro, Max, Team, Enterprise 계정으로 로그인해야 하고 API 키로는 안 됩니다. Team과 Enterprise는 관리자가 먼저 켜야 합니다
• 보안: 내 컴퓨터는 바깥으로 HTTPS 요청만 보내고 들어오는 포트를 열지 않습니다
• 권한 모드: 앱에서는 Manual, Accept edits, Plan만 고를 수 있습니다

클로드 코드 전용 모바일 앱은 따로 없고, Claude 앱(iOS, 안드로이드)의 Code 탭에서 클라우드 세션과 Remote Control을 씁니다. 코드는 휴대폰에서 돌지 않습니다. 컴퓨터를 꺼 둘 예정이면 클라우드 세션, 내 컴퓨터의 파일이나 도구가 필요하면 Remote Control을 쓰라고 공식 문서가 나눠 안내합니다. /config에서 푸시 알림을 켜면 승인이 필요할 때 휴대폰으로 알림이 옵니다.

🔐 SSH로 다른 컴퓨터에서 쓰기

데스크톱 앱은 환경 선택에서 SSH 연결을 추가하면 리눅스나 맥 원격 컴퓨터에서 세션을 돌리고, 처음 연결할 때 원격 컴퓨터에 클로드 코드를 설치합니다. 스킬은 원격 컴퓨터의 ~/.claude/skills/를 읽습니다.

터미널에서 SSH로 접속해 쓸 때는 연결이 끊겨도 세션이 살아 있도록 tmux 안에서 실행하는 방법을 공식 문서도 권합니다. 집 컴퓨터에 tmux 세션을 두고 테일스케일 같은 도구로 포트를 열지 않고 접속하는 구성은 맥 tmux, SSH, 테일스케일 원격 AI 작업 환경에, SSH 기초는 SSH 원격 접속 입문에 정리했습니다.

🛡️ 클라우드 환경의 네트워크와 보안 제한

클라우드 세션은 네트워크 수준을 None, Trusted(기본, 패키지 저장소와 깃허브 같은 허용 목록), Full, Custom 가운데서 고릅니다. 깃허브 연결은 전용 프록시를 거치는데, 실제 토큰은 가상 머신 밖에 두고 세션용 단기 자격 증명만 들어가며 git push는 지금 작업 중인 브랜치에만 됩니다.

주의할 점이 두 가지 있습니다. 환경 변수와 설정 스크립트는 그 환경을 쓰는 누구나 읽을 수 있으므로 비밀 값을 넣지 말라고 공식 문서가 경고합니다. 또 네트워크를 None으로 두어도 앤트로픽 API와 켜 둔 커넥터로 가는 길은 열려 있어서, 데이터가 가상 머신 밖으로 나갈 수 있다고 적고 있습니다.

⚠️ 자주 하는 실수

• 개인 스킬과 CLAUDE.md가 클라우드에도 있다고 생각합니다: 저장소에 있는 것만 가져갑니다
• 로컬 변경을 올리지 않고 claude --cloud를 실행합니다: 원격 브랜치를 복제하므로 방금 고친 내용이 빠집니다
• Remote Control을 켜 두고 노트북을 닫습니다: 내 컴퓨터가 꺼지면 세션도 오프라인이 됩니다
• 클라우드 환경 변수에 API 키를 넣습니다: 그 환경을 쓰는 사람 모두가 읽을 수 있습니다

❓ 자주 묻는 질문

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

2026년 9월 28일 공식 문서 기준으로 가상 머신에 따로 붙는 컴퓨팅 요금은 없고, 계정의 같은 사용량 한도를 씁니다. 한도를 넘어 쓰려면 사용 크레딧을 켜야 하고 그때부터 API 요금이 붙습니다.

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

쓸 수 있습니다. 원격이 없는 저장소는 로컬 저장소를 묶어 올리는 방식으로 보내는데, 100MB 미만이고 커밋이 하나 이상 있어야 하며 커밋하지 않은 .env 같은 파일은 빠집니다.

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

루틴(Routines) 기능으로 됩니다. /schedule로 만들고, 최소 간격은 1시간이며, 컴퓨터를 꺼 둬도 클라우드에서 실행됩니다. 대화형 세션과 같은 사용량을 쓰고 계정당 하루 실행 횟수 상한이 따로 있는데, 수치는 공식 문서에 적혀 있지 않아 확인하지 못했습니다.

📋 3줄 요약

1. 클라우드 세션은 Pro와 Max, Team, Enterprise에서 앤트로픽 관리 가상 머신에 저장소를 받아 실행되므로 노트북을 닫아도 작업이 계속됩니다.

2. Remote Control은 실행과 파일이 내 컴퓨터에 남고 웹과 휴대폰은 그 세션을 보는 창이라서 컴퓨터가 켜져 있고 claude 프로세스가 살아 있어야 합니다.

3. 클라우드 세션은 별도 컴퓨팅 요금 없이 계정의 같은 사용량 한도를 쓰고, 개인 CLAUDE.md와 사용자 스킬, 로컬 MCP 서버는 가져가지 않습니다.

📚 참고 자료

• 웹에서 쓰는 클로드 코드 문서: https://code.claude.com/docs/en/claude-code-on-the-web
• 클라우드 환경 문서: https://code.claude.com/docs/en/cloud-environments
• Remote Control 문서: https://code.claude.com/docs/en/remote-control
• 모바일 문서: https://code.claude.com/docs/en/mobile
• 데스크톱 앱 문서(SSH 세션): https://code.claude.com/docs/en/desktop
• 사용 크레딧 도움말: https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans