Gemini 4 Neon과 함께 사용하는 Antigravity 스웜 모드는 다음과 같이 작동합니다: 모델 선택기에서 Gemini 4 Neon을 선택하고, /swarm 뒤에 작업과 검증 방법을 입력하면 현재 대화가 코디네이터가 됩니다. Neon은 작업을 이름이 지정된 워커들에게 분배하고, @verifier를 추가하며, 테스트가 통과하면 결과를 보고합니다. 할당량을 아끼려면 프롬프트에서 Gemini 4 Hydrogen 워커를 요청하세요.
Gemini 4 Neon과 함께하는 Antigravity 스웜 모드란?
/swarm은 Google Antigravity에서 하나의 작업에 이름이 지정된 에이전트 팀을 투입하는 프리뷰 명령어입니다. 현재 대화가 코디네이터 역할을 합니다: 작업을 분할하고, 각 워커에게 브리핑하고, diff를 읽고 테스트를 실행하는 검증기를 추가하며, 결과를 사용자에게 보고합니다. Gemini 4 Neon이 선택되어 있으면 Neon이 코디네이터가 됩니다.
Google은 2026년 11월 18일 Neon을 출시하며 이를 "Google Antigravity에서 병렬 Hydrogen 서브에이전트를 지휘하는 빠르고 판단력이 뛰어난 오케스트레이터"라고 설명했습니다. Blender MCP로 구축된 3D 실험실 벤치와 앨런 튜링의 1936년 연구실을 3D로 재현한 두 가지 출시 데모가 모두 /swarm으로 만들어졌습니다.
모델의 기본 사항은 Gemini 4 Neon이란? 문서를, Carbon과 함께 출시된 기능에 대해서는 Google Antigravity /swarm 설명서를 참고하세요. 아래 단계는 Google 문서를 기반으로 하며, 스웜은 프리뷰 상태이므로 메뉴는 변경될 수 있습니다.
누가 Gemini 4 Neon으로 /swarm을 사용할 수 있나요?
Google AI Pro 또는 Google AI Ultra 플랜이 필요합니다. Choose a model 문서에 따른 각 플랜별 Antigravity 혜택은 다음과 같습니다:
| 기능 | Free 및 Google AI Plus | Google AI Pro | Google AI Ultra |
|---|---|---|---|
/swarm 명령어 |
불가 | 가능 | 가능 |
| Gemini 4 Neon | 불가 | 가능 (유료 플랜, 또는 해당 프리미엄 기기의 체험판) | 가능 |
| Gemini 4 Hydrogen | 불가 | 가능 (체험판이 아닌 구독만 해당) | 가능 |
| Orchestrator (Neon) | 불가 | 가능 (유료 플랜, 또는 해당 프리미엄 기기의 체험판) | 가능 |
| 할당량 갱신 | 매주 | 5시간마다, 주간 한도까지 | 5시간마다, 가장 높은 주간 한도 |
사람들이 놓치기 쉬운 세 가지 세부 사항:
- Neon이 기본값입니다. Neon이 포함된 플랜에서는 모델 선택기 상단에 Neon이 있으며, 다른 모델을 이미 선택하지 않았다면 새 대화의 기본 모델로 설정됩니다.
- Antigravity 내부에서는 컨텍스트가 더 작습니다. API는 1M 토큰 창을 제공하지만, Antigravity 문서에는 Neon이 "최대 512K 토큰"으로 기재되어 있습니다.
- 스웜은 할당량을 빠르게 소모합니다. Google 문서는 "모든 워커가 각자의 에이전트이므로, 스웜은 단일 대화보다 할당량을 훨씬 빠르게 소모한다"고 경고합니다. Pro 및 Ultra 사용자는 할당량이 부족할 경우 설정에서 AI 크레딧 초과 사용을 활성화할 수 있습니다.
/swarm은 API 키가 아닌 구독 할당량으로 실행됩니다. Neon의 API 요금은 Gemini 4 Neon 가격 가이드를 참고하세요.
Gemini 4 Neon으로 /swarm 실행하기: 단계별 가이드
Antigravity App에서의 단계는 다음과 같습니다:
- 프로젝트를 열고 새 대화를 시작합니다.
- 프롬프트 상자 아래 모델 선택기에서 Gemini 4 Neon을 선택합니다. Orchestrator (Neon)가 아닌 일반 Gemini 4 Neon을 선택하세요. 이유는 아래에서 설명합니다.
- 추론 수준을 선택합니다. Neon은 Low, Medium, High(기본값), Extra를 제공합니다. 코디네이터에게는 High가 적절한 시작점입니다.
/swarm을 입력하고 Tab(또는 Enter)을 눌러 명령어를 삽입합니다.- 작업 내용과 검증 방법을 설명합니다. 예시:
/swarm Add input validation to the handlers in src/routes/users.ts and src/routes/orders.ts, add tests next to each, and have a verifier run npm test. - 코디네이터의 응답 끝에 있는 "Open the Swarm UI" 링크에서 Swarm 창을 엽니다.
- 스웜이 실행되는 동안 코디네이터와 계속 대화합니다. 언제든지 상태를 확인하거나 범위를 조정할 수 있습니다.
창의 Board, Members, Graph 탭에서 실시간 게시물, 각 워커의 상태와 모델, 누가 누구를 멘션했는지 확인할 수 있습니다.

Antigravity CLI에서
터미널에서의 흐름도 거의 동일합니다. Neon을 선택한 상태로 CLI를 시작합니다:
agy --model gemini-4-neon
# or, for the deepest reasoning on the coordinator:
agy --model gemini-4-neon-xhigh
/swarm을 입력하고 Tab을 누른 뒤 작업을 설명합니다. /swarm board 또는 Alt+S(macOS에서는 터미널이 Option을 Meta로 전송하는 경우에만)로 실시간 보드를 열고, /agents로 워커 목록을 확인하며, @verifier also run the integration tests처럼 특정 워커에게 직접 메시지를 보낼 수 있습니다.
Neon 코디네이터, Hydrogen 워커: 모델 조합 방법
기본적으로 모든 워커는 대화와 동일한 모델로 실행됩니다. Neon을 선택하면 전부 Neon인 스웜이 구성됩니다. 강력하지만 할당량 소모가 큽니다.
Neon 출시 게시물은 다른 구성을 설명합니다: Neon이 작업을 판단하고, 더 빠른 Gemini 4 Hydrogen 에이전트가 실행하는 방식입니다. Antigravity에서는 자연어로 이를 요청할 수 있습니다. 문서는 이렇게 말합니다: "특정 워커 또는 모든 워커에 다른 모델을 사용하려면 프롬프트에 그렇게 말하세요." 모델은 모델 선택기에서 선택 가능한 것이어야 합니다.
역할 분담을 설정하는 프롬프트 예시:
/swarm Build the /users and /orders endpoints described in openapi.yaml.
Give each resource its own worker and run every worker on Gemini 4 Hydrogen.
Keep the verifier on Gemini 4 Neon. The verifier must run the API tests
and send each failure back to the worker that owns the endpoint.
왜 Orchestrator (Neon)가 아닌가요?
Orchestrator (Neon)는 모델 선택기의 옵션으로, 하나의 에이전트 안에서 계획 담당 Neon과 실행 담당 Hydrogen을 결합합니다. 문서는 이를 명확히 설명합니다: "Orchestrator는 대화에서 단일 에이전트를 유지합니다." 고정된 구성으로 실행되므로 추론 수준을 설정할 수 없으며, Google의 스웜 문서는 Orchestrator가 대화 모델일 때 스웜이 어떻게 동작하는지 설명하지 않습니다.
따라서 작업 형태에 따라 선택하세요:
| 원하는 것 | 선택 |
|---|---|
| 하나의 에이전트, Neon이 계획하고 Hydrogen이 작성, 할당량 절약 | Orchestrator (Neon) |
| 여러 파일에 걸쳐 병렬로 여러 에이전트 실행, 검증기 포함 | Gemini 4 Neon + /swarm |
| 모든 단계에서 Neon의 판단력, 조절 가능한 추론 수준 | Gemini 4 Neon, 스웜 없이 |
Gemini 4 Hydrogen Orchestrator 가이드에서 단일 에이전트의 작업 인계 루프를 자세히 설명합니다.
코디네이터는 어떤 Neon 추론 수준을 사용해야 할까요?
High에서 시작하세요. Google에 따르면 High 수준의 Neon은 Carbon 대비 작업당 비용이 32% 낮으면서도 Artificial Analysis Intelligence Index에서 높은 점수를 기록합니다. 최고 점수(61점, 3위)는 Extra High에서 나옵니다.
코디네이터가 잘못된 분배를 반복할 때, 예를 들어 두 워커가 같은 파일을 편집할 때는 Extra(xhigh)로 올리세요. 코디네이터를 Medium으로 내리기 전에 워커를 Hydrogen으로 전환하세요. 코디네이터의 역할은 타이핑이 아니라 판단입니다. 전체적인 트레이드오프는 Gemini 4 Neon 추론 수준 가이드를 참고하세요.
깔끔하게 분배되는 /swarm 프롬프트 작성법
Antigravity 스웜 문서는 다른 어떤 규칙보다 하나를 강조합니다: 원하는 것과 검증 방법을 명시하고, 분배는 코디네이터에게 맡기세요. 다음 네 가지 습관이 도움이 됩니다:
- 경계를 명시하세요. 파일이나 리소스를 나열해 각 워커가 단독으로 담당하는 영역을 갖도록 합니다.
- 검증 방법을 명시하세요.
npm test,go test -race ./...또는 API 테스트 실행을 지정합니다. 지정하지 않으면 검증기는 diff만 읽습니다. - 변경되어서는 안 되는 것을 밝히세요. "Without deleting assertions" 같은 문구는 워커가 테스트를 약화시키는 것을 막습니다.
- 편집이 겹칠 때는 작업 복사본을 요청하세요. 기본적으로 워커는 작업 공간을 공유합니다.
깔끔하게 분할되는 광범위한 작업에는 /swarm을 사용하세요. 하나의 어려운 버그에는 Google이 /boost를 권장하며, 수 시간 또는 수일이 걸리는 프로젝트에는 /teamwork을 권장합니다.
대기 중인 워커는 누군가 멘션할 때까지 토큰을 소모하지 않습니다. 할당량이 소진된 멤버는 일시 중지되며, 할당량이 갱신되어도 자동으로 재시작하지 않습니다: 보드에 게시하거나, 모델을 전환하거나, 직접 메시지를 보내세요.
Apidog CLI로 스웜 검증기에 실제 API 테스트 제공하기
스웜이 API를 구축할 때 diff만 읽는 검증기는 추측에 불과합니다. OpenAPI 스펙과 실행 가능한 테스트를 제공하면 "검증됨"이 실제 요청이 계약을 통과했다는 의미가 됩니다.

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
또는 에이전트에게 이렇게 말하세요: "Read https://apidog.com/apidog-cli-installation-guide.md and set up Apidog CLI." 이 가이드는 에이전트를 위해 작성되었습니다. Antigravity 전용 설정은 Antigravity에서 Apidog CLI 사용 방법을 참고하세요.
그 다음 스웜 프롬프트에 테스트 단계를 추가합니다:
/swarm Build the /users and /orders endpoints in openapi.yaml, one Gemini 4
Hydrogen worker per resource. Before building, import openapi.yaml into Apidog
project <projectId> on a new AI branch and create one test case per endpoint
that asserts the status code and response schema. The verifier stays on
Gemini 4 Neon, runs every case against environment <envId>, and treats any
failed run as a failed change, whatever the diff looks like.
검증기는 작성 전에 각 페이로드 스키마를 읽고, 다음과 같은 명령어를 실행합니다:
apidog branch create --project <projectId> --type ai --name "ai/20261119-from-main-neon-swarm" --from main
apidog import --project <projectId> --format openapi --file ./openapi.yaml --branch "ai/20261119-from-main-neon-swarm"
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/20261119-from-main-neon-swarm"
apidog run --test-case <caseId> --project <projectId> --branch "ai/20261119-from-main-neon-swarm" -e <envId> -r cli,json
위의 모든 플래그는 Apidog CLI 2.2.12의 apidog <cmd> --help에서 확인할 수 있습니다. AI 브랜치는 검토 전까지 에이전트가 작성한 변경 사항이 메인 브랜치에 반영되지 않도록 하며, 여러 워커가 동시에 엔드포인트를 수정할 때 특히 중요합니다.
JSON 보고서는 실패한 요청을 명시하므로, 검증기는 @all 대신 @users-api 또는 @orders-api에 게시할 수 있습니다. 이후 Apidog에서 실행 결과를 검토하려면 --upload-report를 추가하세요.
동일한 apidog run ... -r junit 명령어는 CI에 그대로 사용할 수 있어, 스웜이 테스트한 계약을 파이프라인도 강제하게 됩니다. CI/CD 파이프라인에서 Apidog CLI 사용을 참고하세요. Apidog의 Free 플랜은 최대 4명의 사용자를 지원합니다.
FAQ
Antigravity /swarm은 무료인가요?
아니요. Google 문서에 따르면 /swarm은 Google AI Pro 및 Google AI Ultra 플랜에서만 제공되며, Antigravity에서 Gemini 4 Neon은 Free 또는 Plus 플랜에서 사용할 수 없습니다.
스웜 워커는 어떤 모델을 사용하나요?
프롬프트에서 별도로 지정하지 않는 한 대화와 동일한 모델을 사용합니다. 모델 선택기에서 사용 가능한 모델을 사용해 자연어로 Gemini 4 Hydrogen 워커와 Neon 검증기를 요청하세요.
Neon 스웜은 몇 개의 에이전트를 실행할 수 있나요?
Google은 상한을 공개하지 않습니다. 코디네이터가 워커 수를 결정하며, 보통 2~4명의 워커당 하나의 @verifier를 추가하고 여기에 @monitor를 더합니다.
Antigravity에서 Neon은 1M 토큰 컨텍스트를 제공하나요?
Google의 Antigravity 문서에 따르면 그렇지 않습니다. 해당 문서에서는 Neon이 최대 512K 토큰으로 기재되어 있습니다. 1M 창은 Gemini API에 적용됩니다.
/swarm은 Orchestrator (Neon)와 같은가요?
아니요. Orchestrator (Neon)는 Neon 계획과 Hydrogen 실행 사이를 전환하는 하나의 에이전트입니다. /swarm은 전용 검증기를 갖춘 여러 이름이 지정된 에이전트가 공유 보드에서 병렬로 실행되는 방식입니다.
