移行の作業を始めたのは、普段使っているエディタをいったん閉じ、拡張機能の一覧をテキストに書き出した夜でした。リストは思っていたより長く、半分以上は何のために入れたのか思い出せません。
最初のうちは、設定のインポート機能に任せれば全部が元どおりになるものだと考えておりました。結果は芳しくありませんでした。見た目と操作感は引き継がれたのに、いつも使っていた拡張機能がいくつか見つからず、手が止まったのです。
最初にお伝えしたいのは、Antigravity は VS Code のコードベースから派生した IDE なので、設定とキーバインドはほぼそのまま持ち込めるが、拡張機能の入手先が違うという点です。この違いを先に知っておくだけで、移行の作業はずいぶん落ち着いて進められます。
引き継がれるものと、引き継がれないもの
ファイルエクスプローラー、統合ターミナル、ソース管理パネル、デバッガー、タスクランナー、設定の仕組みは、VS Code と同じ感覚で扱えます。カスタムしたキーバインドも、keybindings.json を渡せばそのまま動きます。手に染みついたショートカットを一から覚え直す必要がないのは、ありがたいところです。
一方で、同じ見た目をしていても中身が違う部分があります。
- 拡張機能の入手先(Visual Studio Marketplace ではなく OpenVSX を使います)
- Microsoft 製の一部拡張機能(ライセンスの都合で使えないものがあります)
- Antigravity 固有の機能(エージェントパネルや Manager Surface など、VS Code にはない画面)
VS Code に GitHub Copilot を足した環境と比べると、Antigravity はエージェントがファイルシステムやターミナル、ブラウザまで触れる点が大きく違います。計画、実装、検証を一続きで任せられるぶん、設定の引き継ぎが甘いと、その違いを試す前に環境づくりで疲れてしまいます。
移行前の棚卸し
作業の前に、現在の環境を書き出しておきます。元に戻したくなったときの保険にもなります。
# インストール済み拡張機能の一覧を書き出す
code --list-extensions > ~/vscode-extensions.txt
# Linux の場合
cp ~/.config/Code/User/settings.json ~/vscode-settings-backup.json
cp ~/.config/Code/User/keybindings.json ~/vscode-keybindings-backup.json
# macOS の場合
cp ~/Library/Application\ Support/Code/User/settings.json ~/vscode-settings-backup.json
cp ~/Library/Application\ Support/Code/User/keybindings.json ~/vscode-keybindings-backup.json私の場合、書き出した一覧を一行ずつ眺めて、「毎週使う」「たまに使う」「理由を思い出せない」の三つに分けました。理由を思い出せないものは、移行先には持っていかないことにしています。結果として、新しい環境は元より軽くなりました。
入れる理由を言えない拡張機能は、移行のついでに手放します。 この線引きは、いまも新しい環境を作るたびに守っております。
Antigravity の入手と初回起動
Antigravity は公式サイト antigravity.google からダウンロードでき、Windows、macOS、Linux に対応しています。初回の起動時には Google アカウントでのログインを求められます。
プレビュー期間中の無料枠や利用条件は、時期によって変わる可能性があります。導入を決める前に、公式サイトの最新の案内をご確認いただければ幸いです。
設定の引き継ぎ方
自動インポートを使う
初回のセットアップウィザードに、既存のエディタから取り込むオプションがあります。
- Antigravity を起動し、セットアップウィザードを開きます
- 「Import from VS Code」を選びます
- 設定、キーバインド、拡張機能の候補が検出されます
- 取り込む項目を選んで「Continue」を押します
多くの方には、この方法で足ります。ただ、取り込まれなかった項目があっても画面上ではよく分からないので、後で必ず差分を確認してください。
手動で settings.json を移す
インポートで落ちた設定は、手でコピーします。Antigravity の Settings から Open Settings (JSON) を開いて貼り付けるだけです。
{
"editor.fontSize": 14,
"editor.tabSize": 2,
"editor.wordWrap": "on",
"editor.formatOnSave": true,
"editor.minimap.enabled": false,
"terminal.integrated.fontSize": 13,
"files.autoSave": "afterDelay",
"workbench.colorTheme": "One Dark Pro"
}VS Code の設定キーのうち、Antigravity が知らないものは無視されます。そのため、貼り付けて何かが壊れる心配はほとんどありません。
キーバインドを移す
keybindings.json は、VS Code のものをそのままコピーして使えます。Antigravity 固有の画面を呼び出すキーを足したい場合は、次のように書きます。コマンド名はバージョンで変わることがあるので、コマンドパレットで実際の名前を確かめてから登録してください。
[
{
"key": "cmd+shift+a",
"command": "antigravity.openAgentPanel"
},
{
"key": "cmd+shift+m",
"command": "antigravity.openManagerSurface"
}
]拡張機能で引っかかる場所
OpenVSX を使うという違い
Antigravity は、Microsoft の Visual Studio Marketplace を使いません。Marketplace の利用規約が Visual Studio 系の製品に限られているためで、代わりに Eclipse Foundation が運営する OpenVSX レジストリが使われます。
人気のある拡張機能の多くは OpenVSX にも載っています。けれども、Microsoft 独自の拡張機能や、公開者が OpenVSX への登録をしていないものは見つかりません。
使えなくなりやすい拡張機能
次の拡張機能は、Antigravity では直接使えないか、代替が必要になります。
- C# Dev Kit: ライセンスの制約により、VS Code 以外のフォークでは利用できません
- Live Share: Microsoft のサービスに依存するため、使えません
- Remote - SSH(Microsoft 版): Open Remote SSH などの代替拡張機能で補います
- GitHub Copilot: Gemini ベースの AI が内蔵されているため、そもそも不要です
壁紙アプリの開発で Kotlin や Swift を触る私の環境では、この一覧に当てはまる拡張機能はほとんどありませんでした。一方で、.NET を日常的に書いている方は、C# Dev Kit の可否が移行の判断を左右するかもしれません。
VSIX ファイルで手動導入する
OpenVSX に無い拡張機能でも、VSIX ファイルを入手できれば手で入れられます。
# macOS の場合
/Applications/Antigravity.app/Contents/Resources/app/bin/antigravity \
--install-extension path/to/extension.vsix
# Linux の場合
antigravity --install-extension path/to/extension.vsixここで一度つまずきました。code --install-extension は VS Code 専用のコマンドで、実行しても Antigravity には何も入りません。コマンドの名前を取り違えて、入ったはずの拡張機能が見当たらず、しばらく原因を探しました。Antigravity に入れるときは、必ず Antigravity 側の CLI を使ってください。
検索先を Marketplace に変える方法について
設定を変えて、拡張機能の検索先を Visual Studio Marketplace に向けることは技術的には可能とされています。ただ、Microsoft の利用規約に反する可能性があり、将来の更新で動かなくなることも考えられます。私自身はこの方法を使わず、OpenVSX と VSIX の組み合わせで運用しております。どうしても必要な場合は、規約を読んだうえで自己責任で判断していただければと思います。
併用という選び方
すべてのプロジェクトを移す必要はありません。得意な場面が違うので、分けて使うほうが現実的です。
Antigravity が向いているのは、次のような場面です。
- 新規プロジェクトの立ち上げ(雛形の生成をエージェントに任せられます)
- 大規模なリファクタリング(プロジェクト全体を見渡した提案が得られます)
- 原因の分からないバグの調査(ログの確認から修正案までを任せられます)
- 試作を急ぐとき(計画から実装までを一続きで進められます)
VS Code に残したほうがよいのは、こちらです。
- C# や .NET の開発(C# Dev Kit が必要な場合)
- Live Share を使った共同作業
- 特定の Microsoft 系拡張機能に依存した手順
- 軽いテキスト編集やメモ取り
ワークスペースの共有
同じプロジェクトフォルダを、両方のエディタで開けます。.vscode ディレクトリの設定は共有されるので、ワークスペース設定の大部分はそのまま効きます。Antigravity 固有の設定は .antigravity ディレクトリに保存されるため、Git で管理する場合は無視するかどうかをチームで決めておくと、後で揉めずに済みます。
# Antigravity 固有の設定(チームの方針に応じて)
.antigravity/Git 操作の任せ方
どちらのエディタにも Git の統合機能があります。Antigravity ではさらに、エージェントにコミットメッセージの作成やコンフリクトの解決を頼めます。
最新の変更をレビューして、適切なコミットメッセージを生成してください生成されたメッセージは、そのまま確定せず、必ず自分の目で一度読み直しています。差分の意図を知っているのは、結局のところ私だけだからです。
移行で詰まったときの対処
拡張機能が見つからない
OpenVSX で見つからないときは、次の順で当たります。
- Open VSX Registry を直接検索します
- 拡張機能の GitHub リポジトリから、VSIX をダウンロードします
- 代替の拡張機能を探します(オープンソースの代替があることが多いです)
テーマが反映されない
テーマの多くは OpenVSX にもありますが、一部は手動での導入になります。拡張機能パネルで、使っているテーマの名前を直接検索してください。One Dark Pro、Dracula Official、Tokyo Night、Catppuccin などは、検索で見つかることが多いはずです。
動作が重く感じる
AI 機能が常に動いているぶん、Antigravity は VS Code よりリソースを使う傾向があります。重さが気になるときは、まず次のような設定から試してください。設定キーはバージョンによって異なる場合があるため、設定画面で名前を確かめてから書き写すのが安全です。
{
"antigravity.ai.backgroundAnalysis": false,
"antigravity.ai.autoSuggestions": "onDemand",
"editor.minimap.enabled": false,
"files.watcherExclude": {
"**/node_modules/**": true,
"**/.git/**": true
}
}files.watcherExclude は VS Code 由来の設定なので、node_modules を大量に抱えるプロジェクトでは、AI 機能の設定よりも先にこちらが効きます。
日本語の表示と入力
日本語のメニュー表示には、Japanese Language Pack が必要です。拡張機能パネルで「Japanese」と検索すれば見つかります。入力まわりの設定は VS Code と同じ考え方で扱えます。
移行チェックリスト
最後に、手を動かす順番に並べました。私が確認する順番でもあります。
- バックアップ: 拡張機能の一覧、settings.json、keybindings.json を書き出します
- インストール: Antigravity をダウンロードして導入します
- インポート: 初回のウィザードで VS Code からの取り込みを実行します
- 拡張機能の確認: OpenVSX にあるかを調べ、足りない分は VSIX か代替で補います
- テーマの適用: 見慣れたテーマに戻して、目の疲れ方を揃えます
- AI 機能の確認: エージェントが正常に応答するかを小さな依頼で試します
- 実プロジェクトの確認: 普段のプロジェクトを開き、ビルド・デバッグ・テストが通るかを見ます
- 使い分けの決定: 併用する場合は、どのプロジェクトをどちらで開くかを決めます
まずは今日のうちに、現在の拡張機能の一覧を書き出して、「理由を言えないもの」に印を付けてみてください。そこまで済んでいれば、移行そのものは半日もかからない作業になるはずです。
持っていくものは、理由を言えるものだけに。 環境を移すたびに、この一文に立ち返るようにしています。