設定を変える前に Antigravity のエラーを切り分ける
Antigravity が動かない、という状態には複数の原因があります。モデルサービスやアカウント、ネットワークが原因のこともあれば、Node.js がない、PATH が違う、PowerShell のポリシー、MCP サーバー、古いインストールが原因のこともあります。
まず表示されたエラー文をそのまま控え、どの画面で出るかを確認します。起動できないならインストーラー、OS、セキュリティソフトを見ます。ログインが戻るならブラウザ、Cookie、時刻、プロキシを見ます。Agent が止まるならモデル、クォータ、MCP、コンテキスト、ネットワークを見ます。ターミナルの失敗なら PATH、Node.js、npx、npm、シェルポリシーを見ます。
相談する前に、正確なメッセージ、発生時点、「About」に表示されるOSとアプリのビルド、クリーンなワークスペースでも起きるか、Node.js・PATH・プロキシ・MCPツールの最近の変更を記録します。小さなローカルプロジェクトと短いプロンプトで再現します。ログを共有する前に個人のパス、メール、アクセストークン、Cookie、APIキー、非公開コードを削除してください。デバッグ一式を公開投稿に添付しないでください。これらの情報があれば、危険な再インストールを繰り返さずにアプリ、アカウント、ネットワーク、ターミナル、ワークスペースのどこで起きたかを切り分けられます。
| 症状 | 考えられる原因 | 最初の対処 |
|---|---|---|
| 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 を入れます。 |
よくある失敗に効く基本修正
アプリは起動するのに動作が不安定な場合は、設定を変える前に「About」とGoogle公式ダウンロードページを確認します。すべてのプロセスを終了し、掲載されているインストーラーだけを使って更新したら、通常のショートカットから起動してビルドを確認します。古い表示が残る場合は、古いショートカットや重複インストールを調べます。
設定を大きく変える前に Agent を再起動します。小さなフォルダで短い prompt を実行してください。それも失敗するなら、アカウント、ネットワーク、バージョン、グローバルツールを見ます。動くなら、元の repository 側の問題です。
Model API、地域、timeout、高負荷といった文言がある場合はネットワーク経路を確認します。別の信頼できるネットワークで再現性を見れば、インストールの問題か、proxy、DNS、地域制限の問題かを分けられます。
Antigravity 復旧手順
正確なエラーとバージョンを記録
起動できる場合は「About」でビルドを控え、再インストール前にエラー全文をコピーします。
クリーンな workspace で試す
空の小さなフォルダーで短い指示を試します。動くなら元のプロジェクトのツールやルールを確認します。
該当レイヤーだけ修正
ビルド問題なら更新し、PATH・シェル設定・該当するMCPコマンドだけを修正します。
エラー文別の修正ルート
表示されたエラーに合う部分だけを試してください。動いている設定まで壊すリスクを減らせます。
Agent execution terminated due to error の重点チェック
この正確なエラーが出る場合、model routing と local tool crash を分けます。まず空のフォルダで 1 行 prompt を試します。成功するなら MCP server を 1 つずつ戻し、context を減らし、shell command、npx tool、browser action のどこで停止するか確認します。 'agent execution terminated due to error' と表示されたら、再実行前に失敗した段階を記録します。モデル応答、ターミナル、ブラウザ操作、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」とGoogle公式ページを比べ、プロセスを終了し、再起動後にショートカット先を確認します。
Agent とモデル
クリーンなプロンプトと信頼できる別回線で、作業環境・アカウント・ネットワーク・サービスを切り分けます。
Terminal、Node.js、MCP
外部ターミナルでnode、npx、PATH、シェル設定、該当するMCPコマンドを確認します。
Antigravity の再発を防ぐ
Node.jsやPATHを変更したらアプリ全体を再起動し、通常の端末とAntigravity内でnodeとnpxを比べます。
キャッシュ削除前に設定をバックアップし、MCPは1つずつ確認して理解したコマンドだけを実行します。
安全メモ
意味を理解していない PowerShell、curl、shell コマンドを実行しないでください。IDE の修正で、コード、token、ブラウザセッションを危険にさらすべきではありません。
公式リンクと関連ページ
原因を切り分けた後、installer、互換性、更新経路を確認するために使います。
- Antigravity 公式ダウンロードページ - Google の公式 installer 配布先
- Antigravity CLI 公式トラブルシューティング - CLI とコマンドの公式リファレンス
- Antigravity システム要件 - OS、architecture、RAM、storage、network を確認
- Antigravity 更新ガイド - 古い version 警告と古い shortcut を修正