設定を変える前に Antigravity のエラーを切り分ける
Antigravity が動かない、という状態には複数の原因があります。モデルサービスやアカウント、ネットワークが原因のこともあれば、Node.js がない、PATH が違う、PowerShell のポリシー、MCP サーバー、古いインストールが原因のこともあります。
まず表示されたエラー文をそのまま控え、どの画面で出るかを確認します。起動できないならインストーラー、OS、セキュリティソフトを見ます。ログインが戻るならブラウザ、Cookie、時刻、プロキシを見ます。Agent が止まるならモデル、クォータ、MCP、コンテキスト、ネットワークを見ます。ターミナルの失敗なら PATH、Node.js、npx、npm、シェルポリシーを見ます。
| 症状 | 考えられる原因 | 最初の対処 |
|---|---|---|
| Agent execution terminated due to error | 一時的なモデル経路、セッション、ネットワーク不安定、MCP クラッシュ、コンテキスト上限。 | Agent を再起動し、空に近い workspace で短い prompt を試します。動く場合だけ MCP を疑います。 |
| Model API cannot be reached | Firewall、proxy、DNS、未対応地域、期限切れログイン、サービス側の状態。 | ログインを確認し、信頼できる別ネットワークで試し、Google AI endpoint を許可します。 |
| exec: "npx": executable file not found in PATH | Antigravity が通常ターミナルと違う環境を継承している、または Node.js がない。 | Node.js LTS を入れ、外部ターミナルで npx を確認し、ユーザーまたはシステム PATH を直します。 |
| PowerShell execution policy is blocking npx | Windows のポリシーが npm の shim script をブロックしている。 | 承認済みのポリシー変更だけを使うか、MCP コマンドを互換性のある呼び出しにします。 |
| Installer は開くがアプリが起動しない | アーキテクチャ違い、古いプロセス、未対応 OS、セキュリティソフト、破損したフォルダ。 | 要件を確認し、プロセスを閉じ、x64、ARM64、Apple Silicon、Intel、apt、dnf の正しい build を入れます。 |
よくある失敗に効く基本修正
アプリは開くのに機能が失敗する場合は、まず更新します。古い build でもエディタ画面は開くことがありますが、Agent、補完、ログインが失敗することがあります。更新後は通常のランチャーから開き、About でバージョンを確認します。
設定を大きく変える前に Agent を再起動します。小さなフォルダで短い prompt を実行してください。それも失敗するなら、アカウント、ネットワーク、バージョン、グローバルツールを見ます。動くなら、元の repository 側の問題です。
Model API、地域、timeout、高負荷といった文言がある場合はネットワーク経路を確認します。別の信頼できるネットワークで再現性を見れば、インストールの問題か、proxy、DNS、地域制限の問題かを分けられます。
Antigravity 復旧手順
正確なエラーとバージョンを記録
可能なら About を開き、バージョンとエラー文を記録してから修正を始めます。
クリーンな workspace で試す
小さなフォルダと 1 ファイルで最小 prompt を試し、全体問題か repository 固有問題かを分けます。
該当レイヤーだけ修正
version 問題は更新、npx は PATH/Node.js、PowerShell は承認済み policy、repository crash は MCP を確認します。
エラー文別の修正ルート
表示されたエラーに合う部分だけを試してください。動いている設定まで壊すリスクを減らせます。
agent execution terminated due to error を直す
最小のフォルダを開き、小さなファイルを読ませます。そこでも失敗するならログイン更新、Antigravity 再起動、モデル変更、時間を置いて再試行をします。実プロジェクトだけ失敗するなら MCP、大きなファイル、workspace rules、長すぎる context を確認します。
npx が PATH にない問題を直す
Node.js LTS を入れ、新しいターミナルで node -v、npm -v、npx -v を実行します。外では動くのに Antigravity 内で失敗するなら、ターミナルから起動するか PATH を追加して完全に再起動します。
PowerShell のブロックを直す
Windows では npm や npx が PowerShell にブロックされることがあります。知らない script を実行しないでください。許可されたユーザーポリシーか、互換性のある MCP コマンドを使います。
ログインループと Model API 失敗を直す
システム時刻、既定ブラウザ、Cookie、セッションを確認します。地域、クォータ、高負荷の文言がある場合、再インストールでは解決しないことが多いです。
インストールと更新の失敗を直す
Windows x64/ARM64、macOS Apple Silicon/Intel、Linux repository のように正しい installer を選びます。古いプロセスを閉じ、新しい版が開くことを確認してから古い shortcut を差し替えます。
アプリとバージョン
アプリが起動しない、About が古い build を示す、未対応 version と表示される場合に確認します。
Agent とモデル
Agent、Model API、quota、高負荷、地域エラーの場合に確認します。短い prompt と別ネットワークで原因を絞れます。
Terminal、Node.js、MCP
npx、node、npm、PATH、MCP、PowerShell policy が出る場合に確認します。外部 terminal と Antigravity 内の環境を揃えます。
Antigravity の再発を防ぐ
IDE、Node.js、npm、npx、shell 環境を揃えておきます。Node.js を terminal profile に入れても、デスクトップアイコンから起動した Antigravity が同じ PATH を継承しないことがあります。
MCP は依存関係として扱います。安定性が必要なら version を固定し、実験的な server を一度に複数追加しないでください。基本 Agent を試せる最小 workspace を残しておくと切り分けが速くなります。
コードは version control と backup で守ります。トラブルシューティングのために repository を削除する必要はありません。cache や古い install を消す前に、設定を復元できるか確認します。
安全メモ
意味を理解していない PowerShell、curl、shell コマンドを実行しないでください。IDE の修正で、コード、token、ブラウザセッションを危険にさらすべきではありません。
公式リンクと関連ページ
原因を切り分けた後、installer、互換性、更新経路を確認するために使います。
- Antigravity 公式ダウンロードページ - Google の公式 installer 配布先
- Antigravity CLI 公式トラブルシューティング - CLI とコマンドの公式リファレンス
- Antigravity 最新版 - 古い client や未対応 client の時に確認
- Antigravity システム要件 - OS、architecture、RAM、storage、network を確認
- Antigravity 更新ガイド - 古い version 警告と古い shortcut を修正