웹 기반 Claude Code는 저장소의 복제본을 기반으로 Anthropic의 클라우드 인프라에서 Claude Code를 실행하므로, 내 컴퓨터 없이도 작동합니다. 룸을 갖춘 로컬 에이전트는 내 컴퓨터에서 Claude Code를 실행하며, 내가 초대한 사람들이 작업을 요청할 수 있게 하고 실행 여부는 내가 직접 승인합니다. 전자는 언제나 켜져 있고, 후자는 언제나 온전히 내 것입니다.
두 방식 모두 유효합니다. 코드와 자격 증명이 어디에 있는지, 에이전트와 누가 대화할 수 있는지, 그리고 아무도 지켜보지 않을 때 어떤 일이 일어나는지가 다를 뿐입니다.
웹 기반 Claude Code의 작동 방식
저장소를 연결하면 Anthropic이 샌드박스를 프로비저닝하고 코드를 복제하여 그곳에서 Claude Code를 실행합니다. Git 작업은 GitHub의 OAuth 연동을 통해 제공자에게 발급된 토큰을 사용합니다. 로컬 자격 증명, SSH 키, 환경 변수는 전혀 관여하지 않습니다. 결과는 브랜치나 풀 리퀘스트 형태로 전달됩니다. 세션은 어떤 브라우저에서든 온전히 사용자의 것입니다.
이 방식은 지켜볼 필요 없는 백그라운드 작업에 적합합니다. 노트북을 덮어둔 상태에서 여러 저장소에 걸친 작은 작업 큐를 처리할 때 좋습니다.
룸을 갖춘 로컬 에이전트의 작동 방식
Claude Code는 늘 그렇듯 내 컴퓨터에서 실행되며, 이미 체크아웃된 저장소와 기존 자격 증명을 그대로 사용합니다. muti daemon은 아웃바운드 연결을 통해 작업을 폴링하고 각 도구 호출을 룸으로 스트리밍합니다. 사용자 본인이나 초대받은 사람은 누구나 브라우저나 스마트폰에서 요청을 보낼 수 있습니다. 컴퓨터가 절전 모드일 때는 요청이 대기열에 쌓입니다. 위험한 작업은 사용자의 승인을 기다리기 위해 일시 중지됩니다.
이 방식은 공유에 적합합니다. 하나의 에이전트를 여러 사람이 사용하되, 통제권은 전적으로 소유자에게 있습니다.
왼쪽에는 제공자 클라우드, 오른쪽에는 사용자의 컴퓨터, 그리고 각 방식의 적합한 용도.
비교
각각의 장점
웹 버전이 더 나은 경우: 컴퓨터를 계속 켜둘 수 없을 때입니다. 수십 개의 저장소에 걸친 야간 배치 수정 작업, 개발 환경이 없는 기여자, 또는 개발자 노트북에서 에이전트를 전혀 실행하지 않도록 요구하는 컴플라이언스 환경에 적합합니다.
로컬 버전이 더 나은 경우: 에이전트가 내 컴퓨터에 있는 리소스를 활용해야 할 때입니다. 로컬 네트워크에서만 접근 가능한 데이터베이스, 브라우저에 로그인된 디자인 도구, 작업마다 새로 복제하기에는 너무 큰 모노레포, 또는 직접 구성해 둔 MCP 서버 등이 여기에 해당합니다. 또한 두 번째 사용자가 관여하는 순간 로컬 버전이 항상 유리합니다. 룸은 상대방에게 요청할 수 있는 방법을 제공하고, 소유자에게는 거절할 수 있는 수단을 제공하기 때문입니다.
자격 증명 문제
웹 버전의 보안 논리는 타당합니다. 로컬 시크릿이 에이전트 환경에 전혀 노출되지 않기 때문입니다. 로컬 버전의 논리 역시 그 반대편에서 타당합니다. 내 시크릿이 다른 누구의 환경에도 들어가지 않기 때문입니다. 어느 쪽이 더 중요한지는 본인의 노트북과 제공자의 멀티 테넌트 샌드박스 중 어느 쪽을 덜 신뢰하느냐에 따라 달라집니다. 룸은 웹 버전이 제공할 수 없는 한 가지 장점을 더합니다. 다른 사람이 요청할 때 자격 증명 프롬프트가 소유자에게 라우팅되므로, 요청자는 이를 결코 볼 수 없습니다. what the daemon uploads 문서를 참고하세요.
결정 가이드
자주 묻는 질문
웹 기반 Claude Code는 Remote Control과 같은 것인가요? 아닙니다. Remote Control은 다른 기기에서 내 컴퓨터의 세션을 제어하는 것이며, 웹 버전은 클라우드에서 실행됩니다. Remote Control vs an agent room을 참고하세요.
룸에서 웹 기반 Claude Code를 에이전트로 사용할 수 있나요? 아닙니다. 룸을 사용하려면 소유자가 통제하는 머신에 에이전트가 있어야 합니다. 그래야만 승인 모델이 안전하게 유지됩니다.
로컬 버전을 쓰려면 포트를 열어야 하나요? 아닙니다. daemon은 아웃바운드 방식으로 폴링하므로 인바운드 연결은 필요하지 않습니다.
작업이 있는 곳에 에이전트를 두세요. 그 작업이 내 컴퓨터에 있다면 에이전트에 룸을 마련해 주세요.
게시일