MAC QUICK SETUP GUIDE ｜ 非公式クイックガイド

Antigravity CLI agy を Mac で使う

v1.4.12 時点(2026-11-01 作成) Gemini CLI の後継・無料枠あり macOS (Apple Silicon) ／ 単体で動作

Antigravity CLI(コマンド名 agy)は、Google のエージェント型開発環境 Antigravity のターミナル特化版。IDE なしで単体動作し、無料の Google アカウントだけで使えます(無料と有料の差はクォータ量のみ)。新しい Mac でも、まず agy を「最初の一つ」として入れ、ログイン後に残りの AI ツールの導入を agy に任せるのがこの環境の標準手順です(3 節)。

1インストール

ターミナルを開いて、これだけ:

curl -fsSL https://antigravity.google/cli/install.sh | bash

Google 公式インストーラーです。~/.local/bin/agy に入ります。

終わったら新しいターミナルを開いて agy --version。現在の最新は 1.4.12(2026-10-31 に実機で確認)。

更新は agy update(自己更新)が正道です。

4基本操作

コマンド働き
agyプロジェクトフォルダで対話TUIを起動
agy --model "…"モデルを指定して起動
/model ・ /effortセッション中にモデル/推論強度を切替
/plan ・ /goalタスクの計画・ゴール設定
/diff(Ctrl+R)エージェントの変更差分をレビュー
/agents並列サブエージェントの監視
/resume /fork /rewindセッション再開・分岐・巻き戻し
!シェルコマンドモードに切替
/exit(Ctrl+D)終了して元のシェルへ

2初回起動とログイン

  1. 作業したいフォルダで agy を実行
  2. 認証方式で「1. Google OAuth」を選択(個人利用)
  3. ブラウザが開くので Google アカウントでログイン → 表示された認証コードをターミナルに貼り付け
  4. テーマ選択 → 利用規約に同意 → ワークスペース信頼確認(Yes)

APIキーによるヘッドレス認証は現状非対応(OAuth のみ)。ログアウトは /logout。使えるモデルはセッション内の /model、無料枠の残量は /credits で実測確認してください(モデル構成は改定が頻繁なため本紙には固定しません)。

5Macのつまずき対処

症状対処
agy が見つからない新しいターミナルを開く。実パスは which agy で確認(標準は ~/.local/bin/agy)。~/.local/bin が PATH に無い場合はシェルの設定ファイルに追記する
更新しても版が上がらないagy update を使う(自己更新が正道)
設定を直接いじりたい~/.gemini/antigravity-cli/settings.json(旧ブランド名のパスに注意)

3最初の一つとして入れたら ― 残りは agy に任せる

agy のログインが済んだら、新しい Mac へ入れる残りの AI ツールの導入は agy に任せられます。agy には次の指示と注意をそのまま渡してください。

ツール導入の要点版数の基準(2026-10-31 実機確認)
claude (Claude Code)公式インストーラー2.1.314
codexnpm @openai/codex0.166.0
groknpm @xai-official/grok@alpha。alpha 指定が必須(latest は旧版 1.0.70 に戻る)1.0.73 (alpha)
deepseek (DSH)npm @deepseek-ai/dsh@alpha。alpha 指定が必須。この環境の Mac では npm の導入先が複数あるため、/opt/homebrew/bin/npm で入れる0.2.2-alpha.2
kimi本体はネイティブ版(~/.kimi-code/bin/kimi)。更新は公式 install.sh の実行(curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash。kimi upgrade は手順を表示するだけ)。npm 版と取り違えない2.4.1
cursorcursor-agent 公式インストーラー。更新は cursor-agent update2026.10.22-27dcf5f
cue (Cue by Manus)この環境では Mac に入れていない(Windows 側で使用)。必要になったら別途検討―
museMac 版アプリあり(この環境では Muse.app 10.0 を使用中)。導入は公式サイトから10.0 (アプリ)

agy に任せられないのは各ツールへのログインだけです(Google / OpenAI などの認証は本人がその場で行う)。仕上げに、全ツールの --version 一覧を作成して報告させるところまでを 1 回の指示に含めてください。

🖨 ブラウザの印刷(Ctrl+P)で A4 縦・1枚に収まります