Claude Code 웹 세션 — 클라우드 서버 값은 따로 안 받는데, 깃허브 앱을 한 곳에 깔아도 전부 열립니다

브라우저에서 일을 던져두면 노트북을 닫아도 계속 돕니다. 이게 Claude Code 웹 세션의 요지고, 실제로 클라우드 컴퓨터 값은 따로 안 받습니다. 공짜로 서버 하나가 생기는 것처럼 들리는데, 공식 문서를 읽어 보니 따로 안 받는 대신 무엇을 나눠 쓰는지가 분명히 적혀 있었습니다. 그리고 그보다 더 눈에 걸린 건 깃허브 연결에 대한 문서의 자기 경고였습니다 — 앱을 저장소 하나에 깔았다고 그 저장소만 열리는 게 아닙니다.

📌 30초 요약

• 클라우드 VM에 별도 컴퓨트 요금은 없습니다. 대신 계정 전체와 한도를 공유하고, 병렬로 돌리면 그만큼 더 먹습니다.
• 깃허브 앱 설치는 접근 통제가 아닙니다. 연결한 계정이 볼 수 있는 저장소는 전부 닿습니다. 문서가 직접 적어놓은 문장입니다.
• 깃허브가 없어도 보낼 수 있습니다. 로컬 저장소를 통째로 묶어 올리는데, 추적 안 된 파일은 빠지고 되돌려 푸시도 못 합니다.
• 옮기는 건 한 방향뿐입니다. 클라우드를 터미널로 당겨오는 건 되는데 돌던 터미널 세션을 웹으로 밀어 올리진 못합니다.
• 공유 설정이 플랜에 따라 반대입니다. 개인 상위 플랜 쪽이 전체 공개에 저장소 검증도 기본 꺼짐입니다.
• PR 자동 수정은 내 깃허브 계정으로 댓글을 답니다. 댓글로 도는 자동화가 있으면 그게 트리거될 수 있다고 문서가 경고합니다.

값은 안 받는데, 한도는 나눠 씁니다

세션은 앤트로픽이 관리하는 클라우드 인프라에서 돌고, 브라우저를 닫아도 유지되며 폰의 Claude 앱에서 확인할 수 있습니다. 조직이 자체 호스팅 환경으로 돌려놨다면 그쪽에서 돌고요. 지금은 리서치 프리뷰 단계이고, Pro·Max·Team과 특정 좌석을 가진 Enterprise 사용자가 대상이라고 문서가 밝힙니다.

💸 "컴퓨트 요금 없음"의 정확한 뜻

제한 사항 절의 첫 줄이 이렇습니다 — 웹은 계정 안의 다른 모든 Claude·Claude Code 사용량과 요금 한도를 공유하고, 여러 작업을 병렬로 돌리면 한도를 그만큼 비례해서 더 쓴다. 클라우드 VM에 대한 별도 컴퓨트 과금은 없다. 두 문장을 붙여 읽어야 그림이 맞습니다. 서버를 하나 더 얻는 게 아니라, 내 한도를 여러 갈래로 나눠 쓰는 것이죠. 그래서 병렬 실행이 공짜처럼 느껴지지만 실제로는 가장 빨리 한도를 태우는 방법입니다. 반대로 좋은 소식도 분명합니다 — 돌리는 시간이 길어져도 그 자체로 요금이 붙지는 않습니다. 오래 걸리는 작업일수록 이쪽이 유리하다는 뜻이고요. 어디서 돌릴지 전체 선택지는 제가 실행 위치 여섯 가지를 비교한 글에 표로 정리해뒀습니다.

깃허브 연결 두 가지, 그리고 문서의 경고

클라우드 세션은 코드를 클론하고 브랜치를 푸시해야 하니 깃허브 접근이 필요합니다. 방법은 둘인데, 브라우저에서 온보딩하며 깃허브 앱을 승인하거나, 터미널에서 전용 명령으로 내 로컬 깃허브 CLI 토큰을 계정에 동기화하는 것입니다. 후자는 이미 깃허브 CLI를 쓰는 사람에게 빠르고, 전자는 뒤에 나올 PR 자동 수정을 쓰려면 필요합니다.

🚨 앱 설치는 접근 통제 장치가 아닙니다

문서가 두 방법을 소개한 직후에 곧바로 붙인 주의사항입니다. 요지를 옮기면 — 어느 방법을 쓰든 클라우드 세션은 연결한 깃허브 계정이 볼 수 있는 모든 저장소에 접근할 수 있다. 앱이 설치된 저장소만이 아니다. 그러면서 못을 박습니다 — 앱 설치는 자동 수정을 위한 PR 웹훅을 켜는 것이지, 세션 수준의 접근 통제가 아니다. 이게 왜 위험하냐면, 깃허브 앱은 설치할 때 저장소를 골라서 체크하는 화면을 보여주기 때문입니다. 거기서 하나만 골랐으니 그 하나만 열렸겠거니 하기 딱 좋죠. 실제로는 내 계정이 보는 회사 저장소 전체가 사정권입니다. 문서가 제시하는 유일한 처방도 그래서 도구 바깥에 있습니다 — 범위를 좁히려면 깃허브 쪽에서 좁혀라, 즉 연결한 계정의 팀·저장소 멤버십을 제한하라는 것입니다. 참고로 제로 데이터 보존을 켠 조직은 이 기능들을 아예 못 씁니다.

깃허브가 없어도 보낼 수 있습니다

이건 반대로 반가운 쪽입니다. 깃허브에 연결되지 않은 저장소에서 클라우드 명령을 실행하면 로컬 저장소를 통째로 묶어 세션에 직접 업로드합니다. 묶음에는 모든 브랜치의 전체 히스토리와 추적 중인 파일의 커밋 안 한 변경까지 들어갑니다. 깃허브 접근이 없을 때 자동으로 켜지고, 연결돼 있어도 환경 변수 하나로 강제할 수 있습니다. 다만 조건이 넷 붙습니다.

조건	내용
git 저장소여야	커밋이 최소 하나는 있어야 합니다
100MB 미만	넘으면 현재 브랜치만으로, 그래도 크면 작업 트리 스냅샷 하나로 단계적으로 줄이고, 그것도 크면 실패
추적 안 된 파일은 제외	보여주려면 먼저 스테이징해야 합니다
되돌려 푸시 불가	깃허브 인증을 따로 해두지 않았다면 결과를 원격에 못 올립니다

세 번째가 조용한 함정입니다 — 방금 만든 새 파일은 스테이징하지 않으면 클라우드가 못 봅니다. "분명히 저장했는데 왜 없다고 하지"가 나오는 자리죠. 그리고 이 경로 덕에 깃랩·비트버킷 저장소도 클라우드로 보낼 수는 있습니다. 다만 네 번째 조건 때문에 결과를 되돌려 올리지는 못합니다. git 자체가 처음이라면 제가 git과 깃허브 CLI 입문을 정리한 글을 먼저 보시는 게 순서입니다.

옮기는 건 한 방향뿐입니다

문서가 명시적으로 적어둔 비대칭입니다 — CLI에서 세션 인계는 한 방향이다. 클라우드 세션을 터미널로 당겨오는 건 되는데, 이미 돌고 있는 터미널 세션을 웹으로 밀어 올리지는 못합니다. 클라우드 플래그는 작업 설명과 함께 쓰면 새 세션을 만들 뿐이고요. 밀어 올리는 건 데스크톱 앱의 "다른 곳에서 계속" 메뉴로만 됩니다.

당겨올 때 확인하는 조건이 넷입니다 — 커밋 안 한 변경이 없어야 하고(있으면 임시 보관을 권합니다), 같은 저장소의 체크아웃이어야 하며(포크는 안 됩니다), 그 브랜치가 원격에 푸시돼 있어야 하고, 같은 계정으로 로그인돼 있어야 합니다. 여기에 하나 더 붙는데, API 키로 인증한 상태면 이 기능 자체가 안 뜹니다. 구독 계정 로그인이 필요하고, 서드파티 공급자로 설정돼 있으면 클라우드 세션이 아예 대상이 아닙니다.

🔀 당겨오면 사본이 생깁니다

이 대목을 놓치면 헷갈립니다. 세션을 터미널로 당겨오면 터미널이 그 세션의 사본을 갖습니다. 브랜치를 체크아웃하고 대화 기록 전체를 불러오는데, 그 뒤 터미널에서 한 작업은 로컬에만 남고 웹이나 폰 앱의 클라우드 세션에는 나타나지 않습니다. 즉 당겨온 순간 둘은 갈라집니다. 당겨온 뒤에도 폰에서 계속 조종하고 싶으면 로컬 세션에서 원격 제어를 따로 켜야 합니다. 이름이 비슷해서 더 헷갈리는데, 클라우드 플래그와 원격 제어 플래그는 서로 무관한 기능입니다. 전자는 클라우드에서 새로 돌리는 것이고 후자는 내 컴퓨터의 세션을 밖에서 들여다보게 여는 것입니다. 당겨오기 기능이 원격 제어와 같은 연결망을 쓰는 탓에 오류 메시지에 원격 제어라는 단어가 튀어나오기도 합니다.

공유 설정이 플랜에 따라 반대입니다

세션을 동료에게 보여줄 수 있는데, 선택지와 기본값이 계정 종류에 따라 갈립니다. 보통 기업 플랜이 더 열려 있으리라 짐작하기 쉬운데 여기서는 정반대입니다.

계정	공개 범위 선택지	저장소 접근 검증	넓은 쪽을 골랐을 때
기업 · 팀	비공개 / 팀	기본 켜짐	같은 조직 구성원까지
Max · Pro	비공개 / 전체 공개	기본 꺼짐	로그인한 아무나

문서가 개인 플랜 쪽에만 경고 문단을 따로 답니다 — 공유하기 전에 민감한 내용이 있는지 확인하라. 세션에는 비공개 저장소의 코드와 자격증명이 들어 있을 수 있다. 기업 플랜에서는 받는 사람의 깃허브 계정으로 저장소 접근을 검증하는 게 기본이라 한 겹이 더 있는데, 개인 플랜은 그 검증이 꺼져 있고 범위도 "클로드에 로그인한 모든 사용자"입니다. 다행히 둘 다 설정에서 검증을 요구하도록 켜거나 내 이름을 숨기도록 바꿀 수 있습니다. 개인 플랜을 쓰면서 세션을 공유할 일이 있다면 공유 전에 이 설정부터 한 번 보는 게 맞습니다.

PR 자동 수정 — 내 계정으로 댓글이 달립니다

가장 눈에 띄는 기능입니다. PR을 지켜보다가 CI가 깨지거나 리뷰 댓글이 달리면 알아서 조사하고 고쳐서 푸시합니다. 판단은 셋으로 갈리는데 — 확실한 수정이면 바로 고쳐 올리고, 해석이 갈리거나 구조적으로 중요한 요청이면 나에게 먼저 묻고, 중복이거나 손댈 게 없으면 기록만 남기고 넘어갑니다. 켜는 방법은 웹의 CI 상태바, 터미널 명령, 폰에서 말로 시키기, PR 주소 붙여넣기 넷입니다.

⚠️ 댓글이 배포를 트리거할 수 있습니다

문서가 경고 상자를 따로 씁니다. 먼저 사실 하나 — Claude가 리뷰 댓글 스레드에 답을 다는데, 그 답이 내 깃허브 계정으로 올라가서 내 사용자명으로 보입니다. 각 답변에 Claude Code가 쓴 것이라는 표시는 붙지만, 계정은 제 것이죠. 여기서 문제가 파생됩니다 — 저장소에 댓글 이벤트로 도는 자동화가 걸려 있으면, 그러니까 인프라 도구나 직접 만든 워크플로가 PR 댓글에 반응하도록 돼 있으면, Claude의 댓글이 그걸 트리거할 수 있습니다. 그래서 문서의 권고가 단호합니다 — PR 댓글 하나가 인프라를 배포하거나 특권 작업을 돌릴 수 있는 저장소에서는 자동 수정을 끄는 것을 고려하라. 켜기 전에 저장소의 자동화 목록을 먼저 훑어보라는 것이고, 이건 도구 문제가 아니라 "에이전트에게 내 신원을 빌려주면 내 권한도 같이 빌려준다"는 구조 문제입니다.

못 잡는 것도 하나 명시돼 있습니다 — 기준 브랜치가 앞서 나가면서 생긴 병합 충돌에는 깃허브가 웹훅을 쏘지 않아서, 자동 수정이 충돌에는 스스로 반응하지 못합니다. 세션을 열고 리베이스를 직접 시켜야 합니다. "지켜보고 있으니 괜찮겠지" 하고 두면 충돌만 조용히 쌓입니다.

웹에서 다르게 동작하는 것들

터미널 전용 명령은 웹에서 안 됩니다. 그런데 되긴 하는데 다르게 되는 것들이 따로 있어서 이쪽이 더 헷갈립니다. 모델·강도·이름 바꾸기처럼 터미널에서 선택 화면을 띄우던 명령들은 값을 인자로 붙여야 하고, 설정 명령은 값을 바꾸는 대신 설정 화면을 열며 뒤에 붙인 텍스트를 그냥 무시합니다. 대화 비우기는 아예 없고 사이드바에서 새 세션을 만들라고 안내합니다.

가장 조용한 건 자동 압축 시점입니다. 웹은 압축 시점을 정하는 환경 변수를 스스로 설정해서 컨텍스트가 다 차기 전에 미리 압축합니다. 그런데 문서가 덧붙입니다 — 그 값이 내가 환경 변수에 넣은 값을 덮어쓰기 때문에, 같은 변수를 넣어도 압축 시점은 안 바뀐다. 바꾸려면 다른 변수를 쓰거나 별도 명령으로 해야 합니다. 설정을 넣었는데 아무 반응이 없고 오류도 없는, 딱 걸리기 좋은 자리죠. 이런 "넣었는데 조용히 무시되는" 구조는 제가 큰 코드베이스 설정을 정리한 글에서 다룬 것과 같은 계열입니다.

격리 쪽은 튼튼한 편입니다 — 세션마다 격리된 가상 머신이고, git 자격증명이나 서명 키는 샌드박스 안에 아예 들어가지 않고 보안 프록시가 범위를 제한한 자격증명만 발급합니다. 다만 문서가 스스로 한 줄 덧붙입니다 — 망 접근을 꺼도 Claude Code는 여전히 앤트로픽 API와 통신할 수 있고, 이는 데이터가 VM 밖으로 나가는 것을 허용할 수 있다. "망을 껐으니 아무것도 안 나간다"는 아니라는 뜻입니다.

🙋 정직하게 밝혀둘 것

• PR 자동 수정을 실제로 걸어 보지 않았습니다. 얼마나 자주 맞게 고치는지, 애매한 요청에서 얼마나 잘 멈추는지는 제가 잰 값이 없습니다.
• "깃허브 앱이 위험하다"는 뜻이 아닙니다. 접근 범위는 연결한 계정이 원래 가진 권한 그대로이지, 앱이 권한을 늘리는 게 아닙니다. 문제는 설치 화면에서 저장소를 골랐다는 사실이 범위를 좁혀준다고 오해하기 쉽다는 데 있습니다.
• "한도를 나눠 쓰니 손해"도 아닙니다. 같은 작업을 내 컴퓨터에서 돌려도 토큰은 똑같이 나갑니다. 돌리는 시간에 대한 컴퓨트 요금이 안 붙는 건 명확한 이득이고, 다만 병렬로 여러 개 띄울 때 체감이 달라진다는 것뿐입니다.
• 리서치 프리뷰 단계라고 문서가 밝힙니다. 일부 기능은 계정별로 순차 적용 중이라고 오류 표에 적혀 있어서, 같은 플랜이어도 지금 되는 범위가 다를 수 있습니다.

🗺️ AI 지출 전체 지도

컴퓨트 요금이 없다는 말과 한도를 공유한다는 말은 같이 읽어야 합니다. 구독과 종량제 고르기부터 캐시, 모델 조합, 상한 걸기까지 지금까지 확인한 것들을 일곱 단계 지도 한 장으로 묶어뒀습니다.

자주 묻는 것

Q. 로컬에서 작업하던 걸 그대로 클라우드로 넘길 수 있나요?

CLI에서는 안 됩니다. 클라우드 명령은 새 세션을 만들 뿐이고, 그때 클론하는 것도 내 로컬 체크아웃이 아니라 현재 디렉터리의 깃허브 원격을 현재 브랜치로 가져갑니다. 그래서 로컬 커밋이 있으면 먼저 푸시해야 합니다. 문서가 권하는 우회로는 계획 모드로 로컬에서 방향을 잡고, 계획을 파일로 저장해 커밋·푸시한 뒤 클라우드에 실행만 시키는 방식입니다.

Q. 회사가 IP 허용목록을 쓰는데 괜찮을까요?

전부 실패합니다. 클라우드 세션은 우리 회사 망이 아니라 앤트로픽 인프라에서 API를 호출하기 때문에, IP 허용목록이 켜져 있으면 앤트로픽 호스팅 세션은 전부 인증 오류로 떨어집니다. 코드 리뷰와 정기 작업도 마찬가지고요. 처방은 둘인데 — 앤트로픽 호스팅 서비스를 허용목록에서 예외 처리하거나, 자체 호스팅 환경으로 돌려 우리 망에서 API를 호출하게 하는 것입니다.

Q. 세션이 만료되면 대화도 날아가나요?

아닙니다. 일정 시간 놀면 세션이 멈추고 VM은 회수되지만, 목록에서 다시 열면 새 VM을 띄우면서 대화 기록은 복원됩니다. 반대로 보관 처리한 세션은 새 메시지를 못 받고, 삭제는 되돌릴 수 없습니다. 폰에서 이어 쓰는 쪽 이야기는 원격 제어와 대화 저장을 다룬 글에 따로 정리해뒀습니다.

✨ 정리하면

브라우저에 던져두고 노트북을 닫는다는 그림은 사실이고, 컴퓨트 요금이 따로 안 붙는 것도 사실입니다. 대신 켜기 전에 세 가지를 확인하는 게 좋습니다 — 깃허브 앱 설치는 저장소를 좁혀주지 않고, 개인 상위 플랜의 공유는 전체 공개에 검증이 꺼져 있으며, PR 자동 수정은 내 계정으로 댓글을 답니다. 셋 다 문서가 스스로 적어둔 경고이고, 셋 다 오류 없이 조용히 지나가는 종류입니다.

※ 출처: Claude Code 공식 문서 code.claude.com/docs/en/claude-code-on-the-web 및 code.claude.com/docs/en/mobile (2026-08-18 확인). 문서가 리서치 프리뷰라고 밝힌 단계이므로 대상 플랜과 기능 범위는 바뀔 수 있고, 본문에서 특정 버전 이상이라고 적은 항목은 문서가 그렇게 밝혀둔 것입니다.