클라우드에서 Claude Code 사용하기

• 브라우저: claude.ai/code, 웹에서 Claude Code라고도 불림
• 모바일: Claude 앱의 Code 탭
• 데스크톱 앱: 세션을 시작할 때 환경 선택기의 Cloud 아래에서 환경을 선택
• 터미널: claude --cloud
• 클라우드 예약 작업: 예약 및 트리거된 실행은 각각 클라우드 세션으로 실행됨

​

클라우드 환경

• 첫 번째 환경: 아직 환경이 없으면 온보딩이 제한된 네트워크 액세스를 사용하여 기본 환경을 설정합니다. 플랜에서 이것이 어떻게 작동하는지는 기본 환경을 참조하세요
• 세션이 사용하는 환경: 둘 이상의 환경이 있을 때 세션이 환경을 선택하는 방법은 기본 환경을 참조하세요
• 세션이 접근하거나 시작 시 실행할 수 있는 항목 변경: 클라우드 환경 구성을 참조하세요
• 구성 없이 설치되어 있는 항목: 설치된 도구를 참조하세요

​

GitHub 인증 옵션

• 자동 수정: 저장소에 Claude GitHub App을 설치하면 해당 저장소의 풀 리퀘스트에 대해 자동 수정도 활성화됩니다
• 프로젝트: 프로젝트의 스레드는 연결 방법에 관계없이 복제하는 각 저장소에 Claude GitHub App이 설치되어 있어야 합니다. GitHub 액세스 설정을 참조하세요

​

Team 및 Enterprise용 빠른 설정

• /web-setup: 구성원이 /web-setup으로 GitHub를 연결할 수 있습니다. 설정이 꺼져 있는 동안에는 이 명령이 숨겨집니다
• GitHub App 프롬프트: 브라우저 온보딩에서 Claude GitHub App 설치 프롬프트를 건너뜁니다
• 첫 번째 환경: 브라우저 온보딩이 환경 양식을 표시하는 대신 구성원을 위해 기본 환경을 생성합니다

​

터미널과 클라우드 간 작업 이동

​

터미널에서 클라우드 세션 시작하기

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

​

클라우드 작업 팁

claude --permission-mode plan

claude --cloud "Execute the migration plan in docs/migration-plan.md"

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

​

GitHub 없이 로컬 저장소 보내기

• macOS, Linux 및 WSL: Claude Code는 자격 증명 또는 키와 같은 이름의 파일에 대한 커밋되지 않은 변경 사항을 업로드에서 제외합니다. 여기에는 .env 파일, Terraform *.tfvars 파일, id_rsa 및 *.pem과 같은 키 파일이 포함됩니다. 또한 Git LFS와 같은 git 필터가 관리하는 파일에 대한 커밋되지 않은 변경 사항도 제외합니다. Left on this machine: 알림에 제외된 파일의 이름이 표시되며, 세션은 각 파일의 커밋된 버전으로 시작하거나, 커밋된 버전이 없으면 해당 파일 없이 시작합니다.
• 네이티브 Windows: 추적된 파일에 대한 커밋되지 않은 변경 사항은 파일 이름과 관계없이 그대로 업로드됩니다. 클라우드 세션에 포함하고 싶지 않은 편집 내용은 세션을 시작하기 전에 stash하거나 되돌리십시오.

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

• 디렉토리는 최소 하나의 커밋이 있는 git 저장소여야 합니다
• 번들된 저장소는 100 MB 미만이어야 합니다. 더 큰 저장소는 현재 브랜치만 번들로 묶기로 폴백한 다음, 작업 트리의 단일 스쿼시된 스냅샷으로 폴백하고, 스냅샷이 여전히 너무 크면 실패합니다
• 추적되지 않은 파일은 포함되지 않습니다. 클라우드 세션이 볼 파일에 대해 git add를 실행합니다
• macOS, Linux 및 WSL에서 Claude Code는 포함된 구성 파일에 설정된 core.attributesFile과 같이 파일에 적용되는 속성 규칙에 영향을 미치는 git 설정을 따를 수 없을 때 업로드를 거부합니다. 거부 메시지는 설정과 수정 방법을 이름으로 지정합니다
• 번들에서 생성된 세션은 GitHub 연결이 해당 저장소에 대한 푸시 액세스 권한을 가질 때만 GitHub 원격으로 다시 푸시할 수 있습니다

• 이전 버전의 git: 설치된 git이 2.31보다 오래되었습니다. git을 업데이트한 다음 재시도하십시오.
• 업로드가 지원하지 않는 체크아웃 레이아웃: 서브모듈 내부, git clone --separate-git-dir, --shared 또는 --reference로 만든 클론, core.worktree가 설정된 체크아웃, 또는 ref를 reftable 형식으로 보관하는 저장소에서 시작했습니다. 대신 일반 git clone으로 만든 클론의 메인 체크아웃에서 시작하십시오.
• 스파스 체크아웃이 있는 연결된 worktree: git sparse-checkout은 worktree 자체의 config.worktree 파일에 설정을 기록하는데, 업로드는 이 파일을 허용하지 않습니다. 따라서 이러한 설정이 있는 worktree는 업로드되지 않으며, Claude Code가 worktree.sparsePaths로 생성한 worktree도 마찬가지입니다. 대신 저장소의 메인 체크아웃에서 시작하십시오.
• 작업 트리 내부에 보관된 git 구성: git 구성이 체크아웃 내부에 있는 파일을 포함합니다(예: 저장소 내부를 가리키는 include.path 항목). 해당 파일을 작업 트리 밖으로 옮기거나 include를 제거한 다음 재시도하십시오.

​

CLI에서 후속 메시지 보내기

claude -p "your message" --cloud <session-id>

​

출력

Sent to cloud session.
Session ID: session_01DiUkqY2kzbUbDmW1w96rfi
View: https://claude.ai/code/session_01DiUkqY2kzbUbDmW1w96rfi?from=cli&m=0

​

터미널에서 클라우드 세션 계속하기

• --teleport 사용: 명령줄에서 claude --teleport를 실행하여 대화형 세션 선택기를 열거나, claude --teleport <session-id>를 실행하여 특정 세션을 직접 재개합니다. 커밋되지 않은 변경 사항이 있으면 먼저 stash하라는 메시지가 표시됩니다. --resume은 이 머신의 로컬 기록에서 대화를 다시 열며 클라우드 세션을 나열하지 않습니다.
• /teleport 사용: 기존 CLI 세션 내에서 /teleport 또는 /tp를 실행하여 Claude Code를 다시 시작하지 않고 동일한 세션 선택기를 엽니다.
• /tasks에서: /tasks를 실행하여 백그라운드 세션을 보고, t를 눌러 하나로 teleport합니다.
• claude.ai/code에서: 세션 메뉴에서 Open in > Terminal을 선택하여 터미널에 붙여넣을 수 있는 명령을 복사합니다.
• 클라우드 세션 내에서: /teleport를 입력하면 Claude Code가 해당 세션에 대한 정확한 claude --teleport <session-id> 명령으로 응답하며, 저장소의 체크아웃에서 실행할 준비가 됩니다.

​

Teleport 요구 사항

​

--teleport를 사용할 수 없음

• API 키 또는 Console 계정으로 로그인한 경우: 셸에서 claude auth login을 실행한 다음 claude.ai로 로그인합니다
• 오류가 제공자의 이름을 표시하는 경우: 클라우드 세션은 타사 제공자를 통해 사용할 수 없습니다. 오류 테이블을 참조하십시오
• 이미 claude.ai를 통해 로그인한 경우: 조직이 클라우드 세션을 비활성화했을 수 있습니다

​

세션 작업

​

클라우드 세션의 권한 모드

• Anthropic 호스팅 환경이 만료된 세션을 다시 열기
• 자체 호스팅 runner가 유휴 상태일 때 해제한 세션에 메시지 보내기

​

변경 사항 검토

• 세션 제목 표시줄 또는 표시줄의 ⋮ 메뉴에서 Changes를 클릭할 수도 있습니다.
• 패널이 숨겨져 있을 때 표시하려면 세션 제목 표시줄 또는 표시줄의 ⋮ 메뉴에서 Show session rail 아이콘을 클릭하세요.

• Comment: 특정 줄에 인라인 주석을 남긴 다음, 다음 메시지와 함께 주석을 Claude에 보냅니다
• Compare: diff 보기는 기본적으로 세션의 변경 사항을 해당 기본 브랜치와 비교합니다. 저장소의 다른 브랜치와 비교하려면 Compare against를 선택하고 브랜치를 하나 고르세요

• PR 생성을 포함한 전체 안내: 검토 및 반복을 참조하세요
• Claude가 PR을 모니터링하여 CI 실패 및 검토 주석에 자동으로 대응하도록 하기: 풀 리퀘스트 자동 수정을 참조하세요

​

diff 보기에서 누락된 파일 문제 해결

• 아직 푸시된 변경 사항이 없는 경우: 목록에는 Claude가 직접 수행한 편집은 포함되지만, 포매터와 같이 Claude가 실행한 명령으로 인한 변경 사항은 포함되지 않습니다
• 변경 사항이 푸시된 경우: 목록에는 푸시된 커밋은 포함되지만, 마지막 푸시 이후에 이루어진 변경 사항은 포함되지 않습니다

​

컨텍스트 관리

• /model, /effort, /color, 및 /rename: 터미널 선택기 또는 슬라이더를 열지 않고 대신 인수로 값을 전달합니다(예: /model sonnet). 인수 형식은 각 명령의 가용성 참고 사항을 따릅니다.
• /fast: 빠른 모드가 계정에서 사용 가능할 때 세션에 대해 빠른 모드를 전환합니다. 세션의 환경에서 Claude Code v2.1.271 이상이 필요합니다.
• /config: 브라우저의 claude.ai/code에서는 값을 설정하는 대신 Settings > Code 또는 Settings > Claude Code를 엽니다. 클라우드 세션의 설정을 변경하려면 환경에 환경 변수를 설정하세요. 프로젝트의 스레드 외부에서 하나의 저장소가 있는 세션에서는 대신 해당 저장소의 .claude/settings.json에 키를 커밋하세요. 클라우드 세션의 설정에서 각 세션이 읽는 내용을 나열합니다.

​

대화 중 플러그인 제안

​

제안된 플러그인 추가 또는 제거

​

플러그인 제안 끄기

{
  "permissions": {
    "deny": ["SearchPlugins", "SuggestPluginInstall"]
  }
}

​

대기 중인 메시지 되돌리기

​

세션 공유

​

Enterprise 또는 Team 계정에서 공유

• 가시성 옵션: Private 및 Team. Team 가시성은 claude.ai 조직의 다른 구성원에게 세션을 표시합니다
• 저장소 액세스: 수신자의 계정에 연결된 GitHub 계정을 기반으로 확인이 기본적으로 활성화됩니다
• 사용자 이름: 계정의 표시 이름은 액세스 권한이 있는 모든 수신자에게 표시됩니다
• Slack 세션: Claude in Slack 세션은 자동으로 Team 가시성으로 공유됩니다

​

Max, Ultra 또는 Pro 계정에서 공유

• 가시성 옵션: Private 및 Public. Public 가시성은 claude.ai에 로그인한 모든 사용자에게 세션을 표시합니다
• 저장소 액세스: 확인은 기본적으로 활성화되지 않습니다
• 민감한 내용: 공유하기 전에 세션을 확인하세요. 세션에는 개인 GitHub 저장소의 코드 및 자격 증명이 포함될 수 있습니다

• Settings 메뉴에 Claude Code 대신 Code가 표시되는 경우: 이러한 설정이 있는 Privacy로 이동하세요
• 그 외의 경우: Claude Code > Sharing settings로 이동하세요

​

세션 보관

​

보관된 세션 찾기

​

세션 삭제

• 사이드바에서: 세션 위에 마우스를 올리고 ⋯ 메뉴를 열어 Delete를 선택합니다
• 세션 메뉴에서: 세션을 열고 세션 제목 옆의 드롭다운을 선택한 다음 Delete를 선택합니다
• Archived 탭에서: Archived 탭에서 세션 위에 마우스를 올리고 ⋮ 메뉴를 열어 Delete를 선택합니다

​

Pull request 자동 수정

• 클라우드 세션에서 생성된 PR: claude.ai/code에서 세션을 열고 Changes 카드에서 풀 리퀘스트를 찾습니다. 풀 리퀘스트 제목 옆의 ⋮ 메뉴를 열고 Auto-fix를 켭니다
• 터미널에서: PR의 분기에 있는 동안 /autofix-pr을 실행합니다. Claude Code가 gh로 열린 PR을 감지하고, 클라우드 세션을 생성하고, 한 단계에서 자동 수정을 켭니다
• 모바일 앱에서: Claude에 PR을 자동 수정하도록 지시합니다. 예를 들어 “watch this PR and fix any CI failures or review comments”
• 기존 PR: PR URL을 세션에 붙여넣고 Claude에 자동 수정하도록 지시합니다

​

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

• 명확한 수정: Claude가 수정에 확신하고 이전 지침과 충돌하지 않으면 Claude가 변경을 수행하고, 푸시하고, 세션에서 수행한 작업을 설명합니다
• 모호한 요청: 검토자의 주석을 여러 방식으로 해석할 수 있거나 아키텍처적으로 중요한 사항이 포함되면 Claude가 행동하기 전에 확인합니다
• 중복 또는 조치 불필요 이벤트: 이벤트가 중복이거나 변경이 필요 없으면 Claude가 세션에서 이를 기록하고 계속합니다

​

보안 및 격리

• 격리된 가상 머신: 각 세션은 격리된 Anthropic 관리 VM에서 실행됩니다. 조직이 자체 호스팅 환경으로 라우팅하는 세션은 자신의 인프라에서 실행되며, 격리는 배포의 책임입니다
• 네트워크 액세스 제어: Anthropic 호스팅 환경에서 네트워크 액세스는 기본적으로 제한되며 비활성화할 수 있습니다. 액세스 수준, 기본 허용 도메인, 그리고 허용 목록을 통과하지 않는 트래픽에 대해서는 네트워크 액세스를 참조하세요. 자체 호스팅 환경에서는 자신의 네트워크 경계에서 세션 송신을 제한합니다. 네트워크 액세스가 비활성화된 상태에서 실행할 때 Claude Code는 여전히 Anthropic API와 통신할 수 있으며, 이는 VM에서 데이터가 나갈 수 있습니다.
• 자격 증명 보호: Anthropic 호스팅 환경에서 git 자격 증명 및 서명 키는 샌드박스 외부에 유지되며, 프록시는 범위 자격 증명으로 세션을 대신하여 인증합니다. 자체 호스팅 환경에서 배포는 git 자격 증명을 제공합니다. git 구성을 참조하세요
• 네트워크 시크릿: Anthropic 호스팅 환경에서 클라우드 환경에 추가한 키는 샌드박스 외부에 동일한 방식으로 유지되며, 세션을 떠난 후 일치하는 요청에 첨부됩니다. 자체 호스팅 환경에는 네트워크 시크릿이 없습니다
• 안전한 분석: 코드는 PR을 생성하기 전에 세션의 격리된 환경 내에서 분석 및 수정됩니다

​

문제 해결

​

Session creation failed

• status.claude.com에서 클라우드 세션 관련 장애를 확인합니다
• 용량은 필요할 때 프로비저닝되므로 1분 후에 재시도합니다
• GitHub 연결 후 저장소가 표시되지 않음의 안내에 따라 GitHub 연결이 저장소에 접근할 수 있는지 확인합니다

​

Your new session couldn’t start

• 연결 끊김: 인터넷 연결과 사용 중인 VPN 또는 프록시를 확인한 다음 프롬프트를 다시 보냅니다
• 서버 오류: 잠시 기다린 다음 프롬프트를 다시 보냅니다. 알림이 다시 나타나면 status.claude.com을 확인합니다

​

Can’t rewind to this message

​

Unable to get organization UUID

• Unable to get organization UUID
• Cloud sessions need a claude.ai sign-in. Run `claude auth login` (or /login in a local session), then try again.
• Cloud sessions aren't available with this Console sign-in. They need a claude.ai sign-in. Run `claude auth login` (or /login in a local session), then try again.
• 세션 ID 없이 claude --teleport를 실행할 때 세션 선택기에 표시되는 Error loading Claude Code sessions

​

브랜치가 GitHub에 없음

​

Remote Control 세션 만료 또는 접근 거부

• 로컬에서 /login을 실행하여 자격 증명을 갱신한 다음 다시 연결합니다
• 세션을 소유한 계정과 동일한 계정으로 로그인했는지 확인합니다
• Remote Control may not be available for this organization이 표시되면 Owner가 조직에서 클라우드 세션을 활성화하지 않은 것입니다

​

클라우드 세션으로 보낼 때 발생하는 오류

​

환경 만료

• 복원됨: 대화 기록
• 복원되지 않음: VM이 회수될 때 아직 실행 중이거나 대기 중이던 백그라운드 작업으로, 다음이 포함됩니다.
  • 셸 명령: Claude Code가 어떤 명령이 중지되었는지 Claude에게 알려 줍니다. 여전히 필요한 명령을 다시 실행하도록 Claude에게 요청합니다.
  • 서브에이전트: Claude Code가 어떤 서브에이전트가 중지되었는지, 그리고 그중 어떤 서브에이전트를 처음부터 다시 시작하는 대신 재개할 수 있는지 Claude에게 알려 줍니다. 작업을 계속하도록 Claude에게 요청합니다.
  • 세션 범위 예약 작업: 세션에서 예약한 작업과 다음 반복을 기다리던 /loop는 다시 연 세션으로 이어지지 않습니다. 작업을 다시 예약하도록 Claude에게 요청하거나, /loop를 다시 실행하여 루프를 다시 시작합니다.

​

제한 사항

• 속도 제한: 클라우드 세션은 계정 내의 다른 모든 Claude 및 Claude Code 사용과 속도 제한을 공유합니다. 여러 작업을 병렬로 실행하면 비례적으로 더 많은 속도 제한을 소비합니다.
• 시간 제한: Claude가 실행하는 명령 및 SessionStart 훅에는 변경할 수 있는 기본 시간 초과가 있으며, 설정 스크립트는 대략 5분 내에 완료될 때만 캐시됩니다. 시간 제한을 참조하십시오.
• 저장소 인증: 동일한 계정으로 인증된 경우에만 클라우드 세션을 터미널로 가져올 수 있습니다.
• 플랫폼 제한: Anthropic 호스팅 환경에서의 저장소 복제 및 풀 리퀘스트 생성에는 GitHub이 필요합니다. 자체 호스팅 GitHub Enterprise Server 인스턴스는 Team 및 Enterprise 플랜에서 지원됩니다. CCR_FORCE_BUNDLE=1을 설정하여 GitLab, Bitbucket 또는 기타 비-GitHub 저장소를 로컬 번들로 클라우드 세션에 전송할 수 있지만, 세션은 결과를 원격으로 다시 푸시할 수 없습니다.
  • 자체 호스팅 환경: 다른 git 호스트에 있는 저장소의 경우 --environment로 세션을 시작하기 위한 요구 사항을 참조하십시오.

​

관련 리소스

• 클라우드 환경: 클라우드 세션의 네트워크 액세스, 환경 변수 및 설정 스크립트 구성
• Projects: Claude가 리포지토리에서 병렬 클라우드 세션을 조정하고 결과를 보고하는 하나의 대화
• Ultrareview: 클라우드 샌드박스에서 심층 다중 에이전트 코드 검토 실행
• 클라우드 예약 작업: 일정에 따라, API 호출을 통해 또는 GitHub 이벤트에 응답하여 작업 자동화
• Hooks 구성: 세션 수명 주기 이벤트에서 스크립트 실행
• 모든 설정: 모든 구성 옵션
• 보안: 격리 보장 및 데이터 처리
• 데이터 사용: Anthropic이 클라우드 세션에서 보유하는 것
• Claude Tag: 동일한 클라우드 인프라에서 실행되는 조직 관리형 Slack의 @Claude