긴 버그 수정이라고 무조건 Cloud를 고르지는 않습니다. 현재 컴퓨터의 승인된 폴더, 로컬 서비스, 설치된 도구를 직접 확인하며 짧게 방향을 바꿔야 하면 Local이 맞습니다. 저장소와 재현 명령, 완료 조건이 분명하고 앱이나 컴퓨터를 닫은 뒤에도 실행을 이어 가야 하면 Cloud를 검토합니다.

둘은 단순한 속도 옵션이 아닙니다. Local은 사용자 컴퓨터에서 실행하며 통합 터미널과 파일 pane을 쓸 수 있습니다. Cloud는 기본적으로 Anthropic 관리 인프라에서 실행하며 장기 작업을 계속할 수 있습니다. 한 환경만 골라 비민감 fixture로 실행합니다. 재현 결과·diff·테스트를 사람이 대조한 지점에서 첫 작업을 끝냅니다.

• Claude Code Desktop의 Local과 Cloud가 실제로 나뉘는 지점
• 긴 버그 수정에서 현재 컴퓨터 의존성과 원격 지속성을 판별하는 법
• Local의 Manual과 Cloud의 permission mode 차이
• 한 환경만 골라 계획·수정·테스트·diff를 검토하는 실행 순서
• 복사해서 쓸 수 있는 선택 프롬프트, 주의점, FAQ

Claude Code Desktop은 Claude Desktop의 Code 탭에서 소프트웨어 작업을 수행하는 화면입니다. 새 session을 시작하기 전에 Environment, project folder 또는 repository, model, permission mode를 정합니다. 공식 문서는 Environment에서 사용자 컴퓨터의 Local, 앱을 닫아도 계속되는 Cloud, 관리하는 원격 컴퓨터의 SSH, Windows의 WSL을 구분합니다.

Local과 Cloud는 같은 Claude Code 데스크톱 안에서 코드가 실행되는 위치와 사용할 수 있는 검토 도구를 나누는 환경 선택입니다.

이 글에서는 Local session을 로컬 세션, Cloud session을 클라우드 세션으로 함께 구분합니다.

Local은 사용자 컴퓨터에서 실행합니다. 공식 quickstart의 첫 진입 문구는 Select Local 입니다. 이어서 Select folder 로 프로젝트 디렉터리를 고릅니다. Local session에서는 통합 terminal이 같은 working directory를 사용합니다. File pane에서는 파일을 열어 확인하거나 spot edit를 저장할 수 있습니다. @mention files 도 Local과 SSH에서 사용할 수 있지만 Cloud와 WSL에서는 제공되지 않습니다.

Cloud는 기본적으로 Anthropic-managed infrastructure에서 실행합니다. 공식 Desktop 문서는 이를 cloud session that continues after you close the app 으로 설명합니다. 앱을 닫거나 컴퓨터를 종료해도 진행됩니다. 웹의 claude.ai/code 또는 Claude mobile app에서 상태를 볼 수 있습니다. 선택한 cloud environment에는 repository를 여러 개 추가할 수 있지만 첫 검토에서는 승인된 repository 하나로 범위를 좁히는 편이 안전합니다.

실행 위치와 Git 격리는 따로 봐야 합니다. Local session에서도 branch 옆 worktree option을 선택하면 프로젝트의 isolated copy를 만들 수 있습니다. Local이라고 반드시 현재 checkout을 직접 수정하지는 않습니다. Cloud에도 필요한 로컬 상태가 자동으로 전달되지 않습니다.

Local이 맞는 경우

현재 컴퓨터에 있는 승인된 프로젝트를 직접 확인해야 하면 Local을 고릅니다. 버그가 로컬 개발 서버, 특정 emulator, 사용자가 준비한 test fixture, 설치된 compiler처럼 현재 장비의 조건과 함께 나타나는 경우가 여기에 해당합니다.

수정할 때마다 개발자가 판단해야 하는 작업도 Local에 맞습니다. 통합 terminal에서 같은 working directory의 명령을 다시 실행하고 file pane과 diff를 오가며 가설을 하나씩 확인할 수 있기 때문입니다. 다만 사내망, 인증서, 개인 설정 파일이 필요하다는 이유로 접근 범위를 곧바로 넓히지는 않습니다. 비민감 복사본으로 재현되지 않는 조건은 확인 필요 로 남기고 조직 정책을 먼저 확인합니다.

Cloud가 맞는 경우

저장소와 재현 절차만으로 문제가 분명한지 봅니다. Large refactor·test suite·migration처럼 오래 실행해야 한다면 Cloud를 검토합니다. 공식 문서는 이러한 long-running task에서 session이 컴퓨터와 분리돼 계속된다는 점을 명시합니다.

Cloud에 보낼 작업은 개발자가 계속 개입하지 않아도 첫 완료 조건을 판정할 수 있어야 합니다. 대상 repository와 branch, 기대 결과와 실제 결과, 변경 가능 파일, 금지 영역, setup과 test command를 적을 수 있어야 합니다. 설명이 모호하거나 로컬에서만 보이는 상태가 핵심이면 먼저 Local에서 재현 범위를 좁힙니다.

Cloud가 여러 repository를 지원한다는 사실은 모든 저장소를 한꺼번에 연결하라는 뜻이 아닙니다. 서로 다른 codebase를 함께 바꿔야 한다는 근거와 별도 승인이 있을 때만 추가합니다. 첫 실습은 repository 한 개와 branch 한 개로 끝냅니다.

선택 답을 한 줄로 정리하면

현재 컴퓨터의 실제 상태를 보며 짧게 판단을 반복해야 하면 Local입니다. 승인된 repository와 명령만으로 재현되고 기기를 닫은 뒤에도 계속해야 하면 Cloud입니다. 작업 시간이 길다는 이유만으로 범위가 모호한 문제를 Cloud에 넘기지는 않습니다.

Claude Code quickstart는 Pro, Max, Team 또는 Enterprise 구독이 필요하다고 안내합니다. Cloud가 연결되는 web surface는 Pro·Max·Team의 research preview이며, Enterprise에서는 premium seat 또는 Chat + Claude Code seat 조건이 공식 문서에 적혀 있습니다. 조직 설정과 현재 계정의 Code 탭에서 실제 제공 상태를 확인합니다.

Local과 Cloud는 permission mode도 다릅니다. Local에서 Manual을 고르면 Claude가 파일을 편집하거나 명령을 실행하기 전에 묻습니다. 사용자는 diff에서 각 변경을 accept 또는 reject할 수 있습니다. Plan은 파일을 바꾸지 않고 조사와 계획을 먼저 검토할 때 씁니다.

Cloud session은 Accept edits, Plan, Auto를 지원합니다. 공식 문서는 Cloud가 file edit를 pre-approve하므로 selector에 Manual 대신 Accept edits가 표시된다고 설명합니다. Cloud에서 Manual과 같은 승인 흐름이 작동한다고 쓰면 안 됩니다. Bypass permissions도 Cloud에서는 제공되지 않습니다.

데이터 처리 범위를 실행 위치 하나로 판정해서는 안 됩니다. 공식 data usage 문서는 consumer plan과 commercial terms의 training policy를 따로 설명합니다. Local에서도 conversation과 code context는 모델 처리를 위해 Anthropic API로 전송됩니다. Cloud의 원격 실행과 Local의 로컬 실행은 조직 정책, repository 권한, network, secrets, 보관 조건과 함께 각각 검토합니다.

첫 작업에는 고객 데이터, production secret, 실제 access token, 개인 식별 정보, 운영 database dump를 넣지 않습니다. 원본 repository 대신 승인된 test branch나 복사본을 사용합니다. 원본 상태와 rollback owner는 작업 기록에 남깁니다.

목표: 재현 가능한 긴 버그 수정의 첫 실행 환경을 Claude Code Desktop의 Local 또는 Cloud 중 하나로 고르고 내부 검토본을 만든다.

허용 입력: 비민감 test fixture, 기대 결과와 실제 결과, 승인된 project folder 또는 repository·branch, 재현 명령, 변경 가능 파일, test command, 현재 UI에서 확인한 environment와 permission mode.

제외 입력: 고객 식별 정보, production data, 실제 secret·token, 승인되지 않은 repository·network, 범위 밖 파일, 무관한 refactor, test 조건 완화, PR 생성·merge·deployment.

출력 형식: 선택한 환경과 이유 | 재현 결과 | 원인 가설과 근거 파일 | 변경 파일·이유 | 실행한 test와 결과 | 상충·확인 필요 | 사람 승인 지점 순서로 작성한다.

완료 기준: 한 환경에서만 변경하고 재현 결과, diff, test 결과를 원본 이슈와 대조할 수 있는 내부 검토 기록을 만든다.

무창작 원칙: 확인하지 않은 원인, 파일, API, 설정, 성공 결과, 권한, 전송·보관 상태를 만들지 말고 확인 필요로 표시한다.

승인 지점: 사람이 environment, folder 또는 repository·branch, plan, 명령, diff, test 결과를 검토한 뒤에만 후속 수정, PR, merge, deployment를 각각 승인한다.

긴 작업을 Cloud로 보내는 기준은 예상 소요 시간만이 아닙니다. 개발자가 자리를 비워도 첫 완료 여부를 판정할 재현 조건이 준비됐는지가 더 중요합니다. 증상만 길게 적고 repository와 test가 불분명하면 원격 지속성은 모호한 작업을 오래 실행하게 만들 뿐입니다.

Local에서 먼저 오류를 좁힌 뒤 같은 session을 Cloud가 자동으로 이어받는다고 가정하지 않습니다. 전환이 필요하면 재현 fixture, repository state, branch, 변경 가능 범위, test command를 새 승인 입력으로 다시 고정합니다. 환경 전환 자체를 하나의 handoff 검토로 다루면 미커밋 파일이나 로컬 secret이 전달됐다고 잘못 믿는 일을 줄일 수 있습니다.

반대로 Cloud가 만든 변경을 Local에서 다시 보는 일도 자동 검증은 아닙니다. 같은 diff를 원본 이슈와 대조합니다. 승인된 환경에서 test를 다시 실행한 뒤 사람이 다음 행동을 결정합니다.

• Local은 현재 컴퓨터에서 실행하지만 conversation과 code context까지 기기에만 남는다는 뜻은 아닙니다. 공식 data usage와 조직 정책을 확인합니다.
• Cloud가 앱이나 컴퓨터를 닫아도 계속된다는 사실은 완료나 정확성 보장이 아닙니다. 진행 상황, diff, test와 남은 위험을 다시 봅니다.
• Cloud의 file edit는 pre-approved됩니다. Local Manual과 같은 단계별 편집 승인으로 오해하지 말고 repository와 branch 범위를 먼저 줄입니다.
• Local과 worktree는 같은 말이 아닙니다. Git repository에서는 Local session의 worktree option을 별도로 선택할 수 있습니다.
• custom cloud environments 에는 필요한 설정만 둡니다. network, secrets, 여러 repository 추가는 버그 수정과 별도 승인합니다.
• PR 생성, auto-fix, auto-merge, 배포와 migration은 검토본 작성 뒤의 독립 행동입니다. 첫 완료 기준에 넣지 않습니다.

Q1. 긴 버그 수정은 항상 Cloud가 더 좋은가요?

아닙니다. 현재 컴퓨터의 local service와 tool, 승인된 folder를 직접 확인하며 사람이 계속 방향을 정해야 하면 Local이 맞습니다. Cloud는 repository와 재현 명령, 완료 조건이 명확하고 기기와 분리해 계속 실행할 작업에 맞습니다.

Q2. Local을 고르면 현재 checkout을 반드시 직접 수정하나요?

아닙니다. 공식 Desktop 문서는 Git repository에서 branch 옆 worktree option을 선택해 session마다 isolated copy를 만들 수 있다고 설명합니다. Local은 실행 위치이고 worktree는 변경 격리 선택입니다. 현재 화면에서 둘을 따로 확인합니다.

Q3. Cloud에서 Manual permission mode를 쓸 수 있나요?

공식 문서는 Cloud session이 Accept edits, Plan, Auto를 지원하고 file edit를 pre-approve한다고 설명합니다. 따라서 selector에는 Manual 대신 Accept edits가 보입니다. 실행 전 Plan을 검토하고 repository·branch·변경 파일 범위를 좁힌 뒤 diff와 test를 사람이 확인합니다.

Q4. Local에서 시작한 내용을 Cloud가 자동으로 이어받나요?

자동 handoff로 가정하면 안 됩니다. Cloud를 새로 고를 때 승인된 repository state, branch, fixture, setup과 test command를 다시 확인합니다. 로컬 미커밋 파일, 개인 설정, secret, 실행 중 service가 자동으로 전달됐다고 보지 않습니다.

• Anthropic Claude Code Docs: Desktop application — Environment의 Local·Cloud, permission mode 차이, terminal·file pane, worktree, long-running Cloud session과 multiple repositories를 확인했습니다.
• Anthropic Claude Code Docs: Get started with the desktop app — 지원 구독, Code 탭, Select Local과 Select folder, diff 검토 흐름을 확인했습니다.
• Anthropic Claude Code Docs: Use Claude Code on the web — Cloud 제공 조건, Anthropic-managed infrastructure, session 지속성, repository·환경·보안 범위를 확인했습니다.
• Anthropic Claude Code Docs: Data usage — consumer와 commercial data policy, Local에서도 API 처리 범위를 확인했습니다.