Claude Code 내부에서 에디터를 떠나지 않고 Google Antigravity CLI를 사용하는 방법

저는 대부분의 시간을 Claude Code에서 보냅니다. 그곳은 저의 git, 테스트, 편집, 그리고 에이전트 지원 (agent-assisted) 작업이 이루어지는 곳이며, 이를 위해 다른 도구로 이동하는 비용은 실질적입니다. 컨텍스트 스위칭 (context-switching)은 흐름을 깨뜨리기 때문입니다.

몇 주 전 Google이 Antigravity CLI (agy)를 출시했을 때, 저는 그 기능들을 사용하고 싶었습니다. Gemini 3.1 Pro의 추론 (reasoning), 네이티브 Imagen 도구, 내장된 조사 및 검토 흐름 (research and review flows) 같은 것들 말이죠. 하지만 이를 위해 Claude Code를 포기하고 싶지는 않았습니다.

기능 설명

이 플러그인은 Claude Code에 6개의 슬래시 명령어를 추가합니다:

명령어	기능
/agy:setup	설치 및 인증 확인, 사용자를 대신해 agy 설치 가능
...

대부분의 명령어는 --model <alias> 플래그를 허용하며, 이에 대한 자세한 내용은 잠시 후에 설명하겠습니다.

모델 플래그 문제

이것을 만드는 동안 한 가지 사실을 발견했습니다. Antigravity CLI v1.0.2에는 --model 플래그가 없습니다.

$ agy -m claude-opus -p "hi"
flags provided but not defined: -m

...

모델 선택은 TUI (Text User Interface)에서만 가능합니다. agy를 대화형 (interactively)으로 실행하고 /model로 모델을 선택해야 합니다. TUI 안에 있을 때는 괜찮지만, 이는 비대화형 (non-interactively)으로 agy를 호출하는 모든 작업이 마지막으로 선택된 모델에 고정된다는 것을 의미합니다.

저는 Claude Code 내부에서 호출할 때마다 모델을 선택하고 싶었습니다. 그래서 플러그인에 그 기능을 추가했습니다.

작동 메커니즘을 짧게 설명하자면: 래퍼 (wrapper)가 휴대 가능한 락파일 (lockfile)을 가져와서, 한 번의 호출 동안 agy 설정 파일의 "model" 필드를 교체한 뒤, agy -p를 실행하고, SIGINT/SIGTERM 상황을 포함하여 종료 시 원래 상태로 복구합니다. 만약 이전 실행이 SIGKILL에 의해 종료되었다면, 다음 호출 시 고립된 백업을 감지하여 자동으로 복구합니다. 마법은 아니며, 그저 세심한 글루 (glue) 코드일 뿐입니다. 궁금한 분들을 위해 전체 구현 내용은 리포지토리 (repo)에 있습니다.

사용자에게 노출되는 인터페이스는 다음과 같습니다:

/agy:delegate --model opus    auth 모듈 리팩토링(refactor) 해줘
/agy:ask      --model pro     "Go 언어의 탈출 분석(escape analysis)을 설명해줘"
/agy:research --model sonnet  --background  양자 내성 TLS(post-quantum TLS) 조사해줘

8개의 모델이 지원되며, 18개의 짧은 별칭(opus, sonnet, pro, flash, gpt-oss 등)과 선호에 따라 사용할 수 있는 표준 TUI 문자열을 제공합니다.

스택 (Stack)

순수 Bash 기반입니다. 하나의 래퍼 스크립트(wrapper script, 약 400줄), 하나의 서브에이전트(subagent) 정의, 6개의 커맨드 마크다운(command markdown) 파일로 구성됩니다. Node 런타임, 브로커(broker), 리뷰 훅(review hooks)이 필요 없습니다. Bash 3.2와 호환됩니다 (macOS 기본 지원). macOS와 Linux에서 테스트되었으며, WSL2에서도 동일하게 작동할 것입니다.

전체 리포지토리(repo)는 의도적으로 작게 유지되었습니다. Claude Code 플러그인 사양(specification)이 슬래시 커맨드(slash commands), 서브에이전트(subagents), 스킬(skills) 등 필요한 대부분의 기능을 제공하며, 나머지는 단순한 배관 작업(plumbing)에 불과하기 때문입니다.

설치 (Install)

Claude Code에서 다음을 실행하세요:

/plugin marketplace add simplybychris/antigravity-plugin-cc
/plugin install agy@antigravity-cc
/reload-plugins
...

그 다음 /agy:help를 입력하여 전체 인덱스를 확인해 보세요.

향후 계획 (What's next)

v0.4.1은 --model과 /agy:help가 포함된 첫 번째 릴리스입니다. 핵심 기능은 작동합니다. 짧은 데모 영상이 곧 공개될 예정입니다. 추가적인 확장 아이디어들이 있지만, 현재 제가 필요로 하는 기능은 이 정도 수준입니다.

이 아이디어가 마음에 드신다면 GitHub star를 눌러주세요. 큰 힘이 됩니다. 이슈(Issues)와 PR(Pull Requests)은 언제나 환영합니다.