Google Antigravity CLI 接続

QCode.cc のキーで Google Antigravity CLI(agy)を設定:settings.json の modelProvider と 2 つの環境変数を Gemini エンドポイントへ(現在 QCode では Gemini を提供しておらず、参考情報)

最終更新 2026-10-15

API キーが必要ですか? 登録する →エンドポイントと Base URL →

目次

⚠️ 現在ご利用いただけません:QCode は現在 Gemini 系モデルを一時的に提供停止しているため、以下の「QCode 経由で Gemini を呼び出す」手順は当面利用できず、参考情報として残しています。Claude、GPT、または中国系モデルをご利用ください。

最終確認:2026-09-18 · 📄 公式ドキュメント準拠(Antigravity CLI 1.2.x(自動更新マニフェスト 1.2.6、2026-09 確認))

概要

項目 内容
利用できるモデル QCode 経由なら:Gemini(QCode は現在提供していません。参考情報のみ)· Claude / GPT / 中国系 ❌。これはエンドポイント側の制約であって、ツール自体の上限ではありません。agy を Google アカウントでログインする場合、公式モデルページには他のファミリーも載っていますが、それは Google のクォータであり当社を経由しません
プロトコルと Base URL Gemini:https://api.qcode.cc/gemini(中国本土は asia.qcode.cc)
設定場所 ~/.gemini/antigravity-cli/settings.json + 環境変数 GEMINI_API_KEY / GOOGLE_GEMINI_BASE_URL
公式ドキュメント antigravity.google

⚠️ Gemini CLI からの移行ですか? 2026-05-19 の公式発表の原文では、2026-06-18 をもって Gemini CLI と Gemini Code Assist の IDE 拡張が「will stop serving requests」とされ、対象は Google AI Pro、Ultra、および個人アカウントで無料利用しているユーザーです。 企業向け有料キーは影響を受けません——同じ発表で、有料の Gemini / Gemini Enterprise Agent Platform API キー経由では引き続き利用可能と明記されています。 同日に公開されたのは Antigravity CLI と Antigravity 2.0 で、IDE としての Antigravity は 2025-11-18 に先行リリース済みです。以前 Gemini CLI 連携 で設定した場合は、 本ページの方法に切り替えられます。

Google Antigravity は、個人ログイン向けに Gemini CLI を継承する形での ツールチェーンで、デスクトップ IDE、コマンドライン Antigravity CLI(agy、Go 製)、 SDK の 3 つで構成されます。本ページは CLI のみを扱い、QCode.cc を接続先に設定する方法を説明します。

🔴 最初に確認:Gemini プロトコルのみ

Antigravity CLI のカスタムエンドポイントは Gemini 互換で、環境変数 GOOGLE_GEMINI_BASE_URL で指定します。公式のトラブルシューティング表には modelProvider について「gemini が唯一受け付けられる値」と明記されているため、この経路は OpenAI 互換エンドポイントを受け付けません。QCode 経由で呼べるのも Gemini 系のみです。

項目 値
設定ファイル ~/.gemini/antigravity-cli/settings.json
主要フィールド "modelProvider": "gemini"
認証情報 環境変数 GEMINI_API_KEY(QCode の cr_ キー)
エンドポイント上書き 環境変数 GOOGLE_GEMINI_BASE_URL
読まれない変数 公式明記:agy は .env ファイルを読み込みませんし、GOOGLE_API_KEY を設定しても無効です。認証情報は環境変数 GEMINI_API_KEY からのみ取得されます。Gemini CLI は .env を自動で読むため、両者は挙動が逆です(CI で一度踏めば忘れません)
利用可能モデル QCode 経由の場合:Gemini 系のみ

Claude や GPT を使うなら別のクライアントを選んでください —— Claude Code、Codex CLI、 Cline、Zed など。どのプロトコルでどのモデルが使えるかは エンドポイントと API パス を参照。

🔴 Antigravity IDE(2.0 デスクトップ版)は接続できません

Antigravity のデスクトップ IDE には現在、公式の BYOK / カスタム provider の入口がありません。 内蔵 agent のモデルを第三者エンドポイントに差し替えることはできません。コミュニティにはローカル プロキシで傍受する方法もありますが、リバースエンジニアリングであり公式サポート外のため、 本ページでは推奨しません。

QCode に接続できるのは CLI(agy)であって IDE ではありません。

前提条件

手順 1:Antigravity CLI のインストール

公式インストール文書 を優先してください:

curl -fsSL https://antigravity.google/cli/install.sh | bash
# ~/.local/bin/agy にインストール
curl -fsSL https://antigravity.google/cli/install.sh | bash
# ~/.local/bin/agy にインストール

PowerShell:

irm https://antigravity.google/cli/install.ps1 | iex
# C:\Users\<ユーザー名>\AppData\Local\agy\bin にインストール

CMD:

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

公式のインストールページには --skip-aliases と --skip-path が挙げられていますが、これは Windows 側の挙動です。install.ps1 / install.cmd は引数を agy install に渡しますが、macOS / Linux の install.sh 自体が受け付けるのは -d, --dir <パス> と -h, --help だけで、未知の引数では終了します。macOS / Linux でこの 2 つのフラグをそのままコピーしないでください。

手順 2:API キー認証に切り替える(Google サインインを省く)

既定では agy は OS のキーリングを読むか、ブラウザで Google アカウントのサインインを開きます。 API キー認証に切り替えるには、~/.gemini/antigravity-cli/settings.json を編集(なければ作成)します:

{
  "modelProvider": "gemini"
}

これを設定すると agy はサインイン画面を飛ばして直接メイン画面を開き、代わりに GEMINI_API_KEY 環境変数を読みます。

🔴 "modelProvider": "gemini" を設定したのに GEMINI_API_KEY がない場合、CLI は起動しません。 両方が必要です。

手順 3:キーとエンドポイントを QCode に向ける

export GEMINI_API_KEY="cr_あなたのQCodeキー"
export GOOGLE_GEMINI_BASE_URL="https://api.qcode.cc/gemini"

~/.zshrc / ~/.bashrc に書けば永続化します。Windows PowerShell:

$env:GEMINI_API_KEY = "cr_あなたのQCodeキー"
$env:GOOGLE_GEMINI_BASE_URL = "https://api.qcode.cc/gemini"

GOOGLE_GEMINI_BASE_URL は /gemini までとし、/v1beta は付けないでください。公式の例は 素のアドレス(export GOOGLE_GEMINI_BASE_URL="https://your-endpoint.example.com")で、バージョン部と リクエストパスはクライアント側が補います。agy はクローズドな Go クライアントで、公式は連結規則も 末尾の / が正規化されるかどうかも文書化していません(Gemini CLI 側の SDK は末尾スラッシュを 1 つ剥がします)。 そのため公式の形に沿うに留め、境界動作の推測はしません。これは OpenCode の google provider とは逆 (あちらは /v1beta が必要)です。差異は エンドポイントと API パス を参照。

中国本土からはホストを https://asia.qcode.cc/gemini(アジアノード、韓国 / 台湾 / 香港の近い方)に変えるだけで、 キーは共通です。us も同様。

GEMINI_API_KEY で認証した場合、/logout は何もしません —— 消すセッションが存在しないためです。

手順 4:疎通確認

まずツールを介さず QCode の Gemini エンドポイントを直接叩きます:

# 現在呼べる Gemini モデルの一覧
curl -s https://api.qcode.cc/gemini/v1beta/models \
  -H "x-goog-api-key: $GEMINI_API_KEY"

# 最小リクエスト(モデル名は上の一覧から)
curl -s "https://api.qcode.cc/gemini/v1beta/models/gemini-2.5-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "content-type: application/json" \
  -d '{"contents":[{"parts":[{"text":"ping"}]}],"generationConfig":{"maxOutputTokens":16}}'
  • candidates を含む JSON が返る → エンドポイントもキーも正常
  • 401 → パスは正しく、キーが未設定または誤り

どのモデルがあるかはリアルタイム照会を正典としてください。本ページを含め、いかなる文書の 固定リストも転記しないでください。最初の curl が返した id が、QCode のこの経路で呼べるモデルです。 販売中の一覧と単価は qcode.cc/models を参照。

ただし注意点が一つ。agy の /model パネルや agy --model=... が扱うのは製品側の表示名 (Gemini 3.5 Flash のような形)です。公式は、カスタムエンドポイント指定時に API の id を パネルの項目へどう対応付けるかも、その一覧が設定したエンドポイントから来るのかどうかも 述べていません。パネルに目的の型が無ければ、それ以上の公式手順はありません —— この点は当社で未実測なので、事実どおりに記載します。

エンドポイントが確認できたら agy で会話を実行します。

画像を読む(視覚入力)と画像を生成することの違い

agy のようなツールは画像を読めます —— UI のスクリーンショット、エラー画面、アーキテクチャ図を 与えてコードを書かせたり原因を切り分けたりできます。これは画像を生成することとは別物です:

  • 視覚入力:プロンプトで画像ファイルパスを参照するか、画像を貼り付け / ドラッグします。 Gemini 系モデルは視覚能力を持ちます。典型例:デザイン画から UI を再現、エラー画面から不具合を特定、 アーキテクチャ図を読む。

  • 画像生成:専用の画像モデル gpt-image-2 を QCode の画像エンドポイントで使います。 詳細は gpt-image-2 画像生成。

トラブルシューティング

症状 想定原因 対処
CLI が起動しない modelProvider: "gemini" を設定したが GEMINI_API_KEY がない 環境変数を追加、または当該フィールドを削除してアカウント認証に戻す
401 キー未設定または誤り GEMINI_API_KEY を確認(cr_ 始まり、前後に空白なし)
404 GOOGLE_GEMINI_BASE_URL に /v1beta が余計、またはパス接頭辞の誤り 公式の例どおり /gemini までにする。末尾スラッシュの挙動は公式に記載なし
model_not_available_on_endpoint Claude / GPT モデルを指定した この経路は Gemini 系のみ。クライアントかモデルを変更
モデル名エラー 販売終了 ID または綴り誤り 手順 4 の curl で実際に呼べる集合を確認
中国から遅い / タイムアウト api の主ドメインを使っている https://asia.qcode.cc/gemini に変更
/logout が効かない API キー認証を使っている 想定どおり。消すセッションがない

さらに

QCode のキーをまだお持ちでない場合:1 本の cr_ キーで Claude、GPT、中国系、画像モデルを カバーします(プロトコルは異なります。上の対応表を参照)。 料金プラン をご覧ください。

QCode を始める

API キーひとつで Claude Code・Codex などに対応。トークン単位の課金で、各モデルの単価は qcode.cc/models に掲載

企業版 →