맥미니에 Codex 개발 환경을 옮기다가 pnpm 문제와 Git Worktree를 정리하게 된 이야기
TL;DR MacBook에서만 사용하던 Codex 개발 환경을 Mac mini에도 구축하는 과정에서 pnpm dev가 실행되지 않는 문제를 만났다. 원인은 pnpm 11의 dependency build approval 정책이었고, pnpm 버전 고정과 allowBuilds 설정으로 해결했다. 추가로 next-env.d.ts가 Next.js가 생성하는 파일이라는 점을 다시 확인했고, Git Worktree를 사용하면 AI 에이전트별 작업 공간을 분리할 수 있다는 점도 정리하게 됐다. 최근까지는 MacBook Pro에서만 Codex를 사용해 개발했다. 그런데 AI 에이전트가 코드 생성, 테스트 실행, 빌드 검증을 반복하다 보니 생각보다 리소스를 많이 사용했다. 집에 항상 켜져 있는 Mac mini가 있으니 여기에 동일한 개발 환경을 구축해두고 원격으로 작업하는 편이 낫겠다고 생각했다. 작업 자체는 특별할 것이 없었다. 저장소를 새로 clone하고 의존성을 설치한 뒤 개발 서버를 실행하면 된다. 그런데 pnpm dev 단계에서 바로 실패했다. 맥북에서는 정상 동작하는 프로젝트였기 때문에 환경 차이를 먼저 확인하기 시작했다. 확인한 내용은 다음과 같다. 맥북과 맥미니의 pnpm 버전 차이 개발 서버와 로컬 환경의 차이 최근 pnpm 정책 변경 여부 프로젝트 설정 누락 여부 Git에 포함된 생성 파일들 원인: pnpm 11의 Build Approval 정책 로그를 확인해보니 Next.js나 애플리케이션 코드가 실행되기 전에 pnpm 단계에서 실패하고 있었다. 에러는 다음과 같았다.