Claude Code on the web과 Remote Control의 차이 설명
Claude Code on the web(claude.ai/code)는 Anthropic이 관리하는 클라우드 VM에서 작업을 실행합니다. 새로 클론하므로 로컬 설정이 필요 없어요. Remote Control은 바로 그 동일한 claude.ai/code 인터페이스를 쓰지만, 실제로는 여러분 자신의 컴퓨터에서 돌아가고 있는 Claude Code 세션을 조종합니다. Teleport는 완료된 클라우드 세션을 터미널로 끌어와 로컬에서 마무리할 수 있게 해 주는 단방향 브리지예요. 둘 다 research preview로 표시되어 있습니다. Claude Code on the web은 Pro, Max, Team, Enterprise(프리미엄 시트)가 필요하고, Remote Control은 Pro를 포함한 모든 유료 플랜에서 작동합니다.
- 플랜 제한과 기능 상태는 작성 시점(2026-08-20)의 code.claude.com/docs를 기준으로 확인했습니다. 두 기능 모두 아직 research preview이고 변화가 빠르므로, 여기 나온 구체적인 내용을 바탕으로 워크플로를 구성하기 전에 최신 문서를 반드시 확인하세요.
Claude Code on the web이란?
Claude Code on the web은 터미널 대신 claude.ai/code에서 실행되는 Claude Code입니다. 거기서 세션을 시작하거나 CLI에서 보내면, Claude Code는 격리된 Anthropic 관리 클라우드 VM(팀이 세션을 그쪽으로 라우팅한다면 조직의 자체 호스팅 환경)을 띄우고, 현재 브랜치에서 GitHub 저장소를 새로 클론한 뒤, 그 VM 안에서 작업을 실행합니다. 브라우저 탭을 닫아도 세션은 계속 진행되고, Claude 모바일 앱을 열면 진행 상황을 확인하거나 질문에 답하거나 다른 방향으로 살짝 방향을 틀 수 있어요. 이 중 어느 것도 로컬 파일 시스템을 건드리지 않습니다.
모든 클라우드 세션은 저장된 클라우드 환경 안에서 실행됩니다. 이는 네트워크 접근, 환경 변수, 그리고 Claude가 작업을 시작하기 전에 실행하는 모든 설정 스크립트를 제어하는 구성이에요. Claude Code는 처음 온보딩할 때 Default 환경을 자동으로 만들고, 같은 환경은 web뿐 아니라 클라우드 세션을 시작하는 모든 곳에 적용됩니다. routines와 모바일 앱 클라우드 세션에서도 이 환경을 사용해요. 세션이 GitHub 저장소에 접근할 수 있게 하려면 한 번만 연결하면 됩니다. 온보딩 중에 Claude GitHub App을 승인하거나, 터미널에서 /web-setup을 실행해 기존 gh CLI 토큰을 동기화하세요. 어느 방법이든 Claude가 클라우드 VM에서 클론, 푸시, 풀 리퀘스트 생성을 할 수 있게 해 줍니다.
먼저 짚고 넘어갈 구분이 하나 있습니다. 이 글에서 다루는 것은 여러분이 직접 시작하고 지켜보는 클라우드 세션입니다. Claude Code가 스케줄, API 호출, GitHub 이벤트를 계기로 스스로 실행되기를 원한다면, 그건 다른 기능이에요. 스케줄 기반 클라우드 자동화(Routines)이며, 여기서는 다루지 않습니다.
Claude Code on the web vs Remote Control — 같은 URL, 서로 다른 두 기능
혼란의 진짜 원인을 솔직히 말하면 이렇습니다. Remote Control과 Claude Code on the web은 완전히 동일한 claude.ai/code 인터페이스를 사용합니다. Anthropic의 공식 문서에도 그렇게 명시되어 있어요. 같은 URL을 열면 비슷하게 생긴 세션 목록이 보이고, 지금 어느 기능을 보고 있는지 알려 주는 시각적 단서가 없습니다. 그래서 대부분의 사람들은 이 둘이 이름만 다른 같은 것이라고 여기죠. 하지만 그렇지 않습니다.
| Claude Code on the web | Remote Control | |
|---|---|---|
| 코드가 실행되는 곳 | Anthropic 관리 클라우드 VM(또는 조직의 자체 호스팅 환경) | 여러분 자신의 컴퓨터 |
| 필요한 것 | GitHub에 연결된 저장소, 또는 GitHub를 쓰지 않는다면 로컬 번들 업로드 | 계속 실행 중인 로컬 claude remote-control 프로세스(또는 --remote-control / /remote-control) |
| 로컬 설정과 MCP 사용 여부 | 아니요 — 새로 클론하며, 클라우드 환경 자체의 구성만 사용 | 네 — 파일 시스템, MCP 서버, 도구, 프로젝트 설정을 그대로 사용할 수 있습니다 |
| 연결을 끊어도 계속 실행되는지 | 네 — 탭을 닫아도 세션이 유휴 상태가 될 때까지 유지됩니다 | 아니요 — 터미널을 닫거나 VS Code를 종료하면 오프라인이 됩니다(원격 머신의 tmux/screen에서 계속 살려 두는 경우 제외) |
짧게 말하면, Claude Code on the web은 노트북 없이 작업을 실행하는 장소입니다. Remote Control은 아직 노트북에서 돌아가고 있는 작업을 들여다보는 창이고요. 같은 문이지만, 그 뒤의 방은 아주 다릅니다.
UI를 공유해서 생기는, 짚어 둘 만한 또 다른 부작용이 있습니다. web 세션을 공유하는 것은 Remote Control 링크를 공유하는 것과 같지 않아요. web 세션에는 자체 공개 범위 토글이 있고(Team과 Enterprise에서는 Private/Team, Pro와 Max에서는 Private/Public), Public 링크를 가진 사람은 누구나 세션의 코드와 대화를 볼 수 있습니다. 게다가 Pro/Max 계정에서는 저장소 접근 검증이 기본으로 켜져 있지 않으므로, Public으로 만들기 전에 자격 증명이 섞여 들어가지 않았는지 세션을 확인해 두는 것이 좋습니다.
전체 지형도 — Web, Remote Control, 터미널, Desktop
한 단계 더 물러서서 보면, Claude Code를 실행하는 방법은 사실 둘이 아니라 넷입니다.
| 실행 면 | 코드가 실행되는 곳 | 조작하는 위치 | GitHub 필요 여부 | 적합한 용도 |
|---|---|---|---|---|
| Web(claude.ai/code) | 클라우드 VM | 브라우저 또는 Claude 모바일 앱 | 푸시/PR에는 필요(그 외에는 로컬 번들로 대체 가능) | 병렬 작업, 로컬 체크아웃 불필요, 노트북은 닫힌 채로 |
| Remote Control | 여러분의 컴퓨터 | 브라우저 또는 모바일 앱에서 로컬 프로세스를 조종 | 불필요 — 로컬 저장소에 이미 있는 것을 그대로 사용 | 로컬에서 이미 진행 중인 작업에서 잠시 벗어날 때 |
| 터미널(순수 CLI) | 여러분의 컴퓨터 | 터미널 그 자체 | 불필요 | 최대한의 제어 — 스크립팅, 모든 권한 모드, 브라우저 의존성 없음 |
| Desktop 앱의 Code 탭 | 여러분의 컴퓨터 | Desktop GUI | 불필요 | 여러 병렬 로컬 세션의 diff를 시각적으로 검토 |
권한 모드도 같은 패턴을 따릅니다. Remote Control과 터미널은 로컬 세션이 이미 실행 중인 권한 모드를 그대로 공유하고, Desktop은 자체 선택기(Manual, Accept edits, Plan, Auto, Bypass)를 가지며, web 세션은 승인을 브라우저 UI 안에서 처리합니다. Desktop은 따로 깊이 다룰 가치가 있어요. 설치 단계, 병렬 worktree, 예약 작업에 대해서는 Desktop 앱 가이드를 참고하세요.
Teleport — 클라우드 세션을 터미널로 끌어오기
Teleport는 사람들이 실제로 가장 원하는 방향을 위한 브리지입니다. 즉, web에서 무언가를 시작한 뒤, 완전한 로컬 환경이 있는 곳에서 마무리하는 흐름이죠. 방향은 단방향 — 클라우드에서 터미널로뿐입니다. 실행 중인 터미널 세션을 web으로 밀어 올리는 CLI 명령은 없어요. (Desktop 앱에는 로컬 세션을 web으로 보낼 수 있는 별도의 "Continue in" 메뉴가 있지만, 그건 teleport와는 다른 메커니즘입니다.)
실행하는 방법은 다섯 가지입니다.
claude --teleport— 클라우드 세션의 대화형 선택기를 엽니다.claude --teleport <session-id>— 특정 세션을 바로 재개합니다./teleport또는/tp— 기존 터미널 세션 안에서 재시작 없이 사용합니다./tasks를 연 뒤t를 누릅니다 — 백그라운드 세션 목록에서 사용합니다.- 클라우드 세션 안에서
/teleport를 입력하면 Claude가 실행할 정확한 명령을 알려 줍니다(해당 세션 환경에 Claude Code v2.1.223 이상이 필요합니다).
Teleport는 세션을 넘겨주기 전에 네 가지를 확인합니다.
- 깨끗한 git 상태 — 커밋되지 않은 로컬 변경이 없어야 합니다(있으면 stash를 제안해 줍니다).
- 올바른 저장소 — 포크가 아니라 같은 저장소의 체크아웃에 있어야 합니다.
- 브랜치 푸시 완료 — 클라우드 세션의 브랜치가 원격에 이미 존재해야 합니다. teleport가 이를 fetch해서 체크아웃합니다.
- 같은 계정 — 해당 세션을 소유한 claude.ai 계정으로 로그인되어 있어야 합니다.
넘겨받고 나면 터미널은 대화와 브랜치의 자체 사본을 갖게 됩니다. 그 시점 이후 로컬에서 하는 새 작업은 클라우드 세션으로 다시 동기화되지 않아요. teleport한 뒤에도 (이제 로컬이 된) 세션을 휴대폰에서 계속 조종하고 싶다면, 그 안에서 /remote-control을 시작하세요.
헷갈리지 않도록 알아 둘 만한 특이한 점이 하나 있습니다. --teleport는 사실 Remote Control이 내부적으로 쓰는 것과 동일한 세션 인프라를 통해 연결됩니다. 그래서 오래된 로그인 때문에 Remote Control session expired나 Access denied 오류가 나타날 수 있어요. /remote-control을 직접 실행한 적이 없는데도 말이죠. /login을 실행해 자격 증명을 갱신한 뒤 다시 시도하면 거의 모든 경우에 해결됩니다.
실제 흐름 — web에서 시작해 터미널에서 마무리하기
제가 실제로 이것을 어떻게 쓰는지 대략 소개할게요. 그대로 옮긴 기록이 아니라 워크플로의 모양을 보여 주는 예시입니다.
- 로컬 변경을 전부 푸시한 뒤 터미널에서 작업을 시작합니다.
claude --cloud "fix the flaky retry test in payment-webhook.spec.ts". VM이 프로비저닝되는 동안 CLI가 실시간 체크리스트를 보여 주고, 그 뒤 작업은 클라우드에서 실행되며 저는 로컬에서 다른 일을 계속합니다. - 상관없는 다른 일을 하는 동안, 다른 터미널의
/tasks에서, 또는 휴대폰의 claude.ai/code에서 상태를 확인합니다. Claude가 작업 도중 질문에 부딪혀도 제가 바로 못 봤다면, 그냥 기다려 줍니다. 세션은 제가 답한 시점부터 이어서 진행돼요. - 거의 끝나 보이면 web에서 diff를 열어 훑어봅니다. 제 컴퓨터에만 있는 도구(로컬 디버거나 VPN 뒤의 서비스 등)로 한 번 더 손봐야 한다면 teleport로 끌어옵니다.
claude --teleport를 실행하고 목록에서 세션을 고르면 됩니다. - 로컬에서 검토를 마치고, 실제 테스트 스위트를 돌리고, 푸시한 뒤, 다른 변경과 똑같이 터미널에서 PR을 엽니다.
실제로 시간을 아껴 주는 부분은 2단계입니다. 작업은 노트북이 열려 있든 아니든 계속 실행되므로, "시작해 놓고 다른 일을 하러 가기"가 같은 탭에서 기다리는 게 아니라 진짜 선택지가 됩니다.
보너스: Auto-Fix는 푸시 후에도 여러분의 PR을 계속 지켜봅니다
teleport한 세션에서 PR을 푸시하기 시작했다면 알아 둘 만한 기능이 하나 있습니다. Claude는 풀 리퀘스트가 열린 뒤에도 계속 지켜보면서, 새 세션을 시작하지 않아도 CI 실패나 새 리뷰 코멘트에 스스로 반응할 수 있어요. 켜려면 web 세션의 CI 상태 표시줄에서(Auto-fix 선택), PR 브랜치에 있는 상태에서 터미널의 /autofix-pr로, 또는 아무 세션에나 "이 PR을 지켜보다가 CI 실패가 있으면 고쳐 줘"라고 말하면 됩니다. Claude가 확신하고 이전 지시와 충돌하지 않는 수정이라면, 변경을 푸시하고 세션에서 무엇을 했는지 설명합니다. 모호하거나 아키텍처상 중요한 것이라면 추측하지 않고 먼저 물어봐요. 이 기능은 저장소에 Claude GitHub App이 설치되어 있어야 합니다. web 온보딩 때 이미 사용했을 바로 그 앱이에요.
Web vs 터미널 vs Desktop vs Remote Control, 언제 쓸까
| 사용 | 이럴 때 |
|---|---|
| Web(claude.ai/code) | 로컬 체크아웃 없이 작업을 시작하고 싶거나, 여러 개를 병렬로 돌리거나, 컴퓨터를 붙잡아 두지 않고 계속 일하고 싶을 때 |
| Remote Control | 로컬에서 작업 도중인데 상태를 확인하거나, 프롬프트를 승인하거나, 휴대폰에서 계속 조종하고 싶을 때 |
| 터미널(순수 CLI) | 모든 권한 모드나 스크립팅이 필요할 때, 또는 그냥 브라우저를 끼우고 싶지 않을 때 |
| Desktop 앱 | 여러 로컬 세션의 diff를 나란히 검토하며 GUI를 쓰고 싶을 때 |
요구 사항과 플랜 제한
| 기능 | 상태 | 플랜 제한 |
|---|---|---|
| Claude Code on the web | Research preview | Pro, Max, Team, Enterprise(프리미엄 시트, 또는 Chat + Claude Code 시트) |
| Remote Control | Research preview | 모든 유료 플랜 — Pro, Max, Team, Enterprise. API 키는 지원되지 않습니다. Team/Enterprise에서는 기본으로 꺼져 있으며, Owner가 관리 설정에서 켤 때까지 사용할 수 없습니다. |
정확히 짚어 둘 점이 하나 있습니다. Remote Control은 Max 플랜 전용이 아닙니다. Pro를 포함해 Claude Code의 나머지 기능과 같은 플랜 목록에 있어요. Team이나 Enterprise 조직에서 아직 보이지 않는다면, 그건 거의 항상 Owner 수준의 토글이 꺼져 있기 때문이지 플랜 등급에 의한 차단이 아닙니다. Team과 Enterprise 조직은 Trusted Devices(베타)도 켤 수 있어요. 이 기능은 위의 플랜 요건에 더해, Remote Control 세션을 보거나 조종하기 전에 각 기기를 등록하고 약 18시간마다 생체 인증으로 다시 확인하도록 요구합니다.
자주 묻는 질문(FAQ)
Claude Code on the web이란 무엇인가요?
Anthropic이 관리하는 클라우드 VM(또는 조직의 자체 호스팅 환경) 안에서 claude.ai/code로 실행되는 Claude Code입니다. 세션마다 GitHub 저장소를 새로 클론하고, 브라우저를 닫은 뒤에도 계속 실행되며, Claude 모바일 앱에서 모니터링할 수 있어요.
Remote Control은 Claude Code on the web과 같은 건가요?
아니요. 다만 둘 다 같은 claude.ai/code 인터페이스에서 열리는데, 바로 그 점 때문에 사람들이 헷갈려 합니다. Claude Code on the web은 작업을 클라우드에서 실행합니다. Remote Control은 여러분 자신의 컴퓨터에서 아직 돌아가고 있는 세션을 조종하고요. 로컬 파일 시스템과 MCP 서버가 그대로 관여합니다.
로컬 터미널 세션을 web으로 밀어 올릴 수 있나요?
teleport로는 안 됩니다. 방향은 단방향, 클라우드에서 터미널로뿐이에요. 실행 중인 로컬 세션을 claude.ai/code로 보내는 CLI 명령은 없습니다. Desktop 앱에는 로컬 세션을 web으로 보낼 수 있는 별도의 "Continue in" 메뉴가 있지만, 그건 teleport가 아니라 다른 기능입니다.
클라우드 세션에 GitHub가 필요한가요?
일반적인 흐름에서는 필요합니다. Claude Code가 GitHub에서 저장소를 클론하고 브랜치를 다시 그쪽으로 푸시하거든요. 저장소가 GitHub에 없다면 Claude Code가 대신 직접 번들해서 업로드할 수도 있지만, 그렇게 만든 세션은 GitHub를 함께 연결하지 않는 한 결과를 원격으로 다시 푸시할 수 없습니다.
Remote Control은 인터넷 연결 없이 작동하나요?
아니요. Remote Control은 휴대폰이나 브라우저가 도달할 수 있도록 로컬 세션을 Anthropic API에 등록합니다. 컴퓨터가 온라인이 되지 못하면 그들이 연결할 대상이 없어요. 터미널 세션 자체는 어느 쪽이든 로컬에서 계속 작동합니다. 네트워크가 필요한 것은 원격 조종 부분뿐이에요. 세션 도중 네트워크가 끊겨도 Claude Code가 스스로 재시도하고 복구되면 다시 연결하므로, 짧은 장애는 보통 세션 손실이 아니라 지연으로 끝납니다.
Claude Code on the web은 무료인가요?
클라우드 VM 자체에 별도 요금은 없습니다. 클라우드 세션은 기존 Pro, Max, Team, Enterprise 플랜에서의 다른 Claude Code 사용과 같은 사용량 제한을 공유합니다.
마무리
같은 claude.ai/code 문, 그 뒤의 서로 다른 두 방 — Claude Code on the web은 작업을 다른 곳에서 실행하고, Remote Control은 자기 컴퓨터에서 아직 돌아가는 작업을 지켜보며 조종하게 해 주며, teleport는 이제 그곳에서 마무리할 준비가 된 클라우드 세션을 터미널로 다시 끌어오는 단방향 브리지입니다. 둘 다 아직 research preview이므로, 여기 적힌 구체적인 플랜 제한과 버전 번호는 계속 바뀔 거라고 생각하세요. 어느 한 가지 세부 사항을 바탕으로 워크플로를 구성하기 전에 최신 문서를 확인하세요. Claude Code가 완전히 처음이신가요? 먼저 Claude Code란 무엇인가부터 시작하세요.