Google Antigravity Remote Control: 휴대전화로 에이전트를 제어하는 방법
Markdown데스크톱의 Google Antigravity와 CLI에서 Remote Control을 활성화하는 방법: 토글, agy remote-control daemon, 연결 문제가 있을 때 해야 할 일.
전체 글 읽기
Ailoot 문서 — 서비스 사용에 관한 참고 자료입니다.
핵심 요점
데스크톱 Antigravity 2.0에서는 Settings → App의 토글을 켜 Remote Control을 활성화합니다. 같은 Google 계정으로 antigravity.google.com에서 세션에 연결할 수 있습니다. Antigravity CLI에는 두 가지 모드가 있습니다. /remote-control(또는 --remote-control 플래그)은 터미널 세션이 지속되는 동안 터널을 열고, agy remote-control start는 열린 터미널 없이 백그라운드 데몬을 시작합니다. Linux에서는 로그아웃한 후에도 데몬이 계속 실행되고 재부팅 후 시작됩니다. Windows에서는 관리자가 설치해야 이 기능을 사용할 수 있습니다. macOS와 일반적인 Windows 설치에서는 다음 로그인 시 다시 실행됩니다. 컴퓨터는 켜져 있고 인터넷에 연결되어 있어야 합니다. 계정 또는 조직 정책이나 요금제 조건에 따라 기능을 사용할 수 없을 수 있습니다.
아직 Antigravity를 설치하지 않았다면 먼저 Google Antigravity란 무엇이며 설치하는 방법을 살펴보세요. 이 가이드는 에이전트가 긴 작업(리팩터링, 테스트 실행, 종속성 마이그레이션 등)을 처리하는 동안 책상에서 자리를 비우되 세션 제어권은 유지해야 하는 경우를 위한 내용입니다.
Remote Control이란 무엇이며 왜 필요한가요?
Remote Control은 Google Antigravity의 기능으로, 여러 컴퓨터의 데스크톱 및 CLI 세션에 안전하게 연결하고 웹 브라우저에서 제어할 수 있게 해줍니다. 공식 설명에 따르면 전체 하위 시스템 리팩터링, 장시간 테스트 실행, 복잡한 종속성 마이그레이션 같은 대규모 작업에는 시간이 오래 걸릴 수 있습니다. Remote Control을 사용하면 컴퓨터에서 떨어져 있을 때도 세션을 관리하면서 전체 개발 환경은 로컬에 유지할 수 있습니다.
이 기능은 데스크톱 앱 2.0과 CLI(터미널 버전 Antigravity인 agy)에서 모두 작동하지만, 각 환경에서 활성화하는 방법과 작동 방식은 다릅니다.
데스크톱 Antigravity 2.0에서 Remote Control 활성화하기
앱 설정에서 Remote Control을 활성화할 수 있습니다.
Cmd + ,(Linux 및 Windows에서는Ctrl + ,)를 눌러 Settings 패널을 열거나 왼쪽 패널 아래쪽의 Settings 버튼을 클릭합니다.- App 섹션으로 이동합니다.
- Enable Remote Control을 On으로 전환합니다.
- (선택 사항)
workstation-primary또는server-machine같은 Nickname을 설정하면 연결된 기기 목록에서 이 컴퓨터를 쉽게 알아볼 수 있습니다.
휴대전화 또는 다른 브라우저에서 연결하기
원격 세션을 열려면 다음 단계를 따르세요.
- 기기에서 브라우저를 열고 Antigravity Remote Control 대시보드로 이동합니다. 휴대전화에서는 홈 화면에 웹 앱을 설치해 에이전트가 작업을 마치거나 응답을 요청할 때 푸시 알림을 받을 수도 있습니다.
- 데스크톱에서 사용하는 것과 같은 Google 계정으로 로그인합니다.
- 기기 전환기에서 원하는 컴퓨터를 선택합니다.
- 연결되면 활성 대화를 확인할 수 있고, 에이전트에 새 작업을 시작시키며 구현 계획과 아티팩트를 볼 수 있습니다.
웹 인터페이스에 컴퓨터가 표시되지 않으면 공식 안내에 따라 다음 세 가지를 확인하세요. Antigravity가 실행 중인 컴퓨터에서 Enable Remote Control 토글이 켜져 있는지, 해당 컴퓨터가 인터넷에 연결되어 있고 절전 상태가 아닌지, 데스크톱 앱과 브라우저에서 같은 Google 계정을 사용하는지 확인합니다.
연결에 사용하는 기기의 네트워크 연결이 일시적으로 끊기면 웹 인터페이스가 자동으로 다시 연결을 시도합니다. Antigravity가 실행 중인 컴퓨터가 인터넷에 연결된 상태라면 에이전트의 백그라운드 작업과 터미널에서 시작한 명령은 중단 없이 계속 실행됩니다.
Antigravity CLI의 두 가지 Remote Control 모드
CLI에는 두 가지 모드가 있습니다. 특정 터미널 프로세스에 연결되는 대화형 모드와 열린 터미널 없이 실행되는 백그라운드 헤드리스 데몬입니다.
대화형 모드: /remote-control
CLI를 다시 시작하지 않고 현재 대화형 agy 세션에서 Remote Control을 활성화할 수 있습니다. 입력 줄에 다음을 실행합니다.
/remote-control
공식 설명에 따르면 CLI는 현재 세션을 위한 연결, 즉 역방향 터널을 열고 다른 기기에서 활성 대화에 접속할 수 있도록 호스트 이름과 링크를 출력합니다.
Remote control on for this session.
Hostname: devbox-swift-falcon
Open https://antigravity.google.com/r/<instance-id>?p=c%2F<conversation-id> on another device to continue this conversation.
이 링크를 노트북, 태블릿 또는 휴대전화의 브라우저에서 열고, CLI에서 사용하는 것과 같은 Google 계정으로 로그인한 다음 Antigravity 웹 인터페이스에서 세션을 계속 진행합니다.
로컬 터미널 세션을 종료하지 않고 터널을 비활성화하려면 다음을 실행합니다.
/remote-control off
시작 시 플래그를 사용해 Remote Control이 이미 활성화된 상태로 CLI를 실행할 수 있습니다.
agy --remote-control
대화형 모드는 agy 프로세스에 연결됩니다. CLI를 종료하거나(/exit, Ctrl+C, Ctrl+D) 터미널 창을 닫으면 Remote Control 터널이 자동으로 종료되고 대시보드에서 세션 항목이 사라집니다. 각 대화형 CLI 프로세스에는 별도의 세션 ID와 호스트 이름이 있으므로 여러 터미널 탭이나 작업 디렉터리에서 agy --remote-control을 동시에 실행할 수 있습니다.
브라우저에서 대화형 CLI 세션에 연결하면 양쪽이 실시간으로 동기화됩니다. 원격 기기에서 보낸 요청은 로컬 터미널로 곧바로 전달되고, 에이전트의 추론, 도구 호출, 코드 변경 사항은 원격 인터페이스에 표시됩니다. 에이전트가 확인을 요청하거나(y/n) 추가 질문을 하면 휴대전화나 로컬 터미널에서 응답할 수 있습니다. 설정은 예외입니다. 원격 웹 인터페이스에서는 설정을 변경할 수 없으며 CLI에서만 변경할 수 있습니다.
헤드리스 데몬: agy remote-control start
두 번째 모드는 OS 서비스로 등록되는 지속형 백그라운드 데몬입니다. 컴퓨터가 켜져 있고 인터넷에 연결되어 있는 동안 사용할 수 있으며, 로그아웃 및 재부팅 후의 동작은 플랫폼에 따라 다릅니다.
agy remote-control start
데몬은 OS 서비스(Linux에서는 systemd 사용자 서비스, macOS에서는 LaunchAgent, Windows에서는 예약 작업)로 등록되며, 터미널 창을 열지 않아도 즉시 시작됩니다.
agy remote-control status를 사용해 항목 이름을 확인합니다. 그런 다음 Antigravity Remote Control 대시보드에서 이 컴퓨터를 선택하고 Antigravity 웹 인터페이스에서 작업을 이어갑니다.
데몬은 다음 세 가지 명령으로 제어합니다.
agy remote-control start 데몬 등록 및 시작
agy remote-control status 데몬 상태와 인스턴스 이름 표시
agy remote-control stop 데몬 중지 및 등록 해제
데몬은 CLI에 로그인할 때 사용한 자격 증명을 사용합니다. CLI 로그인은 같은 컴퓨터의 Antigravity 데스크톱 편집기 로그인과 별개입니다. 브라우저에서는 CLI와 같은 Google 계정을 사용하세요.
시작할 때 --name 플래그를 사용해 헤드리스 데몬의 컴퓨터 이름을 설정할 수 있습니다.
agy remote-control start --name "my-workstation"
새 값으로 start --name을 다시 실행하면 컴퓨터 이름이 바뀝니다.
이름을 설정하지 않으면 데몬은 처음 시작할 때 기억하기 쉬운 이름(예: my-machine-distant-plume)을 생성합니다. agy remote-control status에서 현재 이름을 확인할 수 있습니다. 설정 파일에서도 이름을 바꿀 수 있습니다. Linux/macOS에서는 ~/.gemini/config/config.json, Windows에서는 %USERPROFILE%\.gemini\config\config.json을 열고 cliRemoteControlHostname 값을 변경한 뒤 저장하고 agy remote-control start를 실행해 데몬을 다시 시작합니다. 서비스가 다시 시작되면 대시보드에 새 이름이 표시됩니다. 데몬 실행 중에는 파일 변경 사항이 적용되지 않습니다.
파일에는 서로 비슷한 필드가 두 개 있습니다. cliRemoteControlHostname은 여기서 설명하는 CLI 데몬의 이름입니다. remoteControlHostname은 같은 컴퓨터의 Antigravity 데스크톱 편집기에 별도로 사용되는 필드입니다. Antigravity 2.0에서는 Settings → App에서 변경할 수 있습니다.
로그아웃 및 재부팅 후 데몬의 작동 방식
동작은 OS에 따라 다릅니다.
| 동작 | Linux | macOS | Windows |
|---|---|---|---|
| 시작 | 부팅 시. 로그인 불필요 | 로그인 시 | 부팅 시(관리자가 설치한 경우), 그렇지 않으면 로그인 시 |
| 로그아웃 후 실행 | 예 | 아니요. 다음 로그인 시 다시 실행 | 부팅 시 시작하도록 설정한 경우 예 |
| 장애 후 자동 복구 | 예 | 예 | 최대 세 번 재시작을 시도한 뒤 다음 부팅 시 또는 agy remote-control start를 다시 실행할 때 복구 |
Windows 전용 세부 정보
시스템 부팅 시 데몬을 자동 시작하도록 등록하려면 관리자 권한으로 실행해야 합니다. PowerShell이나 일반 명령 프롬프트를 사용할 수 있습니다. start 명령은 일반 창에서도 작동하지만, 로그아웃하거나 재부팅한 후에는 부팅 시가 아니라 다음 로그인 시 데몬이 다시 실행됩니다. status와 stop 명령은 권한 상승 없이 일반 창에서 사용할 수 있습니다.
어떤 모드를 선택해야 하나요?
| 기준 | 대화형(/remote-control / agy --remote-control) | 헤드리스 데몬(agy remote-control start) |
|---|---|---|
| 범위 | 대화형 터미널 세션 하나 | 컴퓨터 전체(백그라운드 OS 서비스) |
| 수명 주기 | Remote Control이 활성화되고 터미널 세션이 실행되는 동안 활성 상태 | Linux 및 관리자가 설치한 Windows에서는 로그아웃 및 재부팅 후에도 유지됩니다. macOS 및 일반적인 Windows 설치에서는 다음 로그인 시 다시 실행됩니다. |
| 항목 이름 | 세션마다 새로 생성(예: host-swift-falcon) | 컴퓨터별로 고정된 이름 하나(--name 또는 cliRemoteControlHostname) |
| 동시 사용 | 한 컴퓨터에서 여러 터미널 세션을 동시에 실행 | 컴퓨터 한 대당 데몬 서비스 하나 |
| 직접 링크 | CLI가 활성 대화 링크를 출력 | antigravity.google.com의 기기 전환기를 통해 접속 |
| 적합한 용도 | 활성 터미널 작업에서 자리를 비우고 휴대전화나 브라우저에서 이어서 작업하기 | OS 조건에 따라 컴퓨터가 켜져 있고 인터넷에 연결된 동안 워크스테이션이나 서버에 지속적으로 원격 접속하기 |
대화형 모드만으로도 휴대전화에서 현재 작업을 관리할 수 있습니다. 열린 터미널 없이 원격 접속해야 한다면 OS 조건에 따라 헤드리스 데몬을 사용하세요.
연결 문제가 있을 때 해야 할 일
공식 문서에서 제시하는 문제와 해결 방법입니다.
| 표시되는 내용 | 이유 | 해결 방법 |
|---|---|---|
Remote control is not enabled for your account | 계정 또는 조직 정책에서 Remote Control 기능을 활성화하지 않았습니다 | 워크스페이스 관리자에게 문의하거나 요금제가 Remote Control을 지원하는지 확인합니다 |
| 대시보드에서 항목이 사라짐(CLI) | /remote-control 및 agy --remote-control은 대화형 세션을 종료하거나(/exit, Ctrl+C) /remote-control off를 실행하면 자동으로 연결이 끊기는 터널을 생성합니다 | 열린 터미널 없이 컴퓨터를 계속 사용 가능하게 해야 한다면 agy remote-control start로 헤드리스 데몬을 설치합니다 |
| 대시보드에 같은 컴퓨터의 CLI 항목이 여러 개 표시됨 | 대화형 CLI 세션마다 고유한 호스트 이름이 있습니다. 터미널을 여러 개 열었을 때 나타나는 정상적인 동작입니다 | 조치가 필요하지 않습니다. 예상된 동작입니다 |
| 대시보드에 컴퓨터가 표시되지 않음(데몬) | CLI 로그인에 문제가 있을 수 있습니다 | agy remote-control status를 실행합니다. 로그인 문제가 표시되면 agy를 실행해 다시 로그인한 다음 agy remote-control start를 다시 실행합니다 |
| 이름 변경이 적용되지 않음 | 데몬이 시작될 때 이름을 읽습니다 | agy remote-control start를 다시 실행해 데몬을 재시작합니다 |
| Windows에서 데몬이 부팅 시가 아니라 로그인 시에만 시작됨 | start 명령을 관리자 권한 없이 실행했습니다 | 권한 상승된 창에서 agy remote-control start를 다시 실행합니다 |
| 연결이 계속 끊겼다 다시 연결됨 | 설치 스크립트로 설치한 이전 데몬이 아직 등록되어 새 데몬과 연결을 놓고 경쟁하고 있을 수 있습니다 | agy remote-control start를 다시 실행합니다. 이전 서비스는 자동으로 제거됩니다 |
| 대시보드에 한 컴퓨터의 비슷한 항목 두 개가 표시됨 | 하나는 편집기 항목이고 다른 하나는 CLI 데몬 항목입니다. 서로 별개로 의도된 항목입니다 | 구분해야 하는 항목의 이름을 바꿉니다 |
| 웹 대시보드에 컴퓨터가 표시되지 않음(데스크톱) | 토글이 꺼져 있거나, 인터넷 연결이 없거나, 컴퓨터가 절전 상태이거나, 서로 다른 Google 계정을 사용 중일 수 있습니다 | Enable Remote Control 토글, 컴퓨터의 인터넷 연결, 컴퓨터의 절전 여부, 양쪽에서 같은 계정을 사용하는지 확인합니다 |
자세한 진단을 위해 데몬 로그를 확인하세요. Linux에서는 journalctl --user -u antigravity-cli-daemon -n 50을 실행하고, macOS에서는 ~/Library/Logs/antigravity-cli-daemon.log를 확인하며, Windows에서는 %USERPROFILE%\.gemini\antigravity-cli\log에서 가장 최근의 cli-*.log 파일을 확인합니다.
헤드리스 데몬을 사용하면 터미널을 열지 않고도 접속할 수 있으며, 컴퓨터 및 OS의 작동 조건이 충족되면 자리를 비운 동안에도 사용할 수 있습니다. 지속적인 접속이 더 이상 필요하지 않으면 agy remote-control stop으로 데몬을 중지합니다.
Claude Code의 원격 제어에 관한 별도 문서도 있습니다. Telegram을 통해 다른 에이전트를 제어하려면 Telegram에서 Hermes Agent 설정하기를 참고하세요.
다음 단계
CLI에서 작업하며 현재 작업 도중 자리를 비우려면 대화형 모드로 시작하세요. 터미널은 열린 상태로 두세요. 터미널을 닫으면 터널 연결이 끊기고 대시보드에서 세션 항목이 사라집니다. 열린 터미널 없이 컴퓨터에 접속하려면 OS 제한에 따라 데몬을 사용하세요.
출처
Ailoot 에서 더 많은 자료를 확인할 수 있습니다.
자세히 보기
Google Antigravity Remote Control: 휴대전화로 에이전트를 제어하는 방법: 자주 묻는 질문
터미널을 닫으면 원격 세션이 사라지는 이유는 무엇인가요?
대화형 Remote Control은 실행 중인 agy 프로세스에 속하므로 종료하면 터널도 닫힙니다. 열린 터미널 없이 접속하려면 헤드리스 데몬을 사용하고 운영체제의 시작 조건을 확인하세요.
대시보드에서 내 컴퓨터가 보이지 않으면 무엇을 확인하나요?
컴퓨터가 깨어 있고 온라인인지, Remote Control이 켜졌는지, 브라우저와 데스크톱 또는 CLI가 같은 Google 계정을 쓰는지 확인하세요. 데몬 세션은 agy remote-control status로 로그인이나 서비스 문제를 점검하세요.