.env는 보통 Git에서 파일을 무시하기 때문에 Codex 워크트리에서 찾을 수 없으며, 새 워크트리는 저장소에서 추적된 파일만 자동으로 가져옵니다. Codex Apps에서 만든 로컬 호스팅 워크트리의 경우, 저장소 루트 디렉터리에 .worktreeinclude을 추가하고 실제로 필요한 무시된 파일만 복사할 수 있습니다.
최소 구성은 다음과 같이 작성됩니다
메인 저장소의 루트 디렉터리에 .worktreeinclude를 생성하세요:
.env
.env.local
config/local-secrets.json문법은 .gitignore의 경로 패턴과 유사합니다. 새로운 워크트리를 생성한 후, Codex는 로컬 점검 디렉터리에서 일치하는 무시(ignore) 파일을 복사합니다; 목록에 없는 다른 추적되지 않은 문서들은 함께 포함되지 않습니다. 이미 목표 위치에 있는 파일은 덮어쓰지 않습니다.
왜 예전 워크트리는 아직도 이용할 수 없는 걸까요?
.worktreeinclude 로컬에서 호스팅된 워크트리를 생성하는 과정에서 작동하며, 이미 생성된 워크트리를 자동으로 다시 작성하지 않습니다. 기존 워크트리는 목적지 경로를 확인한 후 필요한 파일을 수동으로 복사하거나, 새로운 워크트리 검증 규칙을 생성할 수 있습니다. 문제를 해결하기 위해 .env Git 트레이스 파일로 변경하지 마세요. 이는 키 오공유 위험이 높아집니다.
먼저, 그 시나리오가 적합한지 판단하세요
이 메커니즘은 ChatGPT 데스크톱 애플리케이션이 관리하는 네이티브 워크트리를 위해 설계되었습니다. 명령줄에서 git worktree add를 실행하여 생성한 원격 워크트리와 디렉터리는 이 파일 때문에 자동으로 구성을 복사하지 않습니다; 이러한 환경들은 각각의 초기화 스크립트, 키 인젝션, 또는 배포 구성을 통해 준비되어야 합니다.
파일이 도착했는데도 오류가 계속 나오면 어떻게 해야 하나요?
먼저 Worktree 통합 터미널에서 현재 디렉터리를 확인한 후, 애플리케이션이 .env, .env.local 또는 다른 이름을 읽는지 확인하세요. 그 다음 시작 명령어의 파일 권한과 작업 디렉터리를 확인하세요. 파일은 보이지만 변수는 비어 있습니다. 문제가 "Worktree 복사되지 않음"에서 "애플리케이션이 이 파일을 불러오지 않음"으로 바뀌었습니다. .worktreeinclude 계속 수정하지 말고 프레임워크의 환경 변수 규칙을 확인하는 것이 좋습니다.
실행에 필요한 로컬 구성만 나열하고, 전체 키나 홈 디렉터리를 각 작업 트리에 복사하는 것은 피하세요. 이 덕분에 워크트리가 민감한 파일의 경계 없는 복사본으로 변하지 않고도 테스트가 실행될 수 있습니다.
