Claude Code✓ 공식 문서로 확인10월 16일 수집
클로드 코드 워크트리 세션에 .env 같은 gitignore 파일을 자동으로 복사하는 법
클로드 코드(Claude Code)가 만드는 워크트리는 새로 체크아웃한 폴더라서 .env, .env.local처럼 git이 무시하는 파일이 없다. 데스크톱 앱에서 세션마다 워크트리를 따로 쓰면 새 세션에서 앱을 띄울 때 이 설정 파일이 빠져 있다. 프로젝트 루트에 .worktreeinclude를 두면 워크트리가 생길 때마다 이 파일들을 복사해 넣는다.
- 프로젝트 루트에
.worktreeinclude를 만들고.gitignore와 같은 문법으로 복사할 파일을 적는다.
.env
.env.local
config/secrets.json
- 새 워크트리 세션을 시작한다. 패턴에 맞는 파일이 이미 복사돼 있다.
패턴에 맞고 gitignore에도 걸린 파일만 복사하므로 커밋된 파일이 두 벌 생기지 않는다. --worktree로 띄운 세션과 서브에이전트 워크트리, 데스크톱 앱의 병렬 세션이 모두 이 파일을 따른다. 폴더째 무시된 곳 안의 파일은 **/config.json 대신 vendor/**/config.json처럼 폴더 이름을 패턴에 적어야 가져온다. WorktreeCreate 훅을 쓰면 이 파일을 읽지 않으니 훅 스크립트에서 직접 복사한다.
출처