コンテキストを失わずにGoogle AntigravityからClaude Codeへ移行する方法（2026年）

ルール：Antigravityが読み込むものとClaude Codeが読み取るもの

Antigravityはルールを「コードベースにおけるAntigravityの動作を決定する、永続的な指示、コーディング標準、およびアーキテクチャ上の制約」と説明しています。ルールは、任意のディレクトリにあるAGENTS.mdやGEMINI.md、.agents/rules/内のルールファイル、および~/.gemini/配下のグローバルファイルなど、複数の場所から検出されます。また、これらは組み合わされます。「ルールは置き換えではなく累積的」であり、「指示が競合する場合、より具体的なディレクトリのルールが優先」されます。

Claude Codeの指示ファイルは、CLAUDE.mdファイルと.claude/rules/です。また、何かを追加する前に知っておくべき1つの条件を満たしていれば、AGENTS.mdを読み取ることもできます。ドキュメントによると、「デフォルトでは、Claudeは作業ディレクトリまたはその上位ディレクトリにCLAUDE.mdが存在しない場合にのみAGENTS.mdを読み取ります。」このチェックの対象となるファイルは、「作業ディレクトリまたはその上位ディレクトリにあるCLAUDE.md、.claude/CLAUDE.md、またはCLAUDE.local.md」です。

これにより、次の3つのケースを想定する必要があります。

• プロジェクトでAGENTS.mdのみを使用している場合。 CLAUDE.mdを追加しない限り、Claude Codeは変更なしでそれを読み取ります。
• 両方を使用したい場合。 Claude Codeには「Project instructions」設定があり、その値にclaude-md-and-agents-mdを指定すると、「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/に配置されます。

アクティベーションモードは1対1で対応しない

ここに、動作の変化の大部分が隠されています。Antigravityのモジュール化されたルールは、それぞれのフロントマターでtriggerを宣言し、その値はalways_on、model_decision、glob、manualの4つのいずれかになります。

Claude Codeのルールには2つの状態があります。「pathsフィールドのないルールは無条件にロードされ、すべてのファイルに適用されます。」pathsを持つルールは、「Claudeが一致するファイルに対してRead、Write、またはEditツールを使用するときにロードされます。」

そのため、マッピングは以下のようになります。

• always_on は、pathsを持たないルール、またはCLAUDE.md内のコンテンツになります。
• glob は、pathsを持つルールになります。Antigravityはパターンをglobsにカンマ区切りの文字列として記述します。Claude Codeの例では、これらをYAMLのエントリとしてpaths配下にリストするため、行をそのままコピーするのではなく書き換えてください。
• model_decision は興味深いものです。Antigravityはルールのパスと説明のみを事前に注入し、「タスクが説明と一致したときに、エージェントが必要に応じてルール全体を読み取ります。」Claude Codeにおける最も近い同等機能はスキル（skill）です。ドキュメントによると、スキルは「呼び出したとき、またはClaudeがプロンプトに関連していると判断したときにのみロードされます。」
• manual ルールは、言及したときにのみロードされます。Claude Codeでは、名前で呼び出すスキルが同じ役割を果たします。

移行する前にもう1つ、Antigravityの詳細を確認しておく価値があります。ルールファイルが「フロントマターを省略しているか、認識されないtrigger値（キャメルケースのalwaysOnやmodelDecisionなど）を指定している場合、Antigravityは警告なしにそのルールを破棄します。」リポジトリ内の一部のルールファイルは、これまで一度も有効になっていなかった可能性があります。これらをClaude Codeに移行すると、初めて有効化されることになります。

ファイル参照の動作の違い

どちらのツールでもルールから他のファイルを指し示すことができますが、その参照の扱い方が異なるため、コンテキストに含まれる内容が静かに変化する可能性があります。

Antigravityには2つの形式があります。@[label](path)は、プロンプトが評価されサイズ制限がチェックされる前に、「ターゲットファイルの内容をルールに直接インライン展開」します。プレーンな@filenameは何もインライン展開しません。Antigravityはパスを解決して書き換えるため、エージェントはファイルへの明確な参照を持つことができます。

Claude Codeには1つの形式があり、それはインポートを行います。「CLAUDE.mdファイルは、@path/to/import構文を使用して追加のファイルをインポートできます。インポートされたファイルは展開され、それを参照しているCLAUDE.mdとともに起動時にコンテキストにロードされます。」

つまり、Antigravityでは単なるポインタであった「check @src/db/schema.ts first」のような行は、CLAUDE.mdに配置されるとインポートになります。Claude Codeのドキュメントによると、@pathインポートはAGENTS.md内でも展開されるため、ファイルの内容が指示と一緒にロードされます。また、ドキュメントには回避策も示されています。パスをバッククォートで囲むことで、リテラルテキストとして保持できます。ルール内のプレーンな@filename参照を確認し、ファイルの内容をロードしたいのか、それとも名前だけを言及したいのかを1つずつ判断してください。

制限も異なります。Antigravityは24,000バイトを超えるルールファイルを切り詰め、すべてのalways-onルールを共有トークン予算内に収めます。これを超えると、最も大きいファイルがポインタに格下げされます。Claude Codeは「CLAUDE.mdファイルあたり200行未満を目指す」ことを推奨しており、「ファイルが長くなると、より多くのコンテキストを消費し、準拠度が低下する」と警告しています。Antigravityが静かに格下げしていた大きなalways-onルールを、無条件のルールとして移行すると、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から読み取ります。各スキルフォルダを対応する場所にコピーし、その説明（description）を確認してください。どちらのツールも、その説明を使用してスキルを適用するかどうかを判断するためです。

MCPサーバーはフォーマットの変更が必要

AntigravityはMCPサーバーを専用のファイルに保持します。ワークスペース用は.agents/mcp_config.json、グローバル用は~/.gemini/config/mcp_config.jsonです。リモートサーバーはserverUrlキーを使用します。

Claude Codeは、.mcp.jsonファイルを介してプロジェクトサーバーを共有します。そのドキュメントでは、リモートエントリについて具体的に説明されています。「urlはあるがtypeがないJSONエントリは設定エラーになります。なぜなら、Claude Codeはtypeがないエントリをstdioサーバーとして読み取るためです。」serverUrlキーについては記載されていないため、ファイルをそのままコピーするのではなく、各リモートエントリをurlと正しいtypeで書き換えてください。

会話とナレッジアイテムはAntigravityに残る

Antigravityはワークスペースごとに会話履歴を保持します。そのCLIドキュメントによると、「会話履歴のスコープを現在の作業ディレクトリに直接限定」します。会話の再開、名前変更、フォーク、削除が可能で、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 files」リストを確認することを推奨しています。また、パススコープのルールやサブディレクトリのファイルは必要に応じてロードされると説明されています。AGENTS.mdに依存している場合は、/memoryを実行してそのパスを探すことも推奨されています。Claude Codeにプロジェクトの指示を要約させ、その回答を棚卸しリストと比較してください。

2つのファイルが矛盾するガイダンスを提供している場合は、どちらかに依存する前に修正してください。Claude Codeは「2つの指示が互いに矛盾している場合、Claudeはどちらかを任意に選択する可能性がある」と警告しています。競合するCLAUDE.mdレイヤーを調整するためのガイドで、その手順を解説しています。

手動での移行はルールを移動させます。しかし、Antigravityの会話の中にあった推論プロセスは移行されず、プロジェクトの知識は現在のエージェントが読み取るファイルフォーマットに縛られたままになります。

ルールファイルは、エージェントに何をすべきかを指示するのには適しています。しかし、なぜそうするのか（決定の履歴、却下されたアプローチ、規約の背景にあるコンテキストなど）を保持するのにはあまり適していません。エージェントが作成した指示ファイルを無視する理由で別の角度から説明しているように、ツールを変更すると、そうした知識は失われがちです。

MemoryLakeはそのために構築されています。一度保存すれば、使用するすべてのコーディングエージェントに接続できるメモリレイヤーです。

エントリはあなた自身の言葉で作成します。Antigravityのデータ、Claude Codeの設定、またはベンダーのストアから何かが読み取られたり、書き込まれたり、削除されたりすることはありません。コードが雇用主やクライアントに帰属する場合は、プロジェクトの詳細を他の場所にコピーする前に、彼らのポリシーを確認してください。

ステップ1：APIキーを作成する

サインインし、ダッシュボードからキーを生成します。このキーはMemoryLakeのワークスペースに属し、GoogleやAnthropicのアカウントとは別個のものです。

ステップ2：最初のメモリをアップロードする

ステップ1でAntigravityの会話から書き留めた決定事項から始めましょう。1つのエントリにつき1つの決定事項とし、日付、理由、および影響を受けるコードベースの部分を記載します。

ステップ3：AIとエージェントを接続する

Claude Codeや、その他に使用しているエージェントを接続します。これにより、すべてのツールのファイルフォーマットに書き換えることなく、同じプロジェクトの決定事項をそれぞれのツールで利用できるようになります。

第1の違いは、ルールと理由が分離されることです。ルールはClaude CodeがロードするCLAUDE.md、.claude/rules/、およびスキルに留まります。理由は、どのエージェントからでも見つけられる場所に配置されます。

第2に、次の移行作業がより小規模になります。コーディングエージェントが実際に読み取るもので説明しているように、指示のフォーマットは変化し続けます。これらのフォーマットの外部に保持された決定事項は、再度翻訳する必要がありません。

第3に、同じ説明を繰り返す必要が減ります。Claude Codeはセッションごとに指示ファイルから開始します。すでに解決したコンテキストについて何度も質問してくる場合は、Claude Codeがプロジェクトのコンテキストを忘れる問題で一般的な原因を解説しています。

第4に、スキルライブラリがすっきりします。スキルは手順であり、メモリではありません。この区別については、エージェントのスキルがメモリではない理由で説明しています。決定事項をスキルから排除することで、各スキルを1つのタスクに集中させることができます。

最初にAGENTS.mdについて決定する。 CLAUDE.mdを追加すると、Claude Codeがそれを読み取るかどうかが変わります。

GEMINI.mdにコンテンツを残さない。 Claude Codeのドキュメントには記載されていません。

トリガーを慎重にマッピングする。 globはpathsになり、model_decisionは通常スキルになります。

@参照を監査する。 Antigravityにおけるポインタは、Claude Codeでは完全なインポートになります。

フロントマターが壊れているルールを確認する。 Antigravityはそれらを一度もロードしていなかった可能性があります。

MCPエントリを書き換える。 .mcp.jsonでurlとtypeを使用します。

会話から決定事項を書き留める。 これらは自動的には移行されません。

Antigravityのセットアップの大部分は、Claude Codeに移行先があります。CLAUDE.mdが存在しない場合はAGENTS.mdをそのまま読み取ることができ、スキルは同じオープン標準に従い、MCPサーバーはフォーマットの変更が必要です。重要な違いはより静かな部分にあります。GEMINI.mdはClaude Codeのリストに含まれておらず、アクティベーショントリガーはpathsとスキルに集約され、Antigravityでは単なるポインタであったプレーンな@filenameはClaude Codeではインポートになります。

会話やナレッジアイテムは移行されずに残ります。これらを確認し、そこに含まれる決定事項を書き留め、特定のエージェントのファイルフォーマットに依存しない場所にそれらの決定事項を保持してください。