AI에게 큰 리팩터링 계획을 맡길 때는 모델보다 실행 위치를 먼저 봐야 한다. 로컬과 클라우드는 읽을 수 있는 설정, 인증, 미커밋 변경이 다르다. 필요한 증거가 작업 환경에 없으면 정교한 계획도 틀린다.
선택 기준은 간단하다. 로컬에만 있는 사실이 계획을 좌우하면 로컬에서 시작한다. 커밋된 저장소만으로 분석할 수 있고 긴 초안을 백그라운드에서 만들거나 브라우저에서 구획별로 검토해야 한다면 클라우드가 맞다. 어느 쪽이든 계획 승인은 구현 권한을 넘기는 별도 결정이다.
1. 먼저 계획에 필요한 증거를 분류한다
먼저 증거 목록을 만든다. 기준·머리 커밋, 관련 모듈과 테스트, 배포 구조, 금지 영역, 성공 조건, 롤백 지점이 기본이다. 이어 증거가 커밋된 저장소에 있는지, 미커밋 파일·사용자 설정·로컬 MCP·사내 인증 뒤 서비스에만 있는지 표시한다.
“서비스를 현대화하라” 대신 “결제 모듈을 새 인터페이스로 옮길 호출부를 찾고, 호환 단계를 나누며, 단계마다 검증 테스트와 되돌림 조건을 제시하라”고 쓴다. 계획에는 사실, 가정, 확인 질문을 구분해 달라고 요청한다.
2. 로컬 Plan Mode가 맞는 경우
Claude Code의 Plan Mode는 파일을 읽고 탐색 명령을 실행한다. 일반 세션은 계획 승인 전 편집을 막지만, 읽기 전용으로 판정되지 않은 명령은 자동 분류나 사용자 승인을 거친다. bypassPermissions가 허용된 세션은 예외이므로 보안 격리로 보지 않는다. /plan으로 한 요청에 적용하거나 claude --permission-mode plan으로 세션을 시작할 수 있다. 세부 동작은 Plan Mode 공식 안내에서 확인한다.
미커밋 변경, 사용자 범위 설정, 로컬 전용 도구, 브라우저 로그나 사내 SSO 뒤의 정보가 핵심이면 로컬이 유리하다. 비밀 파일, 생성물, 관련 없는 디렉터리는 권한 규칙으로 제외한다.
3. 클라우드 Ultraplan이 맞는 경우
Ultraplan은 로컬 CLI의 계획 작업을 Claude Code 웹 세션에 넘겨 초안을 만들고, 브라우저에서 특정 구획에 의견을 달게 한다. 승인 뒤 같은 웹 세션에서 구현하거나 계획을 터미널로 돌려보낼 수 있다. 2026-07-29 현재 연구 프리뷰이며 웹 계정과 GitHub 저장소가 필요하다. Bedrock·Google Cloud Agent Platform·Microsoft Foundry에서는 쓸 수 없다. 최신 조건은 Ultraplan 공식 문서로 확인한다.
저장소 전체의 의존 관계처럼 분석이 길고, 팀이 계획을 구획별로 검토하며 로컬 터미널을 계속 써야 할 때 적합하다. 로컬에만 있는 사실은 먼저 커밋 가능한 문서로 옮기거나 계획을 로컬로 돌린다.
4. 클라우드에 없는 것과 보이는 것을 확인한다
웹 세션은 새 관리형 VM에 저장소를 복제한다. 커밋된 CLAUDE.md와 저장소 설정은 사용할 수 있지만 사용자 홈의 지침, 사용자 전용 플러그인·MCP, 로컬 미커밋 변경은 자동으로 따라가지 않는다. 전용 비밀 저장소도 없다. 환경 변수와 설정 스크립트는 그 환경 사용자 누구나 읽을 수 있으므로 자격 증명을 넣지 않는다.
네트워크는 None·Trusted·Full·Custom 중 필요한 최소 범위로 정한다. 연결 계정이 볼 수 있는 저장소 범위와 환경 편집 권한도 함께 확인한다. 구체적인 차이와 보안 경계는 Claude Code 웹 환경 공식 안내에서 확인할 수 있다.
5. 실행 전 계획 계약을 고정한다
최종 계획 첫머리에 검토한 커밋 SHA, 포함·제외 범위, 실행 위치와 미확인 항목을 적는다. 각 단계에는 변경 파일, 선행 조건, 검증 명령, 관찰할 지표, 중단·롤백 조건을 붙인다. 클라우드 초안을 로컬에서 실행한다면 도구 버전과 인증, 미커밋 차이를 다시 확인한다.
승인도 한 번에 하지 않는다. 첫 배포 단위만 확정하고 실제 결과가 가정과 맞는지 본 뒤 다음 단계를 연다. 계획이 길어도 첫 변경을 검증할 수 없다면 실행 가능한 계획이 아니다.
좋은 환경 선택은 클라우드와 로컬의 우열을 가리는 일이 아니다. 필요한 증거가 있는 곳에서 계획하고, 없는 정보를 명시하며, 구현 직전에 같은 기준으로 다시 확인하는 일이다.