\"Claude remote agents\"가 실제로 뜻하는 것: cloud session, 원격으로 조종하는 로컬 세션, 또는 내가 소유한 머신

매달 수백 명이 Google에 "claude remote agents"나 "claude code remote agent"를 입력하고, 폰에서 Claude Code를 조종하는 방법을 다룬 저희 페이지에 도착합니다. 거의 아무도 클릭하지 않는데, 그게 맞는 판단입니다. 그 페이지는 질문 하나에 답하고, 검색은 질문 세 개를 던지고 있으니까요.

이 검색어에서 "remote"라는 단어는 많은 것을 떠안고 있습니다. 누가 입력하느냐에 따라, 노트북을 닫아 둔 동안 Anthropic 서버에서 돌아가는 에이전트를 뜻하기도 하고, 노트북에서 돌아가지만 폰에서 조종하는 에이전트를 뜻하기도 하고, 본인이 소유한 빌드 서버에서 돌아가는 에이전트를 뜻하기도 합니다. 이 셋은 규칙이 서로 다른 세 가지 제품이고, Anthropic 스스로 올해 첫 번째 것의 이름을 바꿨습니다. 혼란의 상당 부분이 여기서 나옵니다.

이 글은 셋을 구분하고, 사실 관계는 2026년 9월 28일 Anthropic 문서로 확인했습니다. 그다음 AgentsRoom에서 각 경우를, 어떤 에이전트 CLI로든, 어떻게 다루는지 설명합니다.

"remote"라는 단어는 서로 다른 세 가지를 가리킨다

1. cloud session(클라우드 세션): 에이전트가 여러분의 컴퓨터가 아니라 클라우드 인프라에서 돌아갑니다. Anthropic은 예전에 이 CLI 플래그를 --remote라고 불렀고, 그래서 이 검색어가 굳어졌습니다.
2. Remote Control: 에이전트는 여러분의 컴퓨터에서 돌아가고, claude.ai나 폰의 Claude 앱에서 조종합니다.
3. 내가 소유한 머신: 에이전트가 서버, 사무실 데스크톱, 집 컴퓨터에서 돌아가고, SSH나 터널로 그곳에 접속합니다.

셋 중 둘은 Claude Code의 기능입니다. 세 번째는 평범한 인프라이고, 모든 에이전트 CLI에서 작동하는 유일한 방법입니다.

1. cloud session: 에이전트가 Anthropic의 머신에서 돌아간다

Anthropic 문서는 이것을 cloud session이라고 부릅니다. "여러분의 컴퓨터 대신 클라우드 인프라에서 돌아가는 Claude Code 세션"입니다. 기본적으로 그 인프라는 Anthropic이 관리하는 격리된 VM이며, 조직은 세션을 자체 호스팅 환경으로 보낼 수도 있습니다. 세션은 노트북을 닫은 뒤에도 계속 돌아가고, 어떤 기기에서든 상태를 확인하거나 조종할 수 있습니다.

시작할 수 있는 곳은 다섯 군데이며, 모두 같은 클라우드 환경(네트워크 접근 규칙, 환경 변수, 설정 스크립트)을 공유합니다.

검색어가 어디서 왔는지 설명해 주는 것은 터미널 형태입니다. 예전 표기인 --remote는 지금도 --cloud의 폐기 예정 별칭으로 작동합니다. 이 기능 전체를 허용하거나 막는 조직 정책의 이름은 여전히 allow_remote_sessions입니다. 그러니까 "remote"는 한동안 공식 용어였고, 플래그, 오류 메시지, 관리자 설정 속에 남아 있습니다.

claude --cloud를 실행하면 실제로 일어나는 일은 이렇습니다. claude.ai에 새 세션이 만들어지고, 클라우드 VM이 저장소의 GitHub 리모트를 현재 브랜치로 클론합니다. 클론하는 것은 작업 트리가 아니라 리모트이므로, 로컬 커밋이 있다면 먼저 푸시해야 합니다. 저장소에 리모트가 없거나 Claude GitHub App이 설치되어 있지 않으면, Claude Code가 로컬 저장소를 묶어(100 MB 미만, 추적 중인 파일만) 업로드하고, 커밋되지 않은 .env, *.tfvars, 키 파일은 빼 둡니다. 작업은 클라우드에서 돌아가고, 여러분은 로컬에서 계속 일할 수 있습니다. 작업이 끝나면 claude.ai/code에서 풀 리퀘스트를 만들거나, 세션을 터미널로 다시 가져옵니다.

claude --teleport                 # session picker
claude --teleport <session-id>    # a specific session

Teleport는 네 가지를 확인합니다. 깨끗한 작업 디렉터리, 같은 저장소의 체크아웃, 리모트에 푸시된 세션 브랜치, 그리고 같은 claude.ai 계정입니다. 그런 다음 브랜치를 가져오고 대화 전체를 터미널로 불러옵니다. CLI에서는 한 방향으로만 넘길 수 있습니다. cloud session을 내려받을 수는 있지만, 이미 있는 터미널 세션을 클라우드로 올려 보낼 수는 없습니다. 로컬 세션을 클라우드로 보내는 Continue in 메뉴가 있는 것은 데스크톱 앱뿐입니다.

Routines는 같은 것의 예약 버전입니다. 저장해 둔 프롬프트, 하나 이상의 저장소, 커넥터 묶음을 예약 시각에, HTTP 호출로, 또는 GitHub 이벤트로 실행하며, 각 실행은 권한 확인 없이 완전한 cloud session으로 돌아갑니다. 아직 리서치 프리뷰 단계이고, claude.ai/code/routines나 CLI의 /schedule로 만들며, 계정당 하루 실행 횟수 상한이 추가로 붙습니다.

믿고 맡기기 전에 알아 둘 제약이 세 가지 있습니다. cloud session에는 GitHub가 필요합니다. 클론과 풀 리퀘스트는 Claude GitHub App을 거치거나, /web-setup으로 보낸 gh 토큰을 거칩니다. 계정의 다른 모든 사용과 사용량 한도를 공유하며, 별도의 컴퓨팅 요금은 없지만 여러 개를 병렬로 돌리면 그만큼 소모합니다. 그리고 Pro, Max 또는 Team(적절한 시트가 있는 Enterprise)의 claude.ai 로그인이 필요합니다. --cloud와 --teleport는 API 키로는 작동하지 않고, Claude Code가 Bedrock이나 Vertex용으로 설정되어 있을 때도 작동하지 않습니다.

2. Remote Control: 에이전트는 여러분의 컴퓨터에서 돌고, 다른 곳에서 조종한다

Remote Control은 그 거울상입니다. 문서는 이를 한 문장으로 말합니다. "클라우드 인프라에서 돌아가는 cloud session과 달리, Remote Control 세션은 여러분의 컴퓨터에서 직접 돌아가며 로컬 파일 시스템과 상호 작용합니다." claude.ai/code와 iOS, Android의 Claude 앱은 노트북에서 계속 돌아가는 프로세스를 들여다보는 창이며, 파일, MCP 서버, 훅, 프로젝트 설정도 그대로입니다. 폰에서 @를 입력하면 로컬 프로젝트의 경로까지 자동 완성됩니다.

시작하는 방법은 세 가지입니다.

claude remote-control            # server mode: serves sessions to your devices
claude --remote-control          # an interactive session you can also drive remotely
/remote-control                  # from inside a session that is already running

처음 한 번은 Claude Code가 확인을 요청합니다. Pro, Max, Team 또는 Enterprise의 claude.ai 로그인이 필요하고(API 키는 지원하지 않습니다), Team과 Enterprise에서는 먼저 소유자가 스위치를 켜야 합니다. 노트북이 잠자기에 들어가거나 네트워크가 끊겨도, 컴퓨터가 돌아오면 세션은 다시 연결됩니다. 그리고 기억해 둘 것은 Anthropic 문서에 적힌 이 메모입니다. --cloud는 cloud session을 만들고, --remote-control은 그것과 관계가 없습니다.

두 기능이 만나는 곳은 딱 한 군데입니다. --teleport는 Remote Control의 세션 인프라 위로 지나가므로, 만료된 teleport는 Remote Control의 표현으로 오류를 보여 줍니다. 이건 배관의 세부 사항일 뿐, 둘이 같은 것이라는 신호가 아닙니다.

궁금한 게 토큰이라면, 저희가 측정했습니다: Remote Control은 토큰을 더 쓰지 않으며, Codex에는 대신 무엇이 있는지.

3. 내가 소유한 머신: SSH, 터널, 빌드 서버

세 번째 의미는 Anthropic 계정과 아무 관계가 없습니다. 에이전트는 여러분이 소유했지만 지금 눈앞에 있지는 않은 컴퓨터에서 돌아갑니다. 빌드 서버, 사무실 데스크톱, VPS 같은 것입니다. SSH로 접속해 그곳에서 claude나 codex를 실행하면, 세션은 그 머신 위에서 살아 있습니다.

에디터들도 이것을 기능으로 묶기 시작했습니다. VS Code 1.121은 "Remote agents (Preview)"를 추가했습니다. Agents 창은 오래 살아 있는 에이전트 호스트 프로세스를 통해, SSH나 dev tunnels로 여러분이 소유한 원격 머신에서 에이전트 세션을 돌릴 수 있어서, 클라이언트 연결이 끊겨도 실행 중인 세션은 계속됩니다. 같은 발상이고, CLI 하나, 에디터 하나입니다.

가장 단순한 형태는 터미널과 ssh입니다. 모든 CLI에서 작동하고, 코드를 여러분이 관리하는 하드웨어에 그대로 두며, 비용은 늘 그렇듯 따라옵니다. tmux나 screen으로 감싸지 않으면 세션은 연결과 함께 끝나고, 폰은 그리 좋은 SSH 클라이언트가 아닙니다.

어떻게 고를까

올바른 질문은 "어느 것이 가장 좋은가"가 아니라, 코드를 어디서 돌리고 싶은지, 그리고 무엇을 지켜야 하는지입니다.

기억해 둘 것이 두 가지 있습니다. cloud session과 Remote Control은 Claude Code의 기능입니다. Codex에는 --teleport에 해당하는 것이 없고, Antigravity CLI는 버전 2.0부터 자체 Remote Control을 제공합니다. 그리고 "remote"가 "지켜보지 않아도 된다"는 뜻은 아닙니다. 질문을 던진 cloud session은 환경이 만료될 때까지 여러분을 기다리고, Remote Control 세션은 여느 로컬 세션처럼 권한 응답을 기다립니다.

각 경우에 저희가 하는 일

AgentsRoom은 에이전트를 실행하지만 호스팅하지는 않습니다. 그래서 세 경우를 대체하기보다는 각각에 대해 자기 자리를 정합니다.

로컬 에이전트를 폰에서 조종하기, 어떤 CLI든: AgentsRoom 모바일 앱은 데스크톱에서 돌아가는 모든 에이전트(Claude Code, Codex, GitHub Copilot CLI, Cursor 및 다른 에이전트 CLI)의 터미널을 종단 간 암호화된 릴레이를 통해 넘겨받아 조종하고, 에이전트가 여러분을 기다리면 푸시 알림을 보냅니다. Claude Code 세션에서는 Anthropic의 Remote Control과 함께 쓸 수 있습니다. 하나는 대화를 보는 창이고, 다른 하나는 터미널을 보는 창입니다.

내가 소유한 머신의 에이전트: SSH 연결은 서버를 한 번 저장해 두고 그곳에서 CLI를 실행하며, 로컬 에이전트와 같은 타일, 상태, 알림을 보여 줍니다. 원격 플릿(Remote Fleet)은 같은 일을 계정의 모든 컴퓨터에 걸쳐 해내며, 사무실, 집, 빌드 서버를 하나의 뷰에 모읍니다.

내 머신이 전혀 없는 경우: Cloud Agents는 일회용 머신을 띄워 저장소를 클론하고, 폰에서 보낸 지시로 Claude Code나 Codex를 헤드리스로 실행하고, 커밋하고, 브랜치를 푸시한 뒤 스스로 사라집니다. 이것은 세션이 아니라 작업(job)입니다. 접속할 화면이 없고, 그것이 바로 위의 두 경우와의 차이입니다.

이 중 어떤 것도 Anthropic cloud session이 하는 일을 바꾸지 않습니다. Claude Code를 쓰고 있고 VM을 Anthropic이 돌려 주기를 원한다면, claude --cloud가 그 도구이고, 그것이 푸시한 브랜치는 다른 브랜치와 똑같이 저장소에 나타납니다.

자주 묻는 질문

Claude의 remote agents는 Claude Code on the web과 같은 것인가요?

네. Anthropic의 현재 이름은 cloud session입니다. 여러분의 컴퓨터가 아니라 Anthropic이 관리하는 인프라(또는 조직의 자체 호스팅 환경)에서 돌아가는 Claude Code 세션입니다. claude.ai/code에서, Claude 앱의 Code 탭에서, 데스크톱 앱에서 Local 대신 Cloud를 골라서, 또는 터미널에서 claude --cloud로 시작합니다. remote라는 단어는 지금도 --cloud의 폐기 예정 별칭으로 작동하는 예전 플래그 --remote와, 이 기능을 관리하는 조직 정책 allow_remote_sessions에 남아 있습니다.

claude --cloud는 제 컴퓨터에서 무언가를 실행하나요?

아니요. claude.ai에 새 세션을 만들고, 클라우드 VM이 저장소의 GitHub 리모트를 현재 브랜치로 클론합니다. 로컬 체크아웃이 아니므로 로컬 커밋이 있다면 먼저 푸시해야 합니다. 저장소에 리모트가 없거나 Claude GitHub App이 설치되어 있지 않으면, Claude Code가 로컬 저장소를 묶어서 대신 업로드하며, 커밋되지 않은 .env, 키, 자격 증명 파일은 빼 둡니다. 그다음 작업은 클라우드에서 돌아가고, 터미널은 비어 있는 상태로 남습니다.

Remote Control은 클라우드에서 돌아가나요?

아니요. Remote Control은 cloud session의 반대입니다. Claude Code 프로세스는 여러분의 컴퓨터에서 계속 돌아가고, 파일 시스템, MCP 서버, 프로젝트 설정도 그대로이며, claude.ai/code나 iOS와 Android의 Claude 앱이 그 세션을 들여다보는 창이 됩니다. claude remote-control(서버 모드), 대화형 세션에서 claude --remote-control, 또는 이미 돌고 있는 세션 안에서 /remote-control로 시작합니다. Anthropic 문서는 --cloud와 --remote-control이 서로 관계가 없다고 분명히 적어 두었습니다.

Claude의 cloud session이나 Remote Control을 Codex, Antigravity 또는 다른 CLI에서 쓸 수 있나요?

아니요. 둘 다 Claude Code의 기능이며, claude.ai 구독에 묶여 있습니다. Antigravity CLI에는 버전 2.0부터 자체 Remote Control이 있습니다. 다른 CLI에 더할 수 있는 것은 공급사에 의존하지 않는 부분입니다. AgentsRoom 모바일 앱은 데스크톱에서 돌아가는 어떤 에이전트의 터미널이든, CLI와 상관없이, 종단 간 암호화된 릴레이를 통해 넘겨받아 조종하며, Claude Code 세션에서는 Claude의 Remote Control과 함께 쓸 수 있습니다.

cloud session은 추가 비용이 드나요?

클라우드 VM에 대한 별도의 컴퓨팅 요금은 없지만, cloud session은 계정의 다른 모든 Claude 및 Claude Code 사용과 사용량 한도를 공유하며, 여러 세션을 병렬로 돌리면 그만큼 소모합니다. Pro, Max, Team 요금제와, 프리미엄 시트 또는 Chat + Claude Code 시트가 있는 Enterprise에서 쓸 수 있습니다. cloud session으로 돌아가는 Routines에는 계정당 하루 실행 횟수 상한이 추가로 붙습니다.

cloud session을 터미널로 다시 가져오려면 어떻게 하나요?

claude --teleport로 세션 선택 화면을 열거나, 특정 세션이라면 claude --teleport <session-id>를 씁니다. 이미 돌고 있는 세션 안에서는 /teleport가 같은 일을 합니다. Claude Code는 작업 디렉터리가 깨끗한지, 같은 저장소의 체크아웃 안에 있는지, 같은 계정으로 로그인했는지 확인한 뒤, 세션의 브랜치를 가져오고 대화 기록을 불러옵니다. 터미널은 자기만의 사본을 받습니다. 그 뒤에 하는 일은 로컬에 남고 cloud session에는 나타나지 않습니다. CLI에서는 한 방향으로만 넘길 수 있으며, 로컬 세션을 클라우드로 보낼 수 있는 것은 데스크톱 앱뿐입니다.