아마 여러분은 자신의 노트북 터미널에서 Claude Code를 실행하고 있을 것입니다. 그 세션은 세 가지 방식으로 노트북에 의존합니다:
- 작업 트리를 공유하므로, 하나의 저장소에 대한 두 세션이 동일한 파일을 편집하고 동일한 포트를 두고 충돌할 수 있습니다.
- 이 기능은 사용자의 자격 증명으로 실행됩니다.
- 컴퓨터가 절전 모드에 들어가거나 Wi-Fi가 끊기면 중단됩니다.
클라우드 세션 자체 머신에서 Claude Code를 실행합니다. 각 작업은 새 가상 머신에서 시작되며, 저장소가 새 브랜치로 클론되고 환경 설정까지 이미 완료되어 있습니다.
다음에서 하나를 시작할 수 있습니다. claude.ai/code, 이 Claude 모바일 앱, 그 데스크톱 앱, 당신의 터미널, 그리고 Slack. 그다음에는 브라우저, 모바일 앱, Desktop에서 이를 팔로우할 수 있습니다. 작업이 완료되면 브랜치에 저장되며, 해당 브랜치를 풀 리퀘스트로 전환할 수 있습니다.
Pro, Max, Team 또는 Enterprise 플랜에는 추가 비용 없이 클라우드 세션이 포함됩니다. 클라우드 머신에 대한 별도 요금은 없으며, 세션은 Claude Code의 나머지 기능과 동일한 사용량 한도를 공유합니다. 플랜에 따라 조직 소유자가 필요할 수 있습니다. 클라우드 세션 켜기 첫 번째.
클라우드 세션에 대한 보너스 크레딧. 기존 Pro 및 Max 개인 구독자는 플랜 한도에 더해 클라우드 세션용 일회성 보너스 크레딧을 받을 수 있습니다: Pro는 $100, Max는 $250입니다. 10월 7일까지 claude.ai/code/claim-credit에서 또는 다음을 통해 청구하세요. /claim-credit Claude Code에서 사용 가능합니다. 크레딧은 11월 4일에 만료됩니다. 사용하거나 만료된 후에는 플랜의 일반 사용량이 적용됩니다. 프로젝트나 루틴에는 적용되지 않습니다. 자세한 내용은 다음을 참조하세요. 판매용 크레딧 제공 약관.
이 가이드를 위해 작은 샘플 저장소를 대상으로 네 번의 실제 클라우드 세션을 실행했습니다. 해당 세션의 트랜스크립트, diff, 그리고 소요 시간이 본문 곳곳에 등장합니다. 스크린샷 속 저장소와 사용자는 가상의 것입니다. 작업 내용, 결과물, 그리고 수치는 그 세션들에서 나온 것입니다.
클라우드 세션의 주요 장점 중 하나는 여러 작업을 서로 간섭하지 않고 동시에 실행할 수 있다는 점입니다. 다음은 16초 간격으로 시작한 세 가지 작업으로, 각각 별도의 머신에서 실행했습니다. 제 노트북에서는 이 작업들을 하나씩 차례로 실행하거나, 서로 간섭하지 않도록 시간을 들여 관리해야 했을 것입니다.
세 가지 작업, 하나의 저장소, 세 대의 머신
샘플 저장소는 tidepool이며, 세 개의 가상 항구의 조석을 예측하는 작은 Node API입니다. 이 저장소에는 세 가지 평범한 문제가 있었습니다: 네 번 중 한 번꼴로 실패하는 테스트 하나, 코드가 더 이상 읽지 않는 매개변수를 설명하는 API 문서, 그리고 문자열을 연결하는 방식으로 로그 줄을 만드는 로거.
저는 16초 이내의 간격으로 세 개의 클라우드 세션을 시작했으며, 문제당 하나씩이었습니다. 프로그래밍 방식으로 시작했고, tidepool이 GitHub에 없기 때문에 각 세션은 먼저 프롬프트에 담긴 파일들로부터 저장소를 재구성했습니다. 실제 저장소가 있다면 이 단계는 건너뛰면 되고, 터미널에서는 각 세션이 claude --cloud 명령 하나입니다. 요약하면 세 개의 프롬프트는 다음과 같았습니다:
claude --cloud "npm test fails maybe one run in four. Find the flaky test, fix the root cause in the code (not the test), and prove it by running the suite at least 30 times in a row." claude --cloud "docs/API.md is out of date with src/server.js. Rewrite it so every endpoint, parameter, default and response shape matches the code. Start the server and run each curl example to check it." claude --cloud "Make src/logger.js emit one JSON object per line, keep LOG_LEVEL, and log method, path, status and duration_ms as fields. Add a test for the logger."
세션들은 각각 61초, 65초, 72초 동안 실행되었고, 첫 번째 세션이 시작된 후 87초 만에 세 세션 모두 완료되었습니다. 저장소 재구성에는 각 실행 시간의 약 3분의 1에서 절반 조금 넘는 시간이 걸렸습니다. 결과는 다음과 같습니다.
- 간헐적으로 실패하는 테스트. Claude는
TtlCache.get에서 경쟁 상태(race)를 발견했습니다. 캐시는 로더가 완료된 후에만 값을 저장했기 때문에, 로드 중에 같은 키에 대한 두 번째get호출이 로더를 다시 호출했습니다. Claude는 캐시가 진행 중인 promise를 저장하도록 변경하고, 로드가 실패하면 해당 항목을 삭제했으며, 실패 없이npm test를 연속 40번 실행했습니다. - 문서. Claude는 서버를 시작하고 모든 엔드포인트에 대해 curl을 실행했으며, 기존 문서가 잘못된 다섯 가지를 발견했습니다. API가 절대 반환하지 않는 필드들을 나열하고, 코드가 무시하는
days매개변수를 문서화했으며, 단위가 미터인데 피트로 높이를 표기했고,/next-high엔드포인트를 빠뜨렸으며, 오류 응답을 누락했습니다. 또한 형식이 잘못된from=값이 200과 함께 빈 목록을 반환한다는 것을 발견했고, 요청받지 않은 서버 코드는 변경하지 않고 그 사실을 주의 사항으로 문서화했습니다. - 로거. Claude는 JSON 로거를 작성하고, 요청 로그를 구조화된 필드로 옮겼으며, 테스트 다섯 개를 추가했습니다. 커밋에 실패하는 테스트 하나가 포함되어 있어서, Claude는 캐시 테스트를 여덟 번 재실행했고, 그중 다섯 번 실패하는 것을 보고 첫 번째 세션이 수정 중이던 동일한 경쟁 상태 때문임을 추적했습니다. 동일한 수정을 제안했지만, 캐시는 자신의 작업 범위 밖이므로 건드리지 않았고, 요약에서 테스트 스위트가 깨끗하지 않다고 밝혔습니다.
로거 결과는 클라우드 세션이 병렬 작업에 적합한 이유를 보여줍니다. 각 세션은 자체 리포지토리 복사본, 자체 프로세스, 자체 브랜치를 가졌습니다. docs 세션과 logger 세션은 각각 테스트를 위해 API 서버를 시작했으며, 서로에게 영향을 주지 않았습니다. 단일 노트북에서 하나의 체크아웃으로 작업하는 두 에이전트는 동일한 파일을 편집하게 되고, 각자 자신의 포트를 선택하지 않는 한 포트에서 충돌이 발생할 것입니다.
그러한 고립 때문에 로거 세션은 첫 번째 세션이 진행하던 캐시 수정에 접근할 수 없었습니다. 병렬 작업을 파일 경계를 기준으로 분할하고, 합리적인 순서로 브랜치를 병합하며, 한 세션이 이미 수정 중인 문제를 다른 세션이 보고할 것으로 예상하세요.
CLAUDE CODE 클라우드 세션의 내부 구조
클라우드 세션은 Anthropic이 관리하는 인프라에서 실행되거나, 또는 셀프 호스팅 환경. 이 그림은 구성 요소를 보여줍니다. 그 뒤의 네 가지 핵심 요점이 여러분의 일하는 방식을 바꾸는 것들입니다.
- 모든 작업에는 자체 머신이 할당됩니다. 저장소를 새 브랜치로 클론한 깨끗한 VM을 제공하여 세션들이 서로의 파일이나 포트에 영향을 줄 수 없습니다. See 설치된 항목.
- GitHub 토큰은 절대 VM에 들어가지 않습니다. 프록시가 이를 보유하고, 세션은 자신의 작업 브랜치에만 푸시할 수 있는 단기 자격 증명을 받게 됩니다. 다음을 참조하세요. GitHub 프록시.
- 저장소의 Claude 설정은 함께 따라옵니다. 개인 설정은 따라오지 않습니다.
CLAUDE.md, 규칙, 스킬, 에이전트, 그리고 명령어가 저장소와 함께 이동하며, 여러분의~/.claude노트북에 그대로 유지됩니다. 다음을 참조하세요 클라우드 세션의 설정. - 유휴 VM은 회수됩니다. 세션을 다시 열면 대화는 복원된 새로운 VM이 제공되므로, 중요한 작업은 커밋하세요. 다음을 참조하세요. 환경 만료.
사양을 보면, 권한 모드, 그리고 네트워크 수준에 대한 내용은 다음을 참조하십시오: 클라우드 환경 문서.
로컬인가 클라우드인가?
클라우드 세션이 로컬 세션을 대체하는 것은 아니며, 대부분의 사람은 둘 다 사용합니다. 표는 두 방식이 어떻게 다른지 보여주고, 표 뒤의 단락에서는 각각이 어떤 경우에 적합한지 설명합니다.
| 로컬 세션 | 클라우드 세션 | |
|---|---|---|
| 실행 환경 | 내 컴퓨터 | 작업마다 새로운 VM |
| 노트북이 절전 중이거나 오프라인일 때 | 세션이 중단됩니다 | 세션이 계속 진행됩니다 |
| 하나의 저장소에서 여러 작업 실행 | 별도의 worktree와 포트, 그리고 주의가 필요 | 작업마다 하나의 VM과 하나의 브랜치 |
| 에이전트가 접근할 수 있는 범위 | 사용자 계정이 접근할 수 있는 모든 것, SSH 키, 클라우드 CLI 및 ~/.claude | 저장소, 설정한 네트워크 수준, 활성화한 커넥터, 그리고 세션 범위의 GitHub 자격 증명 |
| 시작하거나 이어서 작업할 수 있는 위치 | 해당 컴퓨터, 또는 원격 제어를 통해 휴대폰에서 | 브라우저, 휴대폰, 데스크톱, 터미널, Slack, API 호출 또는 스케줄 |
| 승인 | 명령별 승인을 포함한 모든 모드 | 자동(Auto), 편집 수락(Accept edits) 또는 플랜(Plan) |
| 다음으로 끝남 | 작업 트리의 변경 사항 | 브랜치, 그리고 원한다면 풀 리퀘스트 |
| 컴퓨팅 | 본인의 머신 | 별도의 컴퓨팅 요금 없음; 플랜의 한도를 사용 |
작업에 본인의 머신에만 있는 것이 필요하다면 로컬에 머무세요. 여기에는 실제 로컬 데이터가 있는 데이터베이스, VPN을 통해 접근하는 서비스, GPU, 휴대폰 시뮬레이터 또는 책상 위의 하드웨어가 해당됩니다. 몇 초 안에 각 변경 사항을 자신의 브라우저에서 확인하고 싶은 촘촘한 시각적 반복 작업에도 로컬을 유지하고, 조직이 다음과 같이 운영하는 경우에도 마찬가지입니다: Zero Data Retention, 이 경우 클라우드 세션이 비활성화됩니다.
두 가지 기능이 이 선택지들 사이에 있습니다. 원격 제어 는 세션을 본인의 머신에 유지하면서 휴대폰이나 브라우저에서 제어할 수 있게 해줍니다. 셀프 호스팅 환경(Team 및 Enterprise용 베타)은 클라우드 세션을 조직의 자체 인프라에서 실행하므로 사설 네트워크에 접근할 수 있습니다.
어느 것도 해당하지 않는다면, 그 작업은 클라우드의 좋은 후보입니다. 다음 섹션에서는 클라우드가 가장 큰 효과를 발휘하는 워크플로를 다룹니다.
클라우드 세션에 적합한 일곱 가지 워크플로
이 워크플로들은 표의 차이점을 실제로 활용합니다: 각 작업마다 별도의 머신, 자리를 비운 동안에도 계속 실행되는 세션, 그리고 마지막에 검토할 브랜치.
1. 백로그를 병렬로 처리하기
예를 들어 서로 관련 없는 작은 수정 다섯 가지가 있다고 합시다. 로컬에서는 하나씩 차례로 처리하거나, 다섯 개의 worktree를 만들어 포트와 설치를 분리해 관리해야 합니다. 클라우드에서는 다섯 개의 세션을 시작하고 다섯 개의 브랜치를 검토하면 됩니다.
CODEShellclaude --cloud "Fix the flaky test in auth.spec.ts" claude --cloud "Update the API documentation" claude --cloud "Refactor the logger to use structured output"
claude --cloud 은(는) 현재 브랜치를 기준으로 GitHub 원격 저장소를 클론하므로, 먼저 로컬 커밋을 푸시하세요. VM이 시작되는 동안 CLI는 설정 단계의 실시간 체크리스트를 보여주고 입력하는 내용을 대기열에 넣습니다.
각 작업을 무엇이 잘못되었는지, 완료의 모습이 무엇인지, 그리고 이를 어떻게 입증하는지 명시하는 독립적인 티켓으로 작성하세요. 간헐적으로 실패하는 테스트(flaky test) 프롬프트는 입증 방법을 명시했습니다: 최소 30회 연속으로 스위트를 실행하는 것. 세션은 40회 실행했습니다.
작업들이 하나의 더 큰 노력에 속하는 경우, 프로젝트 (Pro 및 Max용 공개 베타)가 클라우드 세션을 시작하고 추적하는 코디네이터 대화를 실행합니다. 이후 상태별로 그룹화합니다: 진행 중, 사용자 대기 중, 검토 준비 완료.
2. 수정 사항 입증하기
간헐적으로 실패하는 테스트는 반복적인 입증이 필요한 작업의 가장 명확한 사례입니다: 스위트를 몇 번이고 다시 실행해야 하며, 그 반복 작업이 작업 중인 머신을 점유하게 두고 싶지 않을 것입니다. 클라우드에서 Claude는 캐시를 패치하고 명령 하나로 전체 스위트를 40회 실행했습니다.
VM에는 컴퓨팅 비용이 청구되지 않고 CPU도 당신의 것이 아니므로 철저한 증거를 요구하세요. 스위트를 200번 실행하고, 회귀를 50개 커밋에 걸쳐 이분 탐색하고, 느린 통합 티어를 실행하거나, 앱을 시작해서 docs 세션에서 했던 것처럼 curl로 요청을 보내보세요.
Claude의 각 턴은 여전히 플랜 사용량에 포함되지만, 하나의 명령 안에서 긴 테스트를 실행하는 것은 비용이 거의 들지 않습니다. 포그라운드 명령 기본적으로 2분 후에 시간 초과되고(최대 10분) 이후 최대 30분까지 백그라운드에서 계속 실행됩니다. 다음을 사용하여 기본값을 높일 수 있습니다. BASH_DEFAULT_TIMEOUT_MS 그리고 BASH_MAX_TIMEOUT_MS 환경 변수에 있습니다.
3. 책상에서 계획하고, 클라우드에서 빌드하고, 터미널에서 마무리하세요
더 큰 변경의 경우에는 왔다 갔다 하는 비용이 적은 단계에서 먼저 접근 방식에 합의하세요. Claude를 plan 모드로 시작하고, 함께 계획을 세운 뒤, 계획을 커밋하고 푸시하세요.
CODEShellclaude --permission-mode plan # ...agree on the plan, save it to docs/migration-plan.md, commit and push... claude --cloud "Execute the migration plan in docs/migration-plan.md"
클라우드 세션이 빌드되는 동안 터미널은 다른 작업에 자유롭게 사용할 수 있습니다. 세션이 완료되면 해당 세션을 내려받아 손으로 마무리할 수 있습니다.
CODEShellclaude --teleport # pick a cloud session claude --teleport <session-id>
Teleport는 같은 저장소에 있는지 확인하고, 세션의 브랜치를 가져와 체크아웃한 후, 전체 대화를 터미널로 불러옵니다. 깨끗한 작업 트리가 필요하고(스태시를 제안해 줍니다), 브랜치는 푸시되어 있어야 합니다. Claude Code 내부에서는, /teleport "(or" → "(또는" /tp(동일한 선택기를 열며, /tasks 그런 다음 t 역시 작동합니다. 데스크톱 앱은 반대 방향으로 나아가며, 그 에서 열기 메뉴가 로컬 세션을 클라우드로 전송합니다.
4. 휴대폰에서 체크인하기
Claude 앱의 Code 탭은 동일한 세션에 연결됩니다. 휴대폰에서 작업을 시작하고, 진행 상황을 따라가고, 방향을 조정하고, Claude가 한 질문에 답하거나, Claude에게 풀 리퀘스트를 지켜보라고 지시할 수 있습니다.
휴대폰은 키보드에 도착할 때쯤이면 잊어버릴 만한 질문에 어울립니다. 나는 네 번째 세션에 휴대폰에서 입력할 법한 질문을 던졌습니다: tidepool은 어떻게 조석을 예측하며, 시간 창의 경계에서는 어떻게 잘못될 수 있을까? 이 도구는 답을 확인하기 위해 코드를 실행했고 실제 버그를 발견했습니다. 루프가 첫 번째와 마지막 샘플을 검사하지 않아, API가 시간 창의 시작 지점과 정확히 일치하는 만조를 놓치게 됩니다.
5. CI 실패와 리뷰 코멘트를 Claude에게 전달하기
Claude GitHub App가 저장소에 설치되어 있으면, 클라우드 세션이 풀 리퀘스트를 감시하고 해당 풀 리퀘스트에 발생하는 일에 따라 작업을 수행할 수 있습니다. claude.ai/code의 세션에 있는 CI 표시줄에서 켜십시오. 자동 수정. 다음과 같이 실행할 수도 있습니다 /autofix-pr 터미널의 PR 브랜치에서 모바일 앱에게 PR을 감시하도록 요청하거나, 세션에 PR URL을 붙여넣으세요.
Claude는 실패한 검사와 리뷰 코멘트에 대한 명확한 수정 사항을 푸시하고 무엇을 변경했는지 설명합니다. 모호하거나 아키텍처 관련 사항이 있으면 사용자에게 묻습니다. 리뷰 스레드의 답글은 Claude Code로 표시되어 사용자의 GitHub 사용자 이름으로 게시됩니다. Claude는 베이스 브랜치와의 머지 충돌에 대한 알림을 받지 못하므로, 리베이스를 요청해야 합니다. 또한 Claude의 코멘트는 Atlantis 같은 코멘트 기반 자동화를 트리거할 수 있습니다.
6. 직접 시작하지 않고 작업 시작하기
A 일상적인 (연구 미리보기) 루틴은 프롬프트, 저장소, 커넥터, 환경 등 작업을 수행하기 위한 저장된 리소스들의 모음입니다. 각 실행은 트리거에 의해 시작되는 클라우드 세션입니다. 트리거는 일정(가장 잦아도 매시간), 루틴 자체 엔드포인트로의 HTTP 호출, 또는 풀 리퀘스트 열림이나 릴리스 같은 GitHub 이벤트일 수 있습니다. claude.ai/code/routines에서, 데스크톱 앱에서, 또는 다음을 통해 만들 수 있습니다: /schedule CLI에서 실행됩니다. 루틴은 승인 확인 없이 실행되며, 기본적으로 다음으로 푸시합니다. claude/- 접두사가 붙은 브랜치.
여기서 도움이 되는 두 가지 더 작은 도구가 있습니다. CI 작업을 포함하여 로그인되어 있는 모든 머신에서 실행 중인 세션에 후속 작업을 대기열에 넣을 수 있습니다.
CODEShellclaude -p "The integration tier is green now; rebase on main and push" --cloud <session-id>
미리 채워진 세션을 북마크할 수도 있습니다. 다음과 같은 URL은 claude.ai/code?prompt=Triage+the+newest+issues&repositories=acme-labs/tidepool 프롬프트와 저장소가 이미 채워진 상태로 claude.ai/code를 엽니다.
7. 완전히 신뢰할 수 없는 코드 실행하기
기여자의 풀 리퀘스트, 새로운 의존성의 설치 스크립트, 또는 5분 전에 클론한 저장소 모두 여러분이 읽지 않은 코드를 실행할 수 있습니다. 노트북에서는 그 코드가 여러분의 SSH 키, 클라우드 CLI 세션, 브라우저 프로필 바로 옆에서 실행됩니다. 반면 클라우드 세션에서는 그런 것들이 전혀 없는 일회용 VM, 세션 범위의 GitHub 자격 증명, 그리고 좁힐 수 있는 네트워크 안에서 실행됩니다.
환경의 네트워크 액세스를 다음으로 설정하십시오: 없음 가장 엄격한 실행을 위해서는, 또는 유지 신뢰할 수 있는패키지 레지스트리, GitHub 및 주요 클라우드 SDK 호스트를 허용하는 설정입니다. None으로 설정되어 있어도 Claude Code는 여전히 Anthropic API로 요청을 보내므로 데이터가 그런 방식으로 VM을 벗어날 수 있으며, 세션은 여전히 자체 브랜치로 푸시할 수 있습니다. 모든 아웃바운드 트래픽은 호스트명을 기록하는 프록시를 통과합니다.
막히지 않고 GITHUB 연결하기
클라우드 세션이 처음에 잘못되는 경우, 가장 가능성이 높은 원인은 GitHub입니다. 대부분의 문제는 클라우드 세션이 두 가지 별도의 GitHub 권한을 필요로 하기 때문에 발생합니다.
- GitHub으로 로그인하기 Claude에게 당신이 누구인지 알려줍니다.
- Claude GitHub App 설치 계정 또는 조직에 설치하면 Claude가 해당 계정이나 조직에서 볼 수 있는 비공개 저장소가 지정됩니다.
공개 저장소는 첫 번째 것만으로 작동합니다. 비공개 저장소는 해당 저장소를 소유한 계정이나 조직에 두 번째 것이 필요합니다. GitHub를 연결했는데 비공개 저장소가 보이지 않는다면, 보통 해당 저장소를 소유한 계정이나 조직에 App이 설치되어 있지 않은 것입니다.
| 연결된 항목 | 공개 저장소 | 내 비공개 저장소 | 조직의 비공개 저장소 | 자동 수정, GitHub 트리거, 프로젝트 |
|---|---|---|---|---|
| GitHub 로그인만 한 경우 | 예 | 아니요 | 아니요 | 아니요 |
| + 개인 계정에 App 설치 | 예 | 예 | 아니요 | 내 리포지토리 |
| 조직에 설치된 App (소유자가 승인) | 예 | 내 계정에도 설치된 경우에만 | 예 | 조직 리포지토리 |
/web-setup (내 gh 토큰) | 예 | 예 | 토큰이 접근할 수 있는 범위 | 아니요, App이 필요함 |
경로 A: 브라우저에서 연결 (권장)
다음에서 GitHub 계정을 연결하세요: claude.ai/connect-github, 그 다음 리포지토리를 소유한 계정 또는 조직에 Claude GitHub App을 설치하세요. 조직의 경우 일반적으로 소유자가 설치를 승인해야 합니다. quickstart 에서 각 단계를 안내합니다.
GitHub이 claude.ai/code로 다시 연결해 주지 않는 경우, claude.ai/connect-github 의 연결 페이지에서 일반적인 원인에 대한 간단한 체크리스트를 확인할 수 있습니다. 그중 하나가 single sign-on 단계인데, 이 단계를 건너뛰면 조직의 리포지토리가 숨겨집니다.
Auto-fix, GitHub 트리거 루틴 및 프로젝트도 App에 의존하므로 다른 방식으로 연결하더라도 반드시 설치하세요.
경로 B: 터미널에서 /web-setup으로 연결
이미 다음을 사용 중이라면 gh CLI, run /web-setup Claude Code 내부에서 사용자의 gh Claude 계정의 토큰입니다. 이후 세션은 App 사용 여부와 관계없이 해당 토큰이 접근할 수 있는 모든 저장소에 도달할 수 있습니다. 다음을 참조하십시오. 터미널에서 연결하기 연습 가이드를 참조하십시오. Team 및 Enterprise 플랜에서는 소유자가 다음을 켜야 합니다 빠른 설정 첫 번째입니다.
경로 C: 일회성 작업 시 GitHub 건너뛰기
실행 claude --cloud GitHub 원격 저장소가 없거나 앱이 설치되지 않은 저장소에서는 Claude Code가 저장소를 클론하는 대신 저장소의 번들을 업로드합니다. 세션에서 푸시를 할 수 있는 경우는 GitHub 연결이 해당 저장소에 대한 푸시 권한을 가지고 있을 때뿐입니다. 문서에는 다음이 나열되어 있습니다. 번들에 포함된 것과 포함되지 않은 것.
Team 또는 Enterprise를 사용하는 경우
소유자는 간단한 체크리스트를 가지고 있습니다: GitHub 커넥터를 다음 위치에서 켜는 것입니다 claude.ai/admin-settings/connectors, 에서 클라우드 세션을 허용합니다 Claude Code 관리자 설정, 조직의 저장소에 Claude GitHub App을 설치하고(또는 구성원의 요청을 승인하고), 다음을 켤지 여부를 결정합니다 빠른 설정". IP 허용 목록을 사용하는 조직이나 GitHub Enterprise Server 사용 조직은 추가 단계가 필요합니다. 관련 문서는 다음을 참조하세요:"} IP 허용 목록 및 GitHub Enterprise Server.
그래도 여전히 작동하지 않을 때
| 여러분이 보게 되는 것 | 왜 | 수정 |
|---|---|---|
| 선택기에서 개인 저장소가 표시되지 않습니다 | App이 해당 계정 또는 소유 조직에 설치되어 있지 않거나, App의 저장소 접근 권한에서 해당 저장소가 제외되어 있습니다 | 그곳에 App을 설치하거나, GitHub 설정에서 App의 Repository access에 해당 저장소를 추가하세요 |
| 조직을 연결하려면 조직의 소유자여야 한다는 오류 메시지 | 조직이 멤버십 확인을 차단했습니다. 보통 App 권한 요청 대기 중, IP 허용 목록, 또는 SAML 싱글 사인온이 원인입니다 | 소유자가 조직의 GitHub App 설정에서 대기 중인 권한 요청을 수락하거나, 설치된 GitHub App에 대한 IP 허용 목록 상속을 켜거나, (SAML의 경우) 조직에 대한 Claude 접근을 부여합니다 |
| 연결 직후 조직의 저장소가 표시되지 않습니다 | 조직이 SAML 싱글 사인온을 사용하며, 인증 단계가 건너뛰어졌습니다 | GitHub의 "Single sign-on to your organizations" 단계에서 Authorize 를 클릭하여 각 조직 옆에서 계속 진행하기 전에 인증하세요. 이미 건너뛰었다면, GitHub 설정에서 해당 조직에 대해 Claude를 인증한 후 다시 연결하세요 |
| 모든 클라우드 세션이 인증 오류로 실패합니다 | Claude 조직에서 IP 허용 목록을 사용합니다 | Anthropic 호스팅 서비스를 예외 처리해 달라고 지원팀에 요청하세요 |
그 외의 경우 다음을 참조하세요 문제 해결 문서에서 GitHub 연결 후 저장소가 표시되지 않음등을 확인할 수 있습니다. GitHub 연결을 완전히 해제하려면 claude.ai/customize/connectors를 사용하세요.
세션이 스스로 작업을 검증할 수 있게 필요한 것을 제공하기
테스트를 실행할 수 있는 세션은 작업을 돌려주기 전에 스스로 작업을 검증합니다. 그렇지 않으면 아무도 실행하지 않은 변경 사항을 검토하게 됩니다. 이 가이드 데모의 가치 대부분은 Claude가 직접 실행한 데서 나왔습니다: 스위트를 40번 실행하고, 서버와 curl 명령을 실행하고, 창 가장자리에서 조석 계산을 실행한 것들입니다. 10분의 환경 설정이면 Claude가 이러한 검증을 실행할 수 있는 방법이 생깁니다.
- Default 환경으로 시작하세요. Trusted network access를 사용하며 변수와 설정 스크립트가 없어서, 대부분의 JavaScript, Python, Go, Rust 저장소에는 충분합니다.
- 머신용 설정 스크립트를 사용하세요. 스크립트는 Claude Code가 시작되기 전에 root로 실행되므로
apt install같은 명령이 작동합니다. exit 0으로 종료되어야 하며 그렇지 않으면 세션이 시작되지 않고, 환경이 캐시되도록 약 5분 이내에 완료되어야 합니다. 그 후 새 세션은 도구가 디스크에 있는 스냅샷에서 시작됩니다. 캐시는 스크립트나 허용된 호스트를 변경할 때, 그리고 약 7일마다 다시 빌드됩니다. - 프로젝트용 SessionStart 훅을 사용하세요. 저장소의
npm install안의 훅에.claude/settings.json및 유사한 단계를 넣으면 로컬과 클라우드에서 동일한 방식으로 실행됩니다. 클라우드에서만 실행되어야 하는 단계인지 확인하려면CLAUDE_CODE_REMOTE을 확인하세요. 저장소 훅은 단일 저장소 세션에서 로드됩니다. - 세션별로 서비스를 시작합니다. 캐시는 파일을 저장합니다. 실행 중이던 프로세스는 남지 않습니다. Claude에게
service postgresql start실행을 요청하거나, SessionStart 훅에서 처리하세요. - 작동하는 가장 좁은 네트워크 수준을 선택하세요. Trusted는 일반적인 레지스트리를 포괄합니다. 프라이빗 레지스트리를 추가하려면 Custom을, 작업이 개방형 인터넷을 필요로 할 때만 Full을 사용하세요. 변경 사항은 약 1분 내에 실행 중인 세션에 적용됩니다.
- 공유 변수에 비밀 정보를 넣지 마세요. 환경 변수는 해당 환경을 사용하는 누구에게나 보입니다. Pro 및 Max에서는 환경의 API 자격 증명이 지정한 호스트에 대한 요청에 키를 VM 외부에서 첨부하므로, 키가 변수에 담기지 않습니다.
- 명령어를 CLAUDE.md에 넣으세요. 개인
~/.claude은(는) 클라우드 VM에 전달되지 않습니다. Claude가 통합 테스트 실행 방법을 알아야 한다면 저장소에 그 내용이 명시되어 있어야 합니다.
효과가 있는 습관들
- 하나의 작업, 하나의 세션. 작고 분리된 세션은 검토하기 쉽고 버리기에도 비용이 적게 듭니다.
- 근거를 요구하세요. 작업이 완료되었음을 증명하는 명령어를 지정하고, diff 전에 Claude의 요약을 읽으세요.
- 푸시한 후에
claude --cloud. VM은 GitHub에서 클론하므로, 푸시되지 않은 커밋은 도달하지 않습니다. - 긴 작업에서는 진행하면서 커밋하세요. 유휴 VM은 회수될 수 있습니다.
- diff 뷰에서 검토하세요. 인라인 코멘트는 다음 메시지에 일괄 반영되며, Create PR 은(는) 완전한 PR, 초안 또는 GitHub의 작성 페이지를 열 수 있습니다.
- Claude가 작업하는 동안 방향을 조정하세요. Claude가 작업 중일 때 보낸 메시지는 대기열에 쌓이며, 대기 중인 메시지를 취소할 수 있습니다.
- 세션을 공유하세요. Team 및 Enterprise에서는 세션 가시성을 Team으로 설정하여 검토자가 변경이 이루어진 과정을 읽을 수 있습니다. 클라우드 세션의 커밋에는 트랜스크립트로 되돌아가는
Claude-Session트레일러가 포함됩니다. - 사용 한도를 주시하세요. 병렬 세션은 플랜 한도를 동시에 소비하므로, 5개의 세션은 하나보다 약 5배 빠르게 소비합니다. 루틴에는 별도의 시간당 상한이 있으며, 프로젝트 는 하루에 최대 200개의 새 스레드를 시작할 수 있습니다.
자주 묻는 질문
클라우드 세션은 누가 사용할 수 있나요? Pro, Max, Team 플랜 사용자, 그리고 프리미엄 시트 또는 Chat + Claude Code 시트를 보유한 Enterprise 사용자로서 claude.ai 계정으로 로그인한 경우에 사용할 수 있습니다. Console API 키나 서드파티 제공업체로는 사용할 수 없습니다. 자세한 내용은 다음을 참조하세요. 클라우드 세션 문서.
내 데이터는 어디로 가나요? Anthropic은 세션 대화 기록을 저장하며, 보관 기간은 사용자의 플랜과 모델 개선 설정에 따라 달라집니다. VM은 비활성 상태가 되면 회수되며, 세션을 삭제하면 해당 데이터도 제거됩니다. 참고: 데이터 사용량 및 보안.
Claude가 제 클라우드 세션 데이터로 학습하나요? 클라우드 세션은 Claude Code의 나머지 부분과 동일한 정책을 따릅니다. Team, Enterprise 및 API에서는 Anthropic이 조직이 옵트인하지 않는 한 귀하의 코드나 프롬프트로 모델을 학습시키지 않습니다. Free, Pro 및 Max에서는 귀하의 모델 개선 설정. 참조 데이터 사용량.
대형 저장소도 처리할 수 있을까요? 이 VM은 약 4 vCPU, 16 GB RAM, 30 GB 디스크를 갖추고 있습니다. 무거운 설치는 다음에 넣으세요 설정 스크립트 그래서 한 번 실행되면 캐시된 스냅샷에 닿게 됩니다.
GitLab이나 Bitbucket은 어떨까요? claude --cloud 모든 git 저장소에서 번들을 업로드할 수 있지만, 세션은 해당 호스트로 푸시할 수 없습니다. GitHub Enterprise Server Team 및 Enterprise 플랜에서 지원됩니다. 자세한 내용은 다음을 참조하세요. 플랫폼 제한.
병렬 브랜치가 충돌하면 어떻게 될까요? 세션들은 서로를 인지하지 못합니다. 한 브랜치를 병합한 다음 다음 세션에 후속 조치를 보내십시오 와 같은 claude -p "rebase on main and fix any conflicts" --cloud <session-id>.
내 로컬 도구를 잃게 되나요? 사용자 수준 설정은 함께 따라오지 않으므로 팀에 필요한 것을 저장소로 옮기세요: 스킬과 커맨드를 다음 위치 아래에 커밋하세요 .claude/, 프로젝트 범위의 MCP 서버를 추가하여 .mcp.json, 그리고 테스트 명령을 다음 위치에 문서화하세요: CLAUDE.md. 클라우드 세션의 설정 각 세션이 읽는 내용을 나열합니다.
5분 후 시작
설정에는 약 5분이 걸립니다. 그 후에는 작업을 넘기고 노트북을 닫은 다음, 검토 준비가 완료된 브랜치로 돌아올 수 있습니다.
- claude.ai/code를 열거나 다음을 실행하세요
/loginclaude.ai 계정으로 Claude Code에서 실행합니다. - 저장소가 있는 곳에서 GitHub을 연결하고 Claude GitHub App을 설치하세요.
- 저장소와 Default environment를 선택하세요.
- 백로그에서 작업 하나를 Claude에게 지정하고, 완료를 증명하는 명령과 함께 전달하세요.
- 탭을 닫으세요. 나중에 휴대폰에서 확인한 다음 diff를 검토하고 claude.ai/code에서 pull request를 생성하세요.