Antigravity がインストールできない・動かない：エラー別の解決ガイド

Antigravity を使い始めようとしたとき、インストールで躓いたり、起動直後にエラーが出たりすることがあります。「やっと試せると思ったのにすぐ壁にぶつかった」という経験は、誰にでもあることです。

ここではAntigravity のセットアップ時によく起きる問題をエラーの種類別に整理し、それぞれの解決策をできるだけシンプルに説明します。

インストール前に確認しておくこと

トラブルシューティングの前に、基本的な動作要件を確認しておきましょう。

対応OS:

• macOS 12 (Monterey) 以降
• Windows 10 / 11（64ビット）
• Linux（Ubuntu 20.04以降 / Debian系）

必要なもの:

• Node.js 18 以上（推奨: 20.x LTS または 22.x）
• 安定したインターネット接続
• Antigravity アカウント（antigravity.ai で作成）

# Node.js のバージョン確認
node --version  # v20.x.x 以上であること
 
# npm のバージョン確認
npm --version

よくあるインストールエラーと解決法

エラー1：EACCES / Permission denied（権限エラー）

症状:

npm error EACCES: permission denied, access '/usr/local/lib/node_modules'

原因: グローバルインストール時にシステムディレクトリへの書き込み権限がありません。

解決法（推奨）: nvm（Node Version Manager）を使ってNode.jsを管理する方法が最も安定しています。

# nvm のインストール（macOS / Linux）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
 
# nvm を使って Node.js をインストール
nvm install 20
nvm use 20
 
# その後 Antigravity をインストール
npm install -g antigravity

Windowsの場合: 「管理者として実行」でターミナル（PowerShell）を開いて再試行してください。

エラー2：ENOENT / Module not found（モジュール未検出）

症状:

Error: Cannot find module 'xxx'

原因: 依存パッケージが正しくインストールされていません。

解決法:

# キャッシュをクリアしてから再インストール
npm cache clean --force
npm install -g antigravity@latest

それでも解決しない場合は、一度アンインストールしてから再インストールします。

npm uninstall -g antigravity
npm install -g antigravity

エラー3：Node.js バージョン不一致

症状:

Error: The engine "node" is incompatible with this module.
Expected version ">=18.0.0". Got "16.x.x"

解決法: Node.js を更新します。

# nvm を使っている場合
nvm install 20
nvm use 20
nvm alias default 20
 
# バージョン確認
node --version  # v20.x.x と表示されれば OK

エラー4：ネットワーク接続エラー

症状:

npm error network request to https://registry.npmjs.org failed
npm error ETIMEDOUT

原因: ファイアウォール、プロキシ、またはVPNによる接続ブロック。

解決法:

# VPN を無効にして再試行
# プロキシが必要な環境では：
npm config set proxy http://your-proxy:8080
npm config set https-proxy http://your-proxy:8080
 
# npmレジストリを変更して試す
npm config set registry https://registry.npmmirror.com
npm install -g antigravity

エラー5：SSL 証明書エラー

症状:

npm error code UNABLE_TO_GET_ISSUER_CERT_LOCALLY

原因: 企業のセキュリティソフトが SSL インスペクションを行っている可能性があります。

一時的な回避策（セキュリティリスクに注意）:

npm config set strict-ssl false
npm install -g antigravity
# インストール後は戻す
npm config set strict-ssl true

企業ネットワークをお使いの場合は、IT部門に相談することをお勧めします。

起動・認証時のエラー

認証が通らない

症状: antigravity login を実行してもログインできない、またはブラウザが開かありません。

対処法:

1. デフォルトブラウザが設定されているか確認する
2. ポップアップブロッカーを無効にする
3. ブラウザで直接 antigravity.ai を開いてログインし、その後 CLI でトークンを手動設定する

# トークンを直接設定する方法
antigravity config set token YOUR_AUTH_TOKEN

起動後に「Workspace not found」

症状: antigravity を起動すると「Workspace not found」と表示されます。

原因: カレントディレクトリがAntigravityのワークスペースとして認識されていません。

対処法:

# プロジェクトディレクトリに移動してから起動
cd /your/project/directory
antigravity
 
# または、ワークスペースを初期化
antigravity init

「API quota exceeded」が起動直後に出る

原因: アカウントの API クォータが消費済み、またはトライアル期間が終了しています。

対処法:

1. antigravity.ai にログインしてクォータ使用状況を確認
2. プランをアップグレードするか、翌日のクォータリセットを待つ

VS Code 拡張機能のトラブル

Antigravity を VS Code 拡張として使っている場合の問題です。

拡張機能が反応しない:

1. VS Code を完全に再起動する
2. 拡張機能の「無効化」→「有効化」を試す
3. 拡張機能を一度アンインストールして再インストールする

拡張機能の更新方法:

VS Code → 拡張機能タブ → Antigravity を検索 → 「更新」をクリック

全体を振り返って：問題別チェックリスト

解決できない場合は、以下の順で確認してみてください。

1. Node.js のバージョンは 18 以上か
2. インターネット接続は正常か（VPN・プロキシの影響を確認）
3. npm キャッシュをクリアして再インストールしたか
4. アカウントのクォータは残っているか
5. 認証トークンは有効か

それでも解決しない場合は、Antigravity のサポートページ またはコミュニティフォーラムに問い合わせてみてください。開発者コミュニティも活発で、同じ問題を経験した方からのヒントが見つかることも多いです。

初めての設定は誰でも時間がかかります。焦らず一つひとつ確認していただければ、必ず使えるようになります。