Antigravity CLI

Google의 터미널 코딩 에이전트 Antigravity CLI(`agy`)를 PleumRouter에 연결합니다.

Antigravity CLI는 데스크톱 IDE가 아니라 터미널에서 쓰는 프로그램이며 명령 이름은 agy입니다. Gemini API 형식(generateContent)으로 통신하고 GOOGLE_GEMINI_BASE_URL로 다른 엔드포인트를 지정할 수 있어, PleumRouter의 Gemini 호환 엔드포인트로 연결합니다. Google Gemini CLI를 쓴다면 Gemini CLI를 보세요.

빠른 시작#

Antigravity CLI 설치

설치 뒤에는 터미널을 한 번 닫았다가 다시 여세요. 이미 설치했다면 건너뛰세요.

macOS · Linux

설치 스크립트.

curl -fsSL https://antigravity.google/cli/install.sh | bash
# then open a new terminal
agy --version

PowerShell.

irm https://antigravity.google/cli/install.ps1 | iex
# then open a new terminal
agy --version

API 키 발급
대시보드의 API 키 페이지에서 plm_로 시작하는 키를 만들어 복사하세요. 처음에는 일·주·월 예산을 함께 걸어 두는 것을 권장합니다.

PleumRouter로 연결

둘 중 하나를 고르세요. 키만 환경변수로 넣으면 무시됩니다. settings.json에 modelProvider가 있어야 합니다.

pleum launch

`~/.gemini/antigravity-cli/settings.json`에 `modelProvider`를 병합하고(`--model`을 주면 `model`도), 주소와 키는 이번 실행에만 붙입니다. 종료하면 원래 값으로 되돌립니다.

npm i -g pleumrouter
pleum login                                 # sign in with the browser
pleum launch agy    # merges modelProvider into settings.json (and model with --model), restores it on exit

설정 파일이 없으면 만들고(이미 있으면 `modelProvider` 키만 추가), `export`한 뒤 실행합니다. 새 터미널에서는 `export`를 다시 해야 합니다.

# settings.json: create it if missing; if it already exists, add only "modelProvider": "gemini" and keep the rest
mkdir -p ~/.gemini/antigravity-cli
[ -f ~/.gemini/antigravity-cli/settings.json ] || echo '{ "modelProvider": "gemini" }' > ~/.gemini/antigravity-cli/settings.json

export PLEUM_API_KEY="plm_xxxxxxxxxxxxxxxx"

# GOOGLE_GEMINI_BASE_URL is the origin WITHOUT /v1beta — agy appends /v1beta itself.
export GEMINI_API_KEY="$PLEUM_API_KEY"
export GOOGLE_GEMINI_BASE_URL="https://apirouter.pleum.ai"
# to keep them, add these export lines to ~/.zshrc or ~/.bashrc
agy --model gemini-3.8-flash --effort low

PowerShell 명령입니다.

New-Item -ItemType Directory -Force -Path "$HOME\.gemini\antigravity-cli" | Out-Null
# settings.json: create it if missing; if it already exists, add only "modelProvider": "gemini" and keep the rest
$settings = "$HOME\.gemini\antigravity-cli\settings.json"
if (-not (Test-Path $settings)) { Set-Content -Path $settings -Value '{ "modelProvider": "gemini" }' }

$env:PLEUM_API_KEY = "plm_xxxxxxxxxxxxxxxx"
$env:GEMINI_API_KEY = $env:PLEUM_API_KEY
$env:GOOGLE_GEMINI_BASE_URL = "https://apirouter.pleum.ai"
# to keep them for new terminals:  setx GEMINI_API_KEY $env:PLEUM_API_KEY  and  setx GOOGLE_GEMINI_BASE_URL "https://apirouter.pleum.ai"
agy --model gemini-3.8-flash --effort low

4
실행하고 확인
agy로 프롬프트 한 번에 응답이 오면 연결 성공입니다.
Terminal
```
cd your-project
agy
```

Antigravity CLI에서 PleumRouter를 쓰는 이유#

선불 크레딧으로 사용한 만큼만 결제합니다. 도구 제작사의 구독과 별개로 크레딧이 차감됩니다.
키마다 예산과 한도를 겁니다. API 키별 일·주·월 예산과 모델 허용 목록, 팀 예산으로 에이전트의 비용을 관리합니다.
한 키로 여러 모델을 씁니다. Claude·GPT·Gemini·오픈 모델을 골라 쓰고, 공급자 장애 시 자동 재시도·폴백이 동작하며, 사용량은 대시보드에서 봅니다.

작동 방식#

Antigravity CLI는 Gemini API 형식(POST /v1beta/models/{model}:generateContent, 스트리밍은 :streamGenerateContent)으로 요청합니다. GOOGLE_GEMINI_BASE_URL이 가리키는 서버로 보내고 도구가 /v1beta를 붙입니다. PleumRouter는 Gemini 형식 요청을 받아 도구 호출(function calling)과 스트리밍(SSE)을 변환해 선택한 모델의 공급자로 전달하고, 응답을 Gemini 형식으로 돌려줍니다. 인증은 GEMINI_API_KEY에 넣은 plm_ 키입니다.

설정 레퍼런스#

항목	설명
settings.json{ "modelProvider": "gemini" }	`~/.gemini/antigravity-cli/settings.json`. 이 값이 없으면 `GEMINI_API_KEY`를 무시합니다.
GOOGLE_GEMINI_BASE_URLhttps://apirouter.pleum.ai	`/v1beta`가 없는 루트 주소입니다. 도구가 `/v1beta`를 붙입니다.
GEMINI_API_KEY$PLEUM_API_KEY	PleumRouter API 키.
--model / --effortgemini-3.8-flash / low	`--model`은 agy가 아는 Gemini 모델만 받습니다. `--effort`는 선택이며, 값은 `agy --help`에서 확인합니다.

모델 선택#

agy에서는 Gemini 모델 ID를 씁니다. --model은 agy가 아는 Gemini 모델(예: gemini-3.8-flash)만 받고, pleum launch agy --model도 검증을 마친 Gemini 모델만 받습니다. 정확한 ID는 모델 카탈로그나 GET /v1/models에서 확인합니다.

Gemini 모델을 기준으로 설명합니다. 도구 호출 품질은 모델마다 다를 수 있습니다.

지원 범위#

기능	상태	설명
스트리밍(SSE)	지원	`:streamGenerateContent`를 `alt=sse` 형식으로 돌려줍니다.
도구 호출(function calling)	지원	도구 호출을 양방향으로 변환합니다. 모델이 도구 호출을 지원해야 합니다.
`:countTokens`	일부	엔드포인트는 있지만 정확한 토크나이저 값이 아닌 추정치입니다.
Gemini 외 모델	미지원	`pleum launch agy --model`은 검증을 마친 Gemini 모델만 받고, 그 밖의 모델은 오류로 거절합니다.

문제 해결#

증상	원인과 조치
키를 넣었는데 무시되거나 Google 로그인으로 넘어갑니다	`~/.gemini/antigravity-cli/settings.json`에 `{ "modelProvider": "gemini" }`가 있는지 확인하세요. 이 파일이 없으면 `GEMINI_API_KEY`를 쓰지 않습니다.
`modelProvider is set to … environment variable is not set`	`settings.json`에 `modelProvider`가 있는데 같은 터미널에 `GEMINI_API_KEY`가 없는 상태입니다. 키를 `export`하거나 `settings.json`에서 `modelProvider`를 지우세요. 설정 파일을 고치지 않고 이번 실행에만 적용하려면 `export`한 상태에서 `agy --settings '{"modelProvider":"gemini"}'`로 실행하세요.
404 Not Found	`GOOGLE_GEMINI_BASE_URL`에 `/v1beta`나 `/v1`을 붙였을 수 있습니다. `https://apirouter.pleum.ai`(루트)로 바꾸세요.
401 Unauthorized	`GEMINI_API_KEY`가 `plm_` 키인지, 같은 터미널에서 `export`했는지 확인하세요.
model not found	`--model`의 ID가 카탈로그에 없습니다. `GET /v1/models`로 정확한 ID를 확인하세요.
`not recognized as a known model`	agy의 `--model`은 자기가 아는 Gemini 모델만 받습니다. `agy models`로 쓸 수 있는 ID를 확인하세요.
새 터미널을 열었더니 다시 안 됩니다	`export`는 그 터미널에서만 유지됩니다. 매번 다시 하거나 셸 프로필에 넣고, 간단히는 `pleum launch agy`를 쓰세요.
`pleum launch agy`가 내 설정을 바꿉니까?	실행하는 동안 `settings.json`의 `modelProvider`(`--model`을 주면 `model`도)만 바꾸고 다른 키는 그대로 둡니다. agy가 끝나면 원래 값으로 자동 복구하며, 비정상 종료로 남은 변경은 다음에 `pleum`을 실행할 때 복구합니다.

비용·보안 팁#

키에 예산을 걸어 두세요. 코딩 에이전트는 한 작업에서 모델을 여러 번 호출하고 긴 컨텍스트를 반복해 보냅니다. API 키에 일·주·월 예산을 설정하면 비용을 예측하기 쉽습니다.
키는 git에 올리지 마세요. 셸 프로필이나 설정 파일에 넣은 키가 저장소에 커밋되지 않게 하고, 유출이 의심되면 대시보드에서 바로 폐기한 뒤 새로 발급하세요.
민감한 코드라면 처리 위치를 확인하세요. 프롬프트와 코드는 고른 모델의 공급자에게 전달됩니다. 데이터 처리 위치와 개인정보 마스킹으로 범위를 정할 수 있습니다.