Gemini 4 Hydrogen 오케스트레이터: Carbon이 계획하고 Hydrogen이 실행하는 방법

Gemini 4 Hydrogen Orchestrator는 Google Antigravity에서 제공되는 모델 옵션으로, 하나의 작업 안에서 플래너(Gemini 4 Carbon 또는 Argon)와 Gemini 4 Hydrogen을 짝지어 사용합니다. 플래너가 탐색하고 계획을 작성하면, Hydrogen이 코드를 편집하고 테스트를 실행하며, Hydrogen이 어려움에 부딪힐 때마다 제어권이 플래너에게 돌아갑니다. Google에 따르면 이 방식은 쿼터를 24% 절감하면서 Carbon에 근접한 성공률에 도달한다고 합니다.

아래에서는 핸드오프 루프의 작동 방식, 24%와 19% 수치의 의미, 어떤 플랜에서 사용할 수 있는지, 그리고 Gemini API로 동일한 역할 분담을 직접 구축하는 방법을 다룹니다. 모델의 기본 사항은 Gemini 4 Hydrogen이란 무엇인가를 참고하세요.

Gemini 4 Hydrogen Orchestrator란 무엇인가?

Orchestrator는 별도의 모델이 아니라 Antigravity의 모델 선택기에 있는 항목입니다. Orchestrator (Carbon)를 선택하면 Gemini 4 Carbon이 계획을 세우고 Gemini 4 Hydrogen이 구현합니다. Orchestrator (Argon)를 선택하면 대신 Gemini 4 Argon이 계획을 세웁니다. 전환은 하나의 대화 안에서 각 응답 도중에 자동으로 이루어집니다.

Google은 2026년 11월 12일에 이를 출시했습니다. Antigravity 공지는 문제의식을 이렇게 밝히고 있습니다. "루틴한 작업의 모든 단계마다 최신 추론 모델을 실행하면 루프가 느려지고 최신 모델 쿼터를 낭비합니다."

기억해야 할 세 가지 사실:

Antigravity 전용입니다. Gemini API에는 Orchestrator 엔드포인트가 없습니다.
고정된 구성입니다. thinking level을 설정할 수 없습니다.
단일 에이전트이며, 스웜(swarm)이 아닙니다. 병렬 에이전트가 필요하면 Antigravity는 subagents, /swarm, Boost 또는 Teamwork를 안내합니다.

Orchestrator는 Carbon과 Hydrogen 사이에서 어떻게 핸드오프하나?

Antigravity 모델 문서는 각 턴 안에서 반복되는 네 가지 동작을 설명합니다:

플래너가 계획합니다. 보내는 모든 메시지는 읽기 전용 단계로 시작합니다. 플래너가 코드베이스를 탐색하고, 모호한 부분을 해소하며, 재계획을 유발해야 할 조건까지 포함한 구체적인 구현 계획을 작성합니다. 단순한 질문은 바로 답변됩니다.
Hydrogen이 작업을 수행합니다. 파일 편집을 적용하고, 코드를 작성하고, 빌드와 테스트를 실행하며, 결과를 계획과 대조해 확인합니다.
어려움이 생기면 제어권이 돌아옵니다. 검증 단계가 두 번 실패하거나, 인터페이스가 예상과 다르게 동작하거나, 계획에서 설계 결정이 정해지지 않은 부분이 있으면 Hydrogen이 제어권을 넘깁니다. 플래너가 대화 상태를 검토하고 계획을 수정한 뒤 실행을 다시 넘깁니다.
플래너가 진행 상황을 검토합니다. 긴 작업에서는, 그리고 실행 도중에 메시지를 보낼 때마다 Hydrogen이 진행 상황을 보고합니다. 플래너는 이를 계획과 대조한 뒤 마무리하거나, 계속하거나, 계획을 갱신합니다.

따라 배울 가치가 있는 설계 선택은 1단계에 있습니다. 플래너가 재계획 트리거를 직접 작성한다는 점입니다. Hydrogen은 "멈추고 물어봐야 하는" 조건들의 서면 목록을 받게 됩니다.

Google은 왜 정적 모델 라우터가 긴 에이전트 실행에서 무너진다고 말하는가?

정적 라우터는 첫 프롬프트를 읽어 작업 난이도를 추측하고, 끝낼 수 있을 것이라 판단한 가장 저렴한 모델에 전체 작업을 보냅니다. 하지만 난이도가 작업 도중에 변하면 이 방식은 실패하는데, 에이전트에서는 그런 일이 흔합니다.

첫 프롬프트에서 난이도를 한 번 추측해 전체 작업을 하나의 모델에 보내는 정적 라우터와, 하나의 작업 타임라인을 따라 Gemini 4 Carbon의 계획 구간과 Gemini 4 Hydrogen의 편집·빌드·테스트 구간이 양방향 핸드오프로 번갈아 나타나는 Orchestrator를 비교하는 다이어그램

Google의 표현을 빌리면, 라우터는 "에이전트 실행이 길어지면서 작업이 진화하는 과정에서 흔히 발견되는, 단계별로 서로 다른 복잡도 수준이 요구될 때 무너지기 시작합니다." 의존성 업그레이드는 7단계에서 호환성이 깨지는 API 변경이 드러나기 전까지는 사소해 보일 수 있습니다. 저렴한 모델을 골랐던 라우터에게는 되돌아갈 길이 없고, 최신 모델을 골랐던 라우터는 테스트를 다시 돌릴 때마다 최신 모델 비용을 치릅니다. Orchestrator는 단계별로, 양방향으로 판단합니다.

24% 쿼터 절감과 19% 속도 향상 수치는 무엇을 의미하는가?

Google은 Terminal-Bench에서 Orchestrator가 "평균 24% 적은 쿼터를 소비하고 19% 더 빠르게 완료하면서 Carbon에 근접한 작업 성공률에 도달했다"고 보고합니다. 이 수치를 이해할 때 네 가지 단서를 염두에 두세요:

주장	하는 말	하지 않는 말
Carbon에 근접한 성공률	단독 실행한 Carbon에 근접	정확한 성공률은 어느 글에도 공개되지 않음
24% 적은 쿼터	Antigravity 플랜 쿼터 기준, 평균	토큰 수나 금액이 아님
19% 더 빠름	평균 작업 완료 시간	요청별 지연 시간이 아님
벤치마크 버전	Google의 출시 글에서는 Terminal-Bench 4.0, Antigravity 글에서는 4.1	어느 버전이 정확한지

이것은 Google의 실행에서 나온 Google의 수치이며, 여러분의 저장소를 위한 예측이 아니라 하나의 신호입니다. 계획이 많이 필요한 작업은 절감 폭이 작고, 실행이 많은 작업(패키지 40개 업데이트와 테스트 수정)은 더 많이 절감될 것입니다.

금전적 논리는 API에서 더 명확하게 보입니다. Gemini 4 Hydrogen은 입력 토큰 100만 개당 $1.50, 출력 토큰 100만 개당 $7.50입니다. Carbon은 11월 30일까지 $2.00/$10.00이고, Gemini 4 Carbon 가격 안내에 따르면 12월 1일부터 $4.00/$20.00입니다. thinking 토큰은 출력으로 청구되므로, 실행 턴을 Carbon에서 Hydrogen으로 옮길 때마다 해당 턴의 출력 요금이 12월 가격 기준 62.5% 절감됩니다.

누가 Orchestrator를 사용할 수 있고, 어떤 플랜에서 가능한가?

Orchestrator는 Antigravity에서만 제공되며, 어떤 플래너를 받을지는 여러분의 Google AI 플랜에 따라 달라집니다. 2026년 11월 13일 기준 Antigravity 문서를 읽어보면:

옵션	플래너	실행자	플랜
Orchestrator (Carbon)	Gemini 4 Carbon	Gemini 4 Hydrogen	Google AI Ultra
Orchestrator (Argon)	Gemini 4 Argon	Gemini 4 Hydrogen	Google AI Ultra; 유료 Google AI Pro (또는 대상 프리미엄 기기의 체험판)

무료 및 Google AI Plus 사용자는 단독 Hydrogen은 사용할 수 있지만 Orchestrator는 사용할 수 없습니다. Enterprise의 경우 문서의 표와 Antigravity 공지가 서로 달라서, 직접 모델 선택기를 확인해 보세요.

Antigravity CLI에서는 옵션 이름을 따옴표로 감싸 전달합니다:

agy --model "Orchestrator (Carbon)"
agy -p "Add input validation to the signup form and run the tests." --model "Orchestrator (Argon)"

플래너 선택에 고민된다면, 저희의 Gemini 4 Carbon vs Argon 비교가 트레이드오프를 다룹니다.

단일 모델 대신 Orchestrator를 선택해야 하는 경우는?

Google 문서는 일상적인 작업에서 Orchestrator를 "권장 기본값"으로 부릅니다:

Orchestrator: 기능 개발, 버그 수정, 리팩토링, 여러 파일에 걸친 디버깅.
Carbon 또는 Argon 단독: 모든 단계에서 최대 깊이가 필요한 작업, 예를 들어 분산 시스템 설계, 레이스 컨디션 추적, 여러 저장소에 걸친 마이그레이션.
Hydrogen 단독: 패키지 업그레이드, 중복 제거, 보일러플레이트, 명확히 정의된 함수의 단위 테스트, 문서화, 간단한 스크립트.

경험 법칙: 시작 전에 계획을 작성할 작업이라면 Orchestrator를, 바로 코드를 치고 들어갈 작업이라면 Hydrogen을 사용하세요.

Gemini API로 동일한 계획/실행 분담을 구축하는 방법은?

Antigravity 밖에서는 Orchestrator의 루프를 직접 만들어야 합니다. Google의 Gemini 4 Hydrogen의 새로운 기능 가이드는 메커니즘을 이렇게 설명합니다. "previous_interaction_id를 사용해 하나의 멀티턴 세션에서 계획 턴은 gemini-4-carbon으로, 실행 턴은 gemini-4-hydrogen으로 라우팅하세요." 두 모델 사이에 요청 스키마 변경은 필요 없습니다.

Gemini API에서 직접 구축하는 계획 및 실행 루프의 플로우차트: gemini-4-carbon이 재계획 트리거를 포함한 읽기 전용 계획을 작성하고 previous_interaction_id를 통해 gemini-4-hydrogen에 전달하면, hydrogen이 각 단계를 실행하고 테스트를 돌린다. 검증을 통과하면 다음 단계로 넘어가고, 두 번 실패하거나 계획에 빈틈이 있으면 Carbon으로 다시 에스컬레이션되어 Carbon이 검토 후 마무리한다

"두 번 실패하면 돌려보낸다" 규칙을 옮긴 최소한의 Python 버전입니다:

from google import genai

client = genai.Client()  # reads GEMINI_API_KEY

def ask(model, prompt, prev=None, level="high"):
    return client.interactions.create(
        model=model,
        input=prompt,
        previous_interaction_id=prev,
        generation_config={"thinking_level": level},
    )

# 1. Carbon plans (read-only) and writes its own re-plan triggers
plan = ask("gemini-4-carbon",
    "Plan this task as numbered steps. For each step, list the check "
    "that proves it worked and the conditions that require re-planning. "
    "Do not write code yet. Task: " + task)
last = plan.id

for step in parse_steps(plan.output_text):
    failures = 0
    while True:
        # 2. Hydrogen executes the step
        run = ask("gemini-4-hydrogen", f"Implement step: {step}", prev=last)
        last = run.id
        ok, log = apply_and_test(run.output_text)  # your patch + test runner
        if ok:
            break
        failures += 1
        if failures >= 2:
            # 3. Escalate to Carbon to repair the plan
            fix = ask("gemini-4-carbon",
                f"Step failed twice. Test log:\n{log}\nRepair the plan for this step.",
                prev=last)
            last = fix.id
            step, failures = fix.output_text, 0

# 4. Carbon reviews the finished work
review = ask("gemini-4-carbon", "Review the completed work against the plan.", prev=last)

parse_steps와 apply_and_test에는 여러분의 저장소 빌드·테스트 로직이 들어갑니다. 제대로 하기 위해 필요한 네 가지:

역할별로 thinking level을 설정하세요. Carbon은 기본값이 medium이고 최대 high입니다. Hydrogen은 기본값이 high이며 xhigh를 추가로 지원합니다.
상태를 서버에 두세요. previous_interaction_id가 모델 간 히스토리를 전달하며, implicit caching은 반복 입력을 95% 할인합니다. store=false는 이를 차단합니다.
에스컬레이션을 명시적으로 만드세요. Orchestrator의 트리거를 플래너 프롬프트에 옮겨 적으세요.
턴별 토큰을 기록하세요. usage 객체는 total_thought_tokens를 별도로 보고하므로, 어떤 역할이 소비하는지 볼 수 있습니다.

요청 형식과 인증은 저희의 Gemini 4 Hydrogen API 가이드에 있습니다.

루프를 직접 손으로 만들기 싫다면, Google에 따르면 Antigravity SDK로 역할을 프로그래밍 방식으로 제어하면서 Hydrogen과 Carbon 에이전트를 연결할 수 있습니다. Google의 데모에서는 Hydrogen 에이전트가 이슈 분류와 코딩을 맡고, Carbon 에이전트가 리팩토링과 보안 검사를 담당합니다.

Apidog CLI로 Carbon-Hydrogen 핸드오프 테스트하기

직접 만든 오케스트레이터는 핸드오프 지점에서 깨지기 쉽습니다. 잘못된 모델 ID, 빠진 previous_interaction_id, 또는 Carbon이 거부하는 thinking level 때문이죠. 여러분의 코딩 에이전트(Claude Code, Codex, Cursor)에게 Apidog CLI로 2단계 테스트를 만들어 실행하게 하세요.

한 번만 설정하면 됩니다:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com   # pick your agent when prompted

그다음 에이전트에게 프롬프트 하나를 주세요:

In Apidog project <projectId>, create an environment "gemini" with base URL
https://generativelanguage.googleapis.com and a secret variable GEMINI_API_KEY.
Build a test scenario with two steps against POST /v1beta/interactions,
both sending the x-goog-api-key header:
1. Planner: model "gemini-4-carbon", thinking_level "high", input asks for a
   3-step plan. Assert status 200, status "completed", non-empty output and a
   usage object. Extract $.id into plannerId.
2. Executor: model "gemini-4-hydrogen", thinking_level "medium",
   previous_interaction_id {{plannerId}}, input "Do step 1 of the plan".
   Assert the same checks. Log total_input_tokens, total_thought_tokens and
   total_output_tokens for both steps. Run it and summarize failures.

에이전트가 스키마를 읽고, 페이로드를 검증하고, 시나리오를 작성해 실행합니다:

apidog environment create gemini --project <projectId> \
  --base-url https://generativelanguage.googleapis.com
apidog cli-schema get test-scenario-update
apidog cli-schema validate test-scenario-update --file scenario.json
apidog test-scenario create --project <projectId> --name "carbon-to-hydrogen"
apidog test-scenario update <scenarioId> --project <projectId> --file scenario.json
apidog test-scenario run <scenarioId> --project <projectId> -e <envId> \
  -r cli,json --out-file handoff-{GENERATE_TIME}

JSON 리포트는 각 역할의 토큰 소비를 나란히 보여줍니다. -r junit을 추가하면 동일한 실행이 CI에 들어가고, 모델 ID 변경이나 깨진 핸드오프는 빌드 실패로 이어집니다. 파이프라인은 Apidog CLI CI/CD 가이드에서, 에이전트 설정은 Claude Code에서의 Apidog CLI에서 다룹니다. Apidog의 무료 플랜은 최대 4명까지 사용할 수 있습니다.

FAQ

Gemini 4 Hydrogen Orchestrator는 Gemini API에서 사용할 수 있나요? 아니요. Google Antigravity의 모델 선택기 옵션입니다. API에서는 previous_interaction_id를 사용해 gemini-4-carbon과 gemini-4-hydrogen 사이를 직접 전환해야 합니다.

Orchestrator에 thinking level을 설정할 수 있나요? 아니요. 고정된 구성으로 실행됩니다. 특정 레벨이 필요하면 Carbon, Argon 또는 Hydrogen을 직접 선택하세요.

Google AI Ultra가 필요한가요? Orchestrator (Carbon)는 그렇습니다. 유료 Google AI Pro 구독자는 Orchestrator (Argon)를 사용할 수 있습니다. 무료 사용자는 Hydrogen을 단독으로 사용할 수 있으며, Gemini 4 Hydrogen 무료 가이드를 참고하세요.

Orchestrator는 API에서 비용을 절감하나요? 동일한 분담 방식은 그렇습니다. 실행 턴이 Carbon 대신 Hydrogen의 100만 출력 토큰당 $7.50 요금으로 청구됩니다. 전체 표는 Gemini 4 Hydrogen 가격 안내에 있습니다.