# Antigravity CLI

出典: https://docs.aicentos.com/ja/clients/antigravity-cli

Language: ja

> Antigravity CLI で aicentos を使う —— API Key モードによる接続

Antigravity CLI は Google がリリースしたコマンドラインツールで、API Key モードを通じて Gemini API 互換のサービスに接続できます。このドキュメントでは、Antigravity CLI をカスタム API エンドポイントで使うための設定方法を紹介します。

## インストール

OS に応じて対応するインストール方法を選択します：

### macOS / Linux

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

### Windows (PowerShell)

```powershell
irm https://antigravity.google/cli/install.ps1 | iex
```

### Windows (CMD)

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

### インストールの確認

```bash
agy --version
```

## 設定

### API Key モードの有効化

`~/.gemini/antigravity-cli/settings.json` を編集し、既存の JSON に次を追加します：

```json
{
  "modelProvider": "gemini"
}
```

⚠️ **注意**：`GEMINI_API_KEY` だけを設定しても認証方式は切り替わりません。`modelProvider` は小文字の `"gemini"` に設定する必要があります。

### 環境変数の設定

```bash
export GOOGLE_GEMINI_BASE_URL="https://aicentos.com"
export GEMINI_API_KEY="your_api_key_here"
```

**重要な説明：**

* `GOOGLE_GEMINI_BASE_URL` にはサービスのルートアドレスを入力し、具体的な API パスは付けません。エンドポイントは Gemini API と互換性がある必要があります。
* `GEMINI_API_KEY` にはあなたの API Key を入力します。
* 上記のコマンドは `agy` を起動するのと同じ shell 内で実行してください。CLI は `.env` や `GOOGLE_API_KEY` を読みません。

永続化したい場合は、2 つの `export` を `~/.zshrc` または `~/.bashrc` に書き込みます。

## 起動と確認

```bash
agy --model gemini-2.0-flash
```

上部に `Gemini API key` と表示されたら、会話を 1 回開始します。

### よくある問題のトラブルシューティング

* **ログインを求められ続ける**：`"modelProvider": "gemini"` を確認し、終了してから `agy` を再起動します。
* **起動時にキー不足と表示される**：現在の shell で `GEMINI_API_KEY` を再設定します。
* **リクエストが失敗する**：API Key、サービスのルートアドレス、選択したモデルのアクセス権限を確認してください。

## 注意事項

* API Key モードを正常に使うには、`modelProvider` 設定項目と環境変数を両方設定する必要があります
* 環境変数は CLI を起動する shell セッション内で設定するか、shell 設定ファイルに書き込んで永続化してください
* サービスのエンドポイントは Gemini API の仕様と互換性がある必要があります

## 関連リンク

* 公式ドキュメント：[https://docs.aicentos.com/clients/antigravity-cli.html](https://docs.aicentos.com/clients/antigravity-cli.html)