Claude Code worktree 안전 경계: .claude/worktrees 밖 진입 전 확인법 | DAKER 커뮤니티

Claude Code worktree 안전 경계란, 병렬 세션이 수정할 수 있는 작업 디렉터리와 삭제·진입 전에 확인해야 할 경로를 분리하는 운영 기준입니다. 2026년 7월 11일 기준 최신 Claude Code changelog는 프로젝트의 .claude/worktrees/ 밖 worktree로 들어갈 때 확인을 요청하고, Windows symlink·junction이 있는 worktree 삭제 안전성도 수정했다고 안내합니다. 병렬 agent를 자주 쓰는 팀이라면 오늘은 “몇 개를 띄울까”보다 “어디까지가 안전한 작업 경계인가”를 먼저 정하세요.

DAKER 클로드 코드 worktree 안전 경계 확인 만화 카드

DAKER 클로드 코드 worktree 안전 경계 확인 만화 카드

문제 상황: worktree가 많아질수록 왜 경로 확인이 중요할까요?

한 줄 요약: worktree는 병렬 작업을 빠르게 만들지만, 잘못 들어가거나 잘못 지우면 프로젝트 밖 파일까지 위험해질 수 있습니다.

Claude Code 팀 사용자는 background agent, remote control, subagent를 통해 여러 작업을 동시에 열 수 있습니다. 이때 worktree가 프로젝트 내부 표준 위치에 있는지, 바깥 경로로 이동하는지, 내부에 symlink나 junction이 있는지 확인하지 않으면 격리의 의미가 흐려집니다. DAKER의 병렬 에이전트와 워크트리 운영법이 기본 운영을 다뤘다면, 이번 글은 최신 changelog 이후 경계 확인 루틴에 집중합니다.

핵심 개념: .claude/worktrees는 무엇을 기준으로 보나요?

핵심 포인트: 프로젝트의 .claude/worktrees/는 Claude Code가 관리하는 작업 경계로 이해하고, 그 밖 worktree는 들어가기 전 한 번 더 확인해야 합니다.

최신 changelog는 EnterWorktree가 프로젝트의 .claude/worktrees/ 밖 git worktree로 들어가기 전에 확인을 요청한다고 설명합니다. 이것은 외부 worktree를 금지한다는 뜻이 아니라, 팀이 만든 표준 격리 위치와 사용자가 별도로 만든 경로를 구분하라는 신호입니다.

DAKER 클로드 코드 worktree 경로와 symlink 삭제 위험 점검 워크플로 카드

DAKER 클로드 코드 worktree 경로와 symlink 삭제 위험 점검 워크플로 카드

단계별 사용법: worktree 진입 전 무엇을 확인하나요?

  1. pwd와 git status --short로 현재 경로와 변경 상태를 먼저 확인합니다.

  2. 새 병렬 작업은 가능하면 프로젝트의 .claude/worktrees/ 아래에서 만들도록 팀 기준을 둡니다.

  3. Claude Code가 바깥 worktree 진입 확인을 띄우면, 왜 그 경로가 필요한지 작업 이유를 먼저 확인합니다.

  4. 삭제 전에는 symlink, junction, nested repository가 있는지 확인하고, 자동 삭제 명령을 바로 허용하지 않습니다.

  5. Remote Control이나 background agent는 DAKER의 모바일 worktree 글처럼 세션 이름과 작업 경계를 함께 남깁니다.

짧은 예시: 병렬 agent 시작 프롬프트

작업 전 현재 경로, branch, git status를 보고해줘. 이 세션이 .claude/worktrees 내부인지 확인하고, 바깥 worktree라면 이유를 설명한 뒤 파일 수정 전에 멈춰줘.

이 문장은 Claude Code가 바로 수정하기 전에 경로와 책임 범위를 말하게 만듭니다. 특히 여러 agent가 같은 저장소를 만질 때는 이 짧은 확인이 충돌을 줄입니다.

팀 적용 체크리스트: worktree를 안전하게 정리하려면?

공식 출처: 어떤 기준으로 확인했나요?

이 글은 2026년 7월 11일 기준 Anthropic Claude Code GitHub changelog 2.1.206과 2.1.205를 확인해 작성했습니다. 공개 본문에는 DAKER 운영 정책에 따라 외부 공식 URL을 직접 노출하지 않고, 기능명과 기준일만 남깁니다.

자주 묻는 질문

.claude/worktrees 밖 worktree는 쓰면 안 되나요?

금지는 아닙니다. 다만 팀 표준 위치 밖이면 작업 경계가 명확하지 않을 수 있으므로 진입 전 이유와 변경 범위를 확인하는 편이 안전합니다.

Windows symlink와 junction은 왜 따로 봐야 하나요?

최신 changelog는 Windows worktree removal에서 symlink 또는 junction이 있는 경우 worktree 밖 파일 삭제 위험을 수정했다고 설명합니다. 팀은 삭제 전 경로 확인을 습관으로 남겨야 합니다.

병렬 agent를 많이 쓰면 worktree가 항상 필요한가요?

같은 파일을 만질 가능성이 있거나 장기 작업이면 worktree가 유용합니다. 단순 읽기 조사라면 같은 디렉터리에서도 충분할 수 있습니다.

worktree 정리는 자동화해도 되나요?

가능하지만 완료된 세션, 남은 diff, symlink 여부를 확인한 뒤 좁게 자동화해야 합니다. 삭제 자동화는 항상 더 보수적으로 설계하세요.

다음 병렬 세션을 열기 전에는 worktree 위치와 삭제 경계를 먼저 확인하세요. 이 작은 습관이 Claude Code 병렬 작업을 빠르면서도 되돌릴 수 있게 만듭니다.

Redirecting to Claude Code worktree 안전 경계: .claude/worktrees 밖 진입 전 확인법 | DAKER 커뮤니티...