2026년 11월 11일 기준, Google Antigravity의 swarm 모드(/swarm 명령어)는 하나의 프롬프트를 Google의 Gemini 4 Carbon이 이끄는 협업 에이전트 팀으로 변환하는 프리뷰 기능입니다. Gemini 4 Carbon은 2026년 11월 10일 정식 출시(GA)되었으며, /swarm에서는 계획 수립, 조율, 감사 역할을 담당하고, 더 빠르고 가벼운 모델들이 병렬로 격리된 작업 공간에서 작업을 수행하며, 적대적 검증 에이전트들이 모든 변경 사항을 테스트합니다.
아래에서는 팀이 어떻게 구성되는지, Google이 이를 통해 무엇을 만들었는지, 누가 사용할 수 있는지, 아직 밝혀지지 않은 부분은 무엇인지, 그리고 Apidog CLI로 테스트하기 위해 swarm 에이전트에 API 계약을 제공하는 방법을 다룹니다.
Google Antigravity /swarm이란?
/swarm은 Google의 에이전트 우선(agent-first) 개발 플랫폼인 Google Antigravity의 프리뷰 명령어입니다. 프롬프트를 하나 입력하면 Antigravity가 실시간으로 추적할 수 있는 에이전트 팀을 구성합니다. Gemini 4 Carbon은 가장 깊은 추론이 필요한 역할을 담당하고, 가벼운 모델들은 병렬 빌드 작업을 수행하며, 검증 에이전트들은 각 변경 사항이 반영되기 전에 확인합니다.
Google은 Gemini 4 Carbon을 정식 출시하는 발표 글에서 이 기능을 소개했습니다. 프리뷰로 표시되어 있으므로 동작 방식과 접근 규칙은 변경될 수 있습니다.
Antigravity 자체가 처음이라면, Google Antigravity 첫 리뷰와 Antigravity 2.0 플랫폼 업데이트부터 살펴보시기 바랍니다. swarm의 기반이 되는 모델에 대해서는 Gemini 4 Carbon이란? 글을 참고하세요.
참고 사항: 이 가이드를 작성한 환경에는 /swarm 접근 권한이 있는 Antigravity가 설치되어 있지 않아, 아래 내용은 모두 Google의 발표를 기반으로 합니다. 직접 실행한 내용은 없으며, /swarm 외의 명령어 문법은 가정하지 않습니다.
Antigravity 에이전트 swarm은 작업을 어떻게 분배하나?
Antigravity 에이전트 swarm은 작업을 세 가지 유형의 에이전트에 걸쳐 분배합니다:
- 리드(Lead, Gemini 4 Carbon). Google은 개발자가 Carbon을 "아키텍처 설계, 조율 같은 가장 깊은 추론이 필요한 역할"과 감사 역할에 배정할 수 있다고 설명합니다. Carbon은 프롬프트를 작업 단위로 나누고 결과를 판단합니다.
- 워커(Workers, 가벼운 모델). 더 빠르고 저렴한 모델들이 "병렬로 격리된 작업 공간"에서 실행되므로, 두 워커가 작업 중에 서로의 파일을 덮어쓰는 일이 없습니다.
- 검증자(Verifiers, 적대적 에이전트). 별도의 에이전트들이 "모든 변경 사항을 테스트"합니다. 이들의 임무는 무엇이 깨졌는지 찾는 것이지, 코드를 작성한 워커에게 동의하는 것이 아닙니다.
익숙한 패턴(비용이 높은 플래너, 저렴한 병렬 실행자, 독립적인 검증자)을 단 하나의 명령어로 구성한 것입니다.
격리가 중요한 이유는, 하나의 작업 트리를 공유하는 병렬 에이전트들은 충돌하기 때문입니다. 한 에이전트가 함수 이름을 바꾸는 동안 다른 에이전트는 여전히 그 함수를 호출하고 있는 식입니다. 적대적 검증자가 중요한 이유는, 코드를 작성한 에이전트는 자신이 이미 생각한 경로만 테스트하는 경향이 있기 때문입니다.
Google은 /swarm으로 무엇을 만들었나?
Google의 발표에는 세 가지 데모가 소개되어 있습니다. 이는 Google의 쇼케이스이지 독립적인 테스트가 아닙니다:
| 데모 | Google이 말하는 Carbon의 산출물 | Google이 언급한 도구 |
|---|---|---|
| 마운틴 뷰 캠퍼스 게임 | "GBike를 탄 펠리컨"으로 Google의 마운틴 뷰 캠퍼스를 탐험하는 오픈월드 3D 게임 | Antigravity /swarm |
| Google Merchandise Store | "두 개의 프롬프트로 다섯 가지 아트 디렉션 컨셉을 제안하며" 재해석한 스토어 | Carbon (Google 게시글) |
| 코너 홀 포르테피아노 | 토론토 코너 홀의 3D 모델에 배치된, "좌석별 공간 음향"을 갖춘 1780년경 Stein-Schule 포르테피아노(연주 가능) | "Google Antigravity의 멀티 에이전트 루프" |
게임 데모만이 /swarm 사용이 명시적으로 언급되었습니다. 포르테피아노 데모는 Antigravity의 멀티 에이전트 루프로 설명되어 있는데, 이는 비슷하지만 동일한 주장은 아닙니다. 이 내용을 인용할 때는 이 구분을 유지하세요.
누가 Antigravity swarm 모드를 사용할 수 있나?
Google이 밝힌 접근 관련 내용과 각 항목의 출처는 다음과 같습니다:
| 항목 | 세부 내용 | 출처 |
|---|---|---|
| Carbon GA 날짜 | 2026년 11월 10일 | |
| 모델 ID | gemini-4-carbon |
|
/swarm 상태 |
Google Antigravity 프리뷰 | |
| 소비자 접근 | Google AI Ultra 구독자 전체에게 Antigravity, Gemini 앱, Search의 AI Mode로 단계적 배포 | |
| 개발자 접근 | Google AI Studio의 Gemini API와 비즈니스용 Gemini를 통해 유료 개발자 및 기업에 제공 | |
| 초기 API 가격 | 100만 토큰당 입력 $2 / 출력 $10 | |
| 2026년 11월 30일 이후 가격 | 100만 토큰당 입력 $4 / 출력 $20 | Google (각주) |
| 기본 모델 | "대부분의 소프트웨어 엔지니어링 및 지식 작업에는 Argon이 이상적인 선택으로 남습니다" |
Google이 아직 밝히지 않은 것들
발표에는 여러 질문이 열려 있습니다. Google이 공식 문서화하기 전까지는 이에 대해 확신에 찬 답을 내놓는 블로그나 영상은 의심해서 봐야 합니다:
- 에이전트 수 상한. swarm당 최대 에이전트 수는 명시되지 않았습니다.
- 요금제. Google은 Carbon이 Antigravity에서 AI Ultra 구독자에게 배포된다고 말하지만, 어떤 요금제가
/swarm프리뷰를 포함하는지는 밝히지 않았습니다. - 워커용 모델 선택. Google은 모델명을 밝히지 않고 "더 빠르고 가벼운 모델"이라고만 표현했습니다.
- 사용량 제한. swarm 전용 할당량이나 속도 제한은 공개되지 않았습니다.
- 정식 출시.
/swarm이 프리뷰를 벗어나는 날짜는 없습니다.
Gemini 4 Carbon swarm은 얼마나 드나?
Google이 명확히 말하는 한 가지는 Carbon이 더 많이 소비한다는 점입니다. 발표에 따르면 Carbon은 "철저하게 탐색하고 깊이 추론하며 확장된 검증 루프를 실행하기 위해" Argon보다 "더 많은 토큰을 사용"합니다. swarm은 리드가 계획을 세우고, 모든 워커의 산출물을 검토하고, 모든 검증자의 보고서를 읽기 때문에 그 사용량을 배가시킵니다.
실무적으로 알아둘 세 가지:
- 토큰당 요금은 2026년 11월 30일까지 Argon과 동일합니다. Carbon의 초기 가격은 100만 토큰당 입력 $2, 출력 $10으로 Argon과 같습니다. 12월 1일부터는 $4와 $20으로 인상됩니다. Gemini 4 Carbon 가격 분석에서 이 인상을 자세히 다룹니다.
- 같은 요금이 같은 청구액을 의미하지는 않습니다. Carbon이 작업당 더 많은 토큰을 사용한다면, 토큰당 가격이 동일하더라도 Carbon 주도의 작업이 Argon 작업보다 비용이 더 듭니다.
- 구독 vs API. swarm 사용량이 Google AI Ultra 플랜에 어떻게 반영되는지는 공개되지 않았으므로, 프리뷰 기간 동안 사용량 페이지를 주시하세요.
대부분의 편집 작업을 가벼운 워커에게 라우팅하면 Carbon의 토큰은 계획 수립과 감사에 집중됩니다. 이는 Google의 안내, 즉 대부분의 작업에는 Argon, 어려운 부분에는 Carbon을 사용하라는 방침과 일치합니다. Gemini 4 Carbon vs Argon 비교 글에서 그 경계가 어디인지 다루며, Gemini 4 Carbon vs Claude Fable 5.2 글은 Anthropic의 모델과 비교합니다.
Antigravity를 거치지 않고 Carbon을 직접 호출하고 싶다면 Gemini 4 Carbon API 가이드에서 첫 요청 방법을, 더 저렴한 기본 모델은 Gemini 4 Argon API 가이드에서 확인할 수 있습니다.
swarm에 계약을 부여하기: OpenAPI 스펙 + Apidog CLI 테스트
검증 에이전트는 테스트 기준이 되는 "올바름"의 정의만큼만 유용합니다. swarm이 API를 만들거나 변경한다면, 제공할 수 있는 가장 강력한 정의는 OpenAPI 스펙에 실행 가능한 테스트를 더한 것입니다. 그러면 "검증됨"이란 다른 모델이 diff를 읽고 승인했다는 뜻이 아니라, 엔드포인트가 실제 요청을 통과했다는 뜻이 됩니다.
실패는 깨진 요청과 응답을 정확히 담아 워커들에게 되돌아갑니다.
Apidog CLI로 Antigravity 에이전트가 테스트를 실행하도록 하기
Apidog CLI를 사용하면 에이전트가 스펙을 가져오고, 테스트 케이스를 작성하고, 터미널에서 실행할 수 있으며, 에이전트가 읽을 수 있는 JSON 출력을 제공합니다. 클릭으로 무언가를 조작할 필요가 없습니다. 한 번 설정해두면 에이전트가 작업을 수행합니다.
설치 및 로그인:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # pick your agent when prompted
더 빠른 방법: 에이전트에게 "https://apidog.com/apidog-cli-installation-guide.md를 읽고 Apidog CLI를 설정해줘"라고 말하세요. 이 가이드는 에이전트를 위해 작성되었습니다. Antigravity 전용 내용은 Antigravity에서 Apidog CLI 사용 방법을 참고하세요.
그다음 에이전트에게 프롬프트 하나를 주면 됩니다:
Import ./openapi.yaml into Apidog project <projectId> on a new AI branch.
For every endpoint in the spec, create a test case that asserts the status code
and the response schema. Run all cases against environment <envId> and report
each failure with the request, the expected schema and the actual response.
에이전트는 무엇을 작성하기 전에 각 페이로드 스키마를 먼저 읽은 뒤, 다음과 같은 명령어를 실행합니다:
apidog branch create --project <projectId> --type ai --name "ai/20261111-from-main-swarm-contract" --from main
apidog import --project <projectId> --format openapi --file ./openapi.yaml --branch "ai/20261111-from-main-swarm-contract"
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json --branch "ai/20261111-from-main-swarm-contract"
apidog run --test-case <caseId> --project <projectId> --branch "ai/20261111-from-main-swarm-contract" -e <envId> -r cli,json
위의 모든 플래그는 Apidog CLI 2.2.12의 apidog <cmd> --help에서 확인한 것입니다. AI 브랜치는 에이전트가 작성한 변경 사항을 검토 전까지는 메인 브랜치에 반영되지 않게 하므로, 한 번에 많은 엔드포인트를 건드리는 swarm에 적합합니다.
swarm과 함께 이 방식을 잘 활용하는 두 가지 습관:
- 검증자 역할이 코드가 아닌 실행 결과를 보도록 하세요. 프롬프트에서 검증 에이전트에게 diff가 어떻게 보이든
apidog run실패를 실패한 변경으로 취급하라고 지시하세요. - 보고서를 기계가 읽을 수 있게 유지하세요.
-r json은 구조화된 실패 정보를 에이전트에게 제공해 적절한 워커에게 전달할 수 있게 합니다. 나중에 Apidog 앱에서 실행 결과를 검토하려면--upload-report를 추가하세요.
동일한 apidog run ... -r junit 명령어는 CI에 바로 넣을 수 있어, swarm이 테스트에 사용한 계약을 파이프라인이 강제하는 계약으로 만들 수 있습니다. 설정 방법은 CI/CD 파이프라인에서의 Apidog CLI를 참고하세요. Apidog의 Free 플랜은 최대 4명의 사용자를 지원하므로 사이드 프로젝트에서 시도해보기에 충분합니다.
단일 에이전트 대신 /swarm을 언제 써야 하나?
swarm은 폭넓은 작업에 사용하세요: API, 프론트엔드, 마이그레이션을 동시에 다루는 기능이나, 조용한 버그 한 번이 큰 비용을 부르는 빌드 같은 경우입니다. 5분 안에 검토할 수 있는 작은 수정이라면 단일 에이전트(아마 Argon에서)를 유지하는 것이 좋습니다.
FAQ
Google Antigravity /swarm은 무료인가?
Google은 /swarm의 무료 티어에 대해 발표한 바 없습니다. Google에 따르면 Gemini 4 Carbon은 Antigravity에서 Google AI Ultra 구독자에게 배포되며, Gemini API를 통해 유료 개발자에게 제공됩니다. 어떤 플랜에 /swarm 프리뷰가 포함되는지는 밝혀지지 않았습니다.
Antigravity swarm의 에이전트는 어떤 모델이 구동하나?
Google의 Gemini 4 Carbon이 리드 역할(아키텍처, 조율, 감사)을 담당합니다. Google은 병렬 워커를 "더 빠르고 가벼운 모델"이 실행한다고 말하지만 모델명은 밝히지 않았습니다.
swarm은 몇 개의 에이전트를 실행할 수 있나?
Google은 한도를 공개하지 않았습니다. 발표는 구체적인 숫자 없이 "협업 에이전트 팀"이라고만 표현합니다.
/swarm은 내 API 테스트와 함께 작동하나?
Google은 내장 API 테스트 통합에 대해 설명하지 않았습니다. 그래도 에이전트에게 계약을 줄 수 있습니다: OpenAPI 스펙과, 에이전트가 Apidog CLI로 실행하는 테스트를 결합하면 검증자의 통과가 스펙이 약속한 응답을 엔드포인트가 실제로 반환했다는 의미가 됩니다.
Gemini 4 Carbon이 Antigravity의 기본 모델인가?
Google은 대부분의 소프트웨어 엔지니어링 및 지식 작업에는 Carbon이 아니라 Argon이 적합하다고 본다고 설명합니다. Carbon은 더 어려운 작업을 위한 것이며 탐색과 검증에 더 많은 토큰을 사용합니다. 에이전트 작업용 프론티어 모델을 비교 중이라면 Claude Fable 5.2 API 가이드에서 또 다른 선택지를 확인할 수 있습니다.