Antigravity에 기존 프로젝트를 가져올 때 새 프로젝트를 만들고 파일을 손으로 옮길 필요는 없습니다. 「폴더 열기」로 프로젝트 루트를 넘기면 에이전트가 기존 코드와 구조를 읽어냅니다. 초보자가 가장 흔히 저지르는 실수는 빈 프로젝트를 만든 뒤 파일을 수동으로 복사하는 것으로, 설정과 Git 기록을 잃을 수 있고 과정도 한 단계 더 늘어납니다.
상황에 맞는 세 가지 열기 방법
- 코드가 로컬에 있는 경우: 시작 화면에서 「폴더 열기」를 선택하고 프로젝트 루트를 지정하세요. 상위 폴더나 바탕화면을 선택하지 마세요.
- 코드가 GitHub에 있는 경우: 「Git 저장소 복제」를 선택하고 저장소 주소를 입력하면 Antigravity가 코드를 가져온 뒤 열어줍니다.
- VS Code나 Cursor에서 넘어온 경우: 첫 실행 시 설정 가져오기를 선택하면 테마, 확장 프로그램, 단축키를 함께 가져올 수 있어 편집 습관을 그대로 유지할 수 있습니다.
- Firebase Studio에서 이전하는 경우: Google이 전용 마이그레이션 절차를 문서로 제공하고 있습니다. zip으로 내보낸 뒤 로컬에서 압축을 풀고 열고, 복잡한 프로젝트는 공식 마이그레이션 안내에 따라 에이전트가 진행하게 하세요.
가져온 뒤 바로 할 네 가지 일
- 먼저 프로젝트를 읽게 하세요. 에이전트는 파일 구조와 함수 이름을 스캔하는데, 인덱싱이 끝나기 전에 작업을 맡기면 답이 빗나가기 쉽습니다.
- Git 상태를 확인하세요. 브랜치와 커밋되지 않은 변경 사항이 있는지 확인하고, 편집 전에 한 번 커밋해 두면 언제든 되돌릴 수 있습니다.
- .gemini 디렉터리를 확인하세요. 프로젝트 단위 설정이 이곳에 있습니다. 다른 컴퓨터로 옮길 때는 이 디렉터리도 함께 복사해야 하며, 코드만 복사하면 세션과 규칙이 사라집니다.
- 작은 작업으로 먼저 시험하세요. 입력창에 /plan을 입력해 에이전트가 먼저 계획을 세우게 하고, 계획이 괜찮으면 그때 코드를 수정하게 하세요.
빠지기 쉬운 세 가지 함정
- 드라이브 전체나 상위 폴더를 프로젝트로 열지 마세요. 무관한 폴더까지 컨텍스트로 취급되어 느려지고 잘못된 제안을 하기 쉽습니다.
- 세션은 폴더와 함께 이동하지 않습니다. 현재 공식 세션 마이그레이션 도구가 없어 경로를 바꾸거나 컴퓨터를 바꾸면 이전 대화를 가져오지 못할 수 있습니다. 중요한 결론은 먼저 문서에 적어 두세요.
- 여러 저장소를 쓰는 프로젝트는 다중 폴더 작업 공간을 쓰세요. 경로가 다른 저장소는 각각 권한을 따로 설정할 수 있어 하나의 루트에 억지로 넣을 필요가 없습니다.