Antigravity Auth クイックインストール：5分でプラグイン設定完了

Antigravity Auth のクイックインストールで、5分以内に OpenCode プラグインを設定し、Claude や Gemini 3 の高性能モデルを使い始めましょう。本チュートリアルでは、2つのインストール方法（AI アシスト/手動設定）を紹介し、プラグインのインストール、OAuth 認証、モデル定義、動作確認までをカバーします。

学べること

✅ 5分以内に Antigravity Auth プラグインをインストールする
✅ Claude と Gemini 3 モデルへのアクセス権限を設定する
✅ Google OAuth 認証を実行し、インストールの成功を確認する

現状の課題

Antigravity Auth の強力な機能（Claude Opus 4.5、Sonnet 4.5、Gemini 3 Pro/Flash）を試したいけれど、プラグインのインストール方法やモデルの設定方法がわからず、一歩間違えると詰まってしまうのではないかと不安に感じている。

こんなときに使う

Antigravity Auth プラグインを初めて使うとき
新しいマシンに OpenCode をインストールするとき
プラグインを再設定する必要があるとき

🎒 始める前の準備

事前チェック

始める前に、以下を確認してください：

[ ] OpenCode CLI がインストール済み（opencode コマンドが使用可能）
[ ] Google アカウントを持っている（OAuth 認証に使用）
[ ] Antigravity Auth の基本概念を理解している（Antigravity Auth とは？を参照）

基本的な流れ

Antigravity Auth のインストールは4つのステップで完了します：

プラグインのインストール → OpenCode 設定でプラグインを有効化
OAuth 認証 → Google アカウントでログイン
モデルの設定 → Claude/Gemini モデル定義を追加
インストールの確認 → 最初のリクエストでテスト

重要：設定ファイルのパスは、すべてのシステムで ~/.config/opencode/opencode.json です（Windows の ~ は自動的にユーザーディレクトリ（例：C:\Users\YourName）に解決されます）。

手順

ステップ 1：インストール方法を選択

Antigravity Auth には2つのインストール方法があります。どちらか一方を選んでください。

ステップ 2：Google OAuth 認証を実行

ターミナルで以下を実行します：

bash

opencode auth login

システムが自動的に実行する内容：

ローカル OAuth サーバーを起動（localhost:51121 でリッスン）
ブラウザを開いて Google 認証ページにリダイレクト
OAuth コールバックを受信してトークンを交換
Google Cloud プロジェクト ID を自動取得

あなたがやること：

ブラウザで「許可」をクリックしてアクセスを承認
WSL や Docker 環境の場合、コールバック URL を手動でコピーする必要があるかもしれません

期待される結果：

✅ Authentication successful
✅ Account added: [email protected]
✅ Project ID resolved: cloud-project-id-xxx

マルチアカウント対応

クォータを増やすためにアカウントを追加したい場合は、opencode auth login を再度実行してください。プラグインは最大10アカウントをサポートし、自動的に負荷分散を行います。

ステップ 3：モデル定義を設定

以下の完全な設定をコピーして ~/.config/opencode/opencode.json に追加します（既存の plugin フィールドを上書きしないように注意）：

json

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-antigravity-auth@latest"],
  "provider": {
    "google": {
      "models": {
        "antigravity-gemini-3-pro": {
          "name": "Gemini 3 Pro (Antigravity)",
          "limit": { "context": 1048576, "output": 65535 },
          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] },
          "variants": {
            "low": { "thinkingLevel": "low" },
            "high": { "thinkingLevel": "high" }
          }
        },
        "antigravity-gemini-3-flash": {
          "name": "Gemini 3 Flash (Antigravity)",
          "limit": { "context": 1048576, "output": 65536 },
          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] },
          "variants": {
            "minimal": { "thinkingLevel": "minimal" },
            "low": { "thinkingLevel": "low" },
            "medium": { "thinkingLevel": "medium" },
            "high": { "thinkingLevel": "high" }
          }
        },
        "antigravity-claude-sonnet-4-5": {
          "name": "Claude Sonnet 4.5 (Antigravity)",
          "limit": { "context": 200000, "output": 64000 },
          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
        },
        "antigravity-claude-sonnet-4-5-thinking": {
          "name": "Claude Sonnet 4.5 Thinking (Antigravity)",
          "limit": { "context": 200000, "output": 64000 },
          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] },
          "variants": {
            "low": { "thinkingConfig": { "thinkingBudget": 8192 } },
            "max": { "thinkingConfig": { "thinkingBudget": 32768 } }
          }
        },
        "antigravity-claude-opus-4-5-thinking": {
          "name": "Claude Opus 4.5 Thinking (Antigravity)",
          "limit": { "context": 200000, "output": 64000 },
          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] },
          "variants": {
            "low": { "thinkingConfig": { "thinkingBudget": 8192 } },
            "max": { "thinkingConfig": { "thinkingBudget": 32768 } }
          }
        },
        "gemini-2.5-flash": {
          "name": "Gemini 2.5 Flash (Gemini CLI)",
          "limit": { "context": 1048576, "output": 65536 },
          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
        },
        "gemini-2.5-pro": {
          "name": "Gemini 2.5 Pro (Gemini CLI)",
          "limit": { "context": 1048576, "output": 65536 },
          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
        },
        "gemini-3-flash-preview": {
          "name": "Gemini 3 Flash Preview (Gemini CLI)",
          "limit": { "context": 1048576, "output": 65536 },
          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
        },
        "gemini-3-pro-preview": {
          "name": "Gemini 3 Pro Preview (Gemini CLI)",
          "limit": { "context": 1048576, "output": 65535 },
          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
        }
      }
    }
  }
}

モデルの分類

Antigravity クォータ（Claude + Gemini 3）：antigravity-gemini-*、antigravity-claude-*
Gemini CLI クォータ（独立）：gemini-2.5-*、gemini-3-*-preview

詳細なモデル設定については、利用可能なモデル一覧を参照してください。

期待される結果：設定ファイルに完全な provider.google.models 定義が含まれ、JSON 形式が有効（構文エラーなし）であること。

ステップ 4：インストールの確認

以下のコマンドを実行して、プラグインが正常に動作するかテストします：

bash

opencode run "Hello" --model=google/antigravity-claude-sonnet-4-5-thinking --variant=max

期待される結果：

正在使用: google/antigravity-claude-sonnet-4-5-thinking (max)
...

Claude: 你好！我是 Claude Sonnet 4.5 Thinking。

チェックポイント ✅

AI から正常な応答が返ってきたら、おめでとうございます！Antigravity Auth プラグインのインストールと設定が完了しました。

よくあるトラブル

問題 1：OAuth 認証に失敗する

症状：opencode auth login を実行後、invalid_grant などのエラーが表示される、または認証ページが開かない。

原因：Google アカウントのパスワード変更、セキュリティイベント、またはコールバック URL が不完全。

解決策：

ブラウザで Google 認証ページが正しく開いているか確認
WSL/Docker 環境の場合、ターミナルに表示されるコールバック URL を手動でブラウザにコピー
~/.config/opencode/antigravity-accounts.json を削除して再認証

問題 2：モデルが見つからない（400 エラー）

症状：リクエスト実行時に 400 Unknown name 'xxx' が返される。

原因：モデル名のスペルミス、または設定ファイルの形式に問題がある。

解決策：

--model パラメータが設定ファイルのキーと完全に一致しているか確認（大文字小文字を区別）
opencode.json が有効な JSON かどうか確認（cat ~/.config/opencode/opencode.json | jq で検証）
provider.google.models フィールドに対応するモデル定義があるか確認

問題 3：設定ファイルのパスが間違っている

症状：「設定ファイルが存在しません」と表示される、または変更が反映されない。

原因：異なるシステムで間違ったパスを使用している。

解決策：すべてのシステムで ~/.config/opencode/opencode.json を使用してください（Windows でも ~ は自動的にユーザーディレクトリに解決されます）。

システム	正しいパス	間違ったパス
macOS/Linux	`~/.config/opencode/opencode.json`	`/usr/local/etc/...`
Windows	`C:\Users\YourName\.config\opencode\opencode.json`	`%APPDATA%\opencode\...`

まとめ

このレッスンで学んだこと：

✅ 2つのインストール方法（AI アシスト / 手動設定）
✅ Google OAuth 認証フロー
✅ 完全なモデル設定（Claude + Gemini 3）
✅ インストールの確認とよくあるトラブルの解決

重要なポイント：

設定ファイルの統一パス：~/.config/opencode/opencode.json
OAuth 認証で Project ID を自動取得、手動設定は不要
マルチアカウント対応でクォータ上限を拡大
variant パラメータで Thinking モデルの思考深度を制御

次のレッスン

次のレッスンでは 初回認証：OAuth 2.0 PKCE フローを深く理解する を学びます。
学べること：
OAuth 2.0 PKCE の仕組み
トークンリフレッシュの仕組み
Project ID の自動解決プロセス
アカウントストレージの形式

付録：ソースコード参照

クリックしてソースコードの場所を表示

更新日：2026-01-23

機能	ファイルパス	行番号
OAuth 認証 URL 生成	`src/antigravity/oauth.ts`	91-113
PKCE キーペア生成	`src/antigravity/oauth.ts`	1-2
トークン交換	`src/antigravity/oauth.ts`	201-270
Project ID 自動取得	`src/antigravity/oauth.ts`	131-196
ユーザー情報取得	`src/antigravity/oauth.ts`	231-242

主要な定数：

ANTIGRAVITY_CLIENT_ID：OAuth クライアント ID（Google 認証用）
ANTIGRAVITY_REDIRECT_URI：OAuth コールバックアドレス（固定値：http://localhost:51121/oauth-callback）
ANTIGRAVITY_SCOPES：OAuth 権限スコープリスト

主要な関数：

authorizeAntigravity()：OAuth 認証 URL を構築（PKCE challenge を含む）
exchangeAntigravity()：認証コードをアクセストークンとリフレッシュトークンに交換
fetchProjectID()：Google Cloud プロジェクト ID を自動解決
encodeState() / decodeState()：OAuth state パラメータのエンコード/デコード（PKCE verifier を含む）

Antigravity Auth クイックインストール：5分でプラグイン設定完了 ​

学べること ​

現状の課題 ​

こんなときに使う ​

🎒 始める前の準備 ​

基本的な流れ ​

手順 ​

ステップ 1：インストール方法を選択 ​

ステップ 2：Google OAuth 認証を実行 ​

ステップ 3：モデル定義を設定 ​

ステップ 4：インストールの確認 ​

よくあるトラブル ​

問題 1：OAuth 認証に失敗する ​

問題 2：モデルが見つからない（400 エラー） ​

問題 3：設定ファイルのパスが間違っている ​

まとめ ​

次のレッスン ​

付録：ソースコード参照 ​