Orca 에서 agy(Antigravity CLI)를 써 봤다 — 쓰는 법과 좋았던 점

Orca 에서 agy(Antigravity CLI)를 써 봤다 — 쓰는 법과 좋았던 점

요즘 Claude Code 와 Codex 를 Orca 안에서 같이 띄워 놓고 일한다. Orca 는 여러 코딩 에이전트를 한 화면에서 굴리는 데스크톱 앱이다. 작업 폴더(워크트리)마다 에이전트 터미널을 탭으로 열고, 어떤 에이전트가 무슨 일을 하고 있는지 한눈에 보여준다. 여기에 이번에 하나를 더 붙여 봤다. Google 의 Antigravity CLI, 명령어 이름으로는 agy 다.

계기는 이미지였다. 개인적으로 쓰고 있는 소설 프로젝트에 등장인물 그림이 필요한데, 지금까지는 Codex 의 내장 이미지 생성으로 뽑고 있었다. Gemini 쪽 이미지 모델(일명 나노바나나)은 같은 프롬프트로 어떻게 그리는지 비교해 보고 싶었다.

그동안 agy 를 쓰지 않던 이유

사실 agy 는 석 달 전부터 깔려 있었다. 기록을 보면 7월 23일 밤에 설치했고, 켜자마자 바로 닫았다. 10월 6일에 한 번 더 열어 모델 목록만 보고 닫았다. 제대로 쓴 건 이번이 처음이다. 미뤄 온 이유는 네 가지였다.

하나, 원래 쓰려던 Gemini CLI 가 막혀 있었다. 7월에 Gemini CLI 를 써 보려고 로그인했는데, 개인 계정으로는 이미 쓸 수 없었다. Google 은 2026년 6월 18일부터 Gemini CLI 가 Google AI Pro · Ultra · 무료 개인 계정의 요청을 더 받지 않는다고 공지했고, 그 자리를 Antigravity CLI 로 넘겼다. 기업용 Gemini Code Assist 라이선스와 API 키 사용자만 그대로다. 그래서 같은 날 agy 를 깔긴 했지만, 쓰던 도구가 갑자기 다른 이름의 도구로 바뀐 셈이라 손이 가지 않았다.

둘, Gemini 의 코딩 실력이 아쉬웠다. 코드와 문서는 이미 Claude 와 Codex 로 충분히 돌아가고 있었다. 굳이 세 번째 에이전트를 붙일 만큼 Gemini 모델이 낫다는 느낌을 받지 못했다.

셋, Orca 에서 써도 되는지 불분명했다. Antigravity 추가 약관 6조에는 이런 문장이 있다.

"Using third party software, tools, or services to access the Service (e.g. using OpenClaw with Antigravity OAuth) is a breach of this Agreement."

제3자 소프트웨어로 서비스에 접근하면 약관 위반이고, 계정 정지 사유가 될 수 있다는 내용이다. Orca 같은 도구 안에서 구독 계정으로 로그인한 agy 를 돌리는 게 여기에 해당하는지가 애매했다. 이 고민을 나만 한 건 아니다. Google AI 개발자 포럼에는 "Orca 로 agy 를 써도 약관 위반이 아니냐"는 글을 비롯해 같은 질문이 9 ~ 10월에 여러 개 올라와 있다. 다만 이 글을 쓰는 시점까지 Google 의 공식 답변은 찾지 못했다.

넷, Gemini 4 Argon 을 쓸 수 없었다. 9월 30일에 발표된 Argon 은 처음엔 보안 파트너 일부에게만 열렸다. Google AI Pro 구독으로는 그림의 떡이었다.

이번에 다시 꺼낸 건 넷째 이유가 풀렸기 때문이다. 10월 13일부터 Argon 이 Antigravity 앱과 CLI 에서 Pro 구독자에게도 열렸다. 마침 이미지 작업에서 나노바나나를 써 보고 싶던 참이라 한번 붙여 보기로 했다.

agy 가 뭔가

agy 는 Antigravity 의 터미널판 에이전트다. Claude Code 처럼 터미널에서 대화하면서 파일을 읽고, 명령을 실행하고, 코드를 고친다. 쓴 버전은 1.4.12 이고, Google AI Pro 구독 계정으로 로그인하니 별도 API 키 없이 바로 쓸 수 있었다.

Gemini 뿐 아니라 Claude 모델과 GPT-OSS 까지 목록에 있다는 점이 눈에 띄었다.

Gemini CLI 와는 뭐가 다른가

이름만 바꾼 후속판으로 생각했는데, 써 보니 사실상 다른 도구다.

	Gemini CLI	Antigravity CLI (agy)
개인 계정	2026-06-18 부터 요청을 받지 않음	Google AI Pro · Ultra 구독으로 사용
만든 방식	TypeScript · Node.js, 오픈소스	Go 로 컴파일된 단일 실행 파일[1]
고를 수 있는 모델	Gemini 계열	Gemini + Claude + GPT-OSS
이미지 생성	확장으로 따로 붙여야 함	이미지 생성 서브에이전트가 들어 있음
설정 위치	~/.gemini/	~/.gemini/antigravity-cli/

옮겨 타는 길도 마련돼 있다. Google 공지에 따르면 설치 프로그램이 기존 Gemini CLI 폴더를 찾아 스킬 · MCP 서버 설정 · 에이전트 프로필을 복사하고, 프로젝트의 gemini.md 도 그대로 읽는다. 기존 ~/.gemini/ 는 건드리지 않아서 되돌아갈 수도 있다. 재미있는 건 반대 방향도 된다는 점이다. agy 1.4.11 변경 기록에는 agy plugin import claude 로 Claude Code 에 설치한 플러그인을 가져오는 기능을 고친 내용이 있다.

다만 ~/.gemini/ 아래를 같이 쓰다 보니, Gemini 시절에 깔린 플러그인이 agy 에도 영향을 준다. 이번에 겪은 텔레메트리 훅 문제가 바로 그 경우였다(아래에서 다룬다).

Gemini 4 Argon 은 어떤 모델인가

Argon 은 Google 이 2026년 9월 30일에 발표한 Gemini 4 세대의 첫 모델이다. 실제 소프트웨어 엔지니어링, 지식 노동, 보안 방어처럼 길고 복잡한 작업을 겨냥했고, 출력 한도가 100만 토큰이라는 점을 앞세웠다.

공개는 두 단계로 이뤄졌다.

1. 9월 30일 발표 — Google 의 보안 프로그램(Fairwind)에 참여한 파트너에게만 제한 공개.
2. 10월 13일 확대 — Antigravity 데스크톱 앱과 CLI 에서 Google AI Pro · Ultra 구독자에게 공개. Antigravity 공식 계정에 따르면 Pro 에는 기존 Gemini 사용량과 별도로 주 단위 Argon 사용량이 붙는다. Gemini API 에서는 11월 30일까지 입력 100만 토큰당 2달러, 출력 100만 토큰당 10달러의 출시 기념 가격이다.

Google 이 Antigravity 블로그에 밝힌 사내 사용 결과도 있다. 4주 동안 에이전트가 쓴 코드가 35% 늘고 배포 후 롤백이 30% 줄었으며, 열려 있던 버그 134개 중 97개를 세 시간 안에 닫았다고 한다. 모두 Google 이 직접 낸 수치라 그대로 믿기보다는 방향을 보여주는 정도로 읽었다.

agy 에서는 gemini-4-argon-low · medium · high 세 단계로 고를 수 있고, 이번 작업은 기본값인 Medium 으로 했다.

Orca 에서 쓰는 법

1. agy 를 설치하고 로그인한다

Orca 는 에이전트를 직접 설치해 주지 않고, 이미 설치된 CLI 를 띄우는 역할이다. Google 공지에 나온 설치 명령은 이렇다.

# Windows PowerShell
irm https://antigravity.google/cli/install.ps1 | iex

# macOS · Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash

설치 후 터미널에서 agy 를 한 번 실행해 Google 계정으로 로그인해 두면 준비가 끝난다. 구독 계정이 여럿이라면 처음 뜨는 화면에서 계정과 요금제(Google AI Pro 등)가 맞는지 확인하자. 다른 계정으로 들어가 있으면 /logout 후 다시 로그인하면 된다.

2. Orca 에서 Antigravity 에이전트를 연다

Orca 의 에이전트 목록에 antigravity 가 들어 있어서, 워크트리에서 새 에이전트 탭을 열 때 고르면 된다. CLI 로도 똑같이 할 수 있다.

# 현재 워크트리에 agy 탭을 열고 그 탭으로 이동
orca agent launch --agent antigravity --focus

# 모델을 지정해서 열기 (모델 ID 는 agy models 로 확인)
orca agent launch --agent antigravity --model gemini-4-argon-high --focus

같은 워크트리에 Claude 탭과 agy 탭이 나란히 열리고, Orca 는 각 터미널이 어떤 에이전트인지 알아서 구분한다.

3. 자주 쓰게 되는 agy 옵션

옵션	하는 일
-c / --continue	가장 최근 대화 이어가기
--conversation <ID>	특정 대화 다시 열기
--mode plan	바로 고치지 않고 계획부터 세우기
-p "질문"	대화 창 없이 한 번 묻고 결과만 받기
--effort high	추론 강도 지정
/model	대화 중에 모델 바꾸기

실제로 해 본 것 — 히로인 다섯 명 그리기

첫 관문: 도구가 전부 막혔다

시작하자마자 걸렸다. "설정 문서를 읽었는지부터 확인해 봐" 라고 했더니, agy 가 파일을 하나도 못 읽는다고 답했다. 원인은 Google Cloud 확장이 깔아 둔 텔레메트리 플러그인의 훅(도구를 실행하기 전에 먼저 도는 검사 스크립트)이었다. 훅 설정에 들어간 스크립트 경로에 큰따옴표가 문자 그대로 섞여 들어가서, Node.js 가 그 경로를 상대경로로 읽고 앞에 폴더 경로를 한 번 더 붙여 버렸다.

Cannot find module
'C:\Users\...\googlecloudtools.datacloud_telemetry\"C:\Users\...\telemetry_hook_bundle.js"'

재미있는 건 그다음이다. "그럼 그 플러그인을 지워 줘" 라고 했더니 agy 가 자기는 지울 수 없다고 답했다. 모든 도구 호출 앞에 그 훅이 먼저 도는데 훅이 깨져 있으니, 파일을 지우는 도구조차 실행되기 전에 막힌다는 것이다. 결국 ~/.gemini/config/plugins/ 아래의 해당 폴더를 직접 지웠고, 그 뒤로는 바로 정상으로 돌아왔다.

프로젝트 지침은 어떻게 읽을까

이 프로젝트는 Claude Code 용 CLAUDE.md 와 범용 AGENTS.md 를 같이 두고 있어서, agy 가 어느 쪽을 읽는지 물어봤다. agy 의 설명은 이렇다.

• AGENTS.md 는 세션이 시작될 때 자동으로 읽어서 처음부터 알고 시작한다.
• CLAUDE.md 는 자동으로 읽지 않는다. 다만 AGENTS.md 에 "작업 전에 CLAUDE.md 를 읽어라"라고 적어 두었기 때문에 첫 요청 때 도구로 열어 읽는다.

실제로 플러그인 문제를 해결하고 나니 지침 문서와 설정 문서 13개를 먼저 읽고, 히로인 다섯 명의 나이 · 체형 · 외형 · 복장을 표로 정리해서 보여줬다. 여러 에이전트를 같이 쓴다면 공통 지침은 AGENTS.md 에 두고, 도구별 파일은 거기서 가리키는 구조가 편하다는 걸 확인했다.

1차: 프롬프트만으로, 서브에이전트 다섯 개가 동시에

"이미지는 어떤 모델로 만들어?" 라고 물으니, agy 안의 이미지 생성 서브에이전트(image-generator)가 Gemini 이미지 모델, 그러니까 나노바나나로 그린다고 했다. 기존 그림은 Codex 의 이미지 생성으로 뽑은 것이라 비교하기 딱 좋았다.

조건은 단순하게 잡았다. 기존 그림을 레퍼런스로 넣지 않고, 프롬프트 문서만으로 단독 전신 일러스트를 한 장씩. 요청을 받은 agy 는 다섯 명 각각에 서브에이전트를 하나씩, 총 다섯 개를 동시에 띄웠다. 다 끝날 때까지 기다리지 않고 마리엘, 하린 순으로 끝나는 대로 저장하고 알려줬다.

정리 과정에서 작은 일도 하나 있었다. 생성된 파일은 대화별 작업 폴더(~/.gemini/antigravity-cli/brain/<대화 ID>/)에 JPG 로 떨어지는데, PNG 로 받고 싶었다. agy 가 처음엔 파이썬 PIL 로 변환하려다 실패하자, 스스로 PowerShell 의 System.Drawing 으로 바꿔서 다섯 장을 PNG 로 옮겨 놓았다.

agy 는 결과를 한 장씩 설정과 대조해 검수 보고도 올렸다. 설정과 어긋난 곳을 스스로 짚어낸 게 인상적이었다.

• 아델: 콘텐츠 필터를 피하려고 의상 표현을 바꾸면서, 배가 드러나는 갑옷 대신 복부까지 덮는 판금 흉갑으로 나왔다. 왼쪽 눈썹 끝에만 있어야 할 흉터가 양쪽 눈가에 대칭으로 들어갔다.
• 베아: 왼쪽 눈 밑 점 말고도 입가에 점이 하나 더 생겼다.
• 하린: 목덜미 뒤에 있어야 할 흉터가 목 옆으로 옮겨 왔다.
• 라냐 · 마리엘: 설정과 거의 그대로였다.

하지만 기존 채택본과 나란히 놓고 보니 차이가 컸다. 그때 남긴 말이 이거다.

어우 순수 프롬프트만으로는 퀄리티의 차이가 너무 많이 나네.

2차: 기존 채택본을 레퍼런스로 붙여서

그래서 바로 두 번째 시험으로 넘어갔다. 이번엔 기존 채택본(Codex 로 뽑아 고른 인물 시트)을 레퍼런스 이미지로 붙이고 같은 다섯 명을 다시 그렸다. agy 는 이미 떠 있던 서브에이전트 다섯 개에 메시지를 보내 일을 이어 시켰고, 1차 결과는 {이름}-prompt-only.png 로 이름을 바꿔 비교용으로 남겨 뒀다.

결과는 확연히 달랐다. agy 의 검수 보고로는 선화와 채색 화풍, 얼굴, 등신 비율, 의상 디테일이 채택본을 그대로 따라왔고, 1차에서 목 옆에 찍혔던 하린의 흉터 위치도 바로잡혔다. 프로젝트 문서에 미리 적어 둔 "나노바나나는 붙인 그림의 몸을 글보다 훨씬 잘 따른다"는 설명이 그대로 맞아떨어졌다.

새로 생긴 문제도 하나 있다. 프롬프트에 들어 있던 "Korean web novel cover" 라는 표현 때문에, 그림 한쪽 구석에 엉뚱한 표지 글씨가 그려졌다. 표지용 문구는 그림 생성 프롬프트에서 빼 두는 게 낫겠다.

좋았던 점

하나, 에이전트를 바꿔도 작업 공간은 그대로다. 같은 워크트리에 Claude 탭과 agy 탭을 나란히 열어 두고, 문서 정리는 Claude 에게, 이미지는 agy 에게 맡기는 식으로 나눠 쓸 수 있었다. 에이전트마다 터미널 창을 따로 관리할 필요가 없다.

둘, 세션 검색이 에이전트를 가리지 않는다. Orca 의 orca search 로 검색하면 Claude 세션과 Antigravity 세션이 한 목록에 같이 나오고, 각 결과에 다시 여는 명령까지 붙어 나온다.

Antigravity  2026-10-31  C:\...\images 해당경로에 agy 폴더를 하나더 만들어서 ...
    resume: agy --conversation "26e408c2-..."

"그때 그 이미지 작업 어디서 했더라"를 에이전트별로 따로 뒤질 필요가 없다.

셋, 이미지 생성이 CLI 안에 들어 있다. 별도 API 키나 스크립트 없이, 대화하듯 "다섯 명 한 장씩"이라고 하면 서브에이전트가 병렬로 그려서 원하는 폴더에 넣어 준다. 레퍼런스를 붙여 다시 그리라고 하면 떠 있던 서브에이전트에 일을 이어 맡긴다. 구독 하나로 코딩 에이전트와 이미지 생성을 같이 쓸 수 있다는 점도 컸다.

넷, 모델 선택지가 넓다. Gemini 계열은 물론 Claude 모델도 고를 수 있어서, 같은 agy 환경 안에서 모델만 바꿔 비교해 볼 수 있다.

아쉬웠던 점

• 첫 실행의 플러그인 훅 문제. 훅 하나가 깨지면 에이전트가 스스로 고칠 방법도 없이 완전히 멈춘다. 원인 진단과 해결 방법 안내는 정확했지만, 결국 사람이 손으로 지워야 했다. Gemini CLI 시절 설정 폴더를 같이 쓰는 구조라 생긴 일이기도 하다.
• 이미지는 프롬프트 표현에 민감하다. 의상 묘사 일부가 콘텐츠 필터에 걸려서 agy 가 표현을 순화한 뒤에 생성했고, 그만큼 결과가 설정에서 벗어났다. 반대로 표지용 문구는 그림 속 글씨로 튀어나왔다.
• 약관 문제는 여전히 회색 지대다. Orca 는 손대지 않은 agy 실행 파일을 터미널에서 띄울 뿐이지만, 그게 약관이 말하는 "제3자 도구로 접근"에 해당하는지는 Google 이 아직 답하지 않았다. 구독 계정이 걸린 문제라 각자 약관을 읽고 판단해야 한다.

돌아보며

석 달 동안 깔아만 두었던 agy 를 다시 꺼내게 한 건 결국 모델이었다. Gemini CLI 가 막혔을 때도, 약관이 애매할 때도 움직이지 않다가, Argon 이 Pro 구독에 열리고 나노바나나를 써 볼 일이 생기자 바로 붙여 보게 됐다.

써 보고 나니 agy 는 "Claude Code 대신 쓸 도구"로 보기보다는, Orca 라는 같은 작업대 위에 올려 둔 도구 하나로 쓰는 게 잘 맞았다. 코드와 문서는 원래 쓰던 에이전트에게, 이미지처럼 Gemini 가 강한 일은 agy 에게 맡기고, 결과는 같은 폴더와 같은 검색 화면에서 모아 보는 식이다.

그리고 두 가지를 배웠다. 이미지 일관성은 프롬프트를 다듬는 것보다 레퍼런스 한 장을 붙이는 쪽이 훨씬 빠르다. 여러 에이전트를 같이 쓰려면 지침 파일 구조를 먼저 정리해 두는 게 생각보다 중요하다. AGENTS.md 를 입구로 두고 나머지 문서를 거기서 가리키게 해 두니, 처음 써 보는 agy 도 첫 요청부터 프로젝트 규칙을 따라왔다.

참고

• Important Update: Gemini CLI Has Stopped Serving Requests for Individual Accounts — Gemini CLI 개인 계정 중단 공지(2026-06-18)
• Google Antigravity 추가 약관 — 6조 제3자 도구 조항
• Support for Orca Agent IDE — Orca 와 agy 약관 질문(Google AI 개발자 포럼)
• Google releases Gemini 4 Argon — TechCrunch, 2026-09-30
• Gemini 4 Argon in Google Antigravity — Antigravity 블로그, 2026-10-13
• Antigravity CLI (agy): Install, Migrate from Gemini CLI — 설치 · 마이그레이션 정리

---

1. Go 로 만들어졌다는 점과 소스가 공개되지 않았다는 점은 Google 공식 문서가 아니라 The New Stack 등 외부 글에 근거한다. ↩︎