컨텍스트 손실 없이 Google Antigravity에서 Claude Code로 마이그레이션하는 방법 (2026)

규칙: Antigravity가 로드하는 것과 Claude Code가 읽는 것

Antigravity는 규칙을 "코드베이스에서 Antigravity가 작동하는 방식을 형성하는 영구적인 지침, 코딩 표준 및 아키텍처 제약 조건"으로 정의합니다. Antigravity는 여러 위치에서 규칙을 찾아냅니다: 모든 디렉터리의 AGENTS.md 또는 GEMINI.md, .agents/rules/ 내의 규칙 파일, 그리고 ~/.gemini/ 아래의 글로벌 파일입니다. 또한 이 규칙들을 결합합니다. "규칙은 대체 방식이 아니라 누적 방식"이며, "지침이 충돌할 때는 더 구체적인 디렉터리 규칙이 우선합니다."

Claude Code의 지침 파일은 CLAUDE.md 파일과 .claude/rules/입니다. 또한 한 가지 조건만 만족하면 AGENTS.md도 읽을 수 있습니다. 공식 문서에 따르면 "기본적으로 Claude는 작업 디렉터리나 그 상위 디렉터리에 CLAUDE.md가 없을 때만 AGENTS.md를 읽습니다." 이 검사에 해당하는 파일은 "작업 디렉터리 또는 그 상위 디렉터리에 있는 CLAUDE.md, .claude/CLAUDE.md 또는 CLAUDE.local.md"입니다.

이에 따라 다음과 같은 세 가지 시나리오를 계획할 수 있습니다:

• 프로젝트에서 AGENTS.md만 사용하는 경우. CLAUDE.md를 추가하지 않는 한, Claude Code는 변경 없이 이 파일을 읽습니다.
• 둘 다 사용하고 싶은 경우. Claude Code에는 claude-md-and-agents-md라는 값을 가진 프로젝트 지침(Project instructions) 설정이 있어 "CLAUDE.md와 AGENTS.md 파일을 함께 읽도록" 할 수 있습니다. 또는 CLAUDE.md에서 AGENTS.md를 임포트할 수도 있습니다.
• 프로젝트가 GEMINI.md에 의존하는 경우. Claude Code의 메모리 문서에는 읽는 파일 목록에 GEMINI.md가 포함되어 있지 않습니다. 여기에만 존재하는 모든 내용은 다른 곳으로 이동해야 합니다.

글로벌 규칙에도 동일한 구분이 적용됩니다. Antigravity의 독립형 글로벌 파일에는 ~/.gemini/AGENTS.md 및 ~/.gemini/GEMINI.md가 포함됩니다. Claude Code의 개인용 파일은 ~/.claude/CLAUDE.md이며, 개인용 규칙은 ~/.claude/rules/에 위치합니다.

활성화 모드가 일대일로 매핑되지 않음

이 부분에서 대부분의 동작 변화가 숨어 있습니다. Antigravity의 모듈식 규칙은 프런트매터(frontmatter)에 always_on, model_decision, glob, manual의 네 가지 값 중 하나로 trigger를 선언합니다.

Claude Code의 규칙은 두 가지 상태를 가집니다. "paths 필드가 없는 규칙은 무조건 로드되어 모든 파일에 적용됩니다." paths가 있는 규칙은 "Claude가 일치하는 파일에 대해 Read, Write 또는 Edit 도구를 사용할 때 로드됩니다."

따라서 매핑은 다음과 같이 이루어집니다:

• always_on은 paths가 없는 규칙이 되거나 CLAUDE.md 내의 콘텐츠가 됩니다.
• glob은 paths가 있는 규칙이 됩니다. Antigravity는 패턴을 globs에 쉼표로 구분된 문자열로 작성합니다. Claude Code의 예시에서는 이를 paths 아래에 YAML 항목으로 나열하므로, 라인을 그대로 복사하지 말고 다시 작성해야 합니다.
• model_decision은 흥미로운 부분입니다. Antigravity는 처음에 규칙의 경로와 설명만 주입하며, "에이전트는 작업이 설명과 일치할 때 필요에 따라 전체 규칙을 읽습니다." Claude Code에서 이와 가장 유사한 것은 스킬(skill)입니다. 문서에 따르면 스킬은 "사용자가 호출하거나 Claude가 프롬프트와 관련이 있다고 판단할 때만 로드됩니다."
• manual 규칙은 명시적으로 언급할 때만 로드됩니다. Claude Code에서는 이름으로 호출하는 스킬이 동일한 역할을 수행합니다.

이전하기 전에 Antigravity의 세부 사항을 하나 더 확인하는 것이 좋습니다. 규칙 파일이 "프런트매터를 생략하거나 인식할 수 없는 trigger 값(예: 카멜 케이스인 alwaysOn 또는 modelDecision)을 지정하면, Antigravity는 경고 없이 해당 규칙을 무시합니다." 저장소의 일부 규칙 파일은 한 번도 활성화되지 않았을 수 있습니다. 이를 Claude Code로 포팅하면 처음으로 활성화될 수 있습니다.

파일 참조가 다르게 작동함

두 도구 모두 규칙이 다른 파일을 가리키도록 할 수 있지만, 참조를 처리하는 방식이 다르며, 이로 인해 컨텍스트에 포함되는 내용이 조용히 달라질 수 있습니다.

Antigravity에는 두 가지 형태가 있습니다. @[label](path)는 프롬프트가 평가되고 크기 제한이 확인되기 전에 "대상 파일의 내용을 규칙에 직접 인라인(inline)으로 삽입"합니다. 일반 @filename은 아무것도 인라인화하지 않습니다. Antigravity는 경로를 확인하고 에이전트가 파일에 대해 명확한 참조를 가질 수 있도록 이를 다시 작성합니다.

Claude Code는 한 가지 형태를 가지며, 이는 임포트(import) 방식입니다. "CLAUDE.md 파일은 @path/to/import 구문을 사용하여 추가 파일을 임포트할 수 있습니다. 임포트된 파일은 실행 시 이를 참조하는 CLAUDE.md와 함께 확장되어 컨텍스트에 로드됩니다."

즉, Antigravity에서는 단순한 포인터였던 "check @src/db/schema.ts first"와 같은 라인이 CLAUDE.md에 들어가면 임포트가 됩니다. Claude Code 문서에 따르면 @path 임포트는 AGENTS.md 내부에서도 확장되므로, 파일의 내용이 지침과 함께 로드됩니다. 또한 문서에서는 해결책도 제시합니다. 경로를 백틱(backticks)으로 감싸면 리터럴 텍스트로 유지됩니다. 규칙을 살펴보며 일반 @filename 참조가 있는 부분을 확인하고, 파일 내용을 로드할지 아니면 이름만 언급할지 하나씩 결정하세요.

제한 사항도 다릅니다. Antigravity는 24,000바이트를 초과하는 규칙 파일을 잘라내고, 공유 토큰 예산 내에서 모든 상시 활성화(always-on) 규칙을 유지하며, 예산을 초과하면 가장 큰 파일을 포인터로 강등합니다. Claude Code는 "CLAUDE.md 파일당 200줄 미만을 목표로 할 것"을 권장하며 "파일이 길어질수록 더 많은 컨텍스트를 소비하고 준수율이 떨어집니다"라고 경고합니다. Antigravity가 조용히 강등시키고 있던 대규모 상시 활성화 규칙을 무조건적인 규칙으로 포팅하면, Claude Code에서는 실행 시 그대로 로드됩니다.

스킬은 거의 그대로 이동함

스킬은 가장 쉬운 부분입니다. Antigravity는 "스킬은 에이전트 기능을 확장하기 위한 개방형 표준"이라고 설명하며, Claude Code는 자사의 스킬이 "여러 AI 도구에서 작동하는 Agent Skills 개방형 표준을 따릅니다"라고 설명합니다. 둘 다 SKILL.md 파일과 YAML 프런트매터가 있는 폴더를 사용합니다.

변경되는 것은 위치입니다. Antigravity는 기본적으로 작업 공간의 .agents/skills/를 사용하며, 글로벌 스킬은 ~/.gemini/ 아래에 둡니다. Claude Code는 프로젝트 스킬을 .claude/skills/<skill-name>/SKILL.md에서 읽고, 개인용 스킬은 ~/.claude/skills/<skill-name>/SKILL.md에서 읽습니다. 각 스킬 폴더를 일치하는 위치로 복사하고 설명을 확인하세요. 두 도구 모두 설명을 사용하여 스킬 적용 시점을 결정하기 때문입니다.

MCP 서버는 형식 변경이 필요함

Antigravity는 MCP 서버를 전용 파일에 보관합니다: 작업 공간의 경우 .agents/mcp_config.json, 글로벌의 경우 ~/.gemini/config/mcp_config.json입니다. 원격 서버는 serverUrl 키를 사용합니다.

Claude Code는 .mcp.json 파일을 통해 프로젝트 서버를 공유합니다. 공식 문서는 원격 항목에 대해 구체적으로 설명합니다: "type 없이 url만 있는 JSON 항목은 구성 오류입니다. Claude Code는 type이 없는 항목을 stdio 서버로 읽기 때문입니다." 여기에는 serverUrl 키에 대한 설명이 없으므로, 파일을 그대로 복사하지 말고 각 원격 항목을 올바른 type과 url로 다시 작성해야 합니다.

대화 및 지식 항목은 Antigravity에 남음

Antigravity는 작업 공간별로 대화 기록을 유지합니다. CLI 문서에 따르면 "대화 기록의 범위를 현재 작업 디렉터리로 직접 제한"합니다. 대화를 재개, 이름 변경, 포크(fork), 삭제할 수 있으며, CLI는 Antigravity 2.0 앱에서 시작된 스레드를 가져올 수 있습니다. 에이전트의 로컬 데이터 디렉터리인 ~/.gemini/antigravity/에는 "아티팩트, 지식 항목 등이 포함되어 있습니다."

Antigravity 문서는 Antigravity 내부에서 해당 기록을 관리하는 방법을 설명합니다. 다른 도구로 대화나 지식 항목을 내보내는 방법은 설명되어 있지 않으며, Claude Code 문서에도 이를 가져오는 방법은 나와 있지 않습니다. 두 항목 모두 이동할 수 있는 파일이 아니라, 읽고 요약해야 할 자료로 취급하세요.

1단계: Antigravity가 실제로 로드하는 항목을 인벤토리화하고 각 요소의 이동 위치 결정

저장소와 홈 디렉터리에 있는 모든 지침 소스를 나열하세요: 각 AGENTS.md 및 GEMINI.md, .agents/rules/에 있는 모든 파일과 해당 trigger, ~/.gemini/ 아래의 글로벌 파일, 스킬, 그리고 MCP 구성입니다. 2.0 앱, CLI, IDE가 각각 자체 글로벌 위치를 문서화하고 있으므로 어떤 인터페이스를 사용하는지 기록해 두세요.

그런 다음 각 항목을 분류합니다:

• 여러 도구를 계속 사용할 계획이라면 모든 에이전트가 읽어야 하는 공유 프로젝트 규칙은 AGENTS.md에 두고, Claude Code만 사용할 계획이라면 CLAUDE.md에 둡니다.
• Gemini 전용이 아닌 GEMINI.md 콘텐츠는 이 중 하나로 이동합니다.
• glob 규칙은 paths가 있는 .claude/rules/ 파일이 됩니다.
• model_decision 및 manual 규칙은 스킬이 됩니다.
• 프런트매터가 손상된 규칙은 수정하여 유지할지 아니면 삭제할지 결정합니다.

마지막으로, 최근 Antigravity 대화를 열고 규칙에 반영되지 않은 결정 사항들을 기록해 두세요: 특정 라이브러리를 선택한 이유, 거부된 접근 방식, 까다로운 모듈이 가정하는 사항 등입니다. Cursor에서도 마이그레이션하는 경우, Cursor 규칙을 Claude Code로 이동하는 가이드에서 Cursor 규칙에 대한 동일한 분류 방법을 다룹니다.

2단계: Claude Code 형식으로 지침, 스킬, 서버를 재구축하고 로드되는 항목 확인

새 파일을 작성합니다. CLAUDE.md는 짧게 유지하고 특정 주제에 관한 내용은 규칙이나 스킬로 이동하세요. 일반 @filename 참조는 의도적인 임포트 또는 리터럴 텍스트로 다시 작성합니다. 스킬 폴더를 .claude/skills/로 복사합니다. MCP 항목은 url과 type을 포함하여 .mcp.json으로 다시 작성합니다.

그런 다음 검증합니다. Claude Code의 트러블슈팅 가이드에서는 /context를 실행하고 시작 시 로드되는 파일에 대한 Memory 파일 목록을 확인할 것을 권장하며, 경로 범위 규칙 및 하위 디렉터리 파일은 필요에 따라 로드된다고 명시하고 있습니다. AGENTS.md에 의존하는 경우, /memory를 실행하고 해당 경로를 찾아볼 것을 권장합니다. Claude Code에 프로젝트 지침을 요약해 달라고 요청하고 그 답변을 인벤토리와 비교해 보세요.

두 파일이 서로 충돌하는 지침을 제공하는 경우, 어느 하나에 의존하기 전에 이를 수정하세요. Claude Code는 "두 지침이 서로 모순되는 경우, Claude가 임의로 하나를 선택할 수 있다"고 경고합니다. 충돌하는 CLAUDE.md 레이어 조정 가이드에서 이 과정을 자세히 설명합니다.

수동 마이그레이션은 규칙을 이동시킵니다. 하지만 Antigravity 대화에 존재했던 추론 과정은 이동시키지 못하며, 프로젝트 지식을 현재 에이전트가 읽는 파일 형식에 종속시킵니다.

규칙 파일은 에이전트에게 무엇을 해야 하는지 알려주는 데 유용합니다. 하지만 결정 이력, 거부된 접근 방식, 컨벤션 뒤에 숨겨진 맥락과 같은 '이유'를 담아두는 데는 덜 효과적입니다. 에이전트가 작성된 지침 파일을 무시하는 이유에서 다른 관점으로 다루었듯이, 도구를 변경할 때 이러한 지식은 유실되기 쉽습니다.

MemoryLake는 바로 이를 위해 구축되었습니다. 한 번만 보관하면 사용하는 모든 코딩 에이전트에 연결할 수 있는 메모리 레이어입니다.

사용자가 직접 자신의 언어로 항목을 작성합니다. Antigravity 데이터, Claude Code 구성 또는 다른 벤더의 저장소에서 아무것도 읽거나 쓰거나 삭제하지 않습니다. 코드가 고용주나 고객의 소유인 경우, 프로젝트 세부 정보를 다른 곳에 복사하기 전에 해당 보안 정책을 확인하세요.

1단계: API 키 생성

로그인하고 대시보드에서 키를 생성합니다. 이 키는 Google 및 Anthropic 계정과 별개로 MemoryLake 작업 공간에 속합니다.

2단계: 첫 번째 메모리 업로드

1단계에서 Antigravity 대화로부터 기록해 둔 결정 사항들로 시작하세요. 날짜, 이유, 코드베이스에서 영향을 받는 부분을 포함하여 하나의 결정 사항당 하나의 항목으로 작성합니다.

3단계: AI 및 에이전트 연결

Claude Code 및 사용하는 다른 에이전트를 연결합니다. 그러면 각 도구의 파일 형식으로 다시 작성할 필요 없이 동일한 프로젝트 결정 사항을 모든 도구에서 사용할 수 있습니다.

첫 번째 차이점은 규칙과 이유가 분리된다는 것입니다. 규칙은 Claude Code가 로드하는 CLAUDE.md, .claude/rules/ 및 스킬에 유지됩니다. 이유는 모든 에이전트가 찾을 수 있는 곳에 보관됩니다.

두 번째는 다음 마이그레이션 규모가 작아진다는 점입니다. 코딩 에이전트가 실제로 읽는 것에서 설명했듯이 지침 형식은 계속 변합니다. 이러한 형식 외부에서 유지되는 결정 사항들은 다시 번역할 필요가 없습니다.

세 번째는 반복적인 설명이 줄어든다는 점입니다. Claude Code는 각 세션을 지침 파일에서 시작합니다. 이미 해결된 컨텍스트에 대해 계속 질문하는 경우, Claude Code가 프로젝트 컨텍스트를 잊어버리는 현상 가이드에서 일반적인 원인을 다룹니다.

네 번째는 더 깔끔한 스킬 라이브러리입니다. 스킬은 메모리가 아니라 절차(procedure)이며, 이 차이점은 에이전트 스킬이 메모리가 아닌 이유에서 다룹니다. 스킬에서 결정 사항을 제외하면 각 스킬을 하나의 작업에 집중시킬 수 있습니다.

AGENTS.md에 대해 먼저 결정하세요. CLAUDE.md를 추가하면 Claude Code가 이를 읽을지 여부가 달라집니다.

GEMINI.md에 콘텐츠를 남겨두지 마세요. Claude Code 문서에는 이 파일이 나열되어 있지 않습니다.

트리거를 신중하게 매핑하세요. glob은 paths가 되고, model_decision은 보통 스킬이 됩니다.

@ 참조를 감사하세요. Antigravity의 포인터는 Claude Code에서 전체 임포트가 됩니다.

손상된 프런트매터가 있는 규칙을 확인하세요. Antigravity가 이를 로드하지 않았을 수 있습니다.

MCP 항목을 다시 작성하세요. .mcp.json에서 type과 함께 url을 사용하세요.

대화에서 결정된 사항들을 기록해 두세요. 이들은 자동으로 이동하지 않습니다.

Antigravity 설정의 대부분은 Claude Code에 정착할 수 있습니다. CLAUDE.md가 없을 때는 AGENTS.md를 그대로 읽을 수 있고, 스킬은 동일한 개방형 표준을 따르며, MCP 서버는 형식 변경이 필요합니다. 중요한 차이점은 더 미묘합니다: GEMINI.md는 Claude Code의 지원 목록에 없고, 활성화 트리거는 paths와 스킬로 축소되며, Antigravity에서 단순한 포인터였던 일반 @filename은 Claude Code에서 임포트가 됩니다.

대화 및 지식 항목은 남겨집니다. 이를 읽어보고 포함된 결정 사항들을 기록한 다음, 특정 에이전트의 파일 형식에 의존하지 않는 곳에 보관하세요.