휴대폰으로 쓰는 Antigravity CLI, 내 서버에서

agy 명령어인 Antigravity CLI는 Google의 터미널 코딩 에이전트이며, 개인 계정에서는 Gemini CLI를 대체합니다. Google이 이미 휴대폰에서 사용할 방법을 제공하고 있으니 거기서 시작하세요. 그런 다음 Maude로 내 서버에서 실행하는 것이 도움이 되는지 판단하면 됩니다.

Google Remote Control로 할 수 있는 것

Antigravity Remote Control은 Antigravity 데스크톱 세션과 CLI 인스턴스에서 작동합니다. 시작하는 방법은 세 가지입니다.

• 실행 중인 세션 안에서 /remote-control
• 실행할 때 agy --remote-control
• 헤드리스 데몬인 agy remote-control start

그런 다음 같은 Google 계정으로 로그인한 아무 기기의 브라우저에서 Remote Control 대시보드를 엽니다. 휴대폰에서는 웹 앱으로 설치할 수 있고, 에이전트가 작업을 마치거나 입력이 필요할 때 알림을 받습니다. 에이전트가 도구 확인이나 질문으로 멈추면 터미널이나 대시보드에서 답할 수 있습니다. 호스트가 연결되어 있는 동안 작업은 호스트에서 계속됩니다. Google 문서에 따르면 Remote Control은 계정이나 조직 정책 플래그로 비활성화될 수도 있습니다.

무료로 이만큼 할 수 있는 구성이므로, Antigravity만 사용한다면 이것으로 충분할 수 있습니다. Maude와의 구체적인 차이는 다음과 같습니다.

• 브라우저 대시보드가 아닌 네이티브 앱으로, Claude Code, Codex, OpenCode, Grok Build 세션과 같은 받은함과 세션 목록을 사용합니다.
• 직접 설치하거나 계속 실행해 둘 것이 없습니다. Maude가 SSH로 데몬을 배포하고 고정된 버전의 agy를 설치합니다.
• 세션마다 파일, Git, 터미널이 있고, 다른 의견이 필요할 때는 다른 에이전트에게 작업을 넘길 수 있습니다.

서버에서 agy 실행하기

Maude에 서버를 추가하려면 주소를 입력하거나, ssh … 명령을 붙여넣거나, curl -fsSL https://maude.pilotdev.fr/setup | sh가 출력하는 QR 코드를 스캔하세요. Alpine을 포함해 x86-64 또는 ARM의 모든 Linux나 macOS 머신에서 작동합니다. 그다음 데몬이 다음을 수행합니다.

1. 저희가 검증한 버전의 agy를 설치합니다. 버전을 고정할 때 빌드를 Google 자체 매니페스트의 체크섬과 대조하고 그 SHA-256을 기록하며, 이후 모든 설치는 고정된 그 SHA-256으로 검증합니다.
2. agy의 백그라운드 자동 업데이트를 꺼서, Maude가 바꾸기 전까지 검증된 버전을 유지합니다.
3. agy를 헤드리스 stream-json 모드로, 세션마다 하나의 상주 프로세스로 실행하고, 프로세스가 재시작되면 대화를 이어 갑니다.

앱을 닫아도 세션은 계속됩니다. 서버가 종단 간 암호화된 Maude 릴레이로 먼저 연결하므로 인바운드 포트를 열 필요가 없습니다. agy를 직접 설치하고 tmux로 계속 실행하는 수동 방식은 서버에서 Antigravity CLI 실행하기 가이드를 참고하세요.

휴대폰에서 로그인하기

Google의 설치 문서는 SSH 환경에 맞는 로그인을 설명합니다. agy는 원격 머신에 있다는 것을 감지하면 브라우저를 여는 대신 인증 URL을 출력합니다. Maude는 이 흐름을 이렇게 진행합니다.

1. 앱에서 Antigravity의 Sign in with Google을 선택합니다.
2. 휴대폰에서 Google 링크를 열고 승인합니다. Google이 인증 코드를 보여 줍니다.
3. 그 코드를 Maude에 붙여넣습니다. 코드는 서버의 agy로 전달되고, agy가 모델 목록을 불러올 수 있게 되면 Maude가 완료를 확인합니다.

다른 방법은 Gemini API 키입니다. Maude는 agy의 모델 제공자를 Gemini로 설정하고 GEMINI_API_KEY를 전달합니다. 나중에 Maude에서 키를 삭제하면 Maude가 제공자 설정을 되돌리지만, 그 변경을 Maude가 직접 한 경우에만 그렇습니다. agy 설정에서 직접 지정한 제공자는 건드리지 않습니다. Google의 요금 페이지에는 무료 개인 요금제와 함께, 한도를 높여 주는 Google AI Pro와 Ultra가 나와 있습니다.

승인 방식 (솔직한 설명)

Maude에서 agy가 다른 에이전트와 다르게 동작하는 유일한 부분이 여기입니다. 헤드리스 모드의 agy는 도구를 실행하기 전에 멈춰서 물어볼 수 없습니다. 권한이 필요한 작업이 있으면 agy는 이를 차단하고 턴이 끝날 때 거부된 것으로 보고합니다. Maude는 이를 감추지 않습니다. 턴이 끝나면 차단된 작업마다 세 가지 선택지를 보여 줍니다.

• 허용 후 다시 시도는 해당 명령이나 파일에 한정된 허용 규칙을 추가하고, 같은 대화로 agy를 재시작한 뒤 다시 시도하도록 요청합니다.
• 항상 허용은 그 종류의 작업에 대해 더 넓은 규칙을 추가합니다.
• 차단 유지는 규칙 목록을 바꾸지 않습니다.

규칙은 서버에 있는 agy 설정 파일의 자체 허용 목록에 기록되므로 계속 유지되며, 앱도 이를 알려 줍니다. 이런 사후 승인도 다른 승인처럼 받은함과 푸시 알림으로 표시됩니다.

권한 모드는 default(차단된 작업을 나중에 승인 대상으로 제시), 편집 자동 승인(파일 편집은 허용, 명령은 계속 차단하고 승인 대상으로 제시), 계획, yolo(agy의 --dangerously-skip-permissions)입니다. agy에는 전환할 수 있는 읽기 전용 모드나 자동 모드가 없습니다. 제한이 두 가지 더 있습니다. 텍스트 프롬프트만 가능하고(이미지 첨부 불가), Maude에서 /compact나 /goal을 쓸 수 없습니다. 모델과 추론 수준 칩에는 계정에서 사용할 수 있는 모델이 표시됩니다.

Gemini CLI에서 옮겨 오는 경우

Google은 2026년 5월 19일에 발표하여, 2026년 6월 18일부터 Gemini CLI와 Code Assist IDE 확장 프로그램이 Google AI Pro 및 Ultra 구독자와 무료 사용자의 요청을 더 이상 처리하지 않게 했습니다. Gemini Code Assist Standard 또는 Enterprise를 사용하는 조직은 계속 사용할 수 있습니다. 그 밖의 사용자에게는 Antigravity CLI가 대체재이며, Maude가 Gemini CLI가 아닌 agy를 지원하는 이유도 여기에 있습니다.

서버에서 Gemini CLI를 쓰고 있었다면 이전은 대부분 기계적인 작업입니다. agy를 설치하고, 다시 로그인하고, 프로젝트 지침과 설정을 옮기면 됩니다. 무엇이 바뀌었고 지금 무엇을 써야 하는지는 Gemini CLI 종료에 관한 글에서 다룹니다.

agy의 승인은 사후에 이루어지기 때문에, 계획과 리뷰에는 agy를 쓰고 구현은 먼저 물어볼 수 있는 에이전트에게 맡기는 사람도 있습니다. 세션이 유휴 상태일 때 Claude Code나 Codex로 전환할 수 있습니다. 새 에이전트는 계획, 수정한 파일, git 상태, 최근 대화를 담은 요약을 받고, 다시 전환하면 agy 자신의 대화가 이어집니다.

자주 묻는 질문

변경 사항

• 2026년 10월 1일 — 페이지 게시. Remote Control 명령과 대시보드, SSH 로그인, API 키 모드, Gemini CLI 종료 내용을 이 날짜에 Google 문서와 블로그로 확인했습니다. Maude의 agy 드라이버는 agy 1.2.14로 검증했습니다.