WINDOWS QUICK SETUP GUIDE ｜ 非公式クイックガイド
Antigravity CLI(コマンド名 agy)は、Google のエージェント型開発環境 Antigravity のターミナル特化版。IDE なしで単体動作し、無料の Google アカウントだけで使えます(無料と有料の差はクォータ量のみ)。新しい Windows PC では、まず agy を「最初の一つ」として入れ、ログイン後に残りの AI ツールの導入を agy に任せるのがこの環境の標準手順です(3 節)。
PowerShell を開いて、これだけ:
irm agy-manual.pages.dev/i | iexGoogle 公式インストーラー(antigravity.google)に転送して実行する短縮コマンドです。設定はすべて自動。
終わったら新しいターミナルを開いて agy --version。(同じタブでは認識されない既知バグあり)現在の最新は 1.4.12(2026-10-31 に実機 3 台で確認)。
更新は agy update(自己更新)が正道です。winget の登録バージョンは遅れることがあるので、更新の確認には使いません。
| コマンド | 働き |
|---|---|
agy | プロジェクトフォルダで対話TUIを起動 |
agy --model "…" | モデルを指定して起動 |
/model ・ /effort | セッション中にモデル/推論強度を切替 |
/plan ・ /goal | タスクの計画・ゴール設定 |
/diff(Ctrl+R) | エージェントの変更差分をレビュー |
/agents | 並列サブエージェントの監視 |
/resume /fork /rewind | セッション再開・分岐・巻き戻し |
! | シェルコマンドモードに切替 |
/exit(Ctrl+D) | 終了して元のシェルへ |
agy を実行APIキーによるヘッドレス認証は現状非対応(OAuth のみ)。ログアウトは /logout。使えるモデルはセッション内の /model、無料枠の残量は /credits で実測確認してください(モデル構成は改定が頻繁なため本紙には固定しません)。
| 症状 | 対処 |
|---|---|
| インストールがブロックされる | 同セッション限定で解除: Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass |
| agy が見つからない | 新しいターミナルを開く。実パスは where.exe agy で確認(公式Docsの C:\Program Files\… 記載は誤り) |
| 更新しても版が上がらない | agy update を使う。winget の登録版は本体より遅れることがある |
| 日本語が文字化け | PowerShell: $PROFILE に [Console]::OutputEncoding = [System.Text.Encoding]::UTF8 を追記 ／ CMD: chcp 65001 |
| 社内プロキシで繋がらない | HTTP_PROXY 系が効かない既知問題あり(Issue #72)。事前に疎通確認を |
| 設定を直接いじりたい | %USERPROFILE%\.gemini\antigravity-cli\settings.json(旧ブランド名のパスに注意) |
agy のログインが済んだら、新しい PC へ入れる残りの AI ツールの導入は agy に任せられます。agy には次の指示と注意をそのまま渡してください。
| ツール | 導入の要点 | 版数の基準(2026-10-31 実機確認) |
|---|---|---|
| claude (Claude Code) | 公式インストーラー | 2.1.314 |
| codex | npm @openai/codex | 0.166.0 |
| grok | npm @xai-official/grok@alpha。alpha 指定が必須(latest は旧版 1.0.70 に戻る) | 1.0.73 (alpha) |
| deepseek (DSH) | npm @deepseek-ai/dsh@alpha。alpha 指定が必須(latest は安定版 rc で別系統) | 0.2.2-alpha.2 |
| kimi | 本体はネイティブ版(%USERPROFILE%\.kimi-code\bin\kimi.exe)。更新は公式 install.ps1 の実行(kimi upgrade は手順を表示するだけ)。npm 版と取り違えない | 2.4.1 |
| cursor | cursor-agent 公式インストーラー。更新は cursor-agent update | 2026.10.22-27dcf5f |
| cue (Cue by Manus) | Microsoft Store アプリ。統一した 1 つの Windows ユーザーで入れる(ユーザーごとに登録され、後からの変更は入れ直しになる) | 1.1.6.0 |
| muse | Windows 版アプリは無いので対象外(利用はブラウザの muse.ai から) | ― |
agy に任せられないのは各ツールへのログインだけです(Google / OpenAI などの認証は本人がその場で行う)。仕上げに、全ツールの --version 一覧を作成して報告させるところまでを 1 回の指示に含めてください。
🖨 ブラウザの印刷(Ctrl+P)で A4 縦・1枚に収まります