AI 도서관 · Claude · 하네스 설정 · 실전 셋업

worktree로 나란히 작업하기

한 저장소에서 여러 작업을 동시에, 서로 안 건드리게

내용

📌 worktree = 같은 저장소의 별도 작업 폴더

브랜치를 왔다 갔다 하지 않고, 폴더를 따로 두고 동시에 작업합니다.
한쪽에서 기능을 만들면서 다른 쪽에서 버그를 고칠 수 있습니다.

[ 쓰는 법 ]
claude --worktree feature-auth

다른 터미널에서 이름만 바꿔 실행하면 나란히 도는 세션이 됩니다.

[ 왜 편한가 ]
• 브랜치를 바꿀 때마다 빌드가 다시 도는 일이 없습니다
• 한쪽이 실패해도 다른 쪽에 영향이 없습니다
• 에이전트에게 맡긴 작업이 내 작업 폴더를 건드리지 않습니다

⚠️ 커밋이 하나도 없는 저장소에서는 실패합니다.
   worktree 는 기존 커밋에서 갈라져 나오는 구조라서 그렇습니다.

💡 여러 세션을 한 화면에서 보려면 백그라운드 에이전트 화면을 쓰세요.
터미널을 여러 개 띄우지 않아도 됩니다.

궁금한 점: {{INPUT}}

{{INPUT}} 자리에 내 내용을 넣어 쓰는 프롬프트입니다. 아래 버튼으로 열면 넣는 칸이 나옵니다.

근거

유형
설정 가이드 — 지정된 파일이나 설정에 적용합니다
사용 환경
Claude Code (터미널) — git 저장소
주의
커밋이 하나도 없는 저장소에서는 동작하지 않습니다.
공식 출처
https://code.claude.com/docs/en/worktrees
확인일
2026-09-09 — 이후 바뀌었을 수 있습니다
도서관에서 열기 — 내 내용 넣고 복사하기