클라우드 세션 관리

클라우드 세션은 claude.ai/code에서 실행되는 원격 Claude Code 작업입니다. 터미널에서 새 클라우드 세션을 만들거나, 완료된 웹 세션을 로컬 터미널로 가져오거나, 세션을 공유하고 PR 자동 수정을 켤 수 있습니다.

웹과 터미널 간에 작업 이동

이 워크플로우는 같은 claude.ai 계정으로 로그인된 Claude Code CLI가 필요합니다.

CLI에서 세션 이동은 다음 두 방향입니다.

• --remote: 현재 저장소를 기준으로 새 클라우드 세션을 시작합니다.
• --teleport: 기존 클라우드 세션을 로컬 터미널로 가져옵니다.

기존 로컬 CLI 세션을 웹으로 그대로 밀어 올리는 기능은 CLI에는 없습니다. 데스크톱 앱은 세션 유형에 따라 Continue in 메뉴를 제공합니다.

터미널에서 웹으로

--remote 플래그로 새 클라우드 세션을 시작합니다.

claude --remote "Fix the authentication bug in src/auth/login.ts"

세션은 현재 디렉터리의 GitHub 원격과 현재 브랜치를 기준으로 시작합니다. 클라우드 VM은 사용자의 작업 디렉터리가 아니라 GitHub에서 복제하므로, Claude가 봐야 하는 로컬 커밋은 먼저 푸시합니다.

--remote는 새 클라우드 세션을 만드는 기능입니다. 로컬 CLI 세션을 웹에서 모니터링하는 --remote-control과 다릅니다. 그 경우는 Remote Control을 사용합니다.

Claude Code CLI에서 /tasks를 실행하면 진행 중인 클라우드 세션을 확인하고 열 수 있습니다.

클라우드 작업 팁

복잡한 작업은 로컬에서 Plan Mode로 접근 방식을 정리한 뒤 계획을 커밋하고 --remote로 실행하면 좋습니다.

claude --permission-mode plan
claude --remote "Execute the migration plan in docs/migration-plan.md"

여러 독립 작업은 각각 별도의 클라우드 세션으로 병렬 실행할 수 있습니다.

claude --remote "Fix the flaky test in auth.spec.ts"
claude --remote "Update the API documentation"
claude --remote "Refactor the logger to use structured output"

웹 세션에서 계획을 작성하고 브라우저에서 검토하려면 Ultraplan을 사용합니다.

GitHub 없이 로컬 저장소 보내기

GitHub 접근을 사용할 수 없는 저장소에서 claude --remote를 실행하면 Claude Code는 로컬 저장소를 번들로 만들어 클라우드 세션에 업로드할 수 있습니다.

번들에는 모든 브랜치의 저장소 기록과 추적된 파일의 커밋되지 않은 변경 사항이 포함됩니다. 추적되지 않은 파일은 포함되지 않으므로 필요하면 먼저 git add로 추적 상태로 만듭니다.

강제로 번들 방식을 사용하려면 다음처럼 실행합니다.

CCR_FORCE_BUNDLE=1 claude --remote "Run the test suite and fix any failures"

번들 방식의 주요 제한은 다음과 같습니다.

• 디렉터리는 최소 하나의 커밋이 있는 git 저장소여야 합니다.
• 번들 크기가 너무 크면 현재 브랜치 번들, 작업 트리 스쿼시 스냅샷 순서로 폴백하고 그래도 크면 실패합니다.
• 추적되지 않은 파일은 포함되지 않습니다.
• GitHub 인증도 구성되어 있지 않으면 결과를 원격으로 다시 푸시할 수 없습니다.

웹에서 터미널로

클라우드 세션을 터미널로 가져오려면 다음 중 하나를 사용합니다.

• claude --teleport: 대화형 세션 선택기를 엽니다.
• claude --teleport <session-id>: 특정 세션을 바로 재개합니다.
• /teleport 또는 /tp: 기존 CLI 세션 안에서 세션 선택기를 엽니다.
• /tasks: 백그라운드 세션 목록에서 t를 눌러 텔레포트합니다.
• 웹 인터페이스의 Open in CLI: 터미널에 붙여넣을 명령을 복사합니다.

텔레포트는 클라우드 세션의 브랜치를 가져와 체크아웃하고, 대화 기록을 터미널에 로드합니다. --resume은 로컬 기록만 다시 여는 명령이므로 클라우드 세션 목록을 보여주지 않습니다.

텔레포트 요구 사항

텔레포트 전에 다음 조건을 만족해야 합니다.

API 키, Bedrock, Vertex AI, Microsoft Foundry 인증으로는 텔레포트를 사용할 수 없습니다. /login으로 claude.ai 계정에 로그인합니다.

세션 작업

세션은 claude.ai/code의 사이드바에 나타납니다. 여기서 diff를 검토하고, 팀원과 공유하고, 완료된 작업을 보관하거나 삭제할 수 있습니다.

컨텍스트 관리

클라우드 세션은 텍스트 출력을 생성하는 기본 명령을 지원합니다. /model, /config처럼 대화형 터미널 선택기를 여는 명령은 사용할 수 없습니다.

자동 압축은 컨텍스트 윈도우가 용량에 가까워지면 CLI와 동일하게 실행됩니다. 필요하면 환경 변수에서 CLAUDE_AUTOCOMPACT_PCT_OVERRIDE나 CLAUDE_CODE_AUTO_COMPACT_WINDOW를 조정합니다.

저장소의 .claude/agents/에 정의된 Subagents는 클라우드 세션에서도 선택됩니다. Agent teams는 기본적으로 꺼져 있으며 환경 변수 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1로 활성화할 수 있습니다.

변경 사항 검토

각 세션은 추가 및 제거된 줄 수를 표시합니다. diff 보기를 열어 변경 사항을 확인하고, 특정 줄에 인라인 댓글을 남긴 뒤 다음 메시지로 Claude에게 보냅니다.

변경 사항이 맞으면 웹 인터페이스에서 PR을 생성합니다. PR 생성 후에도 같은 세션에서 CI 실패나 리뷰어 댓글을 붙여넣고 추가 수정을 요청할 수 있습니다.

세션 공유

세션 공유 범위는 계정 유형에 따라 다릅니다.

Team 공유는 claude.ai 조직의 다른 구성원이 세션을 볼 수 있게 합니다. Public 공유는 claude.ai에 로그인한 모든 사용자가 볼 수 있게 하므로, 공유 전에 코드와 자격 증명 등 민감한 내용이 포함되어 있지 않은지 확인합니다.

세션 보관

사이드바의 세션 위에 마우스를 올리고 보관 아이콘을 선택하면 세션 목록에서 숨길 수 있습니다. 보관된 세션은 필터를 통해 다시 볼 수 있습니다.

세션 삭제

세션 삭제는 세션과 해당 데이터를 영구적으로 제거하며 실행 취소할 수 없습니다. 보관된 세션 목록이나 세션 제목 옆 메뉴에서 Delete 를 선택합니다.

Pull request 자동 수정

Claude는 PR을 감시하다가 CI 실패나 리뷰 댓글이 생기면 조사하고, 명확한 수정이 있으면 브랜치에 푸시할 수 있습니다.

자동 수정을 사용하려면 Claude GitHub App이 해당 저장소에 설치되어 있어야 합니다. 아직 설치하지 않았다면 GitHub App 페이지에서 설치하거나 웹 설정 중 표시되는 안내를 따릅니다.

자동 수정은 다음 방식으로 켤 수 있습니다.

• 웹에서 Claude Code로 생성한 PR의 CI 상태 표시줄에서 Auto-fix 선택
• 터미널에서 PR 브랜치에 있는 동안 /autofix-pr 실행
• 모바일 앱에서 "watch this PR and fix any CI failures or review comments"처럼 지시
• 기존 PR URL을 세션에 붙여넣고 자동 수정을 요청

자동 수정은 PR별 토글입니다. 중지하려면 웹 세션의 CI 상태 표시줄에서 토글을 끄거나 Claude에게 PR 감시를 중지하라고 지시합니다.

Claude가 PR 활동에 응답하는 방식

자동 수정이 켜져 있으면 Claude는 새 리뷰 댓글과 CI 검사 실패 같은 PR 이벤트를 받습니다.

• 명확한 수정: 수정에 확신하고 기존 지침과 충돌하지 않으면 변경하고 푸시합니다.
• 모호한 요청: 해석이 여러 가지이거나 설계 판단이 필요하면 확인을 요청합니다.
• 중복 또는 조치 불필요 이벤트: 변경하지 않고 세션에 기록합니다.

Claude는 GitHub 리뷰 스레드에 회신할 수 있습니다. 회신은 사용자의 GitHub 계정 아래에 게시되지만 Claude Code에서 작성된 것으로 표시됩니다.

PR 댓글이 Atlantis, Terraform Cloud, issue_comment 기반 GitHub Actions처럼 권한 있는 자동화를 트리거할 수 있는 저장소에서는 자동 수정을 켜기 전에 자동화 구성을 검토합니다.

보안 및 격리

각 클라우드 세션은 격리된 Anthropic 관리 VM에서 실행됩니다. GitHub 인증은 범위가 제한된 자격 증명과 프록시를 통해 처리되며, 네트워크 접근은 환경 정책으로 제한됩니다.

네트워크 접근을 비활성화해도 Claude Code는 Anthropic API와 통신할 수 있습니다. 즉, 모델 요청에 포함된 데이터 흐름까지 차단되는 것은 아닙니다. 데이터 보관과 삭제는 데이터 사용을 함께 확인합니다.

문제 해결

세션 생성 실패

새 세션이 Session creation failed로 시작되지 않거나 프로비저닝에서 멈추면 저장소 접근, 클라우드 세션 인시던트, 일시적 용량 문제를 확인합니다. status.claude.com에서 상태를 확인한 뒤 잠시 후 다시 시도합니다.

Remote Control 세션 만료 또는 액세스 거부

--teleport는 클라우드 세션의 원격 세션 인프라를 사용하므로 Remote Control session expired 또는 Access denied가 표시될 수 있습니다. /login으로 자격 증명을 새로 고치고, 세션을 만든 같은 계정인지 확인합니다.

환경 만료

클라우드 세션은 비활성 기간 후 중지되고 기본 환경이 회수될 수 있습니다. 웹에서 세션을 다시 열면 대화 기록이 복원된 새 환경을 프로비저닝합니다.

제한 사항

클라우드 세션을 워크플로우에 넣기 전에 다음 제약을 고려합니다.

• Claude Code on the web 사용량은 계정 내 Claude 및 Claude Code 사용량 제한을 공유합니다.
• 웹 세션을 로컬로 가져오려면 같은 claude.ai 계정으로 인증되어 있어야 합니다.
• 저장소 복제와 PR 생성은 GitHub가 기본입니다. GitLab, Bitbucket 등은 로컬 번들로 보낼 수 있지만 결과를 원격으로 푸시하지 못할 수 있습니다.
• 조직 IP 허용 목록이 활성화된 경우 클라우드 세션, Code Review, Routines가 인증 오류로 실패할 수 있습니다. Anthropic 호스팅 서비스를 허용 목록 정책에서 제외해야 할 수 있습니다.