<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Rihpig</title>
    <description>The latest articles on DEV Community by Rihpig (@rihpig).</description>
    <link>https://dev.to/rihpig</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F2745155%2Ff727be57-3d98-4e9b-90ef-46211b492018.jpg</url>
      <title>DEV Community: Rihpig</title>
      <link>https://dev.to/rihpig</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/rihpig"/>
    <language>en</language>
    <item>
      <title>Antigravity Swarm: Gemini 4 Neon /swarm 사용 방법 완벽 가이드</title>
      <dc:creator>Rihpig</dc:creator>
      <pubDate>Thu, 19 Nov 2026 10:18:48 +0000</pubDate>
      <link>https://dev.to/rihpig/antigravity-swarm-gemini-4-neon-swarm-sayong-bangbeob-wanbyeog-gaideu-933</link>
      <guid>https://dev.to/rihpig/antigravity-swarm-gemini-4-neon-swarm-sayong-bangbeob-wanbyeog-gaideu-933</guid>
      <description>&lt;p&gt;Gemini 4 Neon과 함께 사용하는 Antigravity 스웜 모드는 다음과 같이 작동합니다: 모델 선택기에서 Gemini 4 Neon을 선택하고, &lt;code&gt;/swarm&lt;/code&gt; 뒤에 작업과 검증 방법을 입력하면 현재 대화가 코디네이터가 됩니다. Neon은 작업을 이름이 지정된 워커들에게 분배하고, &lt;code&gt;@verifier&lt;/code&gt;를 추가하며, 테스트가 통과하면 결과를 보고합니다. 할당량을 아끼려면 프롬프트에서 Gemini 4 Hydrogen 워커를 요청하세요.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;지금 Apidog를 사용해 보세요&lt;/a&gt;
&lt;/p&gt;

&lt;h2&gt;
  
  
  Gemini 4 Neon과 함께하는 Antigravity 스웜 모드란?
&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;/swarm&lt;/code&gt;은 Google Antigravity에서 하나의 작업에 이름이 지정된 에이전트 팀을 투입하는 프리뷰 명령어입니다. 현재 대화가 코디네이터 역할을 합니다: 작업을 분할하고, 각 워커에게 브리핑하고, diff를 읽고 테스트를 실행하는 검증기를 추가하며, 결과를 사용자에게 보고합니다. Gemini 4 Neon이 선택되어 있으면 Neon이 코디네이터가 됩니다.&lt;/p&gt;

&lt;p&gt;Google은 2026년 11월 18일 Neon을 출시하며 이를 "Google Antigravity에서 병렬 Hydrogen 서브에이전트를 지휘하는 빠르고 판단력이 뛰어난 오케스트레이터"라고 설명했습니다. Blender MCP로 구축된 3D 실험실 벤치와 앨런 튜링의 1936년 연구실을 3D로 재현한 두 가지 출시 데모가 모두 &lt;code&gt;/swarm&lt;/code&gt;으로 만들어졌습니다.&lt;/p&gt;

&lt;p&gt;모델의 기본 사항은 &lt;a href="https://apidog.com/kr/blog/what-is-gemini-4-neon?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Neon이란?&lt;/a&gt; 문서를, Carbon과 함께 출시된 기능에 대해서는 &lt;a href="https://apidog.com/kr/blog/google-antigravity-swarm?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Google Antigravity /swarm 설명서&lt;/a&gt;를 참고하세요. 아래 단계는 Google 문서를 기반으로 하며, 스웜은 프리뷰 상태이므로 메뉴는 변경될 수 있습니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  누가 Gemini 4 Neon으로 /swarm을 사용할 수 있나요?
&lt;/h2&gt;

&lt;p&gt;Google AI Pro 또는 Google AI Ultra 플랜이 필요합니다. &lt;a href="https://antigravity.google/docs/models" rel="noopener noreferrer"&gt;Choose a model 문서&lt;/a&gt;에 따른 각 플랜별 Antigravity 혜택은 다음과 같습니다:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;기능&lt;/th&gt;
&lt;th&gt;Free 및 Google AI Plus&lt;/th&gt;
&lt;th&gt;Google AI Pro&lt;/th&gt;
&lt;th&gt;Google AI Ultra&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;/swarm&lt;/code&gt; 명령어&lt;/td&gt;
&lt;td&gt;불가&lt;/td&gt;
&lt;td&gt;가능&lt;/td&gt;
&lt;td&gt;가능&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Gemini 4 Neon&lt;/td&gt;
&lt;td&gt;불가&lt;/td&gt;
&lt;td&gt;가능 (유료 플랜, 또는 해당 프리미엄 기기의 체험판)&lt;/td&gt;
&lt;td&gt;가능&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Gemini 4 Hydrogen&lt;/td&gt;
&lt;td&gt;불가&lt;/td&gt;
&lt;td&gt;가능 (체험판이 아닌 구독만 해당)&lt;/td&gt;
&lt;td&gt;가능&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Orchestrator (Neon)&lt;/td&gt;
&lt;td&gt;불가&lt;/td&gt;
&lt;td&gt;가능 (유료 플랜, 또는 해당 프리미엄 기기의 체험판)&lt;/td&gt;
&lt;td&gt;가능&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;할당량 갱신&lt;/td&gt;
&lt;td&gt;매주&lt;/td&gt;
&lt;td&gt;5시간마다, 주간 한도까지&lt;/td&gt;
&lt;td&gt;5시간마다, 가장 높은 주간 한도&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;사람들이 놓치기 쉬운 세 가지 세부 사항:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Neon이 기본값입니다.&lt;/strong&gt; Neon이 포함된 플랜에서는 모델 선택기 상단에 Neon이 있으며, 다른 모델을 이미 선택하지 않았다면 새 대화의 기본 모델로 설정됩니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Antigravity 내부에서는 컨텍스트가 더 작습니다.&lt;/strong&gt; API는 1M 토큰 창을 제공하지만, Antigravity 문서에는 Neon이 "최대 512K 토큰"으로 기재되어 있습니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;스웜은 할당량을 빠르게 소모합니다.&lt;/strong&gt; Google 문서는 "모든 워커가 각자의 에이전트이므로, 스웜은 단일 대화보다 할당량을 훨씬 빠르게 소모한다"고 경고합니다. Pro 및 Ultra 사용자는 할당량이 부족할 경우 설정에서 AI 크레딧 초과 사용을 활성화할 수 있습니다.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;code&gt;/swarm&lt;/code&gt;은 API 키가 아닌 구독 할당량으로 실행됩니다. Neon의 API 요금은 &lt;a href="https://apidog.com/kr/blog/gemini-4-neon-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Neon 가격 가이드&lt;/a&gt;를 참고하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  Gemini 4 Neon으로 /swarm 실행하기: 단계별 가이드
&lt;/h2&gt;

&lt;p&gt;Antigravity App에서의 단계는 다음과 같습니다:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;프로젝트를 열고&lt;/strong&gt; 새 대화를 시작합니다.&lt;/li&gt;
&lt;li&gt;프롬프트 상자 아래 모델 선택기에서 &lt;strong&gt;Gemini 4 Neon을 선택&lt;/strong&gt;합니다. Orchestrator (Neon)가 아닌 일반 &lt;strong&gt;Gemini 4 Neon&lt;/strong&gt;을 선택하세요. 이유는 아래에서 설명합니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;추론 수준을 선택합니다.&lt;/strong&gt; Neon은 Low, Medium, High(기본값), Extra를 제공합니다. 코디네이터에게는 High가 적절한 시작점입니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;/swarm&lt;/code&gt;을 입력&lt;/strong&gt;하고 Tab(또는 Enter)을 눌러 명령어를 삽입합니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;작업 내용과 검증 방법을 설명합니다.&lt;/strong&gt; 예시: &lt;code&gt;/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.&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;코디네이터의 응답 끝에 있는 "Open the Swarm UI" 링크에서 &lt;strong&gt;Swarm 창을 엽니다&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;스웜이 실행되는 동안 &lt;strong&gt;코디네이터와 계속 대화합니다.&lt;/strong&gt; 언제든지 상태를 확인하거나 범위를 조정할 수 있습니다.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;창의 &lt;strong&gt;Board&lt;/strong&gt;, &lt;strong&gt;Members&lt;/strong&gt;, &lt;strong&gt;Graph&lt;/strong&gt; 탭에서 실시간 게시물, 각 워커의 상태와 모델, 누가 누구를 멘션했는지 확인할 수 있습니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F2dveujewqwloxgfl6gk5.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F2dveujewqwloxgfl6gk5.png" alt="Diagram of an Antigravity swarm led by Gemini 4 Neon" width="800" height="410"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h3&gt;
  
  
  Antigravity CLI에서
&lt;/h3&gt;

&lt;p&gt;터미널에서의 흐름도 거의 동일합니다. Neon을 선택한 상태로 CLI를 시작합니다:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;agy --model gemini-4-neon
&lt;span class="c"&gt;# or, for the deepest reasoning on the coordinator:&lt;/span&gt;
agy --model gemini-4-neon-xhigh
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;/swarm&lt;/code&gt;을 입력하고 Tab을 누른 뒤 작업을 설명합니다. &lt;code&gt;/swarm board&lt;/code&gt; 또는 Alt+S(macOS에서는 터미널이 Option을 Meta로 전송하는 경우에만)로 실시간 보드를 열고, &lt;code&gt;/agents&lt;/code&gt;로 워커 목록을 확인하며, &lt;code&gt;@verifier also run the integration tests&lt;/code&gt;처럼 특정 워커에게 직접 메시지를 보낼 수 있습니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Neon 코디네이터, Hydrogen 워커: 모델 조합 방법
&lt;/h2&gt;

&lt;p&gt;기본적으로 모든 워커는 대화와 동일한 모델로 실행됩니다. Neon을 선택하면 전부 Neon인 스웜이 구성됩니다. 강력하지만 할당량 소모가 큽니다.&lt;/p&gt;

&lt;p&gt;Neon 출시 게시물은 다른 구성을 설명합니다: Neon이 작업을 판단하고, 더 빠른 Gemini 4 Hydrogen 에이전트가 실행하는 방식입니다. Antigravity에서는 자연어로 이를 요청할 수 있습니다. 문서는 이렇게 말합니다: "특정 워커 또는 모든 워커에 다른 모델을 사용하려면 프롬프트에 그렇게 말하세요." 모델은 모델 선택기에서 선택 가능한 것이어야 합니다.&lt;/p&gt;

&lt;p&gt;역할 분담을 설정하는 프롬프트 예시:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;/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.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  왜 Orchestrator (Neon)가 아닌가요?
&lt;/h3&gt;

&lt;p&gt;Orchestrator (Neon)는 모델 선택기의 옵션으로, &lt;strong&gt;하나의&lt;/strong&gt; 에이전트 안에서 계획 담당 Neon과 실행 담당 Hydrogen을 결합합니다. 문서는 이를 명확히 설명합니다: "Orchestrator는 대화에서 단일 에이전트를 유지합니다." 고정된 구성으로 실행되므로 추론 수준을 설정할 수 없으며, Google의 스웜 문서는 Orchestrator가 대화 모델일 때 스웜이 어떻게 동작하는지 설명하지 않습니다.&lt;/p&gt;

&lt;p&gt;따라서 작업 형태에 따라 선택하세요:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;원하는 것&lt;/th&gt;
&lt;th&gt;선택&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;하나의 에이전트, Neon이 계획하고 Hydrogen이 작성, 할당량 절약&lt;/td&gt;
&lt;td&gt;Orchestrator (Neon)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;여러 파일에 걸쳐 병렬로 여러 에이전트 실행, 검증기 포함&lt;/td&gt;
&lt;td&gt;Gemini 4 Neon + &lt;code&gt;/swarm&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;모든 단계에서 Neon의 판단력, 조절 가능한 추론 수준&lt;/td&gt;
&lt;td&gt;Gemini 4 Neon, 스웜 없이&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;&lt;a href="https://apidog.com/kr/blog/gemini-4-hydrogen-orchestrator?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Hydrogen Orchestrator 가이드&lt;/a&gt;에서 단일 에이전트의 작업 인계 루프를 자세히 설명합니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  코디네이터는 어떤 Neon 추론 수준을 사용해야 할까요?
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;High&lt;/strong&gt;에서 시작하세요. Google에 따르면 High 수준의 Neon은 Carbon 대비 작업당 비용이 32% 낮으면서도 Artificial Analysis Intelligence Index에서 높은 점수를 기록합니다. 최고 점수(61점, 3위)는 Extra High에서 나옵니다.&lt;/p&gt;

&lt;p&gt;코디네이터가 잘못된 분배를 반복할 때, 예를 들어 두 워커가 같은 파일을 편집할 때는 &lt;strong&gt;Extra&lt;/strong&gt;(&lt;code&gt;xhigh&lt;/code&gt;)로 올리세요. 코디네이터를 Medium으로 내리기 전에 워커를 Hydrogen으로 전환하세요. 코디네이터의 역할은 타이핑이 아니라 판단입니다. 전체적인 트레이드오프는 &lt;a href="https://apidog.com/kr/blog/gemini-4-neon-thinking-levels?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Neon 추론 수준 가이드&lt;/a&gt;를 참고하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  깔끔하게 분배되는 /swarm 프롬프트 작성법
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://antigravity.google/docs/swarm" rel="noopener noreferrer"&gt;Antigravity 스웜 문서&lt;/a&gt;는 다른 어떤 규칙보다 하나를 강조합니다: 원하는 것과 검증 방법을 명시하고, 분배는 코디네이터에게 맡기세요. 다음 네 가지 습관이 도움이 됩니다:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;경계를 명시하세요.&lt;/strong&gt; 파일이나 리소스를 나열해 각 워커가 단독으로 담당하는 영역을 갖도록 합니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;검증 방법을 명시하세요.&lt;/strong&gt; &lt;code&gt;npm test&lt;/code&gt;, &lt;code&gt;go test -race ./...&lt;/code&gt; 또는 API 테스트 실행을 지정합니다. 지정하지 않으면 검증기는 diff만 읽습니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;변경되어서는 안 되는 것을 밝히세요.&lt;/strong&gt; "Without deleting assertions" 같은 문구는 워커가 테스트를 약화시키는 것을 막습니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;편집이 겹칠 때는 작업 복사본을 요청하세요.&lt;/strong&gt; 기본적으로 워커는 작업 공간을 공유합니다.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;깔끔하게 분할되는 광범위한 작업에는 &lt;code&gt;/swarm&lt;/code&gt;을 사용하세요. 하나의 어려운 버그에는 Google이 &lt;code&gt;/boost&lt;/code&gt;를 권장하며, 수 시간 또는 수일이 걸리는 프로젝트에는 &lt;code&gt;/teamwork&lt;/code&gt;을 권장합니다.&lt;/p&gt;

&lt;p&gt;대기 중인 워커는 누군가 멘션할 때까지 토큰을 소모하지 않습니다. 할당량이 소진된 멤버는 일시 중지되며, 할당량이 갱신되어도 자동으로 재시작하지 않습니다: 보드에 게시하거나, 모델을 전환하거나, 직접 메시지를 보내세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  Apidog CLI로 스웜 검증기에 실제 API 테스트 제공하기
&lt;/h2&gt;

&lt;p&gt;스웜이 API를 구축할 때 diff만 읽는 검증기는 추측에 불과합니다. &lt;a href="https://spec.openapis.org/oas/latest.html" rel="noopener noreferrer"&gt;OpenAPI&lt;/a&gt; 스펙과 실행 가능한 테스트를 제공하면 "검증됨"이 실제 요청이 계약을 통과했다는 의미가 됩니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fu0mlrewmjk2az1n0uvif.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fu0mlrewmjk2az1n0uvif.png" alt="Diagram of the swarm verification loop" width="800" height="267"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/apidog-cli/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog CLI&lt;/a&gt;를 사용하면 에이전트가 스펙을 가져오고, 테스트 케이스를 작성하고, 파싱 가능한 JSON 출력과 함께 터미널에서 실행할 수 있습니다. 프로젝트에서 한 번만 설정하세요:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm install -g apidog-cli@latest
apidog auth login --with-token &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;YOUR_TOKEN&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
npx -y skills add https://apidog.com   &lt;span class="c"&gt;# pick your agent when prompted&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;또는 에이전트에게 이렇게 말하세요: "Read &lt;a href="https://apidog.com/apidog-cli-installation-guide.md?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;https://apidog.com/apidog-cli-installation-guide.md&lt;/a&gt; and set up Apidog CLI." 이 가이드는 에이전트를 위해 작성되었습니다. Antigravity 전용 설정은 &lt;a href="https://apidog.com/kr/blog/apidog-cli-in-antigravity?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Antigravity에서 Apidog CLI 사용 방법&lt;/a&gt;을 참고하세요.&lt;/p&gt;

&lt;p&gt;그 다음 스웜 프롬프트에 테스트 단계를 추가합니다:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;/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 &amp;lt;projectId&amp;gt; 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 &amp;lt;envId&amp;gt;, and treats any
failed run as a failed change, whatever the diff looks like.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;검증기는 작성 전에 각 페이로드 스키마를 읽고, 다음과 같은 명령어를 실행합니다:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;apidog branch create --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;projectId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --type ai --name &lt;span class="s2"&gt;"ai/20261119-from-main-neon-swarm"&lt;/span&gt; --from main
apidog import --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;projectId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --format openapi --file ./openapi.yaml --branch &lt;span class="s2"&gt;"ai/20261119-from-main-neon-swarm"&lt;/span&gt;
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;projectId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --file case.json --branch &lt;span class="s2"&gt;"ai/20261119-from-main-neon-swarm"&lt;/span&gt;
apidog run --test-case &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;caseId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;projectId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --branch &lt;span class="s2"&gt;"ai/20261119-from-main-neon-swarm"&lt;/span&gt; -e &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;envId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -r cli,json
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;위의 모든 플래그는 Apidog CLI 2.2.12의 &lt;code&gt;apidog &amp;lt;cmd&amp;gt; --help&lt;/code&gt;에서 확인할 수 있습니다. AI 브랜치는 검토 전까지 에이전트가 작성한 변경 사항이 메인 브랜치에 반영되지 않도록 하며, 여러 워커가 동시에 엔드포인트를 수정할 때 특히 중요합니다.&lt;/p&gt;

&lt;p&gt;JSON 보고서는 실패한 요청을 명시하므로, 검증기는 &lt;code&gt;@all&lt;/code&gt; 대신 &lt;code&gt;@users-api&lt;/code&gt; 또는 &lt;code&gt;@orders-api&lt;/code&gt;에 게시할 수 있습니다. 이후 Apidog에서 실행 결과를 검토하려면 &lt;code&gt;--upload-report&lt;/code&gt;를 추가하세요.&lt;/p&gt;

&lt;p&gt;동일한 &lt;code&gt;apidog run ... -r junit&lt;/code&gt; 명령어는 CI에 그대로 사용할 수 있어, 스웜이 테스트한 계약을 파이프라인도 강제하게 됩니다. &lt;a href="https://apidog.com/kr/blog/apidog-cli-ci-cd-pipeline?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;CI/CD 파이프라인에서 Apidog CLI 사용&lt;/a&gt;을 참고하세요. Apidog의 Free 플랜은 최대 4명의 사용자를 지원합니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQ
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Antigravity /swarm은 무료인가요?
&lt;/h3&gt;

&lt;p&gt;아니요. Google 문서에 따르면 &lt;code&gt;/swarm&lt;/code&gt;은 Google AI Pro 및 Google AI Ultra 플랜에서만 제공되며, Antigravity에서 Gemini 4 Neon은 Free 또는 Plus 플랜에서 사용할 수 없습니다.&lt;/p&gt;

&lt;h3&gt;
  
  
  스웜 워커는 어떤 모델을 사용하나요?
&lt;/h3&gt;

&lt;p&gt;프롬프트에서 별도로 지정하지 않는 한 대화와 동일한 모델을 사용합니다. 모델 선택기에서 사용 가능한 모델을 사용해 자연어로 Gemini 4 Hydrogen 워커와 Neon 검증기를 요청하세요.&lt;/p&gt;

&lt;h3&gt;
  
  
  Neon 스웜은 몇 개의 에이전트를 실행할 수 있나요?
&lt;/h3&gt;

&lt;p&gt;Google은 상한을 공개하지 않습니다. 코디네이터가 워커 수를 결정하며, 보통 2~4명의 워커당 하나의 &lt;code&gt;@verifier&lt;/code&gt;를 추가하고 여기에 &lt;code&gt;@monitor&lt;/code&gt;를 더합니다.&lt;/p&gt;

&lt;h3&gt;
  
  
  Antigravity에서 Neon은 1M 토큰 컨텍스트를 제공하나요?
&lt;/h3&gt;

&lt;p&gt;Google의 Antigravity 문서에 따르면 그렇지 않습니다. 해당 문서에서는 Neon이 최대 512K 토큰으로 기재되어 있습니다. 1M 창은 Gemini API에 적용됩니다.&lt;/p&gt;

&lt;h3&gt;
  
  
  /swarm은 Orchestrator (Neon)와 같은가요?
&lt;/h3&gt;

&lt;p&gt;아니요. Orchestrator (Neon)는 Neon 계획과 Hydrogen 실행 사이를 전환하는 하나의 에이전트입니다. &lt;code&gt;/swarm&lt;/code&gt;은 전용 검증기를 갖춘 여러 이름이 지정된 에이전트가 공유 보드에서 병렬로 실행되는 방식입니다.&lt;/p&gt;

</description>
    </item>
    <item>
      <title>Gemini Neon 컨텍스트 캐싱으로 95% 할인 받는 방법</title>
      <dc:creator>Rihpig</dc:creator>
      <pubDate>Thu, 19 Nov 2026 10:18:41 +0000</pubDate>
      <link>https://dev.to/rihpig/gemini-neon-keontegseuteu-kaesingeuro-95-halin-badneun-bangbeob-kd8</link>
      <guid>https://dev.to/rihpig/gemini-neon-keontegseuteu-kaesingeuro-95-halin-badneun-bangbeob-kd8</guid>
      <description>&lt;p&gt;Gemini 4 Neon의 컨텍스트 캐싱은 암시적(implicit) 방식만 지원합니다. 캐시를 직접 만드는 것이 아닙니다. Google이 4,096 토큰 이상의 반복되는 프롬프트 접두사를 자동으로 캐싱하며, 캐시된 입력 토큰은 $3 대신 1M당 $0.15로 청구됩니다. 즉, 95% 할인입니다. 이 혜택을 받으려면 매 요청의 안정적인 부분을 앞쪽에 배치하고 바이트 단위까지 동일하게 유지한 뒤, &lt;code&gt;usage.total_cached_tokens&lt;/code&gt;에서 캐시 적중을 확인하면 됩니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;지금 Apidog를 사용해 보세요&lt;/a&gt;
&lt;/p&gt;

&lt;p&gt;아래에서는 캐시 적중을 위한 프롬프트 구성, 에이전트 루프 규칙, 캐시된 토큰 수 확인 방법, 그리고 코딩 에이전트가 대신 실행해 주는 테스트까지 다룹니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Gemini 4 Neon 컨텍스트 캐싱은 어떻게 작동하나요?
&lt;/h2&gt;

&lt;p&gt;Gemini 4 Neon의 컨텍스트 캐싱은 자동 접두사 캐싱입니다. 새 요청이 최근 요청과 동일한 토큰으로 시작하고, 그 공통 접두사가 4,096 토큰 이상이면 Google이 반복되는 부분을 캐시에서 제공하고 캐시 요금으로 청구합니다. 활성화할 설정도 없고, 관리해야 할 캐시 객체, TTL, 저장 비용도 없습니다.&lt;/p&gt;

&lt;p&gt;Google은 2026년 11월 18일 Neon을 공개했습니다(모델 ID는 &lt;code&gt;gemini-4-neon&lt;/code&gt;, &lt;a href="https://blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-neon/" rel="noopener noreferrer"&gt;출시 포스트&lt;/a&gt; 참고). 캐싱 관련 사항은 다음 표 하나로 정리됩니다:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;항목&lt;/th&gt;
&lt;th&gt;Gemini 4 Neon&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;캐싱 방식&lt;/td&gt;
&lt;td&gt;암시적만 지원, 기본 활성화&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;명시적 캐싱 (&lt;code&gt;cachedContents&lt;/code&gt;, &lt;code&gt;caches.create&lt;/code&gt;)&lt;/td&gt;
&lt;td&gt;미지원&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;캐시 적중을 위한 최소 접두사&lt;/td&gt;
&lt;td&gt;4,096 토큰&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;표준 입력&lt;/td&gt;
&lt;td&gt;1M 토큰당 $3.00&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;캐시된 입력 (Standard)&lt;/td&gt;
&lt;td&gt;1M 토큰당 $0.15&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;캐시된 입력 (Batch 및 Flex)&lt;/td&gt;
&lt;td&gt;1M 토큰당 $0.075&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;캐시된 입력 (Priority)&lt;/td&gt;
&lt;td&gt;1M 토큰당 $0.27&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;적중 확인 위치&lt;/td&gt;
&lt;td&gt;&lt;code&gt;usage.total_cached_tokens&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;무료 등급&lt;/td&gt;
&lt;td&gt;없음, 유료 등급 전용&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;할인율은 모든 등급에서 95%입니다. $3의 5%가 $0.15, $1.50의 5%가 $0.075, $5.40의 5%가 $0.27입니다. thinking 토큰을 포함한 출력 토큰은 Standard 기준 1M당 $15로 그대로이며, 캐싱은 입력에만 적용됩니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Gemini 4 Neon의 암시적 캐싱과 명시적 캐싱 비교
&lt;/h2&gt;

&lt;p&gt;Gemini 2.5나 3에서 명시적 캐싱을 사용하고 계셨다면, 코드가 깨지는 변경 사항입니다. Google의 Neon 마이그레이션 노트는 명확합니다. Gemini 4 Neon은 "명시적 캐싱(&lt;code&gt;cachedContents&lt;/code&gt;, &lt;code&gt;caches.create&lt;/code&gt;)을 지원하지 않으므로" 요청에서 "&lt;code&gt;cached_content&lt;/code&gt; 필드를 제거"해야 합니다.&lt;/p&gt;

&lt;p&gt;캐싱 문서에는 Interactions API는 암시적 캐싱만 지원하며, 어떤 Gemini 4 모델에서도 명시적 캐싱을 사용할 수 없다고 나와 있습니다. 명시적 캐시는 지원되는 Gemini 3 및 2.5 모델에서 &lt;code&gt;generateContent&lt;/code&gt;를 통해 계속 사용할 수 있습니다.&lt;/p&gt;

&lt;p&gt;마이그레이션 시 해야 할 일은 다음과 같습니다:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;code&gt;caches.create&lt;/code&gt;를 호출하고 캐시 이름을 저장하는 코드를 삭제합니다.&lt;/li&gt;
&lt;li&gt;모든 요청 본문에서 &lt;code&gt;cached_content&lt;/code&gt;를 제거합니다.&lt;/li&gt;
&lt;li&gt;더 이상 사용하지 않는 캐시 스토리지에 대한 비용 지불을 중단합니다.&lt;/li&gt;
&lt;li&gt;기존에 명시적으로 캐싱하던 콘텐츠가 각 요청의 맨 앞에 오도록 프롬프트를 재구성합니다.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;특정 문서를 고정하거나 TTL을 지정할 수는 없고, 적중도 보장되지 않습니다. 다만 적중 확률을 크게 높일 수는 있습니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Gemini 4 Neon 캐시에 적중하도록 프롬프트를 구성하는 방법
&lt;/h2&gt;

&lt;p&gt;캐시 적중을 위해서는 길고 동일한 접두사를 짧은 시간 간격으로 다시 전송해야 합니다. Google 문서는 두 가지 팁을 제시합니다: 크고 공통적인 콘텐츠를 프롬프트 앞부분에 배치하고, 비슷한 접두사를 가진 요청을 짧은 시간 안에 전송하는 것입니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F1uxns2od2ou5czej4ir3.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F1uxns2od2ou5czej4ir3.png" alt="Two Gemini 4 Neon requests sharing an identical stable prefix of system instruction, tool definitions and documents over 4,096 tokens, which is billed at $0.15 per 1M on a cache hit, followed by a different new question billed at $3 per 1M" width="800" height="410"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;모든 요청을 다음 순서로 구성하세요:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;시스템 지침.&lt;/strong&gt; 고정된 텍스트. 타임스탬프, 사용자 이름, 요청 ID 없음.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;도구 및 함수 선언.&lt;/strong&gt; 매번 동일한 목록, 동일한 순서, 동일한 설명.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;공유 문서.&lt;/strong&gt; 코드베이스, 계약서, API 명세, 긴 정책 파일.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;변하는 부분.&lt;/strong&gt; 사용자의 질문, 최신 도구 결과, 오늘 날짜.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;캐시 적중에 실패하는 가장 흔한 원인은 상단 근처에 작은 동적 값이 들어가는 것입니다. 시스템 지침에 &lt;code&gt;Current time: 2026-11-19T09:14:02Z&lt;/code&gt; 같은 줄이 있으면 매 호출마다 접두사가 달라져서 그 뒤의 내용은 아무것도 일치하지 않게 됩니다. 이런 값은 문서 뒤, 즉 끝으로 옮기세요.&lt;/p&gt;

&lt;p&gt;그 외 접두사를 깨뜨리는 요인: 무작위 순서로 생성된 도구 목록, 공백이 달라지며 재직렬화된 문서, 다른 순서로 반환되는 검색 청크 등이 있습니다.&lt;/p&gt;

&lt;p&gt;접두사는 4,096 토큰 이상으로 유지하세요. 2,000 토큰짜리 시스템 프롬프트만으로는 기준을 충족하지 못합니다. 여기에 긴 공유 문서를 함께 보내면 합산된 접두사가 기준을 넘게 됩니다.&lt;/p&gt;

&lt;p&gt;Interactions API에서는 안정적인 지침을 &lt;code&gt;system_instruction&lt;/code&gt;에 넣고, 문서는 &lt;code&gt;input&lt;/code&gt;의 앞쪽에 배치하세요:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="n"&gt;google&lt;/span&gt; &lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="n"&gt;genai&lt;/span&gt;

&lt;span class="n"&gt;client&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;genai&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Client&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;  &lt;span class="c1"&gt;# reads GEMINI_API_KEY&lt;/span&gt;

&lt;span class="no"&gt;SYSTEM&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;open&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"review_rules.md"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;read&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;      &lt;span class="c1"&gt;# fixed text&lt;/span&gt;
&lt;span class="no"&gt;CODEBASE&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;open&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"repo_snapshot.txt"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;read&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;  &lt;span class="c1"&gt;# ~200K tokens, unchanged&lt;/span&gt;

&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;ask&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;question&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;str&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="n"&gt;interaction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;interactions&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"gemini-4-neon"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="n"&gt;system_instruction&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="no"&gt;SYSTEM&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="nb"&gt;input&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="no"&gt;CODEBASE&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="s2"&gt;"\n\nQuestion: "&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="n"&gt;question&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"cached tokens:"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;interaction&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;usage&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;total_cached_tokens&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;interaction&lt;/span&gt;

&lt;span class="nf"&gt;ask&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"Where do we validate JWT expiry?"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="nf"&gt;ask&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"Which handlers skip input validation?"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;첫 번째 호출이 캐시를 채웁니다. 두 번째 호출에서 캐시된 토큰 수가 0으로 출력된다면 접두사 중 무언가가 변경된 것입니다.&lt;/p&gt;

&lt;p&gt;암시적 캐싱은 두 가지 대화 모드 모두에서 작동합니다. 위 예제 같은 상태 비저장(stateless) 호출도 해당되고, &lt;code&gt;previous_interaction_id&lt;/code&gt;로 연결된 상태 저장(stateful) 세션도 마찬가지입니다. 전체 요청 형식은 &lt;a href="https://apidog.com/kr/blog/gemini-4-neon-api?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Neon API 가이드&lt;/a&gt;를 참고하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  에이전트 루프에서의 캐싱 작동 방식: 2,050 토큰 규칙
&lt;/h2&gt;

&lt;p&gt;에이전트 루프는 매 턴마다 전체 히스토리를 다시 전송하기 때문에 캐싱의 효과가 가장 큰 곳입니다. 다만 Gemini 4 모델에는 알아두어야 할 규칙이 하나 추가되었습니다. Google의 캐싱 문서에 따르면: "Gemini는 새 요청이 최소 2,050 토큰 이상 추가될 때만 이전 요청 전체를 캐싱합니다." 모델 출력, thoughts, 함수 결과 모두 이 총량에 포함됩니다.&lt;/p&gt;

&lt;p&gt;한 턴에서 2,050 토큰 미만이 추가되면 Gemini는 이전 요청의 마지막 2,050 토큰을 표준 입력 요율로 다시 처리합니다. 접두사의 앞부분은 여전히 캐시에 적중할 수 있지만, 그 뒷부분은 1M당 $3으로 청구됩니다.&lt;/p&gt;

&lt;p&gt;Google에 따르면 대부분의 에이전트 턴은 이 기준을 넘습니다. 기준을 넘지 못하는 경우는 &lt;code&gt;{"ok": true}&lt;/code&gt;를 반환하는 상태 확인 같은 작은 단계가 반복되는 잦은 루프입니다. 턴당 비용은 작지만(1M당 $3 기준 2,050 토큰은 약 $0.006), 수천 번의 짧은 턴에 걸쳐 누적됩니다. 루프에서 아주 작은 호출이 많이 발생한다면 로직이 허용하는 범위 내에서 작은 도구 결과를 하나의 턴에 묶어 보내세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  Gemini 4 Neon 컨텍스트 캐싱으로 얼마나 절약할 수 있나요?
&lt;/h2&gt;

&lt;p&gt;200,000 토큰 규모의 코드베이스에 대해 20개의 질문에 답변하는 코드 리뷰 어시스턴트를 생각해 봅시다. 각 질문은 3,000 토큰을 추가하고 1,000 토큰의 답변을 받으며, Standard 등급을 사용합니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;캐시 적중이 없을 때&lt;/strong&gt; 각 호출의 비용은 다음과 같습니다:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;입력: 203,000 × $3 / 1M = $0.609&lt;/li&gt;
&lt;li&gt;출력: 1,000 × $15 / 1M = $0.015&lt;/li&gt;
&lt;li&gt;호출당: $0.624, 따라서 &lt;strong&gt;20회 호출에 $12.48&lt;/strong&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;첫 호출 이후 캐시에 적중할 때&lt;/strong&gt;, 2번부터 20번까지 호출의 비용은 다음과 같습니다:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;캐시된 접두사: 200,000 × $0.15 / 1M = $0.030&lt;/li&gt;
&lt;li&gt;새 입력: 3,000 × $3 / 1M = $0.009&lt;/li&gt;
&lt;li&gt;출력: $0.015&lt;/li&gt;
&lt;li&gt;호출당: $0.054&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;캐시가 적용되지 않은 첫 호출 $0.624를 더하면 세션 전체 비용은 &lt;strong&gt;$1.65&lt;/strong&gt;로, 약 87% 절약됩니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fxocet37bhuqna69n9xev.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fxocet37bhuqna69n9xev.png" alt="Bar chart of a Gemini 4 Neon session answering 20 questions over a 200K-token codebase on the Standard tier: $12.48 with no cache hits and $1.65 with cache hits after the first call" width="800" height="410"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;절감률이 95%에 미치지 못하는 이유는 출력과 새 입력에는 할인이 적용되지 않기 때문입니다. 공유 접두사가 나머지 부분에 비해 클수록 입력 비용은 95%에 가까워집니다. 같은 작업을 Batch로 실행하면 캐시 요율이 다시 절반인 $0.075로 내려갑니다. 전체 요금표와 thinking 레벨 비용은 &lt;a href="https://apidog.com/kr/blog/gemini-4-neon-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Neon 요금&lt;/a&gt;을 참고하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  응답에서 Gemini 4 Neon의 캐시된 토큰을 확인하는 방법
&lt;/h2&gt;

&lt;p&gt;모든 응답에서 &lt;code&gt;usage.total_cached_tokens&lt;/code&gt;를 확인하세요. Google은 이 필드를 캐시 적중된 토큰 수를 보여주는 필드로 문서화하고 있으며, Python과 JavaScript SDK 모두에서 제공됩니다.&lt;/p&gt;

&lt;p&gt;curl과 &lt;code&gt;jq&lt;/code&gt;를 사용하는 경우:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl -s &lt;span class="s2"&gt;"https://generativelanguage.googleapis.com/v1beta/interactions"&lt;/span&gt; \
  -H &lt;span class="s2"&gt;"x-goog-api-key: $GEMINI_API_KEY"&lt;/span&gt; \
  -H &lt;span class="s2"&gt;"Content-Type: application/json"&lt;/span&gt; \
  -d @request.json &lt;span class="o"&gt;|&lt;/span&gt; jq &lt;span class="s1"&gt;'.usage'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;호출 비용을 계산하려면 캐시된 토큰은 1M당 $0.15로, 나머지 입력은 $3으로, 출력과 thinking은 $15로 청구합니다. 요청 ID 옆에 캐시된 토큰 수를 로그로 남기세요. 전체 트래픽에서 갑자기 0으로 떨어진다면 대개 배포 과정에서 접두사가 변경되었음을 의미합니다. 새 도구 추가, 문구가 바뀐 규칙, 혹은 시스템 지침에 들어간 타임스탬프가 원인일 수 있습니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Apidog CLI로 코딩 에이전트에게 캐시 적중 테스트시키기
&lt;/h2&gt;

&lt;p&gt;평범한 리팩토링 중에도 접두사는 깨질 수 있고, 청구서가 도착할 때까지 아무도 눈치채지 못합니다. 캐시 확인을 코딩 에이전트가 관리하고 CI가 실행하는 API 테스트로 만드세요.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/apidog-cli/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog CLI&lt;/a&gt;를 사용하면 Claude Code, Codex, Cursor, OpenCode가 터미널에서 API 테스트를 만들고 실행할 수 있습니다. 한 번만 설정하세요:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm install -g apidog-cli@latest
apidog login --with-token &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;YOUR_TOKEN&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
npx -y skills add https://apidog.com   &lt;span class="c"&gt;# pick your agent when prompted&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;그다음 에이전트에게 프롬프트 하나를 주면 됩니다:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;In Apidog project &amp;lt;id&amp;gt;, create an environment for the Gemini API with a
GEMINI_API_KEY variable. Build a test scenario called "Neon cache hit" with two
steps that POST to /v1beta/interactions with model gemini-4-neon, using our
production system_instruction and the docs/context.md file as the start of
input, then two different questions. Assert HTTP 200 on both, and assert that
usage.total_cached_tokens on step 2 is greater than 4096. Run it and tell me
the cached token count.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;에이전트가 환경과 시나리오를 만들고, 페이로드를 CLI의 스키마와 대조한 뒤 실행합니다:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;apidog environment create gemini-api --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --base-url https://generativelanguage.googleapis.com
apidog test-scenario create --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --name &lt;span class="s2"&gt;"Neon cache hit"&lt;/span&gt;
apidog cli-schema get test-scenario-update
apidog cli-schema validate test-scenario-update --file scenario.json
apidog test-scenario update &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;scenarioId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --file scenario.json
apidog run -t &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;scenarioId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -e &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;envId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -r cli,json
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;다음 달에 누군가 시스템 프롬프트에 타임스탬프를 추가하면, 변경 사항이 배포되기 전에 2단계의 assertion이 실패합니다. &lt;a href="https://apidog.com/kr/blog/apidog-cli-ci-cd-pipeline?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog CLI CI/CD 가이드&lt;/a&gt;를 참고해 &lt;code&gt;apidog run -t &amp;lt;scenarioId&amp;gt; --project &amp;lt;id&amp;gt; -e &amp;lt;envId&amp;gt; -r junit&lt;/code&gt;을 파이프라인에 넣거나, &lt;a href="https://apidog.com/kr/blog/apidog-cli-in-claude-code?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Code에서 Apidog CLI 사용하기&lt;/a&gt;부터 시작하세요. 실행할 때마다 실제 Neon 호출이 두 번 이루어지므로, 위 요율 기준으로 실행당 몇 센트 정도의 비용이 듭니다. Apidog의 Free 플랜은 최대 4명의 사용자까지 지원합니다.&lt;/p&gt;

&lt;p&gt;프로바이더 전반에서 접두사 캐싱이 작동하는 방식은 &lt;a href="https://apidog.com/kr/blog/what-is-prompt-caching?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;프롬프트 캐싱이란?&lt;/a&gt;을 참고하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQ
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon은 명시적 컨텍스트 캐싱을 지원하나요?&lt;/strong&gt; 아니요. Google의 Neon 가이드에 따르면 &lt;code&gt;cachedContents&lt;/code&gt;나 &lt;code&gt;caches.create&lt;/code&gt;를 지원하지 않으며, 요청에서 &lt;code&gt;cached_content&lt;/code&gt;를 제거해야 합니다. Neon은 기본적으로 활성화되는 암시적 캐싱만 사용합니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon에서 캐시 적중을 위한 최소 프롬프트 크기는 얼마인가요?&lt;/strong&gt; 4,096 토큰의 공유 접두사입니다. 이는 Gemini 4 Hydrogen, Argon, Carbon과 동일한 최소치입니다. Gemini 2.5 Flash와 Pro는 2,048이 필요합니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon의 캐싱 할인율은 얼마인가요?&lt;/strong&gt; 캐시된 입력에 대해 95%입니다. Standard는 1M 토큰당 $3에서 $0.15로, Batch와 Flex는 $1.50에서 $0.075로, Priority는 $5.40에서 $0.27로 내려갑니다. 출력과 thinking 토큰에는 할인이 적용되지 않습니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon이 프롬프트를 캐싱하도록 강제할 수 있나요?&lt;/strong&gt; 아니요. 암시적 캐싱에는 활성화할 설정도, 선택할 TTL도 없으며 적중도 보장되지 않습니다. 각 요청의 시작 부분에 길고 동일한 접두사를 유지하고 비슷한 요청을 가까운 시간 안에 전송함으로써 확률을 높일 수 있습니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;내 요청이 캐시에 적중했는지 어떻게 알 수 있나요?&lt;/strong&gt; 응답의 &lt;code&gt;usage.total_cached_tokens&lt;/code&gt;를 확인하세요. 0보다 큰 값이 있다면 그만큼의 입력 토큰이 캐시 요율로 청구되었다는 뜻입니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;캐싱은 previous_interaction_id와 함께 작동하나요?&lt;/strong&gt; 네. Google 문서에 따르면 암시적 캐싱은 &lt;code&gt;previous_interaction_id&lt;/code&gt;로 연결된 상태 저장 대화와, 전체 히스토리를 직접 전송하는 상태 비저장 호출 모두에서 작동합니다.&lt;/p&gt;

</description>
    </item>
    <item>
      <title>Gemini 4 Neon 벤치마크: 코딩·에이전트·작업당 비용</title>
      <dc:creator>Rihpig</dc:creator>
      <pubDate>Thu, 19 Nov 2026 10:01:06 +0000</pubDate>
      <link>https://dev.to/rihpig/gemini-4-neon-bencimakeu-kodingeijeonteujageobdang-biyong-58c2</link>
      <guid>https://dev.to/rihpig/gemini-4-neon-bencimakeu-kodingeijeonteujageobdang-biyong-58c2</guid>
      <description>&lt;p&gt;Gemini 4 Neon 벤치마크 결과, Artificial Analysis Coding Agent Index에서 58.6점으로 1위, Terminal-Bench 4.1에서 65.2%, Vals Index에서 70.9%로 2위를 기록했습니다. Google은 또한 기본 &lt;code&gt;high&lt;/code&gt; 사고 수준에서 Gemini 4 Carbon보다 작업당 비용이 32% 저렴하다고 밝혔습니다. 다만 대부분의 항목은 &lt;code&gt;xhigh&lt;/code&gt;에서 실행됐고, 일부는 Google 자체 하네스에서 측정된 것입니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;오늘 Apidog를 사용해 보세요&lt;/a&gt;
&lt;/p&gt;

&lt;p&gt;이 마지막 부분이 바로 이 글의 핵심입니다. &lt;a href="https://apidog.com/kr/blog/what-is-gemini-4-neon?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Neon 개요&lt;/a&gt;에서는 사양과 가격을 다뤘습니다. 이 글에서는 공개된 모든 점수, 누가 측정했는지, 어떤 사고 수준에서 측정됐는지, 그리고 "작업당 비용"을 여러분의 실제 청구서와 비교해 확인할 수 있는 숫자로 바꾸는 방법을 알려드립니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Gemini 4 Neon 벤치마크 한눈에 보기
&lt;/h2&gt;

&lt;p&gt;Gemini 4 Neon은 2026년 11월 18일 출시된 Google의 중간급 Gemini 4 모델로, 백만 입력 토큰당 3달러, 백만 출력 토큰당 15달러에 책정됐습니다. 가장 뛰어난 공개 결과는 에이전트 코딩과 지식 노동 분야에서 나오며, 네 개의 독립 리더보드에서 1위 또는 2위를 차지합니다.&lt;/p&gt;

&lt;p&gt;다음은 Google의 &lt;a href="https://blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-neon/" rel="noopener noreferrer"&gt;출시 블로그&lt;/a&gt;에 실린 주요 항목입니다:&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fdyc5hqlh5e3e3mt38dkx.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fdyc5hqlh5e3e3mt38dkx.png" alt="Gemini 4 Neon benchmarks" width="800" height="696"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Google은 Vals AI의 Legal Research Bench와 Tax Agent Bench에서도 1위를 기록했다고 밝혔습니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F9vhurl8cnchmk9gn2iqj.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F9vhurl8cnchmk9gn2iqj.png" alt="Gemini 4 Neon benchmark scores grouped by who measured them: third-party leaderboards (AA Coding Agent Index 58.6, Vals Index 70.9%, Agent Arena 1,336, Terminal-Bench 4.1 65.2%, AutomationBench 56.3%) and Google self-computed rows (SWE-sweep 39.0%, Agents' Last Exam 75.8%, Terminal-Bench Science 70.5%)" width="800" height="450"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  Gemini 4 Neon 코딩 벤치마크
&lt;/h2&gt;

&lt;p&gt;Neon이 가장 강점을 보이는 분야는 코딩이며, 동시에 하네스가 가장 큰 영향을 미치는 분야이기도 합니다. Google의 &lt;a href="https://deepmind.google/models/evals-methodology/gemini-4-neon" rel="noopener noreferrer"&gt;평가 방법론 PDF&lt;/a&gt;에 각 코딩 항목이 어떻게 산출됐는지 설명되어 있습니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Artificial Analysis Coding Agent Index: 58.6, 1위.&lt;/strong&gt; 독립적인 종합 지표이므로 Google의 환경에 가장 덜 영향을 받은 항목입니다. 현재 순위는 &lt;a href="https://artificialanalysis.ai/" rel="noopener noreferrer"&gt;Artificial Analysis&lt;/a&gt;에서 확인할 수 있습니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Terminal-Bench 4.1: 65.2%.&lt;/strong&gt; Artificial Analysis가 공개 Antigravity-CLI 하네스 1.5.9 버전으로 Neon을 실행했습니다. 다른 모델의 점수는 공식 리더보드에서 가져왔으며, 모든 결과는 부정행위 보정 정확도를 사용합니다. 공정한 방식이지만, Neon은 Google 자체 에이전트 도구 안에서 실행됐습니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;FrontierCode 2.0: 46.2%.&lt;/strong&gt; 공개 리더보드에서 가져온 항목이며, 프로덕션에서 기본으로 적용되는 &lt;code&gt;high&lt;/code&gt;에서 실행됐습니다. 일상적인 트래픽에 대해 코딩 숫자 하나만 신뢰해야 한다면, 이 항목을 신뢰하시면 됩니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;SWE-sweep: Antigravity에서 39.0%, mini-SWE에서 12.8%.&lt;/strong&gt; 둘 다 Google이 자체 산출한 수치입니다. 3배 차이는 하네스에서 비롯됩니다. Google은 Antigravity-CLI에 서브 에이전트를 코드베이스 전반에 분산 배치하는 기본 도구가 포함되어 있으며, 이것이 버그 탐색 작업에 적합하다고 설명합니다. 동일한 비교에서 Opus 5.5는 Claude Code에서, GPT-6.2 Sol은 Codex에서 실행됐습니다. 12.8%는 모델 자체로, 39.0%는 모델과 최적의 도구를 결합한 결과로 해석하시면 됩니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fm2qtmjq4o9lyge1rg1i1.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fm2qtmjq4o9lyge1rg1i1.png" alt="Same model, two harnesses: Gemini 4 Neon scores 12.8% on SWE-sweep with the mini-SWE agent and 39.0% in Google Antigravity, where sub-agents fan out across the codebase" width="800" height="450"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  에이전트 및 지식 노동 벤치마크
&lt;/h2&gt;

&lt;p&gt;Neon을 여러 단계에 걸쳐 무인으로 운영할 계획이라면 다음 항목들이 중요합니다.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Agent Arena Index: 1,336, 2위.&lt;/strong&gt; 4,200건 이상의 실제 에이전트 세션을 기반으로 산출됐습니다. Google은 또한 Neon이 조종 가능성(steerability) 부문에서 2위를 기록했다고 밝혔는데, 이는 사용자가 작업 도중 수정을 가할 때 깔끔하게 적응한다는 뜻입니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;AutomationBench: 56.3%, 1위.&lt;/strong&gt; Zapier의 비즈니스 자동화 벤치마크이며, 공개 리더보드에서 가져왔습니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Vending-Bench 2: $16,843, 1위.&lt;/strong&gt; Andon Labs의 장기 지평 비즈니스 운영 시뮬레이션입니다. 점수는 백분율이 아니라 벌어들인 금액입니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Agents' Last Exam v1.1: 75.8%.&lt;/strong&gt; Antigravity-CLI 1.4.8에서 실행당 5시간의 시간 제한을 두고 122개 과제 세트로 자체 산출했습니다. Opus 5.5의 점수는 공개 리더보드에서, GPT-6.2 Sol의 점수는 시스템 카드에서 가져왔으므로 설정이 서로 다릅니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Chartography: 73.5%.&lt;/strong&gt; 복잡한 전문 차트를 읽는 능력이며, 도구 없이 자체 산출했습니다.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;과학 및 수학 분야에서 Neon은 Terminal-Bench Science에서 70.5%(자체 산출, 5회 시도 평균), RiemannBench에서 84.0%, HLE-Diamond에서 71.3%(Artificial Analysis 리더보드 기준)를 기록했습니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Google의 수치 산출 방식
&lt;/h2&gt;

&lt;p&gt;방법론에서 나온 네 가지 규칙은 표를 읽는 방식을 바꿔놓습니다:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;기본적으로 최고 사고 수준 사용.&lt;/strong&gt; "별도 표시가 없는 한 모든 결과는 Gemini API에서 최고 사고 설정으로 실행됩니다." 즉 &lt;code&gt;xhigh&lt;/code&gt;입니다. FrontierCode 2.0만 명시적으로 &lt;code&gt;high&lt;/code&gt;로 표시되어 있습니다. 프로덕션 호출은 기본값이 &lt;code&gt;high&lt;/code&gt;이므로, 사고 토큰이 더 적게 들고 점수도 표에 나온 것보다 낮을 수 있습니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Pass@1, 단일 시도.&lt;/strong&gt; 별도 표시가 없는 한( Terminal-Bench Science는 5회 시도 평균) 다수결 투표나 병렬 테스트 타임 컴퓨트는 사용하지 않았습니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;경쟁 모델 수치는 자체 보고.&lt;/strong&gt; Gemini가 아닌 모델의 점수는 별도 표시가 없는 한 각 제공사에서 가져왔습니다. Opus 5.5와 GPT-6.2 Sol은 사용 가능한 경우 최대 추론 설정을 사용합니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;사이버 항목을 제외하면 안전 필터 활성화.&lt;/strong&gt; 사이버 보안 항목은 필터를 끈 상태로 실행됐습니다.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;&lt;a href="https://apidog.com/kr/blog/gemini-4-neon-thinking-levels?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;사고 수준 가이드&lt;/a&gt;에서 &lt;code&gt;xhigh&lt;/code&gt;가 추가 토큰을 쓸 가치가 있는 경우를 다룹니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  작업당 비용: 32% 절감 주장의 의미
&lt;/h2&gt;

&lt;p&gt;작업당 비용은 벤치마크 과제 하나를 완료하는 데 드는 총 지출이며, 토큰당 가격이 아닙니다. 토큰 가격이 더 높은 모델이라도 더 적은 단계와 사고 토큰으로 정답에 도달하면 작업당 비용은 더 낮을 수 있습니다.&lt;/p&gt;

&lt;p&gt;Google은 세 가지 비용 관련 주장을 내놓습니다:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;주장&lt;/th&gt;
&lt;th&gt;사고 수준&lt;/th&gt;
&lt;th&gt;비교 대상&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;AA Intelligence Index에서 높은 점수를 유지하면서 작업당 비용 32% 절감&lt;/td&gt;
&lt;td&gt;&lt;code&gt;high&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Gemini 4 Carbon&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Vals Index와 Agent Arena에서 작업당 비용 약 50~80% 절감&lt;/td&gt;
&lt;td&gt;&lt;code&gt;high&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;최상위 경쟁 프런티어 모델&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;작업당 비용 36% 이상 절감&lt;/td&gt;
&lt;td&gt;&lt;code&gt;xhigh&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;최고 설정의 경쟁 모델&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;주목할 불일치가 있습니다. 정확도 항목은 대부분 &lt;code&gt;xhigh&lt;/code&gt;를 쓰는 반면, 대표적인 32% 절감은 &lt;code&gt;high&lt;/code&gt; 기준입니다. 둘 다 사실이지만 동시에 성립하지는 않습니다. 비용 절감을 얻든 최고 점수를 얻든 둘 중 하나이며, 그 격차는 여러분이 직접 측정해야 합니다.&lt;/p&gt;

&lt;p&gt;자체 작업당 비용을 추정하는 방법은 다음과 같습니다. 사고 토큰은 출력으로 청구됩니다.&lt;/p&gt;

&lt;p&gt;$$\text{cost} = \frac{\text{input} \times 3 + \text{cached input} \times 0.15 + \text{output} \times 15}{1{,}000{,}000}$$&lt;/p&gt;

&lt;p&gt;입력 토큰 20,000개, 출력 토큰 4,000개인 코딩 작업의 비용은 $0.06 + $0.06 = &lt;strong&gt;$0.12&lt;/strong&gt;입니다. 입력 토큰 중 15,000개가 캐시에 적중하면 $0.015 + $0.00225 + $0.06 = &lt;strong&gt;약 $0.077&lt;/strong&gt;로 떨어집니다. 같은 작업을 &lt;code&gt;xhigh&lt;/code&gt;에서 실행하면 출력 개수가 변동하므로, 통과/실패 여부뿐 아니라 사고 수준별 토큰 수도 기록하세요. &lt;a href="https://apidog.com/kr/blog/gemini-4-neon-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Neon 가격 상세&lt;/a&gt;에서 Batch, Flex, Priority 요금을 다룹니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  사이버 및 안전 항목
&lt;/h2&gt;

&lt;p&gt;사이버 점수는 공개 API가 아니라 Fairwind Program을 통해 신뢰할 수 있는 방어자에게 제공되는 "사이버용 Gemini 4 Neon"에서 나온 것입니다.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;벤치마크&lt;/th&gt;
&lt;th&gt;점수&lt;/th&gt;
&lt;th&gt;비고&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;SEC-bench Pro&lt;/td&gt;
&lt;td&gt;90.5%&lt;/td&gt;
&lt;td&gt;최고 수준, 과제당 비용은 약 절반&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;WebExploitBench v1.2&lt;/td&gt;
&lt;td&gt;51.26%&lt;/td&gt;
&lt;td&gt;최고 수준, 대형 모델 대비 절반의 비용&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;AutoBaxBench (hard 등급)&lt;/td&gt;
&lt;td&gt;76%&lt;/td&gt;
&lt;td&gt;최고 수준, 모든 등급에서 Carbon보다 안전한 코드&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;CWE-bench v2&lt;/td&gt;
&lt;td&gt;70.7%&lt;/td&gt;
&lt;td&gt;Carbon 대비 3.4% 향상&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;ExploitGym&lt;/td&gt;
&lt;td&gt;수치 미공개&lt;/td&gt;
&lt;td&gt;Carbon의 절반 토큰으로 프런티어 수준 달성&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;같은 글에 실린 안전 관련 수치: Neon은 Terminal-Bench 4.0 과제의 1.98%를 거부했고, Terminal-Bench 4.0에서 부정행위 점수 0.0%를 기록했으며, Google의 코딩 부정행위 평가에서 2.45%의 과제에서 편법을 사용했고, 에이전트 정직성 평가에서는 99.2%를 통과했습니다. 최고 사고 수준에서 실시간 안전장치를 켰을 때 Gray Swan의 간접 프롬프트 인젝션 벤치마크의 모든 공격을 방어했습니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Neon이 앞서지 못하는 분야
&lt;/h2&gt;

&lt;p&gt;Neon이 모든 분야에서 1위인 것은 아니며, Google도 이를 인정합니다:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Artificial Analysis Intelligence Index:&lt;/strong&gt; 종합 3위로, "더 크고 느린 모델들에 살짝 뒤처집니다."&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Vals Index:&lt;/strong&gt; 1위가 아닌 2위.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Agent Arena Index:&lt;/strong&gt; 2위.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Google은 또한 가장 어려운 장기 지평 프로젝트에는 여전히 Carbon을 권장합니다. 세 가지 Gemini 4 모델 중에서 고민 중이라면 &lt;a href="https://apidog.com/kr/blog/gemini-4-neon-vs-carbon-vs-hydrogen?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Neon vs Carbon vs Hydrogen 비교&lt;/a&gt;에서 트레이드오프를 정리해 두었고, &lt;a href="https://apidog.com/kr/blog/gemini-4-argon-benchmarks?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Argon 벤치마크&lt;/a&gt; 글에서 이전 모델의 표를 어떻게 읽어야 하는지 확인할 수 있습니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Apidog CLI로 Gemini 4 Neon 직접 벤치마크하기
&lt;/h2&gt;

&lt;p&gt;리더보드는 여러분의 제품이 아니라 Google의 하네스를 설명합니다. Neon이 그 가격만큼 가치가 있는지 확인하는 가장 빠른 방법은 코딩 에이전트가 동일한 프롬프트를 &lt;code&gt;high&lt;/code&gt;와 &lt;code&gt;xhigh&lt;/code&gt;에서 실행하고 각각의 토큰과 지연 시간을 기록하게 하는 것입니다.&lt;/p&gt;

&lt;p&gt;Neon에는 무료 API 티어가 없으므로 유료 Gemini API 키가 필요합니다. 다음 요청은 Google의 문서화된 Interactions API 형식을 따르며, 이 글을 위해 실제로 실행해 보지는 않았습니다:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl -s &lt;span class="s2"&gt;"https://generativelanguage.googleapis.com/v1beta/interactions"&lt;/span&gt; \
  -H &lt;span class="s2"&gt;"x-goog-api-key: $GEMINI_API_KEY"&lt;/span&gt; \
  -H &lt;span class="s2"&gt;"Content-Type: application/json"&lt;/span&gt; \
  -d &lt;span class="s1"&gt;'{"model": "gemini-4-neon", "input": "Find the race condition in this retry queue.", "generation_config": {"thinking_level": "high"}}'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;a href="https://apidog.com/apidog-cli/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog CLI&lt;/a&gt;를 사용하면 Claude Code, Codex, Cursor, OpenCode에서 터미널로 API 테스트를 만들고 실행할 수 있습니다. 한 번만 설정하면 됩니다:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm install -g apidog-cli@latest
apidog login --with-token &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;YOUR_TOKEN&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
npx -y skills add https://apidog.com   &lt;span class="c"&gt;# pick your agent when prompted&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;그런 다음 에이전트에 프롬프트 하나를 주면 됩니다:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;In Apidog project &amp;lt;id&amp;gt;, create a Gemini API environment with GEMINI_API_KEY
and THINKING variables. Add a test case for POST /v1beta/interactions on
gemini-4-neon that sends my 10 eval prompts from prompts.csv, asserts HTTP 200
and a non-empty output, and records token usage and response time. Run it at
THINKING=high and THINKING=xhigh and compare cost per task at $3/$15 per 1M.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;에이전트는 환경을 만들고, 테스트 케이스 페이로드를 스키마와 대조해 검증한 뒤, 사고 수준마다 한 번씩 실행합니다:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;apidog environment create gemini-api --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --base-url https://generativelanguage.googleapis.com
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --file case.json
apidog run --test-case &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;caseId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -e &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;envId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -d prompts.csv --env-var &lt;span class="s2"&gt;"THINKING=high"&lt;/span&gt; -r cli,json
apidog run --test-case &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;caseId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -e &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;envId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -d prompts.csv --env-var &lt;span class="s2"&gt;"THINKING=xhigh"&lt;/span&gt; -r cli,json
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;프롬프트가 길다면 &lt;code&gt;--timeout-request 900000&lt;/code&gt;을 추가하세요. 어려운 &lt;code&gt;xhigh&lt;/code&gt; 실행은 몇 분이 걸릴 수 있습니다. 프롬프트가 바뀔 때마다 비교를 다시 실행하려면 동일한 &lt;code&gt;apidog run ... -r junit&lt;/code&gt;을 &lt;a href="https://apidog.com/kr/blog/apidog-cli-ci-cd-pipeline?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog CLI CI/CD 가이드&lt;/a&gt;와 함께 CI에 넣거나, &lt;a href="https://apidog.com/kr/blog/apidog-cli-in-claude-code?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Code에서의 Apidog CLI&lt;/a&gt;에서 시작하세요. Apidog의 무료 플랜은 최대 4명의 사용자까지 지원합니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQ
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon의 가장 뛰어난 벤치마크 결과는 무엇인가요?&lt;/strong&gt; Artificial Analysis Coding Agent Index에서 58.6으로 1위, 그리고 AutomationBench(56.3%)와 Vending-Bench 2($16,843)에서도 1위를 차지했습니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;벤치마크는 어떤 사고 수준에서 실행됐나요?&lt;/strong&gt; 대부분 &lt;code&gt;xhigh&lt;/code&gt;(최고 설정)입니다. Google의 방법론에 따르면 별도 표시가 없는 한 최고 사고 설정으로 결과를 산출합니다. FrontierCode 2.0(46.2%)만 기본값인 &lt;code&gt;high&lt;/code&gt;로 표시되어 있습니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon이 Carbon보다 작업당 저렴한가요?&lt;/strong&gt; Google은 &lt;code&gt;high&lt;/code&gt;에서 작업당 비용이 32% 낮다고 밝혔습니다. 이는 벤치마크 실행에서 나온 작업당 수치이므로, 트래픽을 옮기기 전에 여러분의 프롬프트에서 직접 확인하세요.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Neon이 SWE-sweep에서 39.0%와 12.8%를 받는 이유는 무엇인가요?&lt;/strong&gt; 하네스가 다르기 때문입니다. 39.0%는 서브 에이전트를 코드베이스 전반에 분산하는 Google Antigravity 내부 결과이고, 12.8%는 더 단순한 mini-SWE 에이전트 결과입니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon의 벤치마크는 독립적인가요?&lt;/strong&gt; 일부만 그렇습니다. Artificial Analysis, Vals, Arena, AutomationBench, FrontierCode 항목은 제3자가 측정했습니다. SWE-sweep, Agents' Last Exam, Terminal-Bench Science는 Google이 자체 산출했습니다.&lt;/p&gt;

</description>
    </item>
    <item>
      <title>Gemini 4 Neon vs GPT-6.2 Astra vs Claude Fable 5.2: 벤치마크·가격·작업당 비용 비교</title>
      <dc:creator>Rihpig</dc:creator>
      <pubDate>Thu, 19 Nov 2026 09:59:50 +0000</pubDate>
      <link>https://dev.to/rihpig/gemini-4-neon-vs-gpt-62-astra-vs-claude-fable-52-bencimakeugagyeogjageobdang-biyong-bigyo-3gcd</link>
      <guid>https://dev.to/rihpig/gemini-4-neon-vs-gpt-62-astra-vs-claude-fable-52-bencimakeugagyeogjageobdang-biyong-bigyo-3gcd</guid>
      <description>&lt;p&gt;Gemini 4 Neon vs GPT-6.2 Astra vs Claude Fable 5.2, 한 줄 요약: Fable 5.2가 가장 높은 점수를 기록하고, Neon이 토큰당 비용이 가장 저렴하며, Astra가 독립 벤치마크 과제를 가장 적은 비용으로 완료합니다. Neon의 정가는 100만 입력/출력 토큰당 $3 / $15이고, Astra와 Fable은 모두 $8 / $40입니다. 세 모델 모두 약 100만 토큰의 컨텍스트를 제공합니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;지금 Apidog를 사용해 보세요&lt;/a&gt;
&lt;/p&gt;

&lt;p&gt;10일 사이에 프런티어 모델 세 개가 출시되었습니다. Claude Fable 5.2는 2026년 11월 9일, GPT-6.2 Astra는 11월 17일, Gemini 4 Neon은 11월 18일이었습니다. 아래에서 가격, 사양, 독립 평가 점수, 과제당 비용, 그리고 Apidog CLI로 세 모델을 모두 테스트하는 방법을 살펴봅니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Gemini 4 Neon vs GPT-6.2 Astra vs Claude Fable 5.2: 한눈에 보는 결론
&lt;/h2&gt;

&lt;p&gt;리더보드 순위가 아니라 워크로드에 따라 고르세요.&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Gemini 4 Neon&lt;/strong&gt;: 하루 종일 돌리는 복잡한 코딩과 분석에 적합합니다. 토큰당 비용이 나머지 두 모델보다 62.5% 저렴하고, Vals Index에서 2위입니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;GPT-6.2 Astra&lt;/strong&gt;: 스택이 OpenAI Responses API 기반이라면 선택하세요. 과제당 생성하는 토큰 수가 훨씬 적어, $8 / $40의 가격에도 Artificial Analysis 과제당 비용은 세 모델 중 가장 낮습니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Claude Fable 5.2&lt;/strong&gt;: 실패한 실행의 비용이 토큰 비용보다 큰, 가장 어려운 장기 작업에 적합합니다. 두 독립 지수 모두에서 1위이며, 과제당 비용은 가장 높습니다.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;지난 10월의 사례가 궁금하다면, &lt;a href="https://apidog.com/kr/blog/gemini-4-argon-vs-gpt-6-astra-vs-claude-opus-5-5?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Argon vs GPT-6 Astra vs Claude Opus 5.5 비교&lt;/a&gt;에서 이전 세대를 다룹니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  세 모델의 가격과 사양은 어떻게 비교되나요?
&lt;/h2&gt;

&lt;p&gt;가격에서 눈에 띄는 것은 Neon입니다. 수치는 Google의 &lt;a href="https://blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-neon/" rel="noopener noreferrer"&gt;Gemini 4 Neon 출시 포스트&lt;/a&gt;와 가격 페이지, &lt;a href="https://developers.openai.com/api/docs/models/gpt-6.2-astra" rel="noopener noreferrer"&gt;GPT-6.2 Astra 모델 페이지&lt;/a&gt;, Anthropic의 &lt;a href="https://platform.claude.com/docs/en/models/fable-5-2/overview" rel="noopener noreferrer"&gt;Claude Fable 5.2 개요&lt;/a&gt;에서 가져왔습니다.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;사양&lt;/th&gt;
&lt;th&gt;Gemini 4 Neon&lt;/th&gt;
&lt;th&gt;GPT-6.2 Astra&lt;/th&gt;
&lt;th&gt;Claude Fable 5.2&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;API 모델 ID&lt;/td&gt;
&lt;td&gt;&lt;code&gt;gemini-4-neon&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;gpt-6.2-astra&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;claude-fable-5-2&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;출시일&lt;/td&gt;
&lt;td&gt;2026년 11월 18일&lt;/td&gt;
&lt;td&gt;2026년 11월 17일&lt;/td&gt;
&lt;td&gt;2026년 11월 9일&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;100만 토큰당 입력 / 출력&lt;/td&gt;
&lt;td&gt;$3 / $15&lt;/td&gt;
&lt;td&gt;$8 / $40&lt;/td&gt;
&lt;td&gt;$8 / $40&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;100만 토큰당 캐시 입력&lt;/td&gt;
&lt;td&gt;$0.15 (암시적 캐시만)&lt;/td&gt;
&lt;td&gt;$0.40&lt;/td&gt;
&lt;td&gt;$0.20&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;컨텍스트 윈도우&lt;/td&gt;
&lt;td&gt;1,048,576 (출력과 공유)&lt;/td&gt;
&lt;td&gt;1,050,000 (최대 입력 922,000)&lt;/td&gt;
&lt;td&gt;100만&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;요청당 최대 출력&lt;/td&gt;
&lt;td&gt;65,536&lt;/td&gt;
&lt;td&gt;128,000&lt;/td&gt;
&lt;td&gt;128K&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;긴 프롬프트&lt;/td&gt;
&lt;td&gt;100만 토큰 전체에 동일 요율&lt;/td&gt;
&lt;td&gt;입력 272K 초과 시: 입력 2배, 출력 1.5배&lt;/td&gt;
&lt;td&gt;100만 토큰 전체에 동일 요율&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;배치 할인&lt;/td&gt;
&lt;td&gt;50% (Batch 및 Flex)&lt;/td&gt;
&lt;td&gt;50%&lt;/td&gt;
&lt;td&gt;50%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;추론 제어&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;thinking_level&lt;/code&gt;: low~xhigh, 기본값 high&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;reasoning.effort&lt;/code&gt;, &lt;code&gt;none&lt;/code&gt;은 거부됨&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;effort&lt;/code&gt;, 기본값 high&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;무료 API 티어&lt;/td&gt;
&lt;td&gt;없음&lt;/td&gt;
&lt;td&gt;없음&lt;/td&gt;
&lt;td&gt;없음&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;실제 청구서를 바꾸는 세부 사항이 두 가지 있습니다. Neon의 캐싱은 암시적입니다. Google이 반복되는 프롬프트 접두사를 매칭할 때만 $0.15 요율이 적용됩니다. 그리고 Neon은 요청당 최대 65,536 토큰까지만 반환하므로, 아주 긴 출력은 Google의 long decode나 이어쓰기(continuation) 루프가 필요합니다.&lt;/p&gt;

&lt;p&gt;전체 요율표는 &lt;a href="https://apidog.com/kr/blog/gemini-4-neon-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Neon 가격&lt;/a&gt;, &lt;a href="https://apidog.com/kr/blog/gpt-6-2-astra-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;GPT-6.2 Astra 가격&lt;/a&gt;, &lt;a href="https://apidog.com/kr/blog/claude-fable-5-2-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Fable 5.2 가격&lt;/a&gt; 분석 글에서 확인하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  독립 벤치마크에서 어떤 모델이 이기나요?
&lt;/h2&gt;

&lt;p&gt;벤더의 벤치마크 표는 같은 테스트를 공유하는 경우가 드뭅니다. 두 개의 독립 리더보드가 세 모델을 동일한 스위트로 평가하며, 2위에 대해서는 서로 다른 결과를 냅니다.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;지표&lt;/th&gt;
&lt;th&gt;Gemini 4 Neon&lt;/th&gt;
&lt;th&gt;GPT-6.2 Astra&lt;/th&gt;
&lt;th&gt;Claude Fable 5.2&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Artificial Analysis Intelligence Index&lt;/td&gt;
&lt;td&gt;61 (xhigh)&lt;/td&gt;
&lt;td&gt;62 (max)&lt;/td&gt;
&lt;td&gt;65 (max)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Vals Index&lt;/td&gt;
&lt;td&gt;70.87%, 2위&lt;/td&gt;
&lt;td&gt;67.66%, 8위&lt;/td&gt;
&lt;td&gt;71.31%, 1위&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;AA 지수 과제당 비용&lt;/td&gt;
&lt;td&gt;$6.44&lt;/td&gt;
&lt;td&gt;$4.00&lt;/td&gt;
&lt;td&gt;$26.54&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;AA 지수 과제당 시간&lt;/td&gt;
&lt;td&gt;21.5분&lt;/td&gt;
&lt;td&gt;13.9분&lt;/td&gt;
&lt;td&gt;41.8분&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;AA 출력 속도&lt;/td&gt;
&lt;td&gt;110 tok/s&lt;/td&gt;
&lt;td&gt;49 tok/s&lt;/td&gt;
&lt;td&gt;109 tok/s&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;AA 지수 전체 출력 토큰&lt;/td&gt;
&lt;td&gt;283M&lt;/td&gt;
&lt;td&gt;65.8M&lt;/td&gt;
&lt;td&gt;275M&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;출처: 각 모델의 &lt;a href="https://artificialanalysis.ai/models/gemini-4-neon" rel="noopener noreferrer"&gt;Artificial Analysis&lt;/a&gt; 모델 페이지(2026년 11월 19일 확인)와 2026년 11월 18일 기준 &lt;a href="https://www.vals.ai/benchmarks/vals_index" rel="noopener noreferrer"&gt;Vals Index&lt;/a&gt;입니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F3tk830hmhdrpji844ym1.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F3tk830hmhdrpji844ym1.png" alt="Bar charts comparing Gemini 4 Neon, GPT-6.2 Astra and Claude Fable 5.2: Artificial Analysis Intelligence Index 61, 62 and 65; Vals Index 70.87%, 67.66% and 71.31%; Artificial Analysis cost per index task $6.44, $4.00 and $26.54" width="800" height="283"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Fable 5.2가 두 지수 모두 1위이며, Vals Index에서 Neon과의 차이는 단 0.44점입니다. Artificial Analysis에서는 Astra가 Neon보다 1점 앞서지만, Vals Index에서는 Neon이 Astra를 3점 이상 앞섭니다.&lt;/p&gt;

&lt;p&gt;Google의 출시 포스트에서는 Neon을 Artificial Analysis 3위로 소개했지만, 11월 19일 같은 페이지에서는 96개 모델 중 6위로 표시됩니다. 출시 당일의 순위는 빠르게 바뀌며, 1점 차이는 노이즈에 가깝습니다. 비용과 속도 항목이 각 모델이 에이전트에서 어떻게 체감될지 더 잘 보여줍니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  토큰당 가장 비싼 모델이 왜 과제당 비용은 가장 낮나요?
&lt;/h2&gt;

&lt;p&gt;청구서의 절반은 토큰당 가격이고, 나머지 절반은 모델이 답을 내기까지 쓰는 토큰 수입니다. Artificial Analysis 스위트에서 Astra는 65.8M의 출력 토큰을 생성했습니다. Neon은 283M, Fable은 275M으로, 네 배 이상 많습니다. Astra의 $40 출력 요율이 훨씬 적은 양에 적용되었기에 과제당 비용이 $4.00으로, Neon의 $6.44보다 낮게 나온 것입니다. Neon의 출력 요율이 62.5% 더 낮음에도 말이죠.&lt;/p&gt;

&lt;p&gt;설정도 중요합니다. Artificial Analysis는 Neon을 &lt;code&gt;xhigh&lt;/code&gt;에서 실행했습니다. &lt;code&gt;high&lt;/code&gt;에서는 283M 대신 123M 출력 토큰으로 60점을 받았습니다. 절반도 안 되는 토큰으로 겨우 1점만 양보한 셈입니다. &lt;a href="https://apidog.com/kr/blog/gemini-4-neon-thinking-levels?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Neon thinking levels 가이드&lt;/a&gt;에서 전체 곡선을 확인할 수 있습니다.&lt;/p&gt;

&lt;p&gt;Fable의 $26.54는 높은 출력 요율과 많은 출력량이 합쳐진 결과입니다. 최고 점수의 대가입니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  실제 에이전트 워크로드는 모델별로 얼마인가요?
&lt;/h2&gt;

&lt;p&gt;두 가지 워크로드를 정가 기준으로 계산했으며, 모든 모델에서 토큰 수가 동일하다고 가정했습니다(실제로는 그렇지 않으므로 예측이 아니라 가격 비교로 읽어 주세요).&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;워크로드&lt;/th&gt;
&lt;th&gt;Gemini 4 Neon&lt;/th&gt;
&lt;th&gt;GPT-6.2 Astra&lt;/th&gt;
&lt;th&gt;Claude Fable 5.2&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;에이전트 세션: 신규 입력 150K, 캐시 읽기 1.35M, 출력 150K&lt;/td&gt;
&lt;td&gt;$0.45 + $0.20 + $2.25 = &lt;strong&gt;$2.90&lt;/strong&gt;
&lt;/td&gt;
&lt;td&gt;$1.50 + $0.54 + $6.00 = &lt;strong&gt;$8.04&lt;/strong&gt;
&lt;/td&gt;
&lt;td&gt;$1.50 + $0.27 + $6.00 = &lt;strong&gt;$7.77&lt;/strong&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;긴 요청 하나: 입력 400K, 출력 8K, 캐시 없음&lt;/td&gt;
&lt;td&gt;$1.20 + $0.12 = &lt;strong&gt;$1.32&lt;/strong&gt;
&lt;/td&gt;
&lt;td&gt;$6.40 + $0.48 = &lt;strong&gt;$6.88&lt;/strong&gt;
&lt;/td&gt;
&lt;td&gt;$3.20 + $0.32 = &lt;strong&gt;$3.52&lt;/strong&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Astra와 Fable은 첫 150K를 100만 토큰당 $10의 캐시 쓰기 요금으로 청구합니다. Neon에는 쓰기 요금이 없습니다. 긴 요청은 Astra의 272K 규칙을 보여줍니다. 이 선을 넘으면 OpenAI는 요청 전체에 대해 입력 100만 토큰당 $16, 출력 100만 토큰당 $60을 청구합니다.&lt;/p&gt;

&lt;p&gt;여러분의 프롬프트에서 Neon이 Astra보다 3배 더 많은 토큰을 쓴다면, 세션 비용 $2.90이 Astra보다 비쌀 수 있습니다. 가격으로 고르기 전에 출력 토큰을 먼저 측정하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  어떤 API 차이가 에이전트 하네스를 망가뜨리나요?
&lt;/h2&gt;

&lt;p&gt;각 API는 다른 API가 받아들이는 설정을 거부합니다.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Gemini 4 Neon:&lt;/strong&gt; 예전 &lt;code&gt;thinking_budget&lt;/code&gt; 파라미터는 HTTP 400을 반환하며, &lt;code&gt;frequency_penalty&lt;/code&gt;와 &lt;code&gt;presence_penalty&lt;/code&gt;도 마찬가지입니다. 커스텀 &lt;code&gt;temperature&lt;/code&gt;, &lt;code&gt;top_k&lt;/code&gt;, &lt;code&gt;top_p&lt;/code&gt; 값은 Google의 Cloud 개발자 가이드에 따라 무시됩니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;GPT-6.2 Astra:&lt;/strong&gt; &lt;code&gt;reasoning.effort&lt;/code&gt;를 &lt;code&gt;none&lt;/code&gt;으로 설정하면 400을 반환하며, 모델 페이지에는 Realtime, Assistants, 파인튜닝이 지원되지 않는다고 나와 있습니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Claude Fable 5.2:&lt;/strong&gt; 강제 도구 사용(&lt;code&gt;tool_choice&lt;/code&gt;가 &lt;code&gt;any&lt;/code&gt; 또는 &lt;code&gt;tool&lt;/code&gt;)과 &lt;code&gt;temperature&lt;/code&gt; 같은 샘플링 파라미터는 400을 반환하며, thinking을 끌 수 없습니다.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;a href="https://apidog.com/kr/blog/gpt-6-2-astra-vs-claude-fable-5-2?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;GPT-6.2 Astra vs Claude Fable 5.2 가이드&lt;/a&gt;에서 Astra와 Fable의 특이사항을 자세히 다루며, &lt;a href="https://apidog.com/kr/blog/gemini-4-neon-api?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Neon API 가이드&lt;/a&gt;에서는 Neon의 요청 형식을 다룹니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  각 모델은 어디에 가장 잘 맞나요?
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon&lt;/strong&gt;은 빈번하고 복잡한 작업을 위해 만들어졌습니다. Google에 따르면 중복 파일 읽기를 줄이고, 더 저렴한 Gemini 4 Hydrogen 서브에이전트가 단계를 실행하는 동안 계획을 세울 수 있습니다. Google Antigravity에서는 &lt;code&gt;/swarm&lt;/code&gt;으로 에이전트를 병렬 실행합니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;GPT-6.2 Astra&lt;/strong&gt;는 OpenAI 툴박스를 제공합니다. &lt;code&gt;apply_patch&lt;/code&gt;, 호스팅 셸, computer use, MCP, 그리고 Responses API의 멀티 에이전트 베타가 있습니다. Artificial Analysis 기준 과제당 13.9분으로 세 모델 중 가장 빠릅니다. Simon Willison은 &lt;a href="https://simonwillison.net/2026/Nov/17/gpt62-astra-and-sol/" rel="noopener noreferrer"&gt;출시 당일&lt;/a&gt; 여러 벤치마크에서 Fable 5.2보다 조금 낮은 점수를 기록한다고 언급했습니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Claude Fable 5.2&lt;/strong&gt;는 품질이 비용보다 중요할 때 선택하세요. 긴 에이전트 세션, 어려운 리팩터링, 리서치 작업에 적합합니다. 캐시 읽기 $0.20과 100만 토큰 전체에 동일한 가격이 $40 출력 요율의 부담을 덜어줍니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fatbdbgpvugb4hhtz2nq0.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fatbdbgpvugb4hhtz2nq0.png" alt="Diagram of a coding agent routing tasks: everyday complex coding to Gemini 4 Neon, OpenAI hosted-tool work to GPT-6.2 Astra, and the hardest long-context work to Claude Fable 5.2" width="800" height="373"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;하나만 고를 필요는 없습니다. 에이전트 단계의 대부분은 Neon으로 보내고, Neon에서 실패하는 소수의 과제만 Fable이나 Astra로 보내면 평균 비용은 Neon에 가깝게 유지됩니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  세 모델을 내 워크로드에서 어떻게 테스트하나요?
&lt;/h2&gt;

&lt;p&gt;리더보드는 다른 사람의 과제를 측정합니다. 에이전트 이력에서 실제 프롬프트 5~10개를 뽑아 세 API 모두에 보내고, 통과율, 토큰, 지연 시간을 비교하세요. 이런 요청을 손으로 반복하기는 금방 지루해지므로, Claude Code, Codex, Cursor에게 &lt;a href="https://apidog.com/apidog-cli/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog CLI&lt;/a&gt;를 맡기세요. 설치는 명령 세 개면 됩니다.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm install -g apidog-cli@latest
apidog login --with-token &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;YOUR_APIDOG_TOKEN&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
npx -y skills add https://apidog.com   &lt;span class="c"&gt;# pick your agent when prompted&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;그다음 에이전트에게 프롬프트 하나를 주세요.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;In Apidog project &amp;lt;PROJECT_ID&amp;gt;, create three test cases that send the
same code-review prompt to gemini-4-neon (Gemini Interactions API,
thinking_level high), gpt-6.2-astra (OpenAI Responses API, effort high)
and claude-fable-5-2 (Claude Messages API, no temperature field).
Keep each API key in a private environment variable. Assert a 200
status and a non-empty answer, record token usage and response time,
run each case 5 times and summarize cost per run at list prices.
Validate every payload against its schema before you write it.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;에이전트가 각 페이로드 스키마를 검사하고, 케이스를 작성하고, 실행합니다. 다음 플래그들은 CLI 2.2.12에서 &lt;code&gt;apidog run --help&lt;/code&gt;로 확인한 것입니다.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file neon-case.json
apidog test-case create --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;PROJECT_ID&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --file neon-case.json
apidog test-case create --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;PROJECT_ID&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --file astra-case.json
apidog test-case create --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;PROJECT_ID&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --file fable-case.json
apidog run --test-case &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;NEON_CASE_ID&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;PROJECT_ID&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; \
  -e &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;ENV_ID&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -n 5 -r cli,json --out-dir abc-results
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;마지막 명령을 Astra와 Fable 케이스 ID로 반복하세요. &lt;code&gt;-n 5&lt;/code&gt;는 각 케이스를 다섯 번 실행하며, &lt;code&gt;--upload-report&lt;/code&gt;를 붙이면 Apidog 앱에서 실행 결과를 볼 수 있습니다. 이는 워크플로 템플릿이며, 이 머신에서 세 API 모두에 대해 실행해 본 것은 아닙니다.&lt;/p&gt;

&lt;p&gt;위의 400 오류에 대한 네거티브 케이스도 추가하세요. 그러면 공급자 규칙이 바뀔 때 여러분의 스위트에서 가장 먼저 드러납니다. &lt;a href="https://apidog.com/kr/blog/apidog-cli-in-claude-code?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Code에서 Apidog CLI 사용 가이드&lt;/a&gt;에서 에이전트 설정을 다루며, Apidog 무료 플랜은 최대 4명의 사용자까지 지원합니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQ
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon이 GPT-6.2 Astra보다 나은가요?&lt;/strong&gt; 리더보드에 따라 다릅니다. Neon은 Vals Index에서 앞서고(70.87% vs 67.66%), Astra는 Artificial Analysis Intelligence Index에서 1점 앞섭니다(62 vs 61). Neon은 100만 토큰당 $3 / $15로, Astra의 $8 / $40보다 저렴합니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;세 모델 중 가장 저렴한 것은 무엇인가요?&lt;/strong&gt; 토큰 기준으로는 100만 토큰당 입력 $3, 출력 $15인 Gemini 4 Neon입니다. Artificial Analysis 과제 기준으로는 GPT-6.2 Astra가 $4.00으로 가장 저렴합니다. Neon($6.44)이나 Fable 5.2($26.54)보다 훨씬 적은 토큰을 생성하기 때문입니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;어떤 모델의 점수가 가장 높나요?&lt;/strong&gt; 2026년 11월 18~19일 기준으로 Claude Fable 5.2가 Artificial Analysis Intelligence Index(65)와 Vals Index(71.31%) 모두에서 1위입니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;무료 API 티어가 있는 모델이 있나요?&lt;/strong&gt; 없습니다. Google은 Neon에 무료 티어를 제공하지 않으며, Astra와 Fable 5.2는 유료 API 모델입니다. Google AI Pro와 Ultra 구독자는 Gemini 앱과 Antigravity에서 Neon을 사용할 수 있습니다. $0 옵션은 &lt;a href="https://apidog.com/kr/blog/gemini-4-neon-free?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Neon 무료 가이드&lt;/a&gt;를 참고하세요.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;같은 에이전트에서 여러 모델을 쓸 수 있나요?&lt;/strong&gt; 네. 일상적인 단계는 Neon으로 보내고, 실패하는 과제는 Fable 5.2나 Astra로 보내면 됩니다. 단, 먼저 각 경로를 테스트하세요. 과제당 토큰 수가 모델 간에 4배 이상 차이 납니다.&lt;/p&gt;

</description>
    </item>
    <item>
      <title>Claude Code와 Cursor(MCP)에서 Firecrawl 로컬 사용하는 방법</title>
      <dc:creator>Rihpig</dc:creator>
      <pubDate>Thu, 19 Nov 2026 08:44:28 +0000</pubDate>
      <link>https://dev.to/rihpig/claude-codewa-cursormcpeseo-firecrawl-rokeol-sayonghaneun-bangbeob-2ilg</link>
      <guid>https://dev.to/rihpig/claude-codewa-cursormcpeseo-firecrawl-rokeol-sayonghaneun-bangbeob-2ilg</guid>
      <description>&lt;p&gt;Firecrawl Local을 사용하려면 &lt;code&gt;cargo install firecrawl-local&lt;/code&gt;로 설치한 뒤, &lt;code&gt;firecrawl-local init&lt;/code&gt;를 실행해 Claude Code와 Cursor에 MCP 서버로 등록하고 두 도구를 재시작하세요. 이제 에이전트가 여러분의 컴퓨터에서 사이트를 스크래핑, 크롤링, 매핑할 수 있습니다. 코드에서 사용하려면 &lt;code&gt;firecrawl-local serve&lt;/code&gt;를 실행하고 아무 Firecrawl SDK나 &lt;code&gt;http://localhost:3002&lt;/code&gt;로 연결하면 됩니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;지금 Apidog를 사용해 보세요&lt;/a&gt;
&lt;/p&gt;

&lt;p&gt;이 가이드는 Firecrawl Local을 단계별로 사용하는 방법을 보여줍니다. 2026년 11월 19일(arm64 Mac에서 Firecrawl Local 0.1.0) 실제 테스트 실행에서 나온 출력과 함께, 에이전트에 전달할 프롬프트, 그리고 에이전트가 Apidog CLI로 로컬 API를 테스트하는 방법을 다룹니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  시작하기 전에 필요한 것
&lt;/h2&gt;

&lt;p&gt;Firecrawl Local은 &lt;a href="https://github.com/firecrawl/firecrawl/tree/main/apps/local?ref=apidog.com" rel="noopener noreferrer"&gt;Firecrawl 저장소&lt;/a&gt;에서 제공하는 단일 Rust 바이너리입니다. 설치하기 전에 다음을 확인하세요.&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Rust와 C 컴파일러.&lt;/strong&gt; Rust는 &lt;a href="https://rustup.rs/?ref=apidog.com" rel="noopener noreferrer"&gt;rustup.rs&lt;/a&gt;에서 받으세요. macOS에서는 &lt;code&gt;xcode-select --install&lt;/code&gt;을 실행하고, Debian이나 Ubuntu에서는 &lt;code&gt;build-essential&lt;/code&gt;을 설치합니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Node.js 22 이상&lt;/strong&gt;(MCP 서버를 사용하려는 경우). &lt;code&gt;npx&lt;/code&gt;로 &lt;code&gt;firecrawl-mcp&lt;/code&gt; npm 패키지를 실행합니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Chrome 또는 Chromium(선택 사항).&lt;/strong&gt; Firecrawl Local은 JavaScript가 필요한 페이지에 대해 여러분이 이미 설치한 브라우저를 사용합니다. 정적 페이지는 브라우저 없이도 작동합니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Claude Code, Cursor 또는 기타 MCP 클라이언트.&lt;/strong&gt; &lt;code&gt;init&lt;/code&gt;는 Claude Desktop, Windsurf, Gemini CLI, Codex도 인식합니다.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Firecrawl 자체가 처음이라면, &lt;a href="https://apidog.com/kr/blog/firecrawl-web-scraping?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Firecrawl 웹 스크래핑 가이드&lt;/a&gt;를 먼저 읽고 돌아오세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  1단계: Firecrawl Local 설치
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://crates.io/crates/firecrawl-local?ref=apidog.com" rel="noopener noreferrer"&gt;crates.io&lt;/a&gt;에서 크레이트를 설치하고 버전을 확인하세요.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;cargo install firecrawl-local
firecrawl-local --version
&lt;span class="c"&gt;# firecrawl-local 0.1.0&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Cargo가 소스에서 컴파일합니다. 테스트한 Mac에서는 릴리스 빌드가 6분 54초 만에 끝났고 바이너리는 &lt;code&gt;~/.cargo/bin/firecrawl-local&lt;/code&gt;에 생성되었습니다. 해당 폴더가 &lt;code&gt;PATH&lt;/code&gt;에 있는지 확인하거나, 전체 경로를 기억해 두세요. 수동 MCP 설정에 필요합니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  2단계: 터미널에서 첫 스크래핑 실행
&lt;/h2&gt;

&lt;p&gt;무엇이든 에이전트에 연결하기 전에 먼저 가져오기가 작동하는지 확인하세요.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nv"&gt;FIRECRAWL_CLOUD&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;off firecrawl-local scrape https://example.com --markdown
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;1.2초 만에 페이지의 본문 텍스트를 마크다운으로 출력했습니다. &lt;code&gt;--markdown&lt;/code&gt;을 빼면 Firecrawl API가 반환하는 것과 동일한 JSON을 얻습니다. &lt;code&gt;--format markdown,links&lt;/code&gt;로 형식을 선택할 수 있으며, 로컬에서 지원하는 형식은 &lt;code&gt;markdown&lt;/code&gt;, &lt;code&gt;html&lt;/code&gt;, &lt;code&gt;rawHtml&lt;/code&gt;, &lt;code&gt;links&lt;/code&gt;입니다.&lt;/p&gt;

&lt;p&gt;다음은 페이지마다 마크다운 파일 하나를 생성하는 크롤링입니다.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nv"&gt;FIRECRAWL_CLOUD&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;off firecrawl-local crawl https://docs.firecrawl.dev --limit 20 --out ./pages
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;이 명령은 Firecrawl 문서 20개 페이지를 4.4초 만에 가져왔고, &lt;code&gt;0005-docs.firecrawl.dev_advanced-scraping-guide.md&lt;/code&gt; 같은 이름의 파일로 저장했습니다. &lt;code&gt;firecrawl-local crawl --help&lt;/code&gt;에서 확인한 유용한 크롤링 플래그는 다음과 같습니다.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;플래그&lt;/th&gt;
&lt;th&gt;설명&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;-l, --limit&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;최대 페이지 수(기본값 100)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;--max-depth&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;링크를 몇 단계까지 따라갈지&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;--include&lt;/code&gt;, &lt;code&gt;--exclude&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;유지하거나 건너뛸 경로 정규식, 반복 지정 가능&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;--entire-domain&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;시작 경로 외부의 링크도 따라가기&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;-c, --concurrency&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;동시에 가져올 페이지 수&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;--ignore-robots&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;robots.txt 무시(기본적으로는 읽음)&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;&lt;code&gt;firecrawl-local map https://firecrawl.dev&lt;/code&gt;는 사이트맵과 시작 페이지에서 발견한 모든 URL을 하나의 JSON 줄로 반환합니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  3단계: init으로 Claude Code와 Cursor에 Firecrawl Local 추가
&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;init&lt;/code&gt;은 컴퓨터에 있는 AI 도구를 찾아 각 도구의 MCP 설정에 Firecrawl Local을 추가합니다. 먼저 미리 보기로 확인하세요.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;firecrawl-local init --dry-run
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;테스트한 Mac에서는 변경될 모든 도구가 나열되었습니다.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Firecrawl MCP server:
  Claude Code: would be added in ~/.claude.json
  Claude desktop: would be added in ~/Library/Application Support/Claude/claude_desktop_config.json
  Cursor: would be added in ~/.cursor/mcp.json
  Gemini CLI: would be added in ~/.gemini/settings.json
  Codex: would be added in ~/.codex/config.toml
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;드라이 런은 Firecrawl 클라우드로 전송되는 항목도 출력합니다. 검색 쿼리, 여러분의 컴퓨터를 차단한 페이지의 URL, 로그인 후의 Alexandria 호출, 그리고 무작위 설치 ID와 AI 도구의 이름입니다. 로컬에서 정상적으로 로드되는 페이지는 절대 전송되지 않습니다.&lt;/p&gt;

&lt;p&gt;이 가이드에서 다루는 두 도구만 설정하려면 &lt;code&gt;--agent&lt;/code&gt;를 반복하세요.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;firecrawl-local init --agent claude-code --agent cursor
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;유효한 이름은 &lt;code&gt;claude-code&lt;/code&gt;, &lt;code&gt;claude-desktop&lt;/code&gt;, &lt;code&gt;cursor&lt;/code&gt;, &lt;code&gt;windsurf&lt;/code&gt;, &lt;code&gt;gemini&lt;/code&gt;, &lt;code&gt;codex&lt;/code&gt;입니다. &lt;code&gt;init&lt;/code&gt;은 각 설정 파일을 쓰기 전에 백업합니다. 이후 Claude Code와 Cursor를 재시작해야 새 서버가 로드됩니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Ff0fcnif3yvufzvlsqqvr.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Ff0fcnif3yvufzvlsqqvr.png" alt="Claude Code and Cursor talk to firecrawl-local mcp over stdio; it scrapes, crawls and maps on your machine and only sends search and blocked pages to Firecrawl Cloud unless FIRECRAWL_CLOUD=off" width="799" height="341"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h3&gt;
  
  
  Claude Code에 Firecrawl Local 직접 추가하기
&lt;/h3&gt;

&lt;p&gt;도구가 설정 파일을 수정하게 두고 싶지 않다면, &lt;a href="https://code.claude.com/docs/en/mcp?ref=apidog.com" rel="noopener noreferrer"&gt;Claude Code MCP 명령&lt;/a&gt;으로 stdio 서버를 직접 추가하세요.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;claude mcp add firecrawl -e &lt;span class="nv"&gt;FIRECRAWL_CLOUD&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;off -- ~/.cargo/bin/firecrawl-local mcp --public-only
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Claude Code에서 &lt;code&gt;/mcp&lt;/code&gt;를 실행해 서버가 연결되었는지 확인하세요.&lt;/p&gt;

&lt;h3&gt;
  
  
  Cursor에 Firecrawl Local 직접 추가하기
&lt;/h3&gt;

&lt;p&gt;Cursor는 &lt;code&gt;~/.cursor/mcp.json&lt;/code&gt;(전역) 또는 &lt;code&gt;.cursor/mcp.json&lt;/code&gt;(단일 프로젝트)에서 &lt;a href="https://cursor.com/docs/context/mcp?ref=apidog.com" rel="noopener noreferrer"&gt;MCP 서버&lt;/a&gt;를 읽습니다. 바이너리의 전체 경로를 사용하세요.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nl"&gt;"mcpServers"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nl"&gt;"firecrawl"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="nl"&gt;"command"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"/Users/you/.cargo/bin/firecrawl-local"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="nl"&gt;"args"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"mcp"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"--public-only"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="nl"&gt;"env"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nl"&gt;"FIRECRAWL_CLOUD"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"off"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;--public-only&lt;/code&gt;는 서버가 localhost와 사설 네트워크 주소를 거부하도록 합니다. 신뢰할 수 없는 페이지를 에이전트가 읽을 때는 이 옵션을 켜 두세요. 그렇지 않으면 페이지에 숨겨진 지시문이 에이전트를 내부 URL로 유도할 수 있습니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  4단계: 에이전트에 전달할 프롬프트
&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;firecrawl-local mcp&lt;/code&gt;는 루프백 포트에서 로컬 API를 시작하고 &lt;code&gt;firecrawl-mcp&lt;/code&gt; 패키지를 그것에 연결해 실행합니다. 에이전트는 표준 Firecrawl MCP 도구를 보게 되며, 스크래핑, 크롤링, 매핑, 배치 스크래핑이 여러분의 컴퓨터에서 실행됩니다. &lt;a href="https://apidog.com/kr/blog/firecrawl-mcp-llms-txt?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;호스팅된 Firecrawl MCP 서버&lt;/a&gt;를 사용해 봤다면 도구 이름은 동일합니다.&lt;/p&gt;

&lt;p&gt;로컬 도구에 잘 맞는 프롬프트입니다.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Map https://docs.example.com, then crawl only the /api/ pages (limit 40)
and write a summary of every endpoint into docs/vendor-api.md.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;





&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Scrape the changelog at https://example.com/changelog as markdown and list
every breaking change from the last three releases.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;





&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Batch scrape these five pricing pages and build a comparison table of
plan names and limits. Quote only what the pages say.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;검색이 필요한 프롬프트는 피하세요. &lt;code&gt;FIRECRAWL_CLOUD=off&lt;/code&gt;에서는 해당 도구가 어디에도 연결되지 않습니다. 완전히 로컬인 검색 환경을 구성하려면 &lt;a href="https://apidog.com/kr/blog/open-source-claude-web-search?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude용 오픈소스 웹 검색&lt;/a&gt; 가이드를 참고하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  5단계: Firecrawl Local API 실행하고 SDK 연결하기
&lt;/h2&gt;

&lt;p&gt;스크립트와 파이프라인용으로 API 서버를 실행하세요.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nv"&gt;FIRECRAWL_CLOUD&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;off firecrawl-local serve
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;127.0.0.1:3002&lt;/code&gt;에서 대기합니다. 상태 확인은 즉시 응답합니다.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl -s localhost:3002/health
&lt;span class="c"&gt;# {"status":"ok","engine":"firecrawl-local","version":"0.1.0"}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;스크래핑 결과는 익숙한 v2 형태로 반환되며, 두 가지 로컬 표시가 포함됩니다. &lt;code&gt;"engine": "local-fetch"&lt;/code&gt;와 &lt;code&gt;"source": "local"&lt;/code&gt;, 그리고 &lt;code&gt;creditsUsed: 0&lt;/code&gt;입니다.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl -s localhost:3002/v2/scrape -H &lt;span class="s1"&gt;'content-type: application/json'&lt;/span&gt; \
  -d &lt;span class="s1"&gt;'{"url":"https://example.com","formats":["markdown","links"]}'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;API 키 없이 &lt;a href="https://docs.firecrawl.dev/sdks/overview?ref=apidog.com" rel="noopener noreferrer"&gt;Firecrawl SDK&lt;/a&gt;를 이 서버에 연결하세요. Python:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="n"&gt;firecrawl&lt;/span&gt; &lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nc"&gt;Firecrawl&lt;/span&gt;

&lt;span class="n"&gt;app&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;Firecrawl&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;api_url&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"http://localhost:3002"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="k"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;app&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;scrape&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"https://example.com"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;markdown&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Node:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Firecrawl&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="s2"&gt;"firecrawl"&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;app&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Firecrawl&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;apiUrl&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"http://localhost:3002"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;doc&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;app&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;scrape&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"https://example.com"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="nb"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;doc&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;markdown&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;init&lt;/code&gt;는 간단한 방법도 제안합니다. &lt;code&gt;FIRECRAWL_API_URL=http://127.0.0.1:3002&lt;/code&gt;를 설정하면 기존 Firecrawl 코드가 로컬에서 실행됩니다. &lt;a href="https://apidog.com/kr/blog/how-to-install-and-use-firecrawl-cli?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Firecrawl CLI&lt;/a&gt;는 저장된 로그인 정보를 Firecrawl Local과 공유하므로, 어느 도구에서 &lt;code&gt;login&lt;/code&gt;을 해도 둘 다 사용할 수 있습니다.&lt;/p&gt;

&lt;p&gt;크롤링은 비동기로 진행됩니다. &lt;code&gt;POST /v2/crawl&lt;/code&gt;은 즉시 작업 ID를 반환했고, 몇 초 후 &lt;code&gt;GET /v2/crawl/{id}&lt;/code&gt;는 &lt;code&gt;status: completed&lt;/code&gt;, &lt;code&gt;total: 10&lt;/code&gt;, &lt;code&gt;creditsUsed: 0&lt;/code&gt;, &lt;code&gt;expiresInSeconds: 3587&lt;/code&gt;을 보고했습니다. 작업은 메모리에 존재하며 시작 후 한 시간 뒤 만료되고 &lt;code&gt;serve&lt;/code&gt;가 중지되면 사라지므로, 크롤링이 완료되면 즉시 결과를 저장하세요.&lt;/p&gt;

&lt;p&gt;&lt;code&gt;ps&lt;/code&gt;로 측정한 결과 서버 프로세스는 유휴 상태에서 약 10 MB, 10페이지 크롤링 직후 약 43 MB의 상주 메모리를 사용했습니다. Firecrawl의 &lt;a href="https://x.com/firecrawl/status/2123096169630912637?ref=apidog.com" rel="noopener noreferrer"&gt;출시 게시물&lt;/a&gt;은 자체 호스팅 Firecrawl보다 37배 빠르고 메모리는 230배 적다고 주장합니다. README에는 방법론이 공개되어 있지 않으므로 Firecrawl 측 수치로 받아들이세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  FIRECRAWL_CLOUD로 Firecrawl Local을 완전히 로컬로 유지하기
&lt;/h2&gt;

&lt;p&gt;기본값(&lt;code&gt;auto&lt;/code&gt;)에서는 세 가지가 Firecrawl 클라우드로 전송됩니다. 검색, 여러분의 컴퓨터를 차단한 페이지, 그리고 Alexandria 데이터 제공자(&lt;code&gt;firecrawl-local login&lt;/code&gt;으로 무료 계정 필요)입니다. &lt;code&gt;FIRECRAWL_CLOUD&lt;/code&gt;는 이 전환을 제어합니다.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;값&lt;/th&gt;
&lt;th&gt;효과&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;auto&lt;/code&gt;(기본값)&lt;/td&gt;
&lt;td&gt;검색, 차단 페이지 폴백, Alexandria 모두 작동&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;search&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;검색만 Firecrawl 클라우드로 전송&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;off&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Firecrawl 클라우드로 아무것도 전송하지 않음&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;인식되지 않는 값은 &lt;code&gt;off&lt;/code&gt;로 처리됩니다. 클라우드가 꺼져 있으면 &lt;code&gt;POST /v2/search&lt;/code&gt;는 &lt;code&gt;"code":"CLOUD_ONLY"&lt;/code&gt;와 함께 &lt;code&gt;FIRECRAWL_API_KEY&lt;/code&gt; 또는 &lt;code&gt;FIRECRAWL_CLOUD=auto&lt;/code&gt;를 설정하라는 메시지를 반환합니다. 클라우드가 대신 가져온 페이지에는 &lt;code&gt;"source": "firecrawl-cloud"&lt;/code&gt;가 붙으므로, 결과의 출처를 항상 알 수 있습니다.&lt;/p&gt;

&lt;p&gt;&lt;code&gt;serve&lt;/code&gt;는 &lt;code&gt;--allow-private&lt;/code&gt;를 전달하지 않는 한 localhost와 사설 대상 주소를 거부하며, 루프백이 아닌 &lt;code&gt;--host&lt;/code&gt;에 바인딩하려면 &lt;code&gt;--token&lt;/code&gt;이 필요합니다. 클라우드 메타데이터와 링크 로컬 주소는 모든 모드에서 차단됩니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Apidog CLI로 코딩 에이전트가 Firecrawl Local API를 테스트하게 하기
&lt;/h2&gt;

&lt;p&gt;크롤링 엔드포인트는 파이프라인을 망가뜨리기 가장 쉬운 부분입니다. 비동기이고, 작업이 만료되며, 서버가 중지되면 사라지기 때문입니다. 직접 반복 조회하는 대신 코딩 에이전트가 &lt;a href="https://apidog.com/apidog-cli/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog CLI&lt;/a&gt;로 테스트를 작성하고 실행하도록 하세요.&lt;/p&gt;

&lt;p&gt;한 번만 설정하면 됩니다.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm install -g apidog-cli@latest
apidog auth login --with-token &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;YOUR_TOKEN&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
apidog skill install
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;그런 다음 Claude Code나 Cursor에 프롬프트 하나를 전달하세요.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;firecrawl-local serve is running on http://localhost:3002. In Apidog project &amp;lt;id&amp;gt;,
import an OpenAPI file for POST /v2/scrape, POST /v2/crawl and GET /v2/crawl/{id},
create an environment for that base URL, and build a test scenario that starts a
crawl of https://docs.firecrawl.dev with limit 10, saves the returned id, polls
GET /v2/crawl/{id} until status is "completed", and asserts total equals completed
and every page has non-empty markdown. Run it and summarize any failures.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fes6y7n6bawbte4h6ca9k.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fes6y7n6bawbte4h6ca9k.png" alt="Sequence of the agent-built test: Apidog CLI posts /v2/crawl to firecrawl-local serve, polls GET /v2/crawl/{id} until completed, checks the assertions and writes a cli, json or junit report" width="800" height="875"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;에이전트는 각 페이로드 스키마를 읽고 검증한 뒤 다음과 같은 명령을 실행합니다. 모두 CLI 2.2.12의 &lt;code&gt;apidog &amp;lt;cmd&amp;gt; --help&lt;/code&gt;에서 가져온 것입니다.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;apidog import --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --format openapi --file ./firecrawl-local-v2.yaml
apidog environment create firecrawl-local --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --base-url http://localhost:3002
apidog cli-schema get test-scenario-create
apidog cli-schema validate test-scenario-create --file scenario.json
apidog test-scenario create --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --file ./scenario.json
apidog run -t &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;scenarioId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -e &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;envId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -r cli,json
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Apidog CLI는 여러분의 컴퓨터에서 요청을 보내므로 &lt;code&gt;localhost:3002&lt;/code&gt;에 접근할 수 있습니다. &lt;code&gt;-r junit&lt;/code&gt;으로 전환하면 같은 실행을 CI에 넣을 수 있습니다. 에이전트 측면은 &lt;a href="https://apidog.com/kr/blog/apidog-cli-in-claude-code?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Code에서의 Apidog CLI&lt;/a&gt;와 &lt;a href="https://apidog.com/kr/blog/apidog-cli-in-cursor?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Cursor에서의 Apidog CLI&lt;/a&gt; 가이드에서 다룹니다. Apidog의 Free 플랜은 최대 4명 팀까지 지원합니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Firecrawl Local 문제 해결
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;증상&lt;/th&gt;
&lt;th&gt;해결&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;/v1/scrape&lt;/code&gt;에서 &lt;code&gt;NOT_FOUND&lt;/code&gt;와 함께 &lt;code&gt;404&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;v2만 제공됩니다. 클라이언트를 &lt;code&gt;/v2/...&lt;/code&gt;로 변경하세요&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;/v2/search&lt;/code&gt;에서 &lt;code&gt;CLOUD_ONLY&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;FIRECRAWL_CLOUD=off&lt;/code&gt;에서는 예상된 동작입니다. &lt;code&gt;auto&lt;/code&gt; 또는 &lt;code&gt;search&lt;/code&gt;를 사용하세요&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;에이전트에 Firecrawl 도구가 나타나지 않음&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;init&lt;/code&gt; 후 도구를 재시작하세요. Node.js 22 이상을 확인하세요&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;JavaScript 페이지가 빈약하게 반환됨&lt;/td&gt;
&lt;td&gt;Chrome을 설치하거나 &lt;code&gt;--browser always&lt;/code&gt;를 설정하세요&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;json&lt;/code&gt; 또는 &lt;code&gt;summary&lt;/code&gt; 형식이 없음&lt;/td&gt;
&lt;td&gt;로컬에서는 지원되지 않으며 경고가 표시됩니다&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;크롤 ID를 찾을 수 없음&lt;/td&gt;
&lt;td&gt;작업이 한 시간 후 만료되었거나 &lt;code&gt;serve&lt;/code&gt;가 재시작됨&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  자주 묻는 질문
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Firecrawl Local은 무료인가요?&lt;/strong&gt; 로컬 스크래핑, 크롤링, 매핑은 Firecrawl에 아무것도 전송하지 않으며 테스트에서 크레딧을 0으로 사용했습니다. 코드는 AGPL-3.0, SDK는 MIT 라이선스입니다. 검색과 Alexandria는 Firecrawl 클라우드를 거칩니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Firecrawl Local을 사용하려면 API 키가 필요한가요?&lt;/strong&gt; 로컬 경로에는 필요 없습니다. Alexandria 데이터 제공자에만 &lt;code&gt;firecrawl-local login&lt;/code&gt; 또는 &lt;code&gt;FIRECRAWL_API_KEY&lt;/code&gt;를 통한 키가 필요합니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Firecrawl Local은 Windsurf, Codex, Gemini CLI와 작동하나요?&lt;/strong&gt; 네. &lt;code&gt;init&lt;/code&gt;는 Claude Code, Claude Desktop, Cursor뿐 아니라 &lt;code&gt;windsurf&lt;/code&gt;, &lt;code&gt;codex&lt;/code&gt;, &lt;code&gt;gemini&lt;/code&gt;도 인식합니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;기존 Firecrawl 코드를 변경 없이 실행할 수 있나요?&lt;/strong&gt; v2 스크래핑, 매핑, 크롤링, 배치 스크래핑에는 가능합니다. API URL을 &lt;code&gt;http://localhost:3002&lt;/code&gt;로 변경하세요. v0와 v1 경로는 제공되지 않으며 브라우저 &lt;code&gt;actions&lt;/code&gt;는 무시됩니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Firecrawl Local은 robots.txt를 준수하나요?&lt;/strong&gt; 네. 크롤링 시 &lt;code&gt;robots.txt&lt;/code&gt;를 읽고 User-Agent에 자신을 명시하므로, 사이트 소유자는 &lt;code&gt;FirecrawlLocal&lt;/code&gt;로 이를 다룰 수 있습니다. &lt;code&gt;--ignore-robots&lt;/code&gt;는 이 기능을 끄며, 소유한 사이트에서만 사용하세요.&lt;/p&gt;

</description>
    </item>
    <item>
      <title>Firecrawl 셀프 호스팅 vs 로컬: 무엇이 달라졌나</title>
      <dc:creator>Rihpig</dc:creator>
      <pubDate>Thu, 19 Nov 2026 08:35:37 +0000</pubDate>
      <link>https://dev.to/rihpig/firecrawl-selpeu-hoseuting-vs-rokeol-mueosi-dalrajyeossna-57la</link>
      <guid>https://dev.to/rihpig/firecrawl-selpeu-hoseuting-vs-rokeol-mueosi-dalrajyeossna-57la</guid>
      <description>&lt;p&gt;Firecrawl 셀프 호스팅은 오랫동안 한 가지를 의미했습니다. 저장소를 클론하고 Docker Compose를 실행한 뒤, API, Playwright 서비스, Redis, RabbitMQ, Postgres를 장비 위에서 계속 살려두는 것이었죠. 2026년 11월 18일, Firecrawl은 두 번째 선택지를 내놓았습니다. Firecrawl Local은 사이트를 마크다운으로 스크레이핑, 크롤링, 매핑하고 &lt;code&gt;localhost:3002&lt;/code&gt;에서 동일한 v2 API에 응답하는 단일 Rust 바이너리로, 데이터베이스도, 큐도, 컨테이너도 필요 없습니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;Apidog를 지금 시작해 보세요&lt;/a&gt;
&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;간단한 답:&lt;/strong&gt; 노트북이나 에이전트의 툴벨트에서 인프라 없이 스크레이프, 크롤, 맵, 배치 스크레이프를 원한다면 Firecrawl Local을 선택하세요. 영구적인 작업(persistent jobs), &lt;code&gt;json&lt;/code&gt; 및 &lt;code&gt;summary&lt;/code&gt; 포맷, 자체 모델을 통한 LLM 추출, 또는 Firecrawl Cloud를 전혀 거치지 않는 검색 라우트가 필요하다면 셀프 호스팅 Docker 스택을 유지하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  Firecrawl 셀프 호스팅이란 무엇이고, Firecrawl Local은 무엇인가요?
&lt;/h2&gt;

&lt;p&gt;셀프 호스팅 Firecrawl은 &lt;code&gt;apps/api&lt;/code&gt;에 있는 전체 Firecrawl 서버를 Docker Compose로 자체 인프라에서 실행하는 것입니다. Firecrawl Local은 &lt;code&gt;apps/local&lt;/code&gt;에 있는 별도의 더 가벼운 빌드로, 동일한 HTML 정리 코드를 사용해 여러분의 머신에서 페이지를 가져와 정리하고, 검색, 차단된 페이지, Alexandria는 Firecrawl Cloud에 넘깁니다.&lt;/p&gt;

&lt;p&gt;둘 다 &lt;a href="https://github.com/firecrawl/firecrawl" rel="noopener noreferrer"&gt;Firecrawl GitHub 저장소&lt;/a&gt;에 있고, 둘 다 포트 3002에서 v2 API를 제공하며, 둘 다 AGPL-3.0으로 오픈 소스입니다. Firecrawl Local은 서버를 대체하지 않습니다. &lt;a href="https://github.com/firecrawl/firecrawl/tree/main/apps/local" rel="noopener noreferrer"&gt;Firecrawl Local README&lt;/a&gt;가 이를 직접 명시합니다. 셀프 호스팅 가이드는 "'&lt;code&gt;apps/api&lt;/code&gt;에 있으며 Firecrawl Local에 의해 변경되지 않는다'"고 말이죠.&lt;/p&gt;

&lt;p&gt;Firecrawl이 처음이신가요? &lt;a href="https://apidog.com/kr/blog/firecrawl-web-scraping?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Firecrawl 웹 스크레이핑 가이드&lt;/a&gt;부터 시작하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  Firecrawl Local vs 셀프 호스팅 Firecrawl 한눈에 보기
&lt;/h2&gt;

&lt;p&gt;다음은 2026년 11월 19일에 확인한 &lt;a href="https://docs.firecrawl.dev/contributing/self-host" rel="noopener noreferrer"&gt;셀프 호스팅 가이드&lt;/a&gt;, &lt;a href="https://docs.firecrawl.dev/contributing/open-source-or-cloud" rel="noopener noreferrer"&gt;오픈 소스 vs 클라우드 페이지&lt;/a&gt;, 그리고 Local README를 바탕으로 정리한 요약입니다.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;항목&lt;/th&gt;
&lt;th&gt;셀프 호스팅 Firecrawl&lt;/th&gt;
&lt;th&gt;Firecrawl Local&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;실행 대상&lt;/td&gt;
&lt;td&gt;Docker Compose 스택: api, playwright-service, redis, rabbitmq, nuq-postgres&lt;/td&gt;
&lt;td&gt;단일 바이너리, &lt;code&gt;firecrawl-local&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;설치&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;git clone&lt;/code&gt;, &lt;code&gt;.env&lt;/code&gt; 작성, &lt;code&gt;docker compose up --build -d&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;&lt;code&gt;cargo install firecrawl-local&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;사전 요구사항&lt;/td&gt;
&lt;td&gt;Git, Docker Engine, Compose v2&lt;/td&gt;
&lt;td&gt;Rust 및 C 컴파일러; Chrome과 Node 22+ 선택 사항&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;API&lt;/td&gt;
&lt;td&gt;포트 3002의 v2&lt;/td&gt;
&lt;td&gt;포트 3002의 v2 (scrape, map, crawl, batch scrape, health)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;검색 라우트&lt;/td&gt;
&lt;td&gt;기본 스택에 포함&lt;/td&gt;
&lt;td&gt;Firecrawl Cloud로 전달&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;LLM 포맷 (&lt;code&gt;json&lt;/code&gt;, &lt;code&gt;summary&lt;/code&gt;)&lt;/td&gt;
&lt;td&gt;OpenAI 호환 프로바이더 또는 Ollama 연결&lt;/td&gt;
&lt;td&gt;경고와 함께 건너뜀&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;스크린샷&lt;/td&gt;
&lt;td&gt;Fire-engine 필요, 기본 스택에 없음&lt;/td&gt;
&lt;td&gt;Chrome이 설치되어 있으면 동작&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;브라우저 &lt;code&gt;actions&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;Fire-engine 필요&lt;/td&gt;
&lt;td&gt;무시됨&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;작업 저장소&lt;/td&gt;
&lt;td&gt;Postgres 기반 큐&lt;/td&gt;
&lt;td&gt;메모리 내, 1시간 후 만료&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Alexandria&lt;/td&gt;
&lt;td&gt;셀프 호스트 기능 표에 없음&lt;/td&gt;
&lt;td&gt;무료 계정으로 Firecrawl Cloud 경유&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;MCP 설정&lt;/td&gt;
&lt;td&gt;MCP 서버를 여러분의 URL로 지정&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;firecrawl-local init&lt;/code&gt;이 구성 파일 작성&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;라이선스&lt;/td&gt;
&lt;td&gt;AGPL-3.0&lt;/td&gt;
&lt;td&gt;AGPL-3.0&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Local은 깊이를 무게와 맞바꿉니다. 에이전트가 가장 많이 호출하는 라우트는 유지하고, 큐나 모델, 브라우저 팜이 필요한 것은 버립니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  무엇이 바뀌었나: 다섯 개 서비스에서 하나의 바이너리로
&lt;/h2&gt;

&lt;p&gt;셀프 호스팅 경로는 가이드에서 릴리스 &lt;code&gt;v2.11.162&lt;/code&gt;를 고정합니다. 저장소를 클론하고, Postgres 자격 증명과 &lt;code&gt;USE_DB_AUTHENTICATION=false&lt;/code&gt;가 담긴 작은 &lt;code&gt;.env&lt;/code&gt;를 작성한 뒤, 스택을 빌드하고 시작합니다:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;git clone https://github.com/firecrawl/firecrawl.git
&lt;span class="nb"&gt;cd&lt;/span&gt; firecrawl
git checkout v2.11.162
docker compose up --build -d
docker compose ps --all
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;이 compose 파일은 &lt;code&gt;api&lt;/code&gt; 컨테이너(워커도 함께 실행), 렌더링용 &lt;code&gt;playwright-service&lt;/code&gt;, 작업 큐를 위한 &lt;code&gt;redis&lt;/code&gt;, &lt;code&gt;rabbitmq&lt;/code&gt;, &lt;code&gt;nuq-postgres&lt;/code&gt;를 시작합니다. compose 파일은 API를 최대 4 CPU와 8 GB 메모리로, Playwright 서비스를 최대 2 CPU와 4 GB로 제한하며, 가이드는 이 제한이 "검증된 최소 요구사항이 아니다"라고 언급합니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F8asds963e0wvpm9mthxf.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F8asds963e0wvpm9mthxf.png" alt="나란히 본 아키텍처: 셀프 호스팅 Firecrawl은 docker compose up 아래에서 api(워커 포함), playwright-service, redis, rabbitmq, nuq-postgres를 실행하는 반면, Firecrawl Local은 선택적 Chrome을 갖춘 하나의 Rust 바이너리로, 검색·차단된 페이지·Alexandria를 위해 Firecrawl Cloud로 점선 핸드오프를 수행하며, 두 방식 모두 localhost:3002에서 v2 API를 노출한다" width="800" height="533"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Firecrawl Local은 이를 하나의 명령으로 압축합니다:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;cargo install firecrawl-local
firecrawl-local scrape https://example.com --markdown
firecrawl-local crawl https://docs.firecrawl.dev --limit 50 --out ./pages
firecrawl-local map https://firecrawl.dev
firecrawl-local serve
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;.env&lt;/code&gt;도, 컨테이너도 없습니다. JavaScript 페이지는 이미 설치된 Chrome이나 Chromium에서 렌더링되며, 크롬이 없어도 정적 페이지는 여전히 작동하고 나머지는 경고를 반환합니다.&lt;/p&gt;

&lt;p&gt;&lt;code&gt;search&lt;/code&gt;, &lt;code&gt;find-tools&lt;/code&gt;, &lt;code&gt;data&lt;/code&gt;, &lt;code&gt;login&lt;/code&gt; 명령은 Firecrawl Cloud에 도달합니다. &lt;code&gt;firecrawl-local login&lt;/code&gt;은 &lt;a href="https://apidog.com/kr/blog/how-to-install-and-use-firecrawl-cli?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Firecrawl CLI 설치 가이드&lt;/a&gt;에 나온 호스팅 CLI의 자격 증명을 재사용합니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  엔드포인트 범위: 각각 무엇을 제공하는가
&lt;/h2&gt;

&lt;p&gt;마이그레이션에서 가장 자주 깨지는 부분이 여기이므로, SDK의 base URL을 바꾸기 전에 반드시 확인하세요.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Firecrawl Local은 여러분의 머신에서 다음 라우트를 제공합니다:&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;POST /v2/scrape&lt;/code&gt; — 하나의 URL 스크레이프&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;POST /v2/map&lt;/code&gt; — 사이트의 URL 목록 조회&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;POST /v2/crawl&lt;/code&gt;, 그리고 &lt;code&gt;GET&lt;/code&gt; 및 &lt;code&gt;DELETE /v2/crawl/{id}&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;POST /v2/batch/scrape&lt;/code&gt;, 그리고 &lt;code&gt;GET&lt;/code&gt; 및 &lt;code&gt;DELETE /v2/batch/scrape/{id}&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;&lt;code&gt;GET /health&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;다른 모든 &lt;code&gt;/v2&lt;/code&gt; 라우트(&lt;code&gt;/v2/search&lt;/code&gt; 등)는 &lt;code&gt;FIRECRAWL_CLOUD&lt;/code&gt;가 다르게 지정하지 않는 한 Firecrawl Cloud로 전달됩니다. v0 및 v1 라우트는 아예 제공되지 않습니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;셀프 호스팅 Firecrawl&lt;/strong&gt;은 오픈 소스 vs 클라우드 페이지 기준으로 기본 스택에서 핵심 scrape, crawl, map, search를 다룹니다. LLM 기반 추출은 직접 연결한 프로바이더가 필요합니다. Agent, Browser, Interact, 대시보드는 포함되지 않습니다.&lt;/p&gt;

&lt;p&gt;실전에서 짚어야 할 두 가지 함정:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;헬스 체크가 다릅니다.&lt;/strong&gt; 셀프 호스팅 가이드는 &lt;code&gt;/v0/health/readiness&lt;/code&gt;에서 준비 상태를 확인합니다. Firecrawl Local은 v0를 제공하지 않으므로 &lt;code&gt;GET /health&lt;/code&gt;를 사용해야 합니다. 모니터와 compose 헬스체크를 업데이트하세요.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;검색이 실행되는 위치가 바뀝니다.&lt;/strong&gt; Docker 스택에서는 검색이 여러분의 인프라에 그대로 있습니다. Local에서는 Firecrawl Cloud로 가며, 키 없는 검색은 속도 제한이 걸립니다. 어떤 데이터도 머신 밖으로 나가면 안 된다면 &lt;code&gt;FIRECRAWL_CLOUD=off&lt;/code&gt;로 설정하세요. 다만 이 경우 검색은 동작하지 않습니다.&lt;/li&gt;
&lt;/ol&gt;

&lt;h2&gt;
  
  
  속도와 메모리: 주장을 신중하게 읽기
&lt;/h2&gt;

&lt;p&gt;Firecrawl의 &lt;a href="https://x.com/firecrawl/status/2123096169630912637" rel="noopener noreferrer"&gt;X 런치 포스트&lt;/a&gt;는 Firecrawl Local이 "셀프 호스팅 대비 37배 빠른 Rust 기반 scrape 프리미티브"이며 "메모리 사용량이 230배 적다(유휴 시 11 MB)"고 밝힙니다. 해당 게시물은 첫날 약 32.4만 조회수와 3.2천 좋아요를 기록했습니다.&lt;/p&gt;

&lt;p&gt;이 수치는 Firecrawl의 주장으로 받아들이세요. README에는 벤치마크 방법도, 페이지 세트도, 하드웨어도 공개되어 있지 않으므로 "37배"가 무엇을 측정한 것인지 알 수 없습니다. 다만 아키텍처 관점에서 방향성은 뒷받침됩니다. 유휴 상태의 프로세스 하나가, compose 제한만으로 API와 Playwright 서비스에만 최대 12 GB를 허용하는 다섯 개 컨테이너보다 훨씬 가벼워야 한다는 것은 합리적입니다.&lt;/p&gt;

&lt;p&gt;속도가 선택의 기준이라면, 실제 URL로 직접 측정하세요. 동일한 스크레이프를 두 서버에 대해 실행하고 타이밍을 비교한 뒤 마크다운이 일치하는지 확인하세요. 아래 Apidog CLI 관련 섹션에서 이를 반복 가능한 테스트로 만드는 방법을 보여드립니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  보안, 클라우드 핸드오프, 데이터 흐름
&lt;/h2&gt;

&lt;p&gt;셀프 호스팅은 완전한 제어와 완전한 책임을 부여합니다. 가이드의 퀵스타트는 인증을 비활성화하며 이것이 "프로덕션 아키텍처가 아니다"라고 경고하므로, 영구 볼륨, 인증, TLS, 모니터링은 여러분이 직접 추가해야 합니다.&lt;/p&gt;

&lt;p&gt;Firecrawl Local은 단일 머신을 위한 더 엄격한 기본값과 함께 제공됩니다:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;serve&lt;/code&gt;는 &lt;code&gt;127.0.0.1&lt;/code&gt;에 바인딩되며, &lt;code&gt;--allow-private&lt;/code&gt;를 전달하지 않는 한 localhost 및 프라이빗 주소는 거부됩니다.&lt;/li&gt;
&lt;li&gt;링크-로컬 및 클라우드 메타데이터 주소는 모든 모드에서(리다이렉트 이후에도 포함) 차단됩니다.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;scrape&lt;/code&gt;, &lt;code&gt;crawl&lt;/code&gt;, &lt;code&gt;mcp&lt;/code&gt;는 &lt;code&gt;--public-only&lt;/code&gt;를 지원하며, README는 신뢰할 수 없는 사이트를 에이전트가 탐색할 때 이를 권장합니다.&lt;/li&gt;
&lt;li&gt;크롤은 &lt;code&gt;robots.txt&lt;/code&gt;를 준수합니다.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;대가는 클라우드 핸드오프입니다. 기본값 &lt;code&gt;FIRECRAWL_CLOUD=auto&lt;/code&gt;로 설정하면 검색, 여러분의 머신을 차단하는 페이지, Alexandria가 Firecrawl Cloud로 갑니다. 해당 결과에는 &lt;code&gt;"source": "firecrawl-cloud"&lt;/code&gt;가 붙습니다. 검색만 허용하려면 &lt;code&gt;FIRECRAWL_CLOUD=search&lt;/code&gt;로, 아무것도 전송하지 않으려면 &lt;code&gt;off&lt;/code&gt;로 설정하세요.&lt;/p&gt;

&lt;p&gt;Firecrawl의 데이터 제공자 카탈로그인 Alexandria는 무료 계정과 &lt;code&gt;firecrawl-local login&lt;/code&gt;이 필요합니다. &lt;a href="https://apidog.com/kr/blog/what-is-firecrawl-alexandria?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Firecrawl Alexandria 해설&lt;/a&gt;에서 무엇을 반환하는지 다룹니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  어떤 걸 선택해야 할까?
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;다음의 경우 Firecrawl Local을 선택하세요:&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;AI 에이전트가 노트북에서 스크레이프 및 크롤을 수행하길 원한다. &lt;code&gt;firecrawl-local init&lt;/code&gt;은 각 구성 파일을 먼저 백업하면서 Claude Code, Claude Desktop, Cursor, Windsurf, Gemini CLI, Codex에 MCP 서버를 추가합니다.&lt;/li&gt;
&lt;li&gt;한 시간 이내에 끝나는 짧은 작업을 실행한다.&lt;/li&gt;
&lt;li&gt;마크다운, HTML, 원시 HTML, 링크만 필요하다.&lt;/li&gt;
&lt;li&gt;Postgres, Redis, RabbitMQ를 직접 관리하고 싶지 않다.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;다음의 경우 셀프 호스팅 Firecrawl을 유지하세요:&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;크롤 작업이 재시작 후에도 살아남아야 하거나 한 시간 이상 실행되어야 한다.&lt;/li&gt;
&lt;li&gt;자체 모델을 통한 &lt;code&gt;json&lt;/code&gt; 또는 &lt;code&gt;summary&lt;/code&gt; 출력이 필요하다.&lt;/li&gt;
&lt;li&gt;검색이 여러분의 인프라에 머물러야 한다.&lt;/li&gt;
&lt;li&gt;여러 서비스나 사용자가 하나의 스크레이핑 백엔드를 인증 뒤에서 공유한다.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;많은 팀이 둘 다 운영합니다. 노트북과 에이전트에는 Local, 프로덕션에는 Docker 스택이나 Firecrawl Cloud를 쓰는 식이죠. 검색만 필요한 에이전트 구성이라면 &lt;a href="https://apidog.com/kr/blog/open-source-claude-web-search?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude용 오픈 소스 웹 검색&lt;/a&gt; 정리글에서 다른 옵션을 확인할 수 있고, &lt;a href="https://apidog.com/kr/blog/firecrawl-mcp-llms-txt?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Firecrawl MCP 및 llms.txt 가이드&lt;/a&gt;에서는 호스팅 MCP 서버를 다룹니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  SDK 코드를 셀프 호스팅에서 Local로 마이그레이션하기
&lt;/h2&gt;

&lt;p&gt;SDK 코드는 바뀌지 않습니다. URL만 바꾸면 됩니다. Python 또는 Node SDK의 API URL을 &lt;code&gt;http://localhost:3002&lt;/code&gt;로 설정하고, 로컬 라우트에는 API 키를 넣지 마세요. 전환하기 전에 여러분의 코드에 v0나 v1 호출이 없는지, &lt;code&gt;json&lt;/code&gt;, &lt;code&gt;summary&lt;/code&gt;, &lt;code&gt;actions&lt;/code&gt;를 요청하지 않는지, 한 시간이 넘은 크롤 ID를 폴링하거나 &lt;code&gt;serve&lt;/code&gt; 재시작을 넘나들며 폴링하지 않는지 확인하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  코딩 에이전트가 Apidog CLI로 패리티 테스트를 실행하게 하기
&lt;/h2&gt;

&lt;p&gt;백엔드를 전환하는 것은 계약(contract) 문제입니다. Local의 &lt;code&gt;/v2/scrape&lt;/code&gt;가 여러분의 코드가 이미 파싱하는 것과 동일한 형태를 반환하는지 말이죠. 응답을 손으로 diff하지 마세요. 두 서버를 나란히 실행하고(Docker는 3002, &lt;code&gt;firecrawl-local serve --port 3012&lt;/code&gt;) 코딩 에이전트가 &lt;a href="https://apidog.com/apidog-cli/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog CLI&lt;/a&gt;로 둘 다 테스트하도록 하세요.&lt;/p&gt;

&lt;p&gt;한 번만 설정하면 됩니다:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm install -g apidog-cli@latest
apidog auth login --with-token &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;YOUR_TOKEN&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
apidog skill install
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;그런 다음 에이전트에 프롬프트 하나를 주세요:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Self-hosted Firecrawl runs on http://localhost:3002 and Firecrawl Local on
http://localhost:3012. In Apidog project &amp;lt;id&amp;gt;, create two environments,
"self-hosted" and "local". Add test cases for POST /v2/scrape on
https://example.com (assert 200, success: true, non-empty data.markdown) and
POST /v2/map (assert 200 and a non-empty links array). Run the cases against
both environments and tell me every assertion that differs.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fa5246g93mas0gaatb8ra.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fa5246g93mas0gaatb8ra.png" alt="패리티 테스트: 코딩 에이전트가 포트 3002의 셀프 호스팅 스택과 포트 3012의 Firecrawl Local에 대해 동일한 Apidog 테스트 케이스를 실행하고, 상태·성공 여부·마크다운에 대해 두 리포트를 diff한다" width="800" height="533"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;에이전트는 페이로드 스키마를 읽고, 검증한 뒤, 동일한 케이스를 두 번 실행합니다:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;firecrawl-local serve --port 3012 &lt;span class="o"&gt;&amp;amp;&lt;/span&gt;
apidog environment create self-hosted --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --base-url http://localhost:3002
apidog environment create &lt;span class="kd"&gt;local&lt;/span&gt; --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --base-url http://localhost:3012
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file scrape-case.json
apidog test-case create --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --file scrape-case.json
apidog run --test-case &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;caseId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -e &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;selfHostedEnvId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -r cli,json --out-file self-hosted
apidog run --test-case &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;caseId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -e &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;localEnvId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -r cli,json --out-file &lt;span class="kd"&gt;local&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Apidog CLI는 여러분의 머신에서 요청을 보내므로 두 localhost 포트 모두 접근 가능합니다. &lt;code&gt;-r cli,json&lt;/code&gt;을 &lt;code&gt;-r junit&lt;/code&gt;으로 바꾸면 Firecrawl을 업그레이드할 때마다 동일한 검사를 CI에서 실행할 수 있습니다. &lt;a href="https://apidog.com/kr/blog/apidog-cli-ci-cd-pipeline?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog CLI CI/CD 가이드&lt;/a&gt;에서 설정을, &lt;a href="https://apidog.com/kr/blog/apidog-cli-in-claude-code?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Code에서의 Apidog CLI&lt;/a&gt;에서 에이전트 쪽을 다룹니다. Apidog의 Free 요금제는 최대 4명 팀까지 커버합니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQ
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Firecrawl Local이 셀프 호스팅 Firecrawl을 대체하나요?&lt;/strong&gt; 아닙니다. &lt;code&gt;apps/local&lt;/code&gt;에 있는 별도의 빌드입니다. &lt;code&gt;apps/api&lt;/code&gt;의 전체 서버와 그 셀프 호스팅 가이드는 그대로이며, 영구 작업과 LLM 포맷을 위해서는 여전히 필요합니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Firecrawl Local이 정말 셀프 호스팅 Firecrawl보다 37배 빠른가요?&lt;/strong&gt; 런치 포스트에서 언급한 Firecrawl의 주장이며, 메모리 230배 절감과 유휴 시 11 MB도 함께 언급되었습니다. README에 벤치마크 방법이 공개되어 있지 않으므로, 실제 URL로 직접 테스트해 보세요.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Firecrawl Local이 클라우드 없이 동작하나요?&lt;/strong&gt; 네. &lt;code&gt;FIRECRAWL_CLOUD=off&lt;/code&gt;로 설정하면 스크레이핑, 크롤링, 매핑이 머신에 머뭅니다. 다만 검색, 차단된 페이지 폴백, Alexandria는 동작을 멈춥니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;셀프 호스팅 Firecrawl은 무료인가요?&lt;/strong&gt; 코드는 서버와 Local 모두 AGPL-3.0으로 무료입니다. 머신 비용과 Postgres, Redis, RabbitMQ를 직접 운영하는 시간을 지불하는 셈이죠.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;AI 에이전트는 어느 쪽을 써야 하나요?&lt;/strong&gt; 대부분의 경우 Firecrawl Local입니다. &lt;code&gt;firecrawl-local init&lt;/code&gt;이 여섯 가지 에이전트 도구에 MCP 서버로 등록해 주며, &lt;code&gt;--public-only&lt;/code&gt;는 에이전트가 사설 네트워크에 접근하는 것을 막아줍니다.&lt;/p&gt;

</description>
    </item>
    <item>
      <title>Firecrawl Local이란? 내 컴퓨터에서 Firecrawl 직접 실행하기</title>
      <dc:creator>Rihpig</dc:creator>
      <pubDate>Thu, 19 Nov 2026 08:34:44 +0000</pubDate>
      <link>https://dev.to/rihpig/firecrawl-localiran-nae-keompyuteoeseo-firecrawl-jigjeob-silhaenghagi-5h46</link>
      <guid>https://dev.to/rihpig/firecrawl-localiran-nae-keompyuteoeseo-firecrawl-jigjeob-silhaenghagi-5h46</guid>
      <description>&lt;p&gt;&lt;strong&gt;Firecrawl Local&lt;/strong&gt;은 웹사이트를 스크래핑하고 크롤링하며, 사이트맵을 매핑해 깔끔한 마크다운으로 변환하는 단일 Rust 바이너리입니다. 모두 여러분의 컴퓨터에서 실행됩니다. 설치는 &lt;code&gt;cargo install firecrawl-local&lt;/code&gt; 한 줄이면 되고, API 키도, 데이터베이스도, 큐도, 컨테이너도 없이 &lt;code&gt;localhost:3002&lt;/code&gt;에서 Firecrawl v2 API를 제공할 수 있습니다. 검색과 몇 가지 기능은 여전히 Firecrawl Cloud로 요청이 나가지만, 이 역시 꺼둘 수 있습니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;지금 Apidog을 사용해 보세요&lt;/a&gt;
&lt;/p&gt;

&lt;p&gt;아래 내용은 내 노트북에서 실행되는 것과 클라우드로 가는 것, 설치 방법, 제공되는 API 라우트, 제약 사항, 그리고 코딩 에이전트가 Apidog CLI로 로컬 API를 테스트하게 만드는 방법을 다룹니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Firecrawl Local이란?
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Firecrawl Local은 Firecrawl의 오픈소스 온디바이스 에디션입니다.&lt;/strong&gt; 단일 바이너리로 웹 페이지를 가져오고, 호스팅형 Firecrawl API가 사용하는 것과 동일한 HTML 정리 코드로 가공한 뒤 마크다운, HTML 또는 링크를 반환합니다. CLI로도, AI 에이전트용 MCP 서버로도, Firecrawl v2 API의 로컬 복제본으로도 실행할 수 있습니다.&lt;/p&gt;

&lt;p&gt;Firecrawl은 2026년 11월 18일 &lt;a href="https://x.com/firecrawl/status/2123096169630912637" rel="noopener noreferrer"&gt;X의 런칭 게시물&lt;/a&gt;에서 이를 공개했으며, 코드는 &lt;a href="https://github.com/firecrawl/firecrawl/tree/main/apps/local" rel="noopener noreferrer"&gt;Firecrawl 저장소의 apps/local 폴더&lt;/a&gt;에 있습니다. 패키지는 &lt;a href="https://crates.io/crates/firecrawl-local" rel="noopener noreferrer"&gt;crates.io에 firecrawl-local이라는 이름으로&lt;/a&gt; 게시되어 있고, 저장소는 AGPL-3.0 라이선스입니다.&lt;/p&gt;

&lt;p&gt;Firecrawl은 셀프 호스팅 Firecrawl보다 37배 빠르고 메모리는 230분의 1(대기 시 11MB)만 쓴다고 주장합니다. README에는 벤치마크 방법이 공개되어 있지 않으므로, 이는 벤더 주장으로 받아들이는 게 좋습니다.&lt;/p&gt;

&lt;p&gt;호스팅형 API나 &lt;a href="https://apidog.com/kr/blog/how-to-install-and-use-firecrawl-cli?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Firecrawl CLI&lt;/a&gt;를 알고 있다면 개념은 간단합니다. 똑같은 호출을, 여러분의 컴퓨터가 처리하는 것입니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Firecrawl Local의 동작 방식: 하나의 바이너리, 열 개의 명령어
&lt;/h2&gt;

&lt;p&gt;모든 기능은 &lt;code&gt;firecrawl-local&lt;/code&gt;의 서브커맨드 뒤에 있습니다. README에 실린 전체 목록은 다음과 같습니다.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;명령어&lt;/th&gt;
&lt;th&gt;하는 일&lt;/th&gt;
&lt;th&gt;실행 위치&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;scrape &amp;lt;urls...&amp;gt;&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;하나 이상의 URL 스크래핑&lt;/td&gt;
&lt;td&gt;내 컴퓨터&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;crawl &amp;lt;url&amp;gt;&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;시작 URL부터 링크를 따라 이동&lt;/td&gt;
&lt;td&gt;내 컴퓨터&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;map &amp;lt;url&amp;gt;&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;사이트맵과 시작 페이지에서 사이트의 URL 목록 추출&lt;/td&gt;
&lt;td&gt;내 컴퓨터&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;serve&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;localhost에서 Firecrawl v2 API 실행&lt;/td&gt;
&lt;td&gt;내 컴퓨터&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;mcp&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;stdio 기반으로 Firecrawl MCP 서버 실행&lt;/td&gt;
&lt;td&gt;내 컴퓨터, 일부 도구는 클라우드&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;init&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;이 컴퓨터의 AI 도구에 MCP 서버 등록&lt;/td&gt;
&lt;td&gt;내 컴퓨터&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;search &amp;lt;query&amp;gt;&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;웹 검색&lt;/td&gt;
&lt;td&gt;Firecrawl Cloud&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;find-tools &amp;lt;query&amp;gt;&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Alexandria 데이터 프로바이더 찾기&lt;/td&gt;
&lt;td&gt;Firecrawl Cloud, 로그인 필요&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;data &amp;lt;provider&amp;gt; &amp;lt;capability&amp;gt;&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Alexandria 데이터 프로바이더 실행&lt;/td&gt;
&lt;td&gt;Firecrawl Cloud, 로그인 필요&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;login&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;브라우저에서 Firecrawl 로그인&lt;/td&gt;
&lt;td&gt;Firecrawl Cloud&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;일상적인 작업 대부분은 세 명령어로 해결됩니다.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# Print one page as markdown&lt;/span&gt;
firecrawl-local scrape https://example.com --markdown

&lt;span class="c"&gt;# Crawl up to 50 pages and save one markdown file per page&lt;/span&gt;
firecrawl-local crawl https://docs.firecrawl.dev --limit 50 --out ./pages

&lt;span class="c"&gt;# List every URL on a site&lt;/span&gt;
firecrawl-local map https://firecrawl.dev
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;--markdown&lt;/code&gt; 없이 &lt;code&gt;scrape&lt;/code&gt;를 실행하면 Firecrawl API의 JSON을 출력합니다. &lt;code&gt;--format&lt;/code&gt;에는 &lt;code&gt;markdown&lt;/code&gt;, &lt;code&gt;html&lt;/code&gt;, &lt;code&gt;rawHtml&lt;/code&gt;, &lt;code&gt;links&lt;/code&gt;를 지정할 수 있습니다. PDF와 Office 문서도 로컬에서 파싱됩니다.&lt;/p&gt;

&lt;p&gt;자바스크립트 페이지의 경우, 이미 설치된 Chrome이나 Chromium을 구동합니다. 브라우저가 없어도 정적 페이지는 작동하며, 브라우저가 필요한 페이지는 경고를 반환합니다. Chrome 사용 여부는 &lt;code&gt;--browser auto|never|always&lt;/code&gt;로 결정됩니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  로컬에서 실행되는 것 vs Firecrawl Cloud로 가는 것
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;스크래핑, 크롤링, 매핑, 문서 파싱은 여러분의 컴퓨터에서 실행되며 Firecrawl에 아무것도 전송하지 않습니다.&lt;/strong&gt; 다음 세 가지 기능은 노트북에 해당 인덱스나 네트워크, 데이터가 없기 때문에 Firecrawl Cloud로 전달됩니다.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;검색.&lt;/strong&gt; 로컬에는 검색 인덱스가 없습니다. 키 없이도 검색은 되지만 속도 제한이 있습니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;내 컴퓨터를 거부하는 페이지.&lt;/strong&gt; 사이트가 일반 fetch와 로컬 브라우저 모두를 차단한 경우, Firecrawl Cloud가 대신 가져옵니다. 계정은 필요 없습니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Alexandria 데이터 프로바이더.&lt;/strong&gt; Firecrawl Cloud에서 실행되며 무료 계정이 필요합니다. 이 기능이 무엇인지는 &lt;a href="https://apidog.com/kr/blog/what-is-firecrawl-alexandria?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Firecrawl Alexandria 설명 글&lt;/a&gt;에서 다룹니다.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fmqavpd8n2cx7yns5cjf1.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fmqavpd8n2cx7yns5cjf1.png" alt="Firecrawl Local split: scrape, crawl, map and PDF and Office parsing run on your machine with optional Chrome, while search, the blocked-page fallback and Alexandria data go to Firecrawl Cloud under FIRECRAWL_CLOUD=auto, switchable to search or off" width="800" height="410"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;code&gt;FIRECRAWL_CLOUD&lt;/code&gt; 환경 변수가 클라우드 전환을 제어합니다.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;값&lt;/th&gt;
&lt;th&gt;효과&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;auto&lt;/code&gt; (기본값)&lt;/td&gt;
&lt;td&gt;검색, 차단된 페이지 폴백, Alexandria 모두 작동&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;search&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;검색만 Firecrawl Cloud로 전달&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;off&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Firecrawl Cloud로 아무것도 전달하지 않음&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;인식할 수 없는 값은 &lt;code&gt;off&lt;/code&gt;로 처리됩니다. 클라우드에서 가져온 결과에는 &lt;code&gt;"source": "firecrawl-cloud"&lt;/code&gt;가 붙으며, 클라우드마저 실패하면 &lt;code&gt;"blocked": true&lt;/code&gt;를 받게 됩니다.&lt;/p&gt;

&lt;p&gt;클라우드 호출에는 무작위 설치 ID와 호출 도구의 이름이 함께 전달되며, Firecrawl은 이를 활용해 설치 수를 집계합니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Firecrawl Local 설치 방법
&lt;/h2&gt;

&lt;p&gt;Rust와 C 컴파일러가 필요합니다. 그다음은 다음과 같습니다.&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;빌드 도구를 설치합니다.&lt;/strong&gt; macOS에서는 &lt;code&gt;xcode-select --install&lt;/code&gt;을 실행합니다. Debian이나 Ubuntu에서는 &lt;code&gt;build-essential&lt;/code&gt;을 설치합니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Chrome 또는 Chromium을 추가합니다 (선택).&lt;/strong&gt; 자바스크립트로 렌더링되는 페이지나 스크린샷이 필요할 때 사용합니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Node.js 22 이상을 추가합니다 (선택).&lt;/strong&gt; MCP 서버를 쓰려면 필요하며, &lt;code&gt;npx&lt;/code&gt;로 &lt;code&gt;firecrawl-mcp&lt;/code&gt; npm 패키지를 실행합니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;로그인합니다 (선택).&lt;/strong&gt; Alexandria 프로바이더를 쓰려면 &lt;code&gt;firecrawl-local login&lt;/code&gt;을 실행합니다.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;&lt;strong&gt;&lt;a href="http://crates.io" rel="noopener noreferrer"&gt;crates.io&lt;/a&gt;에서 바이너리를 설치하세요.&lt;/strong&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;cargo install firecrawl-local
firecrawl-local --version
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;최신 코드를 직접 빌드하려면 저장소를 클론한 뒤 &lt;code&gt;apps/local&lt;/code&gt;에서 &lt;code&gt;cargo build --release&lt;/code&gt;를 실행합니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Firecrawl Local API: localhost:3002에서 제공되는 v2 라우트
&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;firecrawl-local serve&lt;/code&gt;는 3002 포트에서 Firecrawl v2 API를 제공합니다. 로컬 라우트에는 API 키가 필요 없습니다.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;firecrawl-local serve

&lt;span class="c"&gt;# in another terminal&lt;/span&gt;
curl -s http://localhost:3002/v2/scrape \
  -H &lt;span class="s1"&gt;'content-type: application/json'&lt;/span&gt; \
  -d &lt;span class="s1"&gt;'{"url":"https://example.com","formats":["markdown"]}'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;다음 라우트들이 여러분의 컴퓨터에서 실행됩니다.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;라우트&lt;/th&gt;
&lt;th&gt;하는 일&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;POST /v2/scrape&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;URL 하나 스크래핑&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;POST /v2/map&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;사이트의 URL 목록 추출&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;POST /v2/crawl&lt;/code&gt;, &lt;code&gt;GET&lt;/code&gt; 및 &lt;code&gt;DELETE /v2/crawl/{id}&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;크롤 시작, 상태 확인, 취소&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;POST /v2/batch/scrape&lt;/code&gt;, &lt;code&gt;GET&lt;/code&gt; 및 &lt;code&gt;DELETE /v2/batch/scrape/{id}&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;배치 스크래핑 시작, 상태 확인, 취소&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;GET /health&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;상태 확인&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;그 밖의 &lt;code&gt;/v2&lt;/code&gt; 라우트(예: &lt;code&gt;/v2/search&lt;/code&gt;)는 &lt;code&gt;FIRECRAWL_CLOUD&lt;/code&gt; 설정이 다르지 않은 한 Firecrawl Cloud로 포워딩됩니다. v0, v1 라우트는 제공되지 않습니다.&lt;/p&gt;

&lt;p&gt;기존 코드는 설정 한 줄만 바꾸면 됩니다. 어떤 Firecrawl SDK든 API URL을 &lt;code&gt;http://localhost:3002&lt;/code&gt;로 지정하면 됩니다. 스크래퍼나 RAG 파이프라인의 코드는 그대로 두고, 반복 작업을 하는 동안 클라우드 크레딧을 쓰지 않아도 됩니다. 스크래핑 파이프라인 전반에 대해 알고 싶다면 &lt;a href="https://apidog.com/kr/blog/firecrawl-web-scraping?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Firecrawl 웹 스크래핑 가이드&lt;/a&gt;를 참고하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  AI 에이전트용 MCP 서버로 쓰는 Firecrawl Local
&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;firecrawl-local init&lt;/code&gt;은 발견한 모든 AI 도구에 Firecrawl Local을 &lt;a href="https://modelcontextprotocol.io/" rel="noopener noreferrer"&gt;Model Context Protocol&lt;/a&gt; 서버로 등록합니다. Claude Code, Claude Desktop, Cursor, Windsurf, Gemini CLI, Codex를 지원하며, 각 설정 파일을 먼저 백업하고, &lt;code&gt;--dry-run&lt;/code&gt;으로 변경 미리보기를 하거나 &lt;code&gt;--agent cursor&lt;/code&gt;로 특정 도구만 설정할 수 있습니다.&lt;/p&gt;

&lt;p&gt;에이전트는 표준 &lt;a href="https://apidog.com/kr/blog/firecrawl-mcp-llms-txt?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Firecrawl MCP&lt;/a&gt; 도구를 사용하게 됩니다. 스크래핑, 크롤링, 매핑, 배치 스크래핑은 로컬에서 실행되고, 나머지는 Firecrawl Cloud로 갑니다.&lt;/p&gt;

&lt;p&gt;에이전트가 신뢰할 수 없는 사이트를 탐색해야 한다면 &lt;code&gt;firecrawl-local mcp --public-only&lt;/code&gt;로 등록하세요. 그렇지 않으면 숨겨진 지시 사항이 있는 페이지에 의해 에이전트가 내부 네트워크의 URL을 열도록 조종될 수 있습니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Firecrawl Local의 제약 사항
&lt;/h2&gt;

&lt;p&gt;Firecrawl Local은 전체 Firecrawl 서버가 아닙니다. README에 빠져 있는 기능은 다음과 같습니다.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;로컬에서 &lt;code&gt;json&lt;/code&gt;, &lt;code&gt;summary&lt;/code&gt; 포맷 미지원.&lt;/strong&gt; 모델이 필요하기 때문에 로컬 스크래핑에서는 경고와 함께 건너뜁니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;브라우저 &lt;code&gt;actions&lt;/code&gt; 미지원.&lt;/strong&gt; 클릭, 스크롤, 입력 등의 단계는 무시됩니다.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;스크린샷은 Chrome 필요.&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;작업은 메모리에 저장.&lt;/strong&gt; 크롤 및 배치 작업은 시작 후 1시간이 지나면 만료되며, &lt;code&gt;serve&lt;/code&gt;가 중지되면 사라집니다.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;v0, v1 API 라우트 미제공.&lt;/strong&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;큐, 워커, 모든 포맷이 필요하다면 &lt;code&gt;apps/api&lt;/code&gt;의 전체 서버가 여전히 존재하며, Firecrawl의 &lt;a href="https://docs.firecrawl.dev/contributing/self-host" rel="noopener noreferrer"&gt;셀프 호스팅 가이드&lt;/a&gt;에서 다룹니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  알아두어야 할 기본 보안 설정
&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;serve&lt;/code&gt;는 다른 프로그램의 요청을 받기 때문에 명령어에 따라 기본값이 다릅니다.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;scrape&lt;/code&gt;, &lt;code&gt;crawl&lt;/code&gt;, &lt;code&gt;map&lt;/code&gt;, &lt;code&gt;mcp&lt;/code&gt;&lt;/strong&gt;는 키보드 앞의 사용자를 위해 실행되므로 &lt;code&gt;localhost&lt;/code&gt;와 사설 네트워크에 접근할 수 있습니다. &lt;code&gt;scrape&lt;/code&gt;, &lt;code&gt;crawl&lt;/code&gt;, &lt;code&gt;mcp&lt;/code&gt;는 &lt;code&gt;--public-only&lt;/code&gt;를 지정해 이런 주소를 거부할 수 있습니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;serve&lt;/code&gt;&lt;/strong&gt;는 &lt;code&gt;127.0.0.1&lt;/code&gt;에 바인딩되며, &lt;code&gt;--allow-private&lt;/code&gt;를 넘기지 않는 한 localhost와 사설 대상을 거부합니다. &lt;code&gt;--host&lt;/code&gt;로 다른 주소에 바인딩하려면 &lt;code&gt;--token&lt;/code&gt;이 필수입니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;링크 로컬 주소와 클라우드 메타데이터 주소는 항상 차단됩니다.&lt;/strong&gt; 리다이렉트와 DNS 해석 이후에도 마찬가지입니다.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Chrome은 헤드리스 및 샌드박스 모드로 일회용 프로필을 사용해 실행됩니다. 크롤링 시 Firecrawl Local은 &lt;a href="https://www.rfc-editor.org/rfc/rfc9309" rel="noopener noreferrer"&gt;Robots Exclusion Protocol&lt;/a&gt;에 따라 &lt;code&gt;robots.txt&lt;/code&gt;를 읽으며, 사이트 소유자는 &lt;code&gt;FirecrawlLocal&lt;/code&gt;라는 이름으로 이를 지정할 수 있습니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Firecrawl Local이 필요한 사람
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;스크래퍼나 RAG 파이프라인을 만드는 개발자.&lt;/strong&gt; 클라우드 사용량으로 비용을 내기 전에 무료로 빠르게 반복 작업을 하고 싶을 때 적합합니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;코딩 에이전트 사용자.&lt;/strong&gt; 모든 페이지를 제3자를 거치지 않고 Claude Code, Cursor, Codex 안에서 웹을 읽고 싶을 때 적합합니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;데이터 규칙이 있는 팀.&lt;/strong&gt; &lt;code&gt;FIRECRAWL_CLOUD=off&lt;/code&gt;를 사용해 가져온 콘텐츠가 컴퓨터 밖으로 나가지 않도록 해야 할 때 적합합니다.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;code&gt;json&lt;/code&gt; 추출, 브라우저 액션, 장기 크롤 작업에 의존한다면 적합도가 떨어집니다. 에이전트 검색만 필요하다면 &lt;a href="https://apidog.com/kr/blog/open-source-claude-web-search?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude용 오픈소스 웹 검색&lt;/a&gt; 모음 글을 참고하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  코딩 에이전트가 Apidog CLI로 로컬 API를 테스트하게 하기
&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;serve&lt;/code&gt;가 실행되면 &lt;code&gt;localhost:3002&lt;/code&gt;에 실제 HTTP API가 생깁니다. 파이프라인을 여기에 연결하기 전에, 코드가 기대하는 방식으로 라우트가 응답하는지 확인해 보세요. 요청을 일일이 클릭해서 보내는 대신, 코딩 에이전트에게 &lt;a href="https://apidog.com/apidog-cli/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog CLI&lt;/a&gt;를 쥐여주고 프롬프트 하나를 주면 됩니다.&lt;/p&gt;

&lt;p&gt;다음과 같이 한 번만 설정하세요.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm install -g apidog-cli@latest
apidog auth login --with-token &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;YOUR_TOKEN&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
apidog skill install
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;그다음 에이전트에게 요청하세요.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Start firecrawl-local serve in the background. Write an OpenAPI 3 file for its
local routes (POST /v2/scrape, POST /v2/map, GET /health) and import it into
Apidog project &amp;lt;id&amp;gt;. Create an environment pointing at http://localhost:3002,
add test cases that assert /health returns 200 and /v2/scrape returns
success: true with non-empty data.markdown for https://example.com, then run
them and summarize any failures.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fnw6n8q4xflbyads370t4.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fnw6n8q4xflbyads370t4.png" alt="Coding agent workflow: the agent starts firecrawl-local serve on localhost:3002, Apidog CLI imports the spec, creates test cases and runs them against POST /v2/scrape, POST /v2/map and GET /health, and writes a cli, json or junit report" width="799" height="341"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;에이전트는 스키마를 읽고, 페이로드를 검증한 뒤, 다음과 같은 명령어를 실행합니다.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;firecrawl-local serve &lt;span class="o"&gt;&amp;amp;&lt;/span&gt;
apidog import --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --format openapi --file ./firecrawl-local-v2.yaml
apidog environment create firecrawl-local --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --base-url http://localhost:3002
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --file ./case.json
apidog run --test-case &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;caseId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -e &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;envId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -r cli,json
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Apidog CLI는 여러분의 컴퓨터에서 요청을 보내므로 &lt;code&gt;localhost:3002&lt;/code&gt;에 접근할 수 있습니다. &lt;code&gt;-r cli,json&lt;/code&gt;을 &lt;code&gt;-r junit&lt;/code&gt;로 바꾸면 같은 실행 결과가 CI에 그대로 들어갑니다. 설정 방법은 &lt;a href="https://apidog.com/kr/blog/apidog-cli-ci-cd-pipeline?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog CLI CI/CD 가이드&lt;/a&gt;에서, 에이전트 쪽은 &lt;a href="https://apidog.com/kr/blog/apidog-cli-in-claude-code?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Code에서 Apidog CLI 사용하기&lt;/a&gt;에서 자세히 볼 수 있습니다. Apidog의 Free 플랜은 최대 4명 규모 팀까지 지원합니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQ
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Firecrawl Local은 무료인가요?&lt;/strong&gt; 바이너리는 AGPL-3.0으로 오픈소스이며, 로컬 스크래핑, 크롤링, 매핑에는 API 키가 필요 없습니다. 검색, 차단된 페이지 폴백, Alexandria는 Firecrawl Cloud로 가며, Alexandria는 무료 계정이 필요합니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;기존 Firecrawl SDK 코드를 Firecrawl Local과 함께 사용할 수 있나요?&lt;/strong&gt; 네, 로컬 라우트에 한해서 가능합니다. SDK의 API URL을 &lt;code&gt;http://localhost:3002&lt;/code&gt;로 설정하세요. 스크래핑, 매핑, 크롤링, 배치 스크래핑은 로컬에서 실행되며, v0와 v1 라우트는 제공되지 않습니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Firecrawl Local이 클라우드를 호출하지 않게 하려면 어떻게 하나요?&lt;/strong&gt; &lt;code&gt;FIRECRAWL_CLOUD=off&lt;/code&gt;를 설정하세요. 검색과 차단된 페이지 폴백이 작동을 멈추고, 명시적인 &lt;code&gt;login&lt;/code&gt;을 제외하면 아무것도 여러분의 컴퓨터를 떠나지 않습니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Firecrawl Local은 셀프 호스팅 Firecrawl과 무엇이 다른가요?&lt;/strong&gt; 셀프 호스팅 Firecrawl은 &lt;code&gt;apps/api&lt;/code&gt;의 전체 서버로, 큐와 워커, 모든 포맷을 갖추고 있습니다. Firecrawl Local은 &lt;code&gt;json&lt;/code&gt;과 &lt;code&gt;summary&lt;/code&gt; 포맷, 브라우저 액션, 영구 작업을 제거한 더 가벼운 단일 바이너리입니다.&lt;/p&gt;

</description>
    </item>
    <item>
      <title>Gemini 4 Neon 사고 수준: High와 xhigh는 언제 사용해야 할까?</title>
      <dc:creator>Rihpig</dc:creator>
      <pubDate>Thu, 19 Nov 2026 07:57:07 +0000</pubDate>
      <link>https://dev.to/rihpig/gemini-4-neon-sago-sujun-highwa-xhighneun-eonje-sayonghaeya-halgga-42ji</link>
      <guid>https://dev.to/rihpig/gemini-4-neon-sago-sujun-highwa-xhighneun-eonje-sayonghaeya-halgga-42ji</guid>
      <description>&lt;h1&gt;
  
  
  Gemini 4 Neon thinking level 완전 가이드: low, medium, high, xhigh
&lt;/h1&gt;

&lt;p&gt;Gemini 4 Neon의 thinking level은 모델이 답변하기 전에 얼마나 깊이 추론할지를 결정하는 네 가지 설정, 즉 &lt;code&gt;low&lt;/code&gt;, &lt;code&gt;medium&lt;/code&gt;, &lt;code&gt;high&lt;/code&gt;, &lt;code&gt;xhigh&lt;/code&gt;를 제공합니다. Neon의 기본값은 &lt;code&gt;high&lt;/code&gt;입니다. Google은 대부분의 복잡한 작업에서는 &lt;code&gt;high&lt;/code&gt;를 유지하고, 어려운 다단계 문제에서 &lt;code&gt;high&lt;/code&gt;가 성능을 내지 못할 때만 &lt;code&gt;xhigh&lt;/code&gt;로 전환할 것을 권장합니다. &lt;code&gt;xhigh&lt;/code&gt;는 더 많은 토큰을 소모하고 시간이 더 오래 걸리기 때문입니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;지금 Apidog을 사용해 보세요&lt;/a&gt;
&lt;/p&gt;

&lt;h2&gt;
  
  
  Gemini 4 Neon thinking level이란?
&lt;/h2&gt;

&lt;p&gt;Thinking level은 &lt;code&gt;thinking_level&lt;/code&gt; 파라미터의 값으로, &lt;code&gt;gemini-4-neon&lt;/code&gt;이 답변을 작성하기 전에 얼마나 많은 내부 추론을 수행할지 설정합니다. Neon은 &lt;code&gt;low&lt;/code&gt;, &lt;code&gt;medium&lt;/code&gt;, &lt;code&gt;high&lt;/code&gt;(기본값), &lt;code&gt;xhigh&lt;/code&gt;의 네 가지를 지원합니다. level이 높을수록 더 많은 thinking 토큰을 사용하고 지연 시간이 늘어나며, level이 낮을수록 더 빠르게 답변하고 비용이 적게 듭니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fcziwsvv0v0z9yujl98jq.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fcziwsvv0v0z9yujl98jq.png" width="800" height="450"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Google의 &lt;a href="https://ai.google.dev/gemini-api/docs/thinking" rel="noopener noreferrer"&gt;thinking 가이드&lt;/a&gt;가 Neon의 각 level을 다음과 같이 설명합니다.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;&lt;code&gt;thinking_level&lt;/code&gt;&lt;/th&gt;
&lt;th&gt;토큰 사용량&lt;/th&gt;
&lt;th&gt;Google 권장 용도&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;low&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;가장 적은 토큰, 가장 낮은 지연 시간&lt;/td&gt;
&lt;td&gt;빠른 채팅, 고처리량 처리; 에이전트 작업에서도 여전히 유용함&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;medium&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;더 적은 토큰, 더 빠른 응답&lt;/td&gt;
&lt;td&gt;대화형 코딩, 실시간 UI 프로토타이핑, 지연 시간에 민감한 도구 호출&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;high&lt;/code&gt; (기본값)&lt;/td&gt;
&lt;td&gt;지능과 속도의 균형&lt;/td&gt;
&lt;td&gt;복잡한 코딩, 에이전트 실행, 도구 호출, 멀티모달 지식 작업&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;xhigh&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;가장 많은 토큰, 가장 깊은 추론&lt;/td&gt;
&lt;td&gt;어려운 다단계 엔지니어링, &lt;code&gt;high&lt;/code&gt;가 부족한 분석적·과학적 문제&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;예상할 수 있는 두 가지 값이 빠져 있습니다. Neon은 &lt;code&gt;minimal&lt;/code&gt;을 오류로 거부하므로, Gemini 3 Flash 앱에서 복사한 코드가 이 값을 보내면 작동하지 않습니다. 그리고 기존 &lt;code&gt;thinkingBudget&lt;/code&gt; 토큰 수는 Gemini 4에서 더 이상 사용되지 않습니다. 단독으로 보내면 경고와 함께 가장 가까운 level로 매핑되지만, &lt;code&gt;thinkingLevel&lt;/code&gt;과 함께 보내면 &lt;code&gt;400&lt;/code&gt;을 반환합니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fk7vl2s09z76lq1x1wbu7.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fk7vl2s09z76lq1x1wbu7.png" alt="Ladder of the four Gemini 4 Neon thinking levels from low to xhigh, with thought tokens and latency rising at each step and high marked as the default" width="800" height="450"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  Neon의 기본값은 다른 Gemini 4 모델과 어떻게 다른가?
&lt;/h2&gt;

&lt;p&gt;Neon은 더 큰 형제 모델들보다 한 단계 높은 level에서 시작합니다. &lt;a href="https://ai.google.dev/gemini-api/docs/whats-new-gemini-4-neon" rel="noopener noreferrer"&gt;Gemini 4 Neon 릴리스 노트&lt;/a&gt;에 따르면 Neon과 Hydrogen은 기본값이 &lt;code&gt;high&lt;/code&gt;이고 &lt;code&gt;xhigh&lt;/code&gt;를 지원하는 반면, Carbon과 Argon은 기본값이 &lt;code&gt;medium&lt;/code&gt;이고 &lt;code&gt;high&lt;/code&gt;까지만 지원합니다.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;모델&lt;/th&gt;
&lt;th&gt;기본 level&lt;/th&gt;
&lt;th&gt;지원 level&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;gemini-4-neon&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;high&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;low&lt;/code&gt;, &lt;code&gt;medium&lt;/code&gt;, &lt;code&gt;high&lt;/code&gt;, &lt;code&gt;xhigh&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;gemini-4-hydrogen&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;high&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;low&lt;/code&gt;, &lt;code&gt;medium&lt;/code&gt;, &lt;code&gt;high&lt;/code&gt;, &lt;code&gt;xhigh&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;gemini-4-carbon&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;medium&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;low&lt;/code&gt;, &lt;code&gt;medium&lt;/code&gt;, &lt;code&gt;high&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;gemini-4-argon&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;medium&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;low&lt;/code&gt;, &lt;code&gt;medium&lt;/code&gt;, &lt;code&gt;high&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;이는 모델을 전환할 때 중요합니다. &lt;code&gt;thinking_level&lt;/code&gt;을 설정하지 않고 Carbon 워크로드를 Neon으로 옮기면 모든 요청이 &lt;code&gt;medium&lt;/code&gt; 추론에서 &lt;code&gt;high&lt;/code&gt; 추론으로 뛰어올라 토큰 수가 달라집니다. 더 큰 모델들을 비교하고 있다면 &lt;a href="https://apidog.com/kr/blog/gemini-4-carbon-vs-argon?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Carbon vs Argon 비교&lt;/a&gt;에서 그 차이를 다루고 있습니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Gemini API에서 &lt;code&gt;thinking_level&lt;/code&gt;은 어떻게 설정하나?
&lt;/h2&gt;

&lt;p&gt;Neon은 Interactions API와 &lt;code&gt;generateContent&lt;/code&gt; 모두의 유료 등급에서 실행됩니다. 필드 이름은 두 API에서 다릅니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Interactions API:&lt;/strong&gt; &lt;code&gt;generation_config&lt;/code&gt; 안에 &lt;code&gt;thinking_level&lt;/code&gt;을 넣습니다.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl &lt;span class="s2"&gt;"https://generativelanguage.googleapis.com/v1beta/interactions"&lt;/span&gt; \
  -H &lt;span class="s2"&gt;"x-goog-api-key: $GEMINI_API_KEY"&lt;/span&gt; \
  -H &lt;span class="s1"&gt;'Content-Type: application/json'&lt;/span&gt; \
  -X POST \
  -d &lt;span class="s1"&gt;'{
    "model": "gemini-4-neon",
    "input": "Audit this payment retry queue for race conditions.",
    "generation_config": {
      "thinking_level": "xhigh",
      "max_output_tokens": 65536
    }
  }'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;generateContent:&lt;/strong&gt; &lt;code&gt;generationConfig.thinkingConfig&lt;/code&gt; 안에 &lt;code&gt;thinkingLevel&lt;/code&gt;을 사용합니다.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl &lt;span class="s2"&gt;"https://generativelanguage.googleapis.com/v1beta/models/gemini-4-neon:generateContent"&lt;/span&gt; \
  -H &lt;span class="s2"&gt;"x-goog-api-key: $GEMINI_API_KEY"&lt;/span&gt; \
  -H &lt;span class="s1"&gt;'Content-Type: application/json'&lt;/span&gt; \
  -X POST \
  -d &lt;span class="s1"&gt;'{
    "contents": [{"parts": [{"text": "Audit this payment retry queue for race conditions."}]}],
    "generationConfig": {
      "thinkingConfig": {"thinkingLevel": "medium"}
    }
  }'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Python SDK에서는 Interactions 호출이 &lt;code&gt;generation_config={"thinking_level": "high"}&lt;/code&gt;를 받고, &lt;code&gt;generateContent&lt;/code&gt; 호출은 &lt;code&gt;thinking_config=types.ThinkingConfig(thinking_level="low")&lt;/code&gt;를 받습니다. &lt;code&gt;temperature&lt;/code&gt;, &lt;code&gt;top_p&lt;/code&gt;, &lt;code&gt;top_k&lt;/code&gt;는 지정하지 마세요. Google에 따르면 Neon은 범위 내 값은 무시하고 범위를 벗어난 값은 &lt;code&gt;400&lt;/code&gt;으로 거부합니다. 동일한 API 설계에 대한 첫 요청 전체 예시는 &lt;a href="https://apidog.com/kr/blog/gemini-4-hydrogen-api?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Hydrogen API 가이드&lt;/a&gt;를 참고하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  high와 xhigh는 언제 각각 사용해야 하나?
&lt;/h2&gt;

&lt;p&gt;기본적으로 &lt;code&gt;high&lt;/code&gt;를 사용하고, 해당 작업에서 &lt;code&gt;high&lt;/code&gt;가 품질 기준을 충족하지 못할 때만 &lt;code&gt;xhigh&lt;/code&gt;로 올리세요. Google의 출시 글은 &lt;code&gt;xhigh&lt;/code&gt;를 "가장 어려운 엔지니어링, 분석, 과학 워크로드를 위한 더 깊은 다단계 추론"으로 설명합니다.&lt;/p&gt;

&lt;p&gt;다음의 경우 &lt;code&gt;xhigh&lt;/code&gt;를 선택하세요.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;작업에 의존 단계가 많고&lt;/strong&gt; 초반의 실수가 결과를 망치는 경우. 예를 들어 여러 파일에 걸친 리팩터링이나 동시성 감사가 그렇습니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;high&lt;/code&gt;가 자신감 있지만 틀린 답변을 준 경우&lt;/strong&gt;. 단순히 느린 것이 아니라 평가 세트에서 틀렸을 때입니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;지연 시간이 크게 중요하지 않은 경우&lt;/strong&gt;. 백그라운드 작업, 야간 리뷰, 배치 분석 같은 작업입니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;틀린 답변의 비용이 토큰 비용보다 큰 경우&lt;/strong&gt;. 보안 패치나 금융 계산이 그렇습니다.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;다음의 경우 &lt;code&gt;high&lt;/code&gt;를 유지하거나 더 낮추세요.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;프롬프트가 추출이나 포맷팅인 경우.&lt;/strong&gt; Google은 &lt;code&gt;xhigh&lt;/code&gt;가 "텍스트나 JSON 추출 같은 단순한 프롬프트에서 과도하게 생각하거나 &lt;code&gt;max_output_tokens&lt;/code&gt;를 소진할 수 있다"고 경고합니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;사용자가 기다리는 경우.&lt;/strong&gt; 채팅, 자동 완성, 실시간 도구 호출에는 &lt;code&gt;medium&lt;/code&gt;이나 &lt;code&gt;low&lt;/code&gt;가 적합합니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;대량으로 실행하는 경우.&lt;/strong&gt; 추가되는 모든 thinking 토큰에 비용이 청구되며, 그 차이는 요청 수가 늘수록 증폭됩니다.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Google의 벤치마크 수치도 이 구분을 뒷받침합니다. &lt;a href="https://blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-neon/" rel="noopener noreferrer"&gt;출시 발표&lt;/a&gt;에서 &lt;code&gt;xhigh&lt;/code&gt;의 Neon은 Artificial Analysis Intelligence Index에서 61점을 기록해 3위를 차지했습니다. 기본값인 &lt;code&gt;high&lt;/code&gt;에서는 Google이 Carbon보다 작업당 비용이 32% 낮다고 보고합니다. 이는 Google의 수치이지 저희 테스트는 아니지만, 트레이드오프를 보여줍니다. &lt;code&gt;xhigh&lt;/code&gt;는 Neon의 최고 점수를 사고, &lt;code&gt;high&lt;/code&gt;는 효율을 삽니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  각 thinking level의 비용은 얼마인가?
&lt;/h2&gt;

&lt;p&gt;모든 level의 토큰당 가격은 같으며, 달라지는 것은 지불하는 토큰 수입니다. Neon은 100만 입력 토큰당 $3.00, 100만 출력 토큰당 $15.00이며, Google의 &lt;a href="https://ai.google.dev/gemini-api/docs/pricing" rel="noopener noreferrer"&gt;가격 페이지&lt;/a&gt;는 출력 요율에 thinking 토큰이 포함된다고 명시합니다. 암시적 캐싱을 사용하면 캐시된 입력은 100만 토큰당 $0.15로 떨어집니다(Neon에서는 명시적 캐싱이 지원되지 않음). 이 모델에는 무료 등급이 없습니다.&lt;/p&gt;

&lt;p&gt;따라서 level의 비용은 추가되는 thinking 토큰 수에 100만 토큰당 $15를 곱한 값입니다. 다음은 입력 토큰 2,000개와 표시되는 답변 토큰 800개로 구성된 한 요청의 계산입니다. Thinking 토큰 수는 계산 방식을 보여주기 위해 임의로 선택한 것이며 측정값이 아닙니다.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Thinking 토큰 (가정)&lt;/th&gt;
&lt;th&gt;입력 비용&lt;/th&gt;
&lt;th&gt;출력 + thinking 비용&lt;/th&gt;
&lt;th&gt;요청당 합계&lt;/th&gt;
&lt;th&gt;10,000건당&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;500&lt;/td&gt;
&lt;td&gt;$0.006&lt;/td&gt;
&lt;td&gt;$0.0195&lt;/td&gt;
&lt;td&gt;$0.0255&lt;/td&gt;
&lt;td&gt;$255&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2,000&lt;/td&gt;
&lt;td&gt;$0.006&lt;/td&gt;
&lt;td&gt;$0.042&lt;/td&gt;
&lt;td&gt;$0.048&lt;/td&gt;
&lt;td&gt;$480&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;8,000&lt;/td&gt;
&lt;td&gt;$0.006&lt;/td&gt;
&lt;td&gt;$0.132&lt;/td&gt;
&lt;td&gt;$0.138&lt;/td&gt;
&lt;td&gt;$1,380&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Thinking이 청구서를 빠르게 지배합니다. Thinking 토큰이 8,000개일 때 추론은 요청 비용의 87%를 차지합니다. 그래서 Google은 네 가지 level 모두에서 평가를 실행하고 "품질 기준을 충족하는 가장 낮은 &lt;code&gt;thinking_level&lt;/code&gt;을 선택하라"고 권장합니다. 더 저렴한 모델에서 같은 트레이드오프를 비교하고 싶다면 &lt;a href="https://apidog.com/kr/blog/gemini-3-8-flash-thinking-levels?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 3.8 Flash thinking level 가이드&lt;/a&gt;에서 다룹니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  level별 토큰과 지연 시간은 어떻게 측정하나?
&lt;/h2&gt;

&lt;p&gt;같은 프롬프트를 각 level에서 실행하고 usage 블록을 확인하세요. Interactions API에서는 응답의 &lt;code&gt;usage&lt;/code&gt; 객체가 &lt;code&gt;total_input_tokens&lt;/code&gt;, &lt;code&gt;total_output_tokens&lt;/code&gt;, &lt;code&gt;total_thought_tokens&lt;/code&gt;를 각각 보고합니다. &lt;code&gt;generateContent&lt;/code&gt;에서는 thinking 토큰이 &lt;code&gt;usageMetadata.thoughtsTokenCount&lt;/code&gt;로 나타납니다.&lt;/p&gt;

&lt;p&gt;다음 루프는 하나의 프롬프트를 네 level 모두에 보내고 thinking 토큰과 실제 소요 시간을 출력합니다.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="k"&gt;for&lt;/span&gt; level &lt;span class="k"&gt;in&lt;/span&gt; low medium high xhigh&lt;span class="o"&gt;;&lt;/span&gt; &lt;span class="k"&gt;do&lt;/span&gt;
  &lt;span class="nv"&gt;start&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="nv"&gt;$(&lt;/span&gt;date +%s&lt;span class="o"&gt;)&lt;/span&gt;
  &lt;span class="nv"&gt;usage&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="nv"&gt;$(&lt;/span&gt;curl -s &lt;span class="s2"&gt;"https://generativelanguage.googleapis.com/v1beta/interactions"&lt;/span&gt; \
    -H &lt;span class="s2"&gt;"x-goog-api-key: $GEMINI_API_KEY"&lt;/span&gt; \
    -H &lt;span class="s1"&gt;'Content-Type: application/json'&lt;/span&gt; \
    -d &lt;span class="s2"&gt;"{\"model\":\"gemini-4-neon\",
         \"input\":\"Find the race condition in this retry loop: ...\",
         \"generation_config\":{\"thinking_level\":\"$level\",\"max_output_tokens\":65536}}"&lt;/span&gt; \
    &lt;span class="o"&gt;|&lt;/span&gt; jq -c &lt;span class="s1"&gt;'{status, thought: .usage.total_thought_tokens, out: .usage.total_output_tokens}'&lt;/span&gt;&lt;span class="o"&gt;)&lt;/span&gt;
  &lt;span class="nb"&gt;echo&lt;/span&gt; &lt;span class="s2"&gt;"$level $(( $(date +%s) - start ))s $usage"&lt;/span&gt;
&lt;span class="k"&gt;done&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;실제 워크로드에서 10~20개의 프롬프트로 실행해 보세요. 프롬프트 하나로는 알 수 있는 것이 거의 없습니다. 여러 개를 모아야 &lt;code&gt;high&lt;/code&gt;와 &lt;code&gt;xhigh&lt;/code&gt;가 품질에서 갈리기 시작하는 지점을 볼 수 있습니다.&lt;/p&gt;

&lt;p&gt;테스트하는 동안 HTTP 클라이언트의 타임아웃을 높게 설정하세요. Google의 마이그레이션 노트에 따르면 어려운 프롬프트는 몇 분이 걸릴 수 있으므로 최소 15분의 타임아웃을 설정하거나 백그라운드 실행을 사용할 것을 권장합니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  xhigh가 때때로 빈 답변을 반환하는 이유는?
&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;max_output_tokens&lt;/code&gt;는 thinking과 표시되는 출력을 함께 제한합니다. Neon이 예산 전체를 추론에 사용하면 상호작용은 &lt;code&gt;incomplete&lt;/code&gt; 상태로 중단되고 잘렸거나 빈 답변을 반환하며, 생성한 thinking 토큰에 대한 비용은 여전히 청구됩니다.&lt;/p&gt;

&lt;p&gt;Google 문서의 세 가지 규칙으로 이를 피할 수 있습니다.&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;기존의 낮은 상한을 제거하세요.&lt;/strong&gt; 앱에 8,192 같은 값이 하드코딩되어 있다면 동기 호출 기본 상한인 65,536으로 올리세요.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;상한이 아니라 level을 낮추세요.&lt;/strong&gt; 비용이나 지연 시간을 줄이려면 &lt;code&gt;max_output_tokens&lt;/code&gt;를 줄이는 대신 &lt;code&gt;medium&lt;/code&gt;이나 &lt;code&gt;low&lt;/code&gt;로 낮추세요.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;긴 작업은 백그라운드로 전환하세요.&lt;/strong&gt; 65,536 토큰을 넘는 답변에는 &lt;code&gt;background&lt;/code&gt;를 &lt;code&gt;true&lt;/code&gt;로 설정하고 &lt;code&gt;max_output_tokens&lt;/code&gt;를 최대 1,048,576에서 입력을 뺀 값으로 올리세요. 입력, thinking, 출력은 하나의 100만 토큰 윈도를 공유합니다. &lt;a href="https://apidog.com/kr/blog/gemini-4-argon-1m-output-tokens?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Argon 장문 출력 가이드&lt;/a&gt;에서 폴링 패턴을 자세히 다룹니다.&lt;/li&gt;
&lt;/ol&gt;

&lt;h2&gt;
  
  
  Apidog CLI로 코딩 에이전트가 네 level을 모두 벤치마크하게 하기
&lt;/h2&gt;

&lt;p&gt;이 루프를 직접 반복해서 돌리는 일은 금방 지루해집니다. 대신 코딩 에이전트(Claude Code, Codex, Cursor)에게 &lt;a href="https://apidog.com/apidog-cli/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog CLI&lt;/a&gt;로 재사용 가능한 테스트 하나를 만들게 하고, 새로운 수치가 필요할 때마다 각 level에서 다시 실행하게 하세요.&lt;/p&gt;

&lt;p&gt;한 번만 설정하세요.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm install -g apidog-cli@latest
apidog login --with-token &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;YOUR_TOKEN&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
npx -y skills add https://apidog.com   &lt;span class="c"&gt;# pick your agent when prompted&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;그런 다음 에이전트에게 프롬프트 하나를 전달하세요.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;In Apidog project &amp;lt;projectId&amp;gt;, create an environment "gemini" with base URL
https://generativelanguage.googleapis.com and variables GEMINI_API_KEY and
THINKING. Add an endpoint for POST /v1beta/interactions that sends the
x-goog-api-key header from GEMINI_API_KEY. Create a test case that sends model
"gemini-4-neon", my audit prompt, generation_config.thinking_level {{THINKING}}
and max_output_tokens 65536, and asserts: HTTP 200, status is "completed",
and usage.total_thought_tokens exists. Run it once per level (low, medium,
high, xhigh) and give me a table of thought tokens and response time.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;에이전트는 각 페이로드 스키마를 읽고, JSON을 검증하고, 리소스를 작성한 뒤 실행을 반복합니다.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;apidog environment create gemini --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;projectId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --base-url https://generativelanguage.googleapis.com
apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file endpoint.json
apidog endpoint create --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;projectId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --file endpoint.json
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;projectId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --file case.json
&lt;span class="k"&gt;for&lt;/span&gt; level &lt;span class="k"&gt;in&lt;/span&gt; low medium high xhigh&lt;span class="o"&gt;;&lt;/span&gt; &lt;span class="k"&gt;do&lt;/span&gt;
  apidog run --test-case &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;caseId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;projectId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -e &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;envId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; \
    --env-var &lt;span class="s2"&gt;"THINKING=$level"&lt;/span&gt; -r cli,json --out-file &lt;span class="s2"&gt;"neon-$level"&lt;/span&gt;
&lt;span class="k"&gt;done&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fcgbvxxx9yec8lx2xko04.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fcgbvxxx9yec8lx2xko04.png" alt="Flow from one agent prompt through apidog environment create, endpoint create, test-case create and four apidog run commands at low, medium, high and xhigh against gemini-4-neon, ending in an empty comparison table for thought tokens and time" width="800" height="450"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;code&gt;status is "completed"&lt;/code&gt; 단언은 이전 섹션의 &lt;code&gt;incomplete&lt;/code&gt; 함정을 잡아내므로, 예산을 다 써버린 level은 빈 문자열을 반환하는 대신 확실하게 실패합니다. &lt;code&gt;-r cli,json&lt;/code&gt;을 &lt;code&gt;-r junit&lt;/code&gt;으로 바꾸면 같은 실행을 CI에 넣을 수 있습니다. &lt;a href="https://apidog.com/kr/blog/apidog-cli-ci-cd-pipeline?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog CLI CI/CD 가이드&lt;/a&gt;에서 파이프라인을 보여주고, &lt;a href="https://apidog.com/kr/blog/apidog-cli-in-claude-code?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog CLI in Claude Code&lt;/a&gt;에서 에이전트 설정을 다룹니다. Apidog의 무료 플랜은 최대 4명의 사용자를 지원합니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQ
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon의 기본 thinking level은 무엇인가요?&lt;/strong&gt; &lt;code&gt;high&lt;/code&gt;입니다. 이를 얻기 위해 &lt;code&gt;thinking_level&lt;/code&gt;을 보낼 필요는 없습니다. Carbon과 Argon의 기본값은 &lt;code&gt;medium&lt;/code&gt;이므로, 이들 모델에서 마이그레이션할 때는 level을 명시적으로 설정하세요.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon은 minimal thinking을 지원하나요?&lt;/strong&gt; 아니요. Neon은 &lt;code&gt;low&lt;/code&gt;, &lt;code&gt;medium&lt;/code&gt;, &lt;code&gt;high&lt;/code&gt;, &lt;code&gt;xhigh&lt;/code&gt;를 지원하며 &lt;code&gt;minimal&lt;/code&gt;은 오류로 거부합니다. 가장 빠르고 저렴한 응답에는 &lt;code&gt;low&lt;/code&gt;를 사용하세요.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon에서 thinking 토큰에 요금이 부과되나요?&lt;/strong&gt; 예. Thinking 토큰은 100만 출력 토큰당 $15.00 요율로 청구됩니다. Google은 모델이 처리하는 모든 토큰을 계산하며, 여기에는 thinking 토큰도 포함됩니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon에서 thinkingBudget을 여전히 사용할 수 있나요?&lt;/strong&gt; Gemini 4 모델에서는 더 이상 지원되지 않습니다. 단독으로 보내면 가장 가까운 &lt;code&gt;thinkingLevel&lt;/code&gt;로 매핑되고 경고를 반환합니다. &lt;code&gt;thinkingLevel&lt;/code&gt;과 함께 보내면 요청이 &lt;code&gt;400&lt;/code&gt;으로 실패합니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;xhigh가 항상 high보다 정확한가요?&lt;/strong&gt; 항상 그렇지는 않습니다. Google에 따르면 &lt;code&gt;xhigh&lt;/code&gt;는 텍스트나 JSON 추출 같은 단순한 프롬프트에서 과도하게 생각하고 &lt;code&gt;max_output_tokens&lt;/code&gt;를 소진할 수 있습니다. 자신의 프롬프트에서 둘 다 테스트하고 통과하는 가장 낮은 level을 유지하세요.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon thinking level을 무료로 사용할 수 있나요?&lt;/strong&gt; 아니요. Gemini 4 Neon은 Gemini API 무료 등급에서 사용할 수 없습니다. Google AI Studio와 Google Antigravity에서는 유료 Google AI Pro 및 Ultra 플랜에 연결되어 있습니다.&lt;/p&gt;

</description>
      <category>ai</category>
      <category>gemini</category>
      <category>google</category>
      <category>llm</category>
    </item>
    <item>
      <title>Gemini 4 Neon 가격 정리: 입력 $3, 출력 $15, 실제 호출 비용은 얼마일까?</title>
      <dc:creator>Rihpig</dc:creator>
      <pubDate>Thu, 19 Nov 2026 03:48:46 +0000</pubDate>
      <link>https://dev.to/rihpig/gemini-4-neon-gagyeog-jeongri-ibryeog-3-culryeog-15-silje-hocul-biyongeun-eolmailgga-3c7h</link>
      <guid>https://dev.to/rihpig/gemini-4-neon-gagyeog-jeongri-ibryeog-3-culryeog-15-silje-hocul-biyongeun-eolmailgga-3c7h</guid>
      <description>&lt;h1&gt;
  
  
  Gemini 4 Neon 가격 완벽 정리: 토큰당 비용, Thinking 레벨, 등급별 요금표
&lt;/h1&gt;

&lt;p&gt;Gemini 4 Neon의 가격은 Gemini API 스탠더드(Standard) 유료 등급 기준으로 입력 토큰 100만 개당 $3, 출력 토큰 100만 개당 $15이며, 100만 토큰 컨텍스트 윈도우 전체에서 동일하게 적용됩니다. Thinking 토큰은 출력 요금으로 청구되고, 캐시된 입력은 100만 개당 $0.15입니다. Batch와 Flex는 모든 요금을 절반으로 낮춰주며, Priority는 $5.40 및 $27입니다. 무료 API 등급은 없습니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;오늘 Apidog를 사용해 보세요&lt;/a&gt;
&lt;/p&gt;



&lt;p&gt;Google은 2026년 11월 18일, 빠른 Hydrogen과 고성능 Carbon 사이에 위치한 Gemini 4 계열의 중간 모델로 Neon을 출시했습니다. 아래에서는 요금표, 실제 호출 비용, thinking 레벨이 청구액에 미치는 영향, 그리고 12월 1일 전후로 Neon이 형제 모델들과 어떻게 비교되는지 살펴봅니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Gemini 4 Neon은 100만 토큰당 얼마인가요?
&lt;/h2&gt;

&lt;p&gt;Gemini 4 Neon(모델 ID &lt;code&gt;gemini-4-neon&lt;/code&gt;)은 Google 가격 페이지에 네 가지 유료 등급으로 등록되어 있습니다. 모든 가격은 100만 토큰당 미화 달러 기준입니다:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;등급&lt;/th&gt;
&lt;th&gt;입력&lt;/th&gt;
&lt;th&gt;출력 (thinking 포함)&lt;/th&gt;
&lt;th&gt;캐시된 입력&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Standard&lt;/td&gt;
&lt;td&gt;$3.00&lt;/td&gt;
&lt;td&gt;$15.00&lt;/td&gt;
&lt;td&gt;$0.15&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Batch&lt;/td&gt;
&lt;td&gt;$1.50&lt;/td&gt;
&lt;td&gt;$7.50&lt;/td&gt;
&lt;td&gt;$0.075&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Flex&lt;/td&gt;
&lt;td&gt;$1.50&lt;/td&gt;
&lt;td&gt;$7.50&lt;/td&gt;
&lt;td&gt;$0.075&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Priority&lt;/td&gt;
&lt;td&gt;$5.40&lt;/td&gt;
&lt;td&gt;$27.00&lt;/td&gt;
&lt;td&gt;$0.27&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;무료 등급&lt;/td&gt;
&lt;td&gt;제공 안 됨&lt;/td&gt;
&lt;td&gt;제공 안 됨&lt;/td&gt;
&lt;td&gt;제공 안 됨&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;가장 중요한 세 가지 세부 사항:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Thinking은 출력입니다.&lt;/strong&gt; 출력 열이 "thinking 토큰 포함"으로 표시되어 있어, 답변에는 보이지 않더라도 Neon이 추론에 사용하는 모든 토큰은 Standard 기준 100만 개당 $15가 청구됩니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;캐싱은 암시적(implicit)으로만 작동합니다.&lt;/strong&gt; Google의 캐시가 반복되는 프롬프트 접두사와 일치할 때 $0.15 요금이 적용되며, 사용자가 직접 캐시 객체를 생성할 수는 없습니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;무료 등급 없음.&lt;/strong&gt; Google 가격 페이지에서는 Neon이 무료 등급에서 사용할 수 없는 것으로 표시되어 있습니다. $0으로 호출할 수 있는 Gemini 4 모델은 Hydrogen입니다(관련 &lt;a href="https://apidog.com/kr/blog/gemini-4-hydrogen-free?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Hydrogen 무료 가이드&lt;/a&gt; 참고).&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fs5ji1az2ppq6ixl26j4w.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fs5ji1az2ppq6ixl26j4w.png" alt="Gemini 4 Neon pricing tiers" width="800" height="429"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  Gemini 4 Neon의 네 가지 등급은 무엇을 의미하나요?
&lt;/h2&gt;

&lt;p&gt;네 가지 등급은 동일한 모델을 서로 다른 속도 보장 조건으로 판매하는 것입니다. Batch는 절반 가격으로 비동기식 결과를 반환하고, Flex는 느린 처리를 감수할 수 있는 트래픽에 절반 가격을 제공하며, Priority는 용량이 부족할 때도 빠른 속도를 유지하기 위해 Standard보다 80% 더 비쌉니다. 마감 기준으로 선택하세요:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;워크로드&lt;/th&gt;
&lt;th&gt;등급&lt;/th&gt;
&lt;th&gt;이유&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;대화형 코딩 어시스턴트, 채팅&lt;/td&gt;
&lt;td&gt;Standard&lt;/td&gt;
&lt;td&gt;사용자가 기다리는 중; $3/$15가 기본 baseline&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;야간 코드 리뷰, 평가 실행, 문서 백필&lt;/td&gt;
&lt;td&gt;Batch&lt;/td&gt;
&lt;td&gt;아무도 기다리지 않음; $1.50/$7.50 지불&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;나중에 재시도할 수 있는 백그라운드 에이전트&lt;/td&gt;
&lt;td&gt;Flex&lt;/td&gt;
&lt;td&gt;동일한 절반 가격, 배치 파일 패키징 불필요&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;가용성 보장이 필요한 고객 대면 에이전트&lt;/td&gt;
&lt;td&gt;Priority&lt;/td&gt;
&lt;td&gt;$5.40/$27로 부하 상황에서도 용량 확보&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Grounding에는 별도의 요금 체계가 있습니다. Standard와 Priority에서 Google Search grounding은 월 5,000건의 무료 검색 요청(Gemini 3 이상 모델에서 공유)을 제공하며, 이후 1,000건당 $14가 청구됩니다. Google Maps grounding도 동일하게 5,000건 무료, 이후 1,000건당 $14 패턴을 따릅니다. Batch나 Flex에는 grounding 가격이 가격 페이지에 기재되어 있지 않습니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Thinking 레벨은 Gemini 4 Neon 청구액을 어떻게 바꾸나요?
&lt;/h2&gt;

&lt;p&gt;Neon은 &lt;code&gt;low&lt;/code&gt;, &lt;code&gt;medium&lt;/code&gt;, &lt;code&gt;high&lt;/code&gt;, &lt;code&gt;xhigh&lt;/code&gt; 네 가지 thinking 레벨을 지원합니다. 레벨은 토큰당 가격을 바꾸지 않고, Neon이 답변하기 전에 소비하는 출력 토큰 수를 바꿉니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://artificialanalysis.ai/models/gemini-4-neon" rel="noopener noreferrer"&gt;Artificial Analysis&lt;/a&gt;는 모든 레벨에서 Intelligence Index를 실행하고 각 실행에 사용된 출력 토큰 수를 공개했습니다. 여기에 Standard 출력 요금인 $15를 곱하면 전체 실행의 출력 비용이 계산됩니다:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Thinking 레벨&lt;/th&gt;
&lt;th&gt;Intelligence Index&lt;/th&gt;
&lt;th&gt;출력 토큰&lt;/th&gt;
&lt;th&gt;$15/1M 기준 출력 비용&lt;/th&gt;
&lt;th&gt;작업당 시간&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;low&lt;/td&gt;
&lt;td&gt;44&lt;/td&gt;
&lt;td&gt;28.3M&lt;/td&gt;
&lt;td&gt;$424.50&lt;/td&gt;
&lt;td&gt;3.7분&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;medium&lt;/td&gt;
&lt;td&gt;55&lt;/td&gt;
&lt;td&gt;62.9M&lt;/td&gt;
&lt;td&gt;$943.50&lt;/td&gt;
&lt;td&gt;8.3분&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;high&lt;/td&gt;
&lt;td&gt;60&lt;/td&gt;
&lt;td&gt;123M&lt;/td&gt;
&lt;td&gt;$1,845&lt;/td&gt;
&lt;td&gt;14.8분&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;xhigh&lt;/td&gt;
&lt;td&gt;61&lt;/td&gt;
&lt;td&gt;283M&lt;/td&gt;
&lt;td&gt;$4,245&lt;/td&gt;
&lt;td&gt;21.5분&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;두 가지가 눈에 띕니다. &lt;code&gt;high&lt;/code&gt;에서 &lt;code&gt;xhigh&lt;/code&gt;로 올라가면 2.3배의 출력 토큰을 지불하고 인덱스 1점을 얻습니다. 그리고 &lt;code&gt;medium&lt;/code&gt;은 약 절반의 토큰으로 &lt;code&gt;high&lt;/code&gt; 점수의 대부분을 제공합니다. Artificial Analysis는 Neon의 대표 비용을 &lt;code&gt;xhigh&lt;/code&gt; 기준 인덱스 작업당 $6.44로 산정했습니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fx5ynvysto4k4pqzful4g.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fx5ynvysto4k4pqzful4g.png" alt="Gemini 4 Neon output tokens by thinking level" width="800" height="429"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;실용적인 규칙: 테스트는 &lt;code&gt;medium&lt;/code&gt;에서 시작하고, &lt;code&gt;medium&lt;/code&gt;에서 실패하는 것을 확인할 수 있을 때만 해당 작업을 &lt;code&gt;high&lt;/code&gt;로 옮기며, &lt;code&gt;xhigh&lt;/code&gt;는 품질 1점 추가가 비용 두 배 이상의 가치가 있는 드문 문제를 위해 아껴두세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  Gemini 4 Neon 호출 한 번은 얼마인가요?
&lt;/h2&gt;

&lt;p&gt;흔한 세 가지 요청 형태를 Standard 기준으로 계산했습니다. 출력 수치에는 thinking 토큰이 포함됩니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;1. 코드 리뷰 호출.&lt;/strong&gt; 입력 20,000토큰(diff + 컨텍스트), 출력 3,000토큰:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;입력: 20,000 × $3 / 1M = $0.060&lt;/li&gt;
&lt;li&gt;출력: 3,000 × $15 / 1M = $0.045&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;총계: 호출당 $0.105&lt;/strong&gt;, Batch 기준 $0.0525&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;이런 호출을 하루 1,000건씩 30일간 실행하면 Standard에서 한 달 $3,150이며, 리뷰가 Batch를 기다릴 수 있다면 $1,575입니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;2. 캐시된 접두사가 있는 에이전트 루프.&lt;/strong&gt; 10턴 동안 매번 동일한 50,000토큰 시스템 프롬프트와 도구 목록, 그리고 신규 입력 5,000토큰과 출력 2,000토큰을 전송:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;접두사 캐시 히트 시: 50,000 × $0.15 / 1M + 5,000 × $3 / 1M + 2,000 × $15 / 1M = 턴당 $0.0525, &lt;strong&gt;루프 전체 $0.53&lt;/strong&gt;
&lt;/li&gt;
&lt;li&gt;캐시 히트 없이: 55,000 × $3 / 1M + 2,000 × $15 / 1M = 턴당 $0.195, &lt;strong&gt;루프 전체 $1.95&lt;/strong&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;캐싱만으로 73%의 차이가 납니다. Neon의 캐싱은 암시적이기 때문에 히트를 강제할 수 없으며, 안정적인 프롬프트 부분을 맨 앞에 두고 턴 간에 바이트 단위로 동일하게 유지해야 히트 확률을 높일 수 있습니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;3. 긴 문서 질의.&lt;/strong&gt; 입력 800,000토큰(대형 코드베이스 또는 계약서 모음), 출력 4,000토큰:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;입력: 800,000 × $3 / 1M = $2.40&lt;/li&gt;
&lt;li&gt;출력: 4,000 × $15 / 1M = $0.06&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;총계: $2.46&lt;/strong&gt;, Batch 기준 $1.23&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;가격 페이지에 Neon의 롱 컨텍스트 할증료는 없으므로, 900,000번째 토큰도 1번째 토큰과 비용이 같습니다. 컨텍스트 윈도우는 입력과 출력이 공유하는 1,048,576토큰이며, 단일 동기 요청은 기본적으로 최대 65,536 출력 토큰을 반환합니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Neon 가격은 Hydrogen, Carbon과 어떻게 비교되나요?
&lt;/h2&gt;

&lt;p&gt;Neon은 토큰당 Hydrogen의 정확히 2배 비용입니다. Carbon 비교는 12월 1일, Carbon의 도입 가격이 종료되면서 뒤집힙니다:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;모델&lt;/th&gt;
&lt;th&gt;입력 / 1M&lt;/th&gt;
&lt;th&gt;출력 / 1M&lt;/th&gt;
&lt;th&gt;코드 리뷰 호출 (입력 20K, 출력 3K)&lt;/th&gt;
&lt;th&gt;무료 등급&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Gemini 4 Hydrogen&lt;/td&gt;
&lt;td&gt;$1.50&lt;/td&gt;
&lt;td&gt;$7.50&lt;/td&gt;
&lt;td&gt;$0.0525&lt;/td&gt;
&lt;td&gt;있음&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Gemini 4 Neon&lt;/td&gt;
&lt;td&gt;$3.00&lt;/td&gt;
&lt;td&gt;$15.00&lt;/td&gt;
&lt;td&gt;$0.105&lt;/td&gt;
&lt;td&gt;없음&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Gemini 4 Carbon, 11월 30일까지&lt;/td&gt;
&lt;td&gt;$2.00&lt;/td&gt;
&lt;td&gt;$10.00&lt;/td&gt;
&lt;td&gt;$0.070&lt;/td&gt;
&lt;td&gt;없음&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Gemini 4 Carbon, 12월 1일부터&lt;/td&gt;
&lt;td&gt;$4.00&lt;/td&gt;
&lt;td&gt;$20.00&lt;/td&gt;
&lt;td&gt;$0.140&lt;/td&gt;
&lt;td&gt;없음&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;향후 11일 동안은 Carbon이 토큰당 Neon보다 저렴합니다. 오늘 Carbon의 $2/$10 위에 구축한다면 12월의 $4/$20을 예산에 반영하세요. &lt;a href="https://apidog.com/kr/blog/gemini-4-carbon-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Carbon 가격 분석&lt;/a&gt;에서 이 변경 사항을 자세히 다룹니다.&lt;/p&gt;

&lt;p&gt;12월 1일부터 Neon은 중간에 위치합니다: Carbon보다 25% 저렴, 토큰당 Hydrogen의 2배. 작업당 비용 격차는 thinking 토큰에 따라 달라지므로, 요금표를 비교하기보다 자신의 프롬프트에서 요청당 비용을 직접 측정하세요.&lt;/p&gt;

&lt;p&gt;난이도별 라우팅: 대량의 일상적 호출에는 &lt;a href="https://apidog.com/kr/blog/gemini-4-hydrogen-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Hydrogen&lt;/a&gt;, 자주 실행하는 복잡한 코딩과 분석에는 Neon, 가장 어려운 단일 문제에는 &lt;a href="https://apidog.com/kr/blog/what-is-gemini-4-carbon?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Carbon&lt;/a&gt;을 사용하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  Gemini 4 Neon 청구액을 줄이는 방법
&lt;/h2&gt;

&lt;p&gt;통상 이 순서대로 효과가 큰 다섯 가지 방법입니다:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Thinking 레벨을 낮추세요.&lt;/strong&gt; Artificial Analysis 실행에서 &lt;code&gt;medium&lt;/code&gt;은 &lt;code&gt;high&lt;/code&gt;의 약 절반 출력 토큰을 사용합니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;기다릴 수 있는 작업은 Batch나 Flex로 보내세요.&lt;/strong&gt; 실시간으로 읽히지 않는 모든 것은 절반 비용입니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;암시적 캐싱에 맞게 프롬프트를 설계하세요.&lt;/strong&gt; 시스템 프롬프트와 도구 정의를 맨 위에 그대로 유지하면, 반복되는 접두사가 $3 대신 $0.15로 청구됩니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;출력을 제한하세요.&lt;/strong&gt; 작업에 맞는 최대 출력 토큰 수를 설정하세요.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;쉬운 호출은 Hydrogen으로 라우팅하세요.&lt;/strong&gt; Neon은 꼭 필요한 작업에만 사용하세요.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;처리량을 계획하기 전에 자신의 등급에 맞는 &lt;a href="https://aistudio.google.com/docs/rate-limits" rel="noopener noreferrer"&gt;Gemini API 요청 한도 페이지&lt;/a&gt;를 확인하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  Apidog CLI로 실제 Gemini 4 Neon 비용 측정하기
&lt;/h2&gt;

&lt;p&gt;Google Interactions API의 모든 응답에는 입력, 캐시, thought, 출력 토큰 수가 담긴 &lt;code&gt;usage&lt;/code&gt; 객체가 포함됩니다. 이 블록에 위의 요금표를 곱하면 요청당 실제 비용이 됩니다. 각 thinking 레벨에서 동일한 프롬프트를 실행하고 비교하는 것은 반복적인 작업이므로, 코딩 에이전트에게 맡기세요.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/apidog-cli/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog CLI&lt;/a&gt;는 Claude Code, Codex, Cursor, OpenCode에 API 테스트를 생성하고 실행할 수 있는 커맨드라인 방법을 제공합니다. 한 번만 설정하세요:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm install -g apidog-cli@latest
apidog login --with-token &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;YOUR_TOKEN&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
npx -y skills add https://apidog.com   &lt;span class="c"&gt;# pick your agent when prompted&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;그리고 에이전트에 프롬프트 하나를 주세요:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;In Apidog project &amp;lt;id&amp;gt;, create an environment for the Gemini API with
GEMINI_API_KEY and THINKING_LEVEL variables. Add a test case for
POST /v1beta/interactions with model gemini-4-neon and
generation_config.thinking_level set from THINKING_LEVEL. Send our code review
prompt, assert HTTP 200 and non-empty output, and save usage.total_input_tokens,
total_cached_tokens, total_thought_tokens and total_output_tokens. Run it at
low, medium and high, then compute the Standard cost of each run at $3 input,
$0.15 cached and $15 per 1M for thought and output tokens.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;에이전트는 환경을 생성하고, 테스트 케이스 페이로드를 스키마와 대조한 뒤, 레벨별로 한 번씩 실행합니다:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;apidog environment create gemini-api --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --base-url https://generativelanguage.googleapis.com
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --file case.json
apidog run --test-case &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;caseId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -e &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;envId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --env-var &lt;span class="s2"&gt;"THINKING_LEVEL=low"&lt;/span&gt; -r cli,json
apidog run --test-case &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;caseId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -e &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;envId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --env-var &lt;span class="s2"&gt;"THINKING_LEVEL=medium"&lt;/span&gt; -r cli,json
apidog run --test-case &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;caseId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -e &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;envId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --env-var &lt;span class="s2"&gt;"THINKING_LEVEL=high"&lt;/span&gt; -r cli,json
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;JSON 리포트는 에이전트가 가격을 계산할 토큰 수를 제공하므로, 자신의 프롬프트에 대한 레벨별 비용 테이블을 얻게 됩니다. thinking 토큰을 두 배로 늘리는 프롬프트 변경을 잡아내려면 &lt;a href="https://apidog.com/kr/blog/apidog-cli-ci-cd-pipeline?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog CLI CI/CD 가이드&lt;/a&gt;를 참고해 CI에 &lt;code&gt;apidog run ... -r junit&lt;/code&gt;을 추가하거나, &lt;a href="https://apidog.com/kr/blog/apidog-cli-in-claude-code?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Code에서의 Apidog CLI&lt;/a&gt;부터 시작하세요. Apidog의 무료 플랜은 최대 4명의 사용자를 지원합니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQ
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon은 무료인가요?&lt;/strong&gt; API를 통해서는 아닙니다. Google 가격 페이지에서 Neon은 무료 등급에서 사용할 수 없는 것으로 표시되어 있어, 유료 Gemini API 프로젝트가 필요합니다. 무료 등급이 있는 Gemini 4 모델은 Hydrogen입니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Thinking 토큰은 별도로 청구되나요?&lt;/strong&gt; 아닙니다. 출력 토큰으로 청구되며, Standard 기준 100만 개당 $15입니다. Interactions API의 &lt;code&gt;usage&lt;/code&gt; 객체는 이를 &lt;code&gt;total_thought_tokens&lt;/code&gt;로 보고하므로, 각 청구액 중 추론이 차지하는 비중을 확인할 수 있습니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon은 200K 토큰을 넘으면 더 비싸지나요?&lt;/strong&gt; 아닙니다. 가격 페이지에는 전체 1,048,576토큰 윈도우에 걸쳐 Neon에 대해 하나의 입력 요금과 하나의 출력 요금만 표시되어 있으며, 롱 컨텍스트 등급은 없습니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Batch는 얼마나 저렴한가요?&lt;/strong&gt; 정확히 절반입니다: 입력 100만 개당 $1.50, 출력 100만 개당 $7.50, 캐시된 입력은 $0.075. Flex도 동일한 요금입니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Neon이 Carbon보다 저렴한가요?&lt;/strong&gt; 12월 1일까지는 아닙니다. Carbon의 도입 가격 $2/$10은 11월 30일까지 유지되며, 이후 $4/$20으로 인상되어 Neon의 $3/$15가 토큰당 약 25% 낮은 수준이 됩니다.&lt;/p&gt;

</description>
    </item>
    <item>
      <title>Gemini 4 Neon 무료로 사용하는 방법</title>
      <dc:creator>Rihpig</dc:creator>
      <pubDate>Thu, 19 Nov 2026 03:48:19 +0000</pubDate>
      <link>https://dev.to/rihpig/gemini-4-neon-muryoro-sayonghaneun-bangbeob-28oi</link>
      <guid>https://dev.to/rihpig/gemini-4-neon-muryoro-sayonghaneun-bangbeob-28oi</guid>
      <description>&lt;h1&gt;
  
  
  Gemini 4 Neon 무료로 사용하는 3가지 방법 (2026년 11월 기준)
&lt;/h1&gt;

&lt;p&gt;Gemini 4 Neon은 API에서 무료가 아닙니다. Google은 &lt;code&gt;gemini-4-neon&lt;/code&gt;을 유료 티어 전용으로 명시하고 있으며, 입력 토큰 100만 개당 $3, 출력 토큰 100만 개당 $15의 요금이 부과됩니다. 그래도 $0으로 사용할 수 있는 방법은 세 가지입니다. Google AI Pro 무료 체험, 학생 제공 혜택, 또는 무료 Gemini 4 Hydrogen 티어에서 개발한 뒤 나중에 모델 문자열만 교체하는 방법입니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;지금 Apidog를 사용해 보세요&lt;/a&gt;
&lt;/p&gt;

&lt;p&gt;Neon은 2026년 11월 18일에 정식 출시(GA)되었습니다. 아래에서 각 $0 방법과 주의 사항, 그리고 요금을 최소화하는 방법을 확인하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  Gemini 4 Neon은 무료인가요?
&lt;/h2&gt;

&lt;p&gt;Gemini 4 Neon에는 무료 API 티어가 없습니다. Google의 &lt;a href="https://aistudio.google.com/docs/pricing#gemini-4-neon" rel="noopener noreferrer"&gt;가격 페이지&lt;/a&gt;에는 "Gemini 4 Neon은 Free 티어에서 사용할 수 없습니다"라고 명확히 나와 있습니다. 모든 토큰에 요금이 청구되며, thinking 토큰도 포함됩니다. 무료 사용은 Google AI Pro 또는 Ultra 플랜을 통해서만 가능하며, 체험이나 학생 제공 혜택으로 무료로 이용할 수 있습니다.&lt;/p&gt;

&lt;p&gt;Google이 공개한 내용은 다음과 같습니다:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;항목&lt;/th&gt;
&lt;th&gt;무료 티어&lt;/th&gt;
&lt;th&gt;유료 티어 (표준)&lt;/th&gt;
&lt;th&gt;출처&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;모델 ID&lt;/td&gt;
&lt;td&gt;사용 불가&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;gemini-4-neon&lt;/code&gt; (stable)&lt;/td&gt;
&lt;td&gt;모델 페이지&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;입력 가격&lt;/td&gt;
&lt;td&gt;사용 불가&lt;/td&gt;
&lt;td&gt;$3.00 / 100만 토큰&lt;/td&gt;
&lt;td&gt;가격 페이지&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;출력 가격 (thinking 포함)&lt;/td&gt;
&lt;td&gt;사용 불가&lt;/td&gt;
&lt;td&gt;$15.00 / 100만 토큰&lt;/td&gt;
&lt;td&gt;가격 페이지&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;캐시된 입력 (암시적만 해당)&lt;/td&gt;
&lt;td&gt;사용 불가&lt;/td&gt;
&lt;td&gt;$0.15 / 100만 토큰&lt;/td&gt;
&lt;td&gt;가격 페이지&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Batch 및 Flex&lt;/td&gt;
&lt;td&gt;사용 불가&lt;/td&gt;
&lt;td&gt;입력 $1.50 / 출력 $7.50&lt;/td&gt;
&lt;td&gt;가격 페이지&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Google Search 기반 그라운딩&lt;/td&gt;
&lt;td&gt;사용 불가&lt;/td&gt;
&lt;td&gt;월 5,000건 무료, 이후 1,000건당 $14&lt;/td&gt;
&lt;td&gt;가격 페이지&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;컨텍스트 윈도우&lt;/td&gt;
&lt;td&gt;입력, thinking, 출력이 공유하는 1,048,576 토큰&lt;/td&gt;
&lt;td&gt;동일&lt;/td&gt;
&lt;td&gt;모델 페이지&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Thinking 레벨&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;low&lt;/code&gt;, &lt;code&gt;medium&lt;/code&gt;, &lt;code&gt;high&lt;/code&gt; (기본값), &lt;code&gt;xhigh&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;동일&lt;/td&gt;
&lt;td&gt;새 소식 페이지&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Neon은 Carbon과 달리 도입 할인 가격이 없으며, 표준 요금은 Hydrogen의 정확히 2배입니다. 전체 내용은 Google의 &lt;a href="https://blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-neon/" rel="noopener noreferrer"&gt;출시 블로그 글&lt;/a&gt;에서 확인할 수 있습니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Gemini 4 Neon을 무료로 사용하는 모든 방법
&lt;/h2&gt;

&lt;p&gt;현재 $0으로 이용할 수 있는 방법은 세 가지입니다. 두 가지는 Neon을 직접 사용할 수 있게 해주고, 세 번째는 Neon에 맞춰 코드를 미리 준비해 줍니다.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;방법&lt;/th&gt;
&lt;th&gt;비용&lt;/th&gt;
&lt;th&gt;제공되는 것&lt;/th&gt;
&lt;th&gt;카드 필요 여부&lt;/th&gt;
&lt;th&gt;API로 Neon 사용?&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Google AI Pro 무료 체험&lt;/td&gt;
&lt;td&gt;혜택 기간 동안 $0&lt;/td&gt;
&lt;td&gt;Gemini 앱과 Google AI Studio에서 Neon 사용&lt;/td&gt;
&lt;td&gt;필요&lt;/td&gt;
&lt;td&gt;불가&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;학생 제공 혜택&lt;/td&gt;
&lt;td&gt;국가별로 $0 또는 할인&lt;/td&gt;
&lt;td&gt;혜택 기간 동안 Pro와 동일&lt;/td&gt;
&lt;td&gt;필요 (결제 프로필)&lt;/td&gt;
&lt;td&gt;불가&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Gemini 4 Hydrogen 무료 티어&lt;/td&gt;
&lt;td&gt;$0, 요율 제한 있음&lt;/td&gt;
&lt;td&gt;Hydrogen, Neon과 동일한 요청 스키마&lt;/td&gt;
&lt;td&gt;언급 없음&lt;/td&gt;
&lt;td&gt;불가, 나중에 교체&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fp8f35oerzhdabmizmnd5.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fp8f35oerzhdabmizmnd5.png" alt="Decision diagram of the three $0 routes to Gemini 4 Neon" width="799" height="407"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h3&gt;
  
  
  방법 1: Google AI Pro 무료 체험
&lt;/h3&gt;

&lt;p&gt;Google AI Pro(미국 기준 월 $19.99)에는 Neon이 포함되어 있습니다. &lt;a href="https://one.google.com/about/google-ai-plans/" rel="noopener noreferrer"&gt;Google AI 플랜 페이지&lt;/a&gt;에는 "Gemini 앱에서 더 깊이 있는 분석을 위한 Gemini 4 Neon 액세스"와 "Gemini 4 Neon 모델로 프로토타입, 실험, 개발을 할 수 있는 확장된 한도의 AI Studio"가 명시되어 있습니다. 같은 페이지의 FAQ에는 AI 혜택이 "체험을 시작하거나 구독 중일 때" 적용된다고 나와 있습니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://one.google.com/offer/freetrial?hl=en-US" rel="noopener noreferrer"&gt;Google One 제공 약관&lt;/a&gt;(2026년 11월 17일 업데이트)에 따른 주의 사항은 다음과 같습니다:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;결제 수단이 필요합니다.&lt;/strong&gt; 가입 시 "적합한 결제 수단이 등록된 Google Payments 계정"이 필요합니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;자동 갱신됩니다.&lt;/strong&gt; 혜택 기간이 끝나기 전에 해지하지 않으면 표준 가격으로 청구됩니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;한도가 다를 수 있습니다.&lt;/strong&gt; 체험 사용자는 "유료 플랜의 Google One 회원과 다른 사용량 한도를 경험할 수 있습니다."&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;신규 사용자 전용입니다.&lt;/strong&gt; 기간은 페이지에 고정되어 있지 않으며, 혜택 등록 후에 종료일을 확인할 수 있습니다.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;사용 방법: 체험을 시작한 뒤 &lt;a href="https://gemini.google.com" rel="noopener noreferrer"&gt;Gemini 앱&lt;/a&gt;을 열고 모델 드롭다운에서 Gemini 4 Neon을 선택하세요. 프롬프트 테스트를 하려면 &lt;a href="https://aistudio.google.com/prompts/new_chat?model=gemini-4-neon" rel="noopener noreferrer"&gt;AI Studio에서 Neon&lt;/a&gt;을 여세요. Google의 출시 블로그 글에 따르면 "모든 Pro 및 Ultra 구독자는 AI Studio에서 사용해 볼 수 있습니다."&lt;/p&gt;

&lt;h3&gt;
  
  
  방법 2: 학생 제공 혜택
&lt;/h3&gt;

&lt;p&gt;플랜 페이지의 미국 버전에서는 Google 배너에 "학생은 1년 동안 Google AI Pro를 무료로 이용할 수 있습니다"라고 표시됩니다. 이 혜택은 국가별로 다릅니다. 다른 지역에서 불러온 학생 페이지에서는 Google AI Plus 12개월 무료와 Pro 74% 할인이 표시되었으므로, Neon을 중심으로 계획을 세우기 전에 자신의 국가에서 제공되는 혜택을 확인하세요.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://one.google.com/offer/freetrial?hl=en-US" rel="noopener noreferrer"&gt;학생 제공 혜택 약관&lt;/a&gt;에 따르면 인증된 고등교육 기관의 재학(풀타임), 매년 재확인되는 SheerID 인증, 유효한 결제 프로필이 있는 Google 계정이 필요합니다. 학교에서 발급한 Workspace for Education 계정은 해당되지 않습니다.&lt;/p&gt;

&lt;h3&gt;
  
  
  방법 3: Gemini 4 Hydrogen으로 무료 개발 후 나중에 Neon으로 전환
&lt;/h3&gt;

&lt;p&gt;Hydrogen의 입력, 출력, 캐싱은 Gemini API 무료 티어에서 "무료"이며, Google은 Carbon, Neon, Hydrogen이 "동일한 요청 스키마, 컨텍스트 윈도우, 도구를 공유한다"고 밝혔습니다. 무료 Hydrogen 키로 개발한 뒤, 유료로 전환할 준비가 되면 문자열 하나만 바꾸면 됩니다. 해당 티어의 한도와 주의 사항은 &lt;a href="https://apidog.com/kr/blog/gemini-4-hydrogen-free?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Hydrogen 무료&lt;/a&gt; 가이드에서 확인하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  무료 방법이 아닌 것들
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Gemini API에서의 Neon.&lt;/strong&gt; &lt;a href="https://aistudio.google.com/docs/whats-new-gemini-4-neon" rel="noopener noreferrer"&gt;Gemini 4 Neon의 새 소식&lt;/a&gt; 페이지는 "유료 티어 프로젝트를 사용하라"고 안내합니다. Pro 구독은 AI Studio 플레이그라운드 한도를 넓혀주지만, 무료 API 키를 Neon 키로 바꿔주지는 않습니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;체험 중 Google Antigravity에서의 Neon.&lt;/strong&gt; 출시 블로그 글과 &lt;a href="https://antigravity.google/blog/gemini-4-neon-in-google-antigravity" rel="noopener noreferrer"&gt;Antigravity 블로그&lt;/a&gt; 모두 &lt;em&gt;유료&lt;/em&gt; Google AI Pro 및 Ultra 구독자라고 명시하고 있습니다. 이 표현은 체험을 배제하며, 무료 학생 플랜이 해당되는지는 확인할 수 없었습니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;무료 Gemini 앱 플랜 또는 Google AI Plus.&lt;/strong&gt; Google은 Neon에 대해 Pro와 Ultra만 언급하며, Plus는 Hydrogen을 제공합니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Google Cloud 체험 크레딧.&lt;/strong&gt; Google의 Cloud 문서에 따르면 Neon은 "선택된 지역의 검증된 엔터프라이즈 고객"에게만 제공되므로, 새로 만든 체험 계정으로는 확실한 경로가 아닙니다.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Gemini 4 Neon 무료 체험 vs API 유료 사용
&lt;/h2&gt;

&lt;p&gt;체험으로는 채팅 창과 플레이그라운드를 얻을 수 있습니다. 자신의 앱에 Neon을 넣는 것은 토큰당 유료입니다. 입력 20,000 토큰, 출력 4,000 토큰으로 호출하는 경우를 보겠습니다:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;옵션&lt;/th&gt;
&lt;th&gt;호출당 비용&lt;/th&gt;
&lt;th&gt;1,000회 호출&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Neon, 표준&lt;/td&gt;
&lt;td&gt;$0.06 + $0.06 = $0.12&lt;/td&gt;
&lt;td&gt;$120&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Neon, Batch 또는 Flex&lt;/td&gt;
&lt;td&gt;$0.03 + $0.03 = $0.06&lt;/td&gt;
&lt;td&gt;$60&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Hydrogen, 유료 표준&lt;/td&gt;
&lt;td&gt;$0.03 + $0.03 = $0.06&lt;/td&gt;
&lt;td&gt;$60&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Hydrogen, 무료 티어&lt;/td&gt;
&lt;td&gt;$0&lt;/td&gt;
&lt;td&gt;$0 (요율 한도 내)&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fxhoevez4jxnm0f44cwq6.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fxhoevez4jxnm0f44cwq6.png" alt="Bar chart comparing the cost of 1,000 calls" width="800" height="416"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;thinking 토큰은 출력으로 청구되므로 &lt;code&gt;xhigh&lt;/code&gt;는 더 많은 비용이 듭니다. &lt;a href="https://apidog.com/kr/blog/gemini-4-hydrogen-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Hydrogen 가격&lt;/a&gt; 분석과 &lt;a href="https://apidog.com/kr/blog/gemini-4-carbon-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Carbon 가격&lt;/a&gt;도 참고하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  Gemini 4 Neon vs Hydrogen: 무료 모델로 충분한 경우
&lt;/h2&gt;

&lt;p&gt;Google의 모델 가이드는 Hydrogen을 "일상적인 코딩과 에이전트 워크플로우의 기본값"으로 유지하고, Neon은 다중 파일 코딩, 집중적인 지식 작업, 과학 워크플로우로 방향을 잡습니다.&lt;/p&gt;

&lt;p&gt;따라서 모든 단계를 먼저 Hydrogen에서 실행하고, Hydrogen이 품질 기준에 미치지 못할 때만 해당 단계를 Neon으로 옮기세요. 그 단계는 비용이 두 배가 되기 때문입니다. Gemini Managed Agents는 하나의 워크플로우에서 두 모델을 함께 사용할 수 있으며, &lt;a href="https://apidog.com/kr/blog/gemini-4-hydrogen-orchestrator?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Hydrogen Orchestrator&lt;/a&gt; 가이드에서 플래너-실행자 패턴을 보여줍니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  전환은 문자열 하나로 유지하기
&lt;/h2&gt;

&lt;p&gt;모델 이름을 환경 변수에서 읽어오세요. 오늘은 무료 키로 Hydrogen, 나중에는 유료 프로젝트로 Neon을 사용할 수 있습니다:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nv"&gt;MODEL&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"${GEMINI_MODEL:-gemini-4-hydrogen}"&lt;/span&gt;   &lt;span class="c"&gt;# set GEMINI_MODEL=gemini-4-neon on a paid key&lt;/span&gt;
&lt;span class="k"&gt;for&lt;/span&gt; attempt &lt;span class="k"&gt;in&lt;/span&gt; 1 2 3 4 5&lt;span class="o"&gt;;&lt;/span&gt; &lt;span class="k"&gt;do&lt;/span&gt;
  &lt;span class="nv"&gt;code&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="nv"&gt;$(&lt;/span&gt;curl -s -o out.json -w &lt;span class="s2"&gt;"%{http_code}"&lt;/span&gt; \
    &lt;span class="s2"&gt;"https://generativelanguage.googleapis.com/v1beta/models/${MODEL}:generateContent"&lt;/span&gt; \
    -H &lt;span class="s2"&gt;"x-goog-api-key: $GEMINI_API_KEY"&lt;/span&gt; -H &lt;span class="s2"&gt;"Content-Type: application/json"&lt;/span&gt; \
    -d &lt;span class="s1"&gt;'{"contents":[{"parts":[{"text":"Review this diff for bugs."}]}],
         "generationConfig":{"thinkingConfig":{"thinkingLevel":"medium"}}}'&lt;/span&gt;&lt;span class="o"&gt;)&lt;/span&gt;
  &lt;span class="o"&gt;[&lt;/span&gt; &lt;span class="s2"&gt;"$code"&lt;/span&gt; != &lt;span class="s2"&gt;"429"&lt;/span&gt; &lt;span class="o"&gt;]&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nb"&gt;break&lt;/span&gt;
  sleep &lt;span class="nv"&gt;$(&lt;/span&gt;&lt;span class="o"&gt;(&lt;/span&gt;2 ** attempt&lt;span class="o"&gt;)&lt;/span&gt;&lt;span class="o"&gt;)&lt;/span&gt;   &lt;span class="c"&gt;# 2, 4, 8, 16, 32 seconds&lt;/span&gt;
&lt;span class="k"&gt;done&lt;/span&gt;
&lt;span class="nb"&gt;echo&lt;/span&gt; &lt;span class="s2"&gt;"HTTP $code"&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;전환하기 전에 Neon의 세 가지 특성을 유의하세요:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;기본 thinking은 &lt;code&gt;high&lt;/code&gt;입니다.&lt;/strong&gt; 깊이가 필요 없을 때는 &lt;code&gt;medium&lt;/code&gt; 또는 &lt;code&gt;low&lt;/code&gt;로 설정하세요.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;타임아웃을 늘리세요.&lt;/strong&gt; Google은 어려운 프롬프트에 최소 15분 또는 백그라운드 실행을 권장합니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;암시적 캐싱만 지원합니다.&lt;/strong&gt; 긴 프롬프트 접두사를 반복해서 $0.15의 캐시 요율을 받으세요.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;위 재시도 루프는 무료 티어의 HTTP 429를 처리합니다. 상태 코드에 대해서는 &lt;a href="https://apidog.com/kr/blog/status-code-429-too-many-requests?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;HTTP 429 Too Many Requests&lt;/a&gt;를 참고하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  Apidog CLI로 코딩 에이전트에게 테스트 맡기기
&lt;/h2&gt;

&lt;p&gt;전환이 안전하려면 하나의 테스트가 두 모델 모두에서 통과해야 합니다. 코딩 에이전트에게 한 번 만들게 하세요. &lt;a href="https://apidog.com/apidog-cli/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog CLI&lt;/a&gt;는 Claude Code, Codex 또는 Cursor에 명령어를 제공하며, &lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;의 Free 플랜은 최대 4명의 사용자까지 무료입니다.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm install -g apidog-cli@latest
apidog login --with-token &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;YOUR_TOKEN&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
npx -y skills add https://apidog.com   &lt;span class="c"&gt;# pick your agent when prompted&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;그다음 에이전트에게 프롬프트 하나를 주세요:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;In Apidog project &amp;lt;id&amp;gt;, create an environment "gemini" with base URL
https://generativelanguage.googleapis.com/v1beta and a MODEL variable.
Add a test case for POST /models/{{MODEL}}:generateContent using the key in
{{GEMINI_API_KEY}} and thinkingLevel "medium". Assert HTTP 200, a non-empty
candidates array and a usageMetadata object. Run it with MODEL=gemini-4-hydrogen,
2 seconds between requests, and summarize any failures, including 429s.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;에이전트는 환경을 만들고, 스키마를 읽고, 페이로드를 검증하고, 케이스를 작성한 뒤 실행합니다:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;apidog environment create gemini --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; \
  --base-url https://generativelanguage.googleapis.com/v1beta
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --file case.json
apidog run --test-case &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;caseId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -e &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;envId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; \
  --env-var &lt;span class="s2"&gt;"GEMINI_API_KEY=$GEMINI_API_KEY"&lt;/span&gt; --env-var &lt;span class="s2"&gt;"MODEL=gemini-4-hydrogen"&lt;/span&gt; \
  --delay-request 2000 -r cli,json
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;유료 키에서는 &lt;code&gt;--env-var "MODEL=gemini-4-neon"&lt;/code&gt;으로 다시 실행하고 보고서를 비교하세요. &lt;code&gt;--env-var&lt;/code&gt;는 키가 프로젝트에 저장되지 않게 하고, &lt;code&gt;--delay-request&lt;/code&gt;(밀리초)는 분당 한도를 넘지 않게 해줍니다. 에이전트 설정은 &lt;a href="https://apidog.com/kr/blog/apidog-cli-in-claude-code?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Code에서 Apidog CLI&lt;/a&gt; 가이드를, 푸시마다 동일한 케이스를 실행하는 방법은 &lt;a href="https://apidog.com/kr/blog/apidog-cli-ci-cd-pipeline?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;CI/CD에서 Apidog CLI&lt;/a&gt;를 참고하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQ
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon은 무료인가요?&lt;/strong&gt; API에서는 아닙니다. Google은 이를 유료 티어 전용으로 명시하며, 토큰 100만 개당 $3/$15입니다. Google AI Pro 체험이나 해당되는 학생 제공 혜택을 통해 Gemini 앱과 AI Studio에서는 $0으로 사용할 수 있습니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Google AI Studio에 Gemini 4 Neon 무료 티어가 있나요?&lt;/strong&gt; Neon을 지원하는 무료 티어 API 키는 없습니다. Google AI Pro와 Ultra 구독자는 AI Studio 플레이그라운드에서 사용해 볼 수 있으며, Google의 플랜 FAQ에 따르면 AI 혜택은 체험 기간에도 적용됩니다. API 호출은 유료 티어 프로젝트에 청구됩니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon 무료 체험에 신용카드가 필요한가요?&lt;/strong&gt; 네. Google의 제공 약관은 가입 시 적합한 결제 수단을 요구하며, 혜택 기간이 끝나기 전에 해지하지 않으면 플랜이 표준 가격으로 갱신됩니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Antigravity에서 Gemini 4 Neon을 무료로 사용할 수 있나요?&lt;/strong&gt; Google은 Antigravity에서의 Neon을 유료 Google AI Pro 및 Ultra 구독자로 제한하므로, 체험으로는 사용할 수 없습니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Neon API를 호출하는 가장 저렴한 방법은 무엇인가요?&lt;/strong&gt; 토큰 100만 개당 입력 $1.50, 출력 $7.50인 Batch 또는 Flex 추론으로, 표준 요금의 절반입니다. 간단한 단계는 무료 티어에서 계속 무료인 Hydrogen으로 라우팅하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  무료로 시작하고, Neon이 값을 하는 곳에만 지불하기
&lt;/h2&gt;

&lt;p&gt;Gemini 4 Neon에는 무료 API 티어가 없지만, 시작하기 위해 꼭 필요한 것은 아닙니다. Pro 체험으로 사용해 보고, 무료 Hydrogen 키로 개발하며, 전환이 제대로 작동함을 증명하는 테스트 하나를 유지하세요. 어떤 단계가 정말 Neon을 필요로 할 때, 변수 하나만 바꿔 그 단계에만 비용을 지불하면 됩니다.&lt;/p&gt;

</description>
    </item>
    <item>
      <title>Gemini 4 Neon vs Carbon vs Hydrogen: 어떤 모델을 사용해야 할까?</title>
      <dc:creator>Rihpig</dc:creator>
      <pubDate>Thu, 19 Nov 2026 03:16:18 +0000</pubDate>
      <link>https://dev.to/rihpig/gemini-4-neon-vs-carbon-vs-hydrogen-eoddeon-modeleul-sayonghaeya-halgga-3i2</link>
      <guid>https://dev.to/rihpig/gemini-4-neon-vs-carbon-vs-hydrogen-eoddeon-modeleul-sayonghaeya-halgga-3i2</guid>
      <description>&lt;p&gt;이제 Gemini API를 사용하는 모든 팀에게 Gemini 4 Neon vs Carbon은 실질적인 선택지가 되었습니다. Google은 2026년 11월에 Hydrogen과 Carbon 사이에 위치한 중간급 모델인 Neon을 추가했으며, 세 모델은 하나의 요청 스키마, 1M 토큰 컨텍스트 윈도우, 동일한 내장 도구를 공유합니다. 이들을 구분하는 것은 얼마나 깊게 사고하는지, 얼마나 빨리 작업을 마치는지, 그리고 토큰당 비용이 얼마인지입니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;지금 Apidog를 사용해 보세요&lt;/a&gt;
&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;빠른 답변:&lt;/strong&gt; 일상적인 코딩과 에이전트 작업에는 &lt;strong&gt;Gemini 4 Hydrogen&lt;/strong&gt;(100만 토큰당 입력 $1.50 / 출력 $7.50, 무료 티어 제공)을 기본으로 사용하세요. 작업이 복잡하고 자주 실행된다면, 예를 들어 멀티 파일 리팩토링이나 방대한 문서 분석 같은 경우 &lt;strong&gt;Gemini 4 Neon&lt;/strong&gt;($3 / $15, 유료 티어 전용)으로 옮기세요. &lt;strong&gt;Gemini 4 Carbon&lt;/strong&gt;($2 / $10, 2026년 11월 30일까지, 이후 $4 / $20)은 가장 어려운 아키텍처, 디버깅, 보안 문제를 위해 아껴두세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  Gemini 4 Neon vs Carbon vs Hydrogen 한눈에 비교
&lt;/h2&gt;

&lt;p&gt;Gemini 4 Neon은 Google의 중간급 Gemini 4 모델로, 높은 빈도로 실행하는 복잡한 소프트웨어 엔지니어링, 지식 노동, 과학 작업을 위해 만들어졌습니다. Hydrogen보다 더 깊게 추론하고, Carbon보다 적은 출력 토큰으로 더 빨리 작업을 마치며, 유료 티어에서 100만 입력 토큰당 $3, 100만 출력 토큰당 $15의 비용이 듭니다.&lt;/p&gt;

&lt;p&gt;다음은 Google의 &lt;a href="https://aistudio.google.com/docs/choosing-a-model" rel="noopener noreferrer"&gt;모델 선택 가이드&lt;/a&gt;와 &lt;a href="https://aistudio.google.com/docs/pricing" rel="noopener noreferrer"&gt;Gemini API 가격 페이지&lt;/a&gt;(2026년 11월 19일 기준 확인)에서 가져온 나란히 비교한 표입니다:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;&lt;/th&gt;
&lt;th&gt;Gemini 4 Hydrogen&lt;/th&gt;
&lt;th&gt;Gemini 4 Neon&lt;/th&gt;
&lt;th&gt;Gemini 4 Carbon&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;모델 ID&lt;/td&gt;
&lt;td&gt;&lt;code&gt;gemini-4-hydrogen&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;gemini-4-neon&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;gemini-4-carbon&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;포지셔닝&lt;/td&gt;
&lt;td&gt;빠른 기본 모델&lt;/td&gt;
&lt;td&gt;복잡하고 빈번한 작업&lt;/td&gt;
&lt;td&gt;가장 강력한 추론&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;속도 (Google 표기)&lt;/td&gt;
&lt;td&gt;빠름&lt;/td&gt;
&lt;td&gt;보통&lt;/td&gt;
&lt;td&gt;신중함&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;100만 토큰당 입력 / 출력&lt;/td&gt;
&lt;td&gt;$1.50 / $7.50&lt;/td&gt;
&lt;td&gt;$3.00 / $15.00&lt;/td&gt;
&lt;td&gt;11월 30일까지 $2.00 / $10.00, 이후 $4.00 / $20.00&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;캐시된 입력 100만 토큰당&lt;/td&gt;
&lt;td&gt;$0.075&lt;/td&gt;
&lt;td&gt;$0.15&lt;/td&gt;
&lt;td&gt;$0.10, 이후 $0.20&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;사고 수준&lt;/td&gt;
&lt;td&gt;low, medium, high(기본값), xhigh&lt;/td&gt;
&lt;td&gt;low, medium, high(기본값), xhigh&lt;/td&gt;
&lt;td&gt;low, medium(기본값), high&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;무료 API 티어&lt;/td&gt;
&lt;td&gt;있음&lt;/td&gt;
&lt;td&gt;없음&lt;/td&gt;
&lt;td&gt;없음&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;컨텍스트 윈도우&lt;/td&gt;
&lt;td&gt;1,048,576 토큰, 통합&lt;/td&gt;
&lt;td&gt;1,048,576 토큰, 통합&lt;/td&gt;
&lt;td&gt;1,048,576 토큰, 통합&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;세 모델 모두 텍스트, 이미지, 동영상, 오디오, PDF 입력을 받을 수 있으며, 함수 호출, 구조화된 출력, 코드 실행, 컴퓨터 사용, Google Search grounding을 지원합니다. 각 모델은 65,536 토큰의 동기 출력 제한이 있으며, &lt;a href="https://aistudio.google.com/docs/long-decode" rel="noopener noreferrer"&gt;long decode&lt;/a&gt;를 사용하면 1M 토큰까지 출력할 수 있습니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  어떤 Gemini 4 모델을 사용해야 할까?
&lt;/h2&gt;

&lt;p&gt;Google의 공식 가이드는 간결하며, 출발점으로 삼을 만합니다:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;대부분의 새 프로젝트는 &lt;strong&gt;Hydrogen으로 시작&lt;/strong&gt;하세요: 일상적인 코딩, 인터랙티브 앱, 도구를 사용하는 에이전트, 멀티모달 문서 파이프라인 등이 여기에 해당합니다. Google에 따르면 Hydrogen은 Gemini 3.8 Flash에 비해 잘못된 주장을 5배 이상 줄입니다.&lt;/li&gt;
&lt;li&gt;Hydrogen으로 부족하고 Carbon의 추가 검증이 필요 없는 경우에는 &lt;strong&gt;Neon으로 상향&lt;/strong&gt;하세요: 저장소 수준의 디버깅, 멀티 파일 리팩토링, 하루에 여러 번 실행되는 법률, 금융, 과학 분석 등이 있습니다.&lt;/li&gt;
&lt;li&gt;시스템 아키텍처, 멀티 파일 디버깅, 형식 증명, 보안 감사, 또는 더 빠른 모델이 막히는 작업에는 &lt;strong&gt;Carbon을 예약&lt;/strong&gt;하세요.&lt;/li&gt;
&lt;li&gt;번역, 추출, 요약 같은 대량 텍스트 작업에는 &lt;strong&gt;Gemini 3.5 Flash-Lite&lt;/strong&gt;($0.30 / $2.50)로 하향하세요.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fsfqf0j01s5ygzfpmlgzw.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fsfqf0j01s5ygzfpmlgzw.png" alt="들어온 작업을 일상적인 대량 코딩에는 Gemini 4 Hydrogen으로, 자주 실행되는 복잡한 작업에는 Neon으로, 가장 어려운 문제에는 Carbon으로 라우팅하는 의사결정 흐름도" width="800" height="410"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Neon의 핵심 키워드는 "자주"입니다. 분기마다 한 번 하는 보안 감사는 Carbon의 느린 추론을 감수할 수 있습니다. 하지만 매주 200개의 풀 리퀘스트를 처리하는 리팩토링 에이전트는 빨리 끝나면서도 어려운 부분을 정확히 처리하는 모델이 필요합니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Gemini 4 Neon vs Carbon: 가격과 추론 깊이
&lt;/h2&gt;

&lt;p&gt;Neon과 Carbon 모두 어려운 작업을 겨냥하기 때문에, 이것이 대부분의 팀이 가장 궁금해하는 비교입니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;추론 방식.&lt;/strong&gt; Carbon은 턴당 더 많은 사고 토큰을 소비하여 가설을 검증하고, 저장소 전반에 걸친 근본 원인을 파악하며, 수정 사항이 테스트를 통과하는지 확인합니다. Neon은 더 적은 토큰 사용으로 프런티어 수준의 품질을 목표로 합니다. Google의 &lt;a href="https://aistudio.google.com/docs/whats-new-gemini-4-neon" rel="noopener noreferrer"&gt;Gemini 4 Neon의 새로운 기능&lt;/a&gt; 페이지에 따르면, Neon은 저장소 수준의 디버깅을 더 적은 단계로 완료하고, 긴 도구 호출 세션에서 중복 파일 읽기를 줄이며, 컨텍스트 압축을 안정적으로 처리합니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;기본값이 다릅니다.&lt;/strong&gt; Carbon은 &lt;code&gt;medium&lt;/code&gt; 사고가 기본이며 &lt;code&gt;high&lt;/code&gt;가 최대입니다. Neon은 &lt;code&gt;high&lt;/code&gt;가 기본이고, 가장 어려운 다단계 문제를 위한 &lt;code&gt;xhigh&lt;/code&gt;를 추가로 제공합니다. &lt;code&gt;thinking_level&lt;/code&gt;을 설정하지 않은 채 Carbon을 Neon으로 교체하면, 모델이 사고하는 깊이도 함께 바뀝니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;12월 1일에 가격 관계가 역전됩니다.&lt;/strong&gt; 2026년 11월 30일까지는 Carbon의 도입 가격($2 / $10)이 토큰당 실제로 Neon($3 / $15)보다 저렴합니다. 12월 1일부터 Carbon은 $4 / $20으로 두 배가 되고, Neon이 토큰당 25% 더 저렴해집니다. Neon은 도입 가격이 없으므로 가격이 변하지 않습니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fyewuaglf0ae75yv36u5b.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fyewuaglf0ae75yv36u5b.png" alt="100만 토큰당 Gemini 4 API 가격 막대 그래프: Hydrogen 입력 $1.50, 출력 $7.50, Neon $3 및 $15, Carbon은 11월 30일까지 $2 및 $10, 12월 1일부터 $4 및 $20" width="800" height="448"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;하지만 토큰당 가격은 청구서의 절반일 뿐입니다. 출력 가격에는 사고 토큰이 포함되며, Carbon은 더 많이 생각하도록 설계되어 있습니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Gemini 4 Neon vs Hydrogen: 업그레이드가 빛을 발하는 순간
&lt;/h2&gt;

&lt;p&gt;Hydrogen과 Neon은 서류상으로 비슷해 보입니다. 동일한 사고 수준, 동일한 기본값, 동일한 컨텍스트 윈도우, 동일한 도구. Neon은 토큰당 정확히 두 배의 비용이 듭니다.&lt;/p&gt;

&lt;p&gt;Hydrogen의 답변이 재시도를 강제할 때 업그레이드가 빛을 발합니다. Hydrogen이 세 번 시도해야 완성하는 멀티 파일 리팩토링을 Neon이 한 번에 완성한다면, 더 저렴한 모델이 오히려 비용이 더 많이 드는 셈입니다.&lt;/p&gt;

&lt;p&gt;두 가지 실질적인 차이점:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;무료 티어.&lt;/strong&gt; Hydrogen은 프로토타이핑을 위한 무료 API 티어가 있습니다. Neon은 없으므로 첫 호출 전에 유료 티어 프로젝트가 필요합니다. 무료 티어에서는 Google이 제품 개선을 위해 사용자의 데이터를 사용할 수 있습니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;배치 가격.&lt;/strong&gt; 두 모델 모두 Batch 모드에서 가격이 절반이 됩니다: Hydrogen은 $0.75 / $3.75로, Neon은 $1.50 / $7.50으로 내려갑니다. 야간 Neon 배치 작업의 토큰당 비용은 실시간 Hydrogen 호출과 동일합니다.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;이미 Carbon을 플래너로, Hydrogen을 빠른 워커로 운영하고 있다면, &lt;a href="https://apidog.com/kr/blog/gemini-4-hydrogen-orchestrator?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Hydrogen 오케스트레이터 패턴&lt;/a&gt;에 대한 우리의 분석 글을 참고하세요. Neon은 이 구성에 중간 난이도 단계를 위한 세 번째 레인을 제공합니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  작업당 비용: 실제 계산 예시
&lt;/h2&gt;

&lt;p&gt;다음은 입력 40,000 토큰, 출력 8,000 토큰(사고 토큰 포함)인 에이전트 작업을 표준 유료 티어 요금으로 계산한 것입니다:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;모델&lt;/th&gt;
&lt;th&gt;입력 비용&lt;/th&gt;
&lt;th&gt;출력 비용&lt;/th&gt;
&lt;th&gt;작업당&lt;/th&gt;
&lt;th&gt;1,000작업당&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Hydrogen&lt;/td&gt;
&lt;td&gt;$0.060&lt;/td&gt;
&lt;td&gt;$0.060&lt;/td&gt;
&lt;td&gt;$0.12&lt;/td&gt;
&lt;td&gt;$120&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Neon&lt;/td&gt;
&lt;td&gt;$0.120&lt;/td&gt;
&lt;td&gt;$0.120&lt;/td&gt;
&lt;td&gt;$0.24&lt;/td&gt;
&lt;td&gt;$240&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Carbon (11월 30일까지)&lt;/td&gt;
&lt;td&gt;$0.080&lt;/td&gt;
&lt;td&gt;$0.080&lt;/td&gt;
&lt;td&gt;$0.16&lt;/td&gt;
&lt;td&gt;$160&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Carbon (12월 1일부터)&lt;/td&gt;
&lt;td&gt;$0.160&lt;/td&gt;
&lt;td&gt;$0.160&lt;/td&gt;
&lt;td&gt;$0.32&lt;/td&gt;
&lt;td&gt;$320&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;이 표는 각 모델이 동일한 수의 토큰을 사용한다고 가정하지만, 실제로는 그렇지 않습니다. Google은 Carbon이 턴당 더 많은 사고 토큰을 소비하고, Neon이 Carbon보다 적은 출력 토큰으로 작업을 마친다고 밝혔습니다. 만약 Carbon이 동일한 작업에 12,000개의 출력 토큰이 필요하다면, 12월 기준 작업당 비용은 $0.40로 상승하고, Neon과의 격차는 $0.08에서 $0.16으로 벌어집니다. 이 토큰 수는 예시일 뿐이므로, 예산을 세우기 전에 직접 측정하세요.&lt;/p&gt;

&lt;p&gt;비용을 줄이는 세 가지 방법:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;암시적 캐싱.&lt;/strong&gt; 4,096 토큰 이상의 프롬프트에 기본으로 적용되며, 캐시된 입력을 95% 할인합니다. 안정적인 시스템 프롬프트와 도구 정의를 앞쪽에 배치하여 캐시에 적중하도록 하세요.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;사고 수준.&lt;/strong&gt; Google은 네 가지 수준 모두에서 평가를 실행하고 품질 기준을 충족하는 가장 낮은 수준을 선택할 것을 권장합니다. &lt;code&gt;xhigh&lt;/code&gt;는 가장 많은 토큰과 지연 시간을 소비합니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;배치 모드.&lt;/strong&gt; 급하지 않은 작업은 표준 가격의 절반인 Batch 모드에서 처리하세요.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Carbon 가격 타임라인 전체는 &lt;a href="https://apidog.com/kr/blog/gemini-4-carbon-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Carbon 가격 가이드&lt;/a&gt;를 참고하세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  세 모델 간 전환: 코드에서 무엇이 바뀌나
&lt;/h2&gt;

&lt;p&gt;Gemini 4 모델 간 전환에는 요청 스키마 변경이 필요 없습니다. &lt;code&gt;model&lt;/code&gt; 문자열과, 보통은 &lt;code&gt;thinking_level&lt;/code&gt;만 바꾸면 됩니다:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl &lt;span class="s2"&gt;"https://generativelanguage.googleapis.com/v1beta/interactions"&lt;/span&gt; \
  -H &lt;span class="s2"&gt;"x-goog-api-key: $GEMINI_API_KEY"&lt;/span&gt; \
  -H &lt;span class="s1"&gt;'Content-Type: application/json'&lt;/span&gt; \
  -X POST \
  -d &lt;span class="s1"&gt;'{
    "model": "gemini-4-neon",
    "input": "Find the race condition in this retry queue and propose a fix.",
    "generation_config": { "thinking_level": "high" }
  }'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;워크로드를 이동할 때:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;thinking_level&lt;/code&gt;을 명시적으로 고정하세요.&lt;/strong&gt; Carbon의 기본값은 &lt;code&gt;medium&lt;/code&gt;이고, Neon과 Hydrogen의 기본값은 &lt;code&gt;high&lt;/code&gt;입니다. 고정하지 않고 교체하면 비용과 지연 시간이 달라집니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Neon과 Carbon에는 유료 티어 프로젝트를 사용하세요.&lt;/strong&gt; 무료 티어 키는 Hydrogen과 Flash-Lite에만 접근할 수 있습니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;샘플링 파라미터를 제거하세요.&lt;/strong&gt; Neon의 마이그레이션 가이드에 따르면 &lt;code&gt;temperature&lt;/code&gt;, &lt;code&gt;top_p&lt;/code&gt;, &lt;code&gt;top_k&lt;/code&gt;는 유효 범위 내에서는 무시되고, 범위를 벗어나면 &lt;code&gt;400&lt;/code&gt;을 반환합니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;previous_interaction_id&lt;/code&gt;로 모델을 체이닝하세요.&lt;/strong&gt; 세 모델이 스키마를 공유하므로, Carbon으로 계획하고 Hydrogen으로 구현하며, 그 사이의 까다로운 단계는 하나의 대화에서 Neon에 보낼 수 있습니다.&lt;/li&gt;
&lt;/ol&gt;

&lt;h2&gt;
  
  
  Apidog CLI로 코딩 에이전트에게 비교시키기
&lt;/h2&gt;

&lt;p&gt;Neon vs Carbon vs Hydrogen을 가장 빨리 판단하는 방법은 동일한 프롬프트를 세 모델에 모두 보내고 상태, 지연 시간, 토큰 사용량을 비교하는 것입니다. 코딩 에이전트가 &lt;a href="https://apidog.com/apidog-cli/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog CLI&lt;/a&gt;로 이 테스트를 구축하고 실행하는 동안 여러분은 다른 일을 계속할 수 있습니다.&lt;/p&gt;

&lt;p&gt;CLI를 설치하고 에이전트에게 Apidog 스킬을 부여하세요:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm install -g apidog-cli@latest
apidog login --with-token &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;YOUR_TOKEN&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
npx -y skills add https://apidog.com   &lt;span class="c"&gt;# pick your agent when prompted&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;그 다음 Claude Code, Codex 또는 Cursor에 프롬프트 하나를 주세요:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;In Apidog project &amp;lt;id&amp;gt;, create a test scenario named "Gemini 4 model compare"
that POSTs to https://generativelanguage.googleapis.com/v1beta/interactions
with model {{model}}, thinking_level "high" and the prompt in {{prompt}}.
Assert status 200 and a non-empty output, and save the usage block to a variable.
Run it once each for gemini-4-hydrogen, gemini-4-neon and gemini-4-carbon,
then give me a table of latency and token usage per model.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;에이전트는 페이로드 스키마를 읽고, 파일을 검증하고, 시나리오를 생성한 뒤, 모델만 바꿔가며 세 번 실행합니다:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;apidog cli-schema get test-scenario-create
apidog cli-schema validate test-scenario-create --file scenario.json
apidog test-scenario create --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --file scenario.json
apidog run -t &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;scenarioId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -e &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;envId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --env-var &lt;span class="s2"&gt;"model=gemini-4-hydrogen"&lt;/span&gt; -r cli,json
apidog run -t &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;scenarioId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -e &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;envId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --env-var &lt;span class="s2"&gt;"model=gemini-4-neon"&lt;/span&gt; -r cli,json
apidog run -t &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;scenarioId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;id&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -e &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;envId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --env-var &lt;span class="s2"&gt;"model=gemini-4-carbon"&lt;/span&gt; -r cli,json
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;GEMINI_API_KEY&lt;/code&gt;는 Apidog 환경에 보관하세요. &lt;code&gt;--upload-report&lt;/code&gt;를 추가하면 앱에서 각 실행 결과를 볼 수 있고, Google이 모델을 업데이트할 때 회귀를 잡으려면 &lt;code&gt;-r junit&lt;/code&gt;으로 동일한 명령어를 CI에 넣으세요. &lt;a href="https://apidog.com/kr/blog/apidog-cli-in-claude-code?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Code에서의 Apidog CLI&lt;/a&gt; 가이드가 설정 과정을 처음부터 끝까지 다룹니다. Apidog 무료 플랜은 최대 4명의 팀까지 지원합니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQ
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon이 Gemini 4 Carbon보다 나은가요?&lt;/strong&gt; 모든 면에서 그렇지는 않습니다. Carbon은 Google의 가장 강력한 추론 모델입니다. Neon은 일부 깊이를 더 빠른 완료 속도와 적은 출력 토큰과 맞바꾸며, 이는 자주 실행되는 복잡한 작업에 적합합니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon은 무료인가요?&lt;/strong&gt; 아니요. Neon은 Gemini API의 유료 티어에서만, 그리고 Google AI Pro 및 Ultra 플랜의 Google AI Studio에서 사용할 수 있습니다. 무료 API 티어가 있는 Gemini 4 모델은 Hydrogen입니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Neon이 Carbon보다 저렴한가요?&lt;/strong&gt; 토큰당 기준으로는 2026년 12월 1일부터만 그렇습니다. 11월 30일까지는 Carbon의 도입 가격 $2 / $10이 Neon의 $3 / $15보다 저렴합니다. 그 이후 Carbon은 $4 / $20이 되고, Carbon의 더 무거운 사고 비용을 고려하기 전에도 Neon이 토큰당 25% 더 저렴해집니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon, Carbon, Hydrogen은 동일한 컨텍스트 윈도우를 사용하나요?&lt;/strong&gt; 네. 세 모델 모두 입력, 사고, 출력을 위한 통합 1,048,576 토큰 윈도우를 공유하며, 65,536 토큰의 동기 출력 제한과 최대 1M 토큰의 long decode를 갖추고 있습니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Neon, Carbon, Hydrogen을 같은 워크플로우에서 함께 사용할 수 있나요?&lt;/strong&gt; 네. 세 모델은 요청 스키마를 공유하므로, 한 모델의 턴에서 다른 모델의 턴으로 &lt;code&gt;previous_interaction_id&lt;/code&gt;를 전달할 수 있습니다. Carbon으로 계획하고, Hydrogen으로 구현하고, 그 사이의 단계는 Neon에 맡기세요.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;가장 빠른 Gemini 4 모델은 무엇인가요?&lt;/strong&gt; Hydrogen입니다. Google은 Hydrogen을 빠름, Neon을 보통, Carbon을 신중함으로 표기합니다.&lt;/p&gt;

</description>
    </item>
    <item>
      <title>Gemini 4 Neon API 사용 방법 완벽 가이드</title>
      <dc:creator>Rihpig</dc:creator>
      <pubDate>Thu, 19 Nov 2026 03:10:07 +0000</pubDate>
      <link>https://dev.to/rihpig/gemini-4-neon-api-sayong-bangbeob-wanbyeog-gaideu-3145</link>
      <guid>https://dev.to/rihpig/gemini-4-neon-api-sayong-bangbeob-wanbyeog-gaideu-3145</guid>
      <description>&lt;p&gt;Gemini 4 Neon API는 모델 ID로 &lt;code&gt;gemini-4-neon&lt;/code&gt;을 사용합니다. &lt;code&gt;https://generativelanguage.googleapis.com/v1beta/interactions&lt;/code&gt;로 &lt;code&gt;POST&lt;/code&gt; 요청을 보내고, &lt;code&gt;x-goog-api-key&lt;/code&gt; 헤더에 API 키를 담고, JSON 본문에 &lt;code&gt;model&lt;/code&gt;과 &lt;code&gt;input&lt;/code&gt;을 넣으면 호출할 수 있습니다. 이 모델은 유료 등급에서만 실행되며, 입력 토큰 백만 개당 3달러, 출력 토큰 백만 개당 15달러이고, 기본 thinking 레벨은 &lt;code&gt;high&lt;/code&gt;입니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;지금 Apidog를 사용해 보세요&lt;/a&gt;
&lt;/p&gt;

&lt;p&gt;이 가이드에서는 Neon만의 차별점, 즉 유료 등급 설정, 다른 Gemini 4 모델에서의 전환, 64K 토큰을 넘는 출력, Neon과 Hydrogen의 조합, 비용 관리 방법을 다룹니다. 모든 필드 이름은 Google 공식 문서를 기준으로 합니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  첫 Gemini 4 Neon API 호출 전에 무엇이 필요한가요?
&lt;/h2&gt;

&lt;p&gt;결제가 설정된 프로젝트의 Gemini API 키, 모델 ID &lt;code&gt;gemini-4-neon&lt;/code&gt;, 그리고 Interactions 엔드포인트가 필요합니다. Google은 2026년 11월 18일, Gemini 4 계열의 중간 모델로서 Hydrogen과 Carbon 사이에 위치한 Neon을 출시했습니다.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;항목&lt;/th&gt;
&lt;th&gt;값&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;모델 ID&lt;/td&gt;
&lt;td&gt;&lt;code&gt;gemini-4-neon&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;엔드포인트&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;generativelanguage.googleapis.com&lt;/code&gt;의 &lt;code&gt;POST /v1beta/interactions&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;인증 헤더&lt;/td&gt;
&lt;td&gt;&lt;code&gt;x-goog-api-key: $GEMINI_API_KEY&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;API&lt;/td&gt;
&lt;td&gt;Interactions API 및 &lt;code&gt;generateContent&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Thinking 레벨&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;low&lt;/code&gt;, &lt;code&gt;medium&lt;/code&gt;, &lt;code&gt;high&lt;/code&gt; (기본값), &lt;code&gt;xhigh&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;컨텍스트 윈도우&lt;/td&gt;
&lt;td&gt;1,048,576 토큰 (입력, thinking, 출력이 공유)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;동기 호출당 출력&lt;/td&gt;
&lt;td&gt;65,536 토큰&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;롱 디코드(Long decode)&lt;/td&gt;
&lt;td&gt;입력 토큰을 제외한 최대 1,048,576 토큰&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;무료 등급&lt;/td&gt;
&lt;td&gt;없음&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;유료 가격&lt;/td&gt;
&lt;td&gt;입력 $3.00 / 1M, 출력 $15.00 / 1M (thinking 포함)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;캐시된 입력&lt;/td&gt;
&lt;td&gt;암시적 캐싱 사용 시 $0.15 / 1M&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;PDF 처리, 함수 호출, 스트리밍의 경우 요청 형식은 &lt;a href="https://apidog.com/kr/blog/gemini-4-hydrogen-api?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Hydrogen API 가이드&lt;/a&gt;와 동일하며, 모델 ID만 바꾸면 됩니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fot5r2me9b9lm0ltyllld.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fot5r2me9b9lm0ltyllld.png" alt="Gemini 4 Neon API" width="800" height="696"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  Neon에서 사용할 수 있는 Gemini API 키는 어떻게 발급받나요?
&lt;/h2&gt;

&lt;p&gt;Neon은 무료 등급에 포함되어 있지 않으므로 키만으로는 부족합니다. 키가 속한 프로젝트에 결제가 설정되어 있어야 합니다.&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Google AI Studio에서 &lt;a href="https://aistudio.google.com/api-keys" rel="noopener noreferrer"&gt;API 키 페이지&lt;/a&gt;를 열어 키를 생성하거나, 기존에 갖고 있던 키를 재사용하세요.&lt;/li&gt;
&lt;li&gt;키의 프로젝트가 유료 등급인지 확인하세요. Google 가이드에도 명확히 나와 있습니다: "Neon은 유료 등급에서만 사용할 수 있습니다(무료 등급 제외)."&lt;/li&gt;
&lt;li&gt;키를 내보내세요: &lt;code&gt;export GEMINI_API_KEY="YOUR_API_KEY"&lt;/code&gt;. Google GenAI SDK는 이 값을 자동으로 읽어옵니다.&lt;/li&gt;
&lt;li&gt;대량 배치 작업을 계획하기 전에 &lt;a href="https://aistudio.google.com/docs/rate-limits" rel="noopener noreferrer"&gt;rate limits 페이지&lt;/a&gt;에서 유료 등급의 속도 제한을 확인하세요.&lt;/li&gt;
&lt;/ol&gt;

&lt;h2&gt;
  
  
  첫 Gemini 4 Neon API 요청은 어떻게 보내나요?
&lt;/h2&gt;

&lt;p&gt;Interactions 엔드포인트에 &lt;code&gt;model&lt;/code&gt;과 &lt;code&gt;input&lt;/code&gt;을 보내면 됩니다. Google 퀵스타트 문서에 나온 형식은 다음과 같습니다:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl &lt;span class="s2"&gt;"https://generativelanguage.googleapis.com/v1beta/interactions"&lt;/span&gt; \
  -H &lt;span class="s2"&gt;"x-goog-api-key: $GEMINI_API_KEY"&lt;/span&gt; \
  -H &lt;span class="s1"&gt;'Content-Type: application/json'&lt;/span&gt; \
  -X POST \
  -d &lt;span class="s1"&gt;'{
    "model": "gemini-4-neon",
    "input": "Review this Go handler for missing error checks and suggest fixes."
  }'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Python SDK(&lt;code&gt;pip install -U google-genai&lt;/code&gt;)를 사용한 동일한 호출:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="n"&gt;google&lt;/span&gt; &lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="n"&gt;genai&lt;/span&gt;

&lt;span class="n"&gt;client&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;genai&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Client&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;  &lt;span class="c1"&gt;# reads GEMINI_API_KEY&lt;/span&gt;

&lt;span class="n"&gt;interaction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;interactions&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"gemini-4-neon"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nb"&gt;input&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"Review this Go handler for missing error checks and suggest fixes."&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="k"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;interaction&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;output_text&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="k"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;interaction&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;usage&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;테스트하는 동안에는 모든 응답에서 &lt;code&gt;usage&lt;/code&gt;를 확인하세요. thinking 토큰은 출력 요율인 $15로 과금되므로, 비용이 커지는 지점은 바로 thinking 토큰 수입니다.&lt;/p&gt;

&lt;p&gt;이 스니펫들은 Google의 가이드를 따른 것으로, 이 글을 쓰면서 직접 실행해 본 것은 아닙니다. 응답 형식은 직접 첫 호출을 해서 확인해 보세요.&lt;/p&gt;

&lt;h2&gt;
  
  
  Hydrogen이나 Carbon에서 전환할 때 무엇이 달라지나요?
&lt;/h2&gt;

&lt;p&gt;이미 다른 Gemini 4 모델을 사용 중이라면, 전환을 위해 요청 스키마를 바꿀 필요가 없습니다. &lt;code&gt;model&lt;/code&gt; 문자열만 변경하고 다음 세 가지를 확인하세요:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;확인 항목&lt;/th&gt;
&lt;th&gt;Neon&lt;/th&gt;
&lt;th&gt;Hydrogen&lt;/th&gt;
&lt;th&gt;Carbon 및 Argon&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;기본 thinking 레벨&lt;/td&gt;
&lt;td&gt;&lt;code&gt;high&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;high&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;medium&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;최고 레벨&lt;/td&gt;
&lt;td&gt;&lt;code&gt;xhigh&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;xhigh&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;high&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;1M당 입력 / 출력 가격&lt;/td&gt;
&lt;td&gt;$3 / $15&lt;/td&gt;
&lt;td&gt;$1.50 / $7.50&lt;/td&gt;
&lt;td&gt;
&lt;a href="https://apidog.com/kr/blog/gemini-4-carbon-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Carbon 가격&lt;/a&gt; 참조&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Carbon이나 Argon에서 넘어온 경우라면, 기본값이 &lt;code&gt;medium&lt;/code&gt;에서 &lt;code&gt;high&lt;/code&gt;로 바뀌기 때문에 같은 프롬프트에서도 thinking 토큰이 더 많이 소모됩니다. 이전 동작을 유지하려면 &lt;code&gt;thinking_level&lt;/code&gt;을 명시적으로 설정하세요:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="n"&gt;interaction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;interactions&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"gemini-4-neon"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nb"&gt;input&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"Audit this payment retry queue for race conditions."&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;generation_config&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"thinking_level"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"medium"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Gemini 3.8 Flash 이하 버전에서 넘어온 경우라면, 확인할 항목이 더 많습니다. Google의 마이그레이션 체크리스트에 따르면:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;낮은 출력 상한을 올리세요.&lt;/strong&gt; &lt;code&gt;max_output_tokens&lt;/code&gt;는 thinking과 답변을 합쳐서 계산합니다. 8,192처럼 하드코딩된 상한을 제거하거나 65,536으로 올리고, 비용을 줄여야 한다면 thinking 레벨을 낮추세요.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;minimal&lt;/code&gt;을 제거하세요.&lt;/strong&gt; Neon은 이 값에 대해 오류를 반환합니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;샘플링 파라미터를 제거하세요.&lt;/strong&gt; 서버는 범위 내의 &lt;code&gt;temperature&lt;/code&gt;, &lt;code&gt;top_p&lt;/code&gt;, &lt;code&gt;top_k&lt;/code&gt;를 무시하며, 범위를 벗어난 값은 &lt;code&gt;400&lt;/code&gt;을 반환합니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;명시적 캐싱을 걷어내세요.&lt;/strong&gt; Neon은 &lt;code&gt;cachedContents&lt;/code&gt;나 &lt;code&gt;caches.create&lt;/code&gt;를 지원하지 않으므로, &lt;code&gt;cached_content&lt;/code&gt; 필드를 제거하세요.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;도구는 네이티브로 선언하세요.&lt;/strong&gt; 선언된 도구 없이 raw JSON 도구 호출을 프롬프트로 유도하면 &lt;code&gt;MALFORMED_FUNCTION_CALL&lt;/code&gt;이 반환될 수 있습니다. 함수 호출이나 구조화된 출력을 사용하세요.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Neon에서 64K 토큰 이상의 출력을 얻으려면 어떻게 하나요?
&lt;/h2&gt;

&lt;p&gt;동기 요청은 스트리밍 여부와 관계없이 65,536 토큰에서 멈춥니다. 전체 마이그레이션 명세와 그 테스트 스위트처럼 더 긴 출력이 필요하다면, &lt;code&gt;background&lt;/code&gt;를 &lt;code&gt;true&lt;/code&gt;로 설정하고 &lt;code&gt;max_output_tokens&lt;/code&gt;를 65,536 이상으로 올리세요. 그러면 Google 서버가 설정한 상한에 도달할 때까지 64K 토큰 단위로 생성을 계속합니다.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fg72cssh97pjzmydwb8ql.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fg72cssh97pjzmydwb8ql.png" alt="Gemini 4 Neon long decode" width="799" height="341"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;작업을 시작하고 &lt;code&gt;id&lt;/code&gt;를 저장하세요:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="kd"&gt;export&lt;/span&gt; &lt;span class="nv"&gt;ID&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="nv"&gt;$(&lt;/span&gt;curl -s -X POST &lt;span class="s2"&gt;"https://generativelanguage.googleapis.com/v1beta/interactions"&lt;/span&gt; \
  -H &lt;span class="s2"&gt;"x-goog-api-key: $GEMINI_API_KEY"&lt;/span&gt; \
  -H &lt;span class="s2"&gt;"Content-Type: application/json"&lt;/span&gt; \
  -d &lt;span class="s1"&gt;'{
    "model": "gemini-4-neon",
    "input": "Generate a complete multi-module migration specification and test suite for this service.",
    "background": true,
    "generation_config": {
      "max_output_tokens": 262144,
      "thinking_level": "high"
    }
  }'&lt;/span&gt; &lt;span class="o"&gt;|&lt;/span&gt; jq -r &lt;span class="s1"&gt;'.id'&lt;/span&gt;&lt;span class="o"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;그다음 완료될 때까지 폴링하면서 각 단계의 텍스트를 합칩니다(Python, 내보낸 &lt;code&gt;ID&lt;/code&gt; 사용):&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="n"&gt;os&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;time&lt;/span&gt;

&lt;span class="n"&gt;interaction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;interactions&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;id&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;os&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;environ&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"ID"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="k"&gt;while&lt;/span&gt; &lt;span class="n"&gt;interaction&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;status&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"in_progress"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"queued"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="n"&gt;time&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;sleep&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;5&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="n"&gt;interaction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;interactions&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;id&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;interaction&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nb"&gt;id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="n"&gt;text&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;""&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;text&lt;/span&gt;
    &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;step&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; &lt;span class="n"&gt;interaction&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;steps&lt;/span&gt; &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;step&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="kd"&gt;type&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="s2"&gt;"model_output"&lt;/span&gt;
    &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;c&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; &lt;span class="n"&gt;step&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;content&lt;/span&gt; &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="kd"&gt;type&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="s2"&gt;"text"&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Google 가이드의 세 가지 규칙을 지키면 문제를 피할 수 있습니다:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;code&gt;max_output_tokens&lt;/code&gt; 없이 &lt;code&gt;background&lt;/code&gt;만 설정하면, 서버는 65,536 토큰에서 멈춥니다.&lt;/li&gt;
&lt;li&gt;상한은 입력 토큰을 제외한 최대 1,048,576까지 설정할 수 있습니다. Google은 길고 여러 단계로 이루어진 작업에는 131,072 또는 262,144를 권장합니다.&lt;/li&gt;
&lt;li&gt;복잡한 프롬프트는 몇 분씩 걸릴 수 있습니다. 백그라운드 모드를 사용하거나, HTTP 클라이언트 타임아웃을 최소 15분으로 설정하세요.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;상호작용 데이터를 Google 쪽에 저장하고 싶지 않다면, &lt;a href="https://aistudio.google.com/docs/long-decode" rel="noopener noreferrer"&gt;롱 디코드 가이드&lt;/a&gt;에서 최신 SDK의 클라이언트 측 이어쓰기(continuation) 방법도 문서화하고 있습니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Neon과 Hydrogen은 어떻게 조합하나요?
&lt;/h2&gt;

&lt;p&gt;판단이 필요한 작업에는 Neon을, 대량 처리에는 Hydrogen을 사용하세요. Neon이 워크플로를 계획하거나 검토한 다음, 그 interaction의 &lt;code&gt;id&lt;/code&gt;를 &lt;code&gt;previous_interaction_id&lt;/code&gt;로 전달하여 단일 단계를 수행하는 &lt;code&gt;gemini-4-hydrogen&lt;/code&gt; 호출을 하면 됩니다. Google의 &lt;a href="https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/guides/gemini-4-neon" rel="noopener noreferrer"&gt;Cloud 개발자 가이드&lt;/a&gt;에서 이 패턴을 보여줍니다:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="n"&gt;plan&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;interactions&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"gemini-4-neon"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nb"&gt;input&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"Design a 3-step plan to migrate our REST order service to gRPC in Go."&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;store&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="kc"&gt;True&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="n"&gt;step&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;interactions&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"gemini-4-hydrogen"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nb"&gt;input&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"Implement step 1 (.proto service definition) from the plan."&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;previous_interaction_id&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;plan&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nb"&gt;id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="k"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;step&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;output_text&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F4cee3v8k32jvllrfaaye.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F4cee3v8k32jvllrfaaye.png" alt="Neon as planner, Hydrogen as executor" width="800" height="410"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Hydrogen이 Neon 대신 생성하는 출력 토큰 하나하나가 비용을 절반으로 줄여줍니다. &lt;a href="https://apidog.com/kr/blog/gemini-4-hydrogen-orchestrator?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini 4 Hydrogen 오케스트레이터 가이드&lt;/a&gt;에서 Carbon을 플래너로 사용하는 같은 루프를 자세히 다룹니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Gemini 4 Neon API 비용은 어떻게 낮출 수 있나요?
&lt;/h2&gt;

&lt;p&gt;통상적으로 효과가 큰 순서대로 정렬한 네 가지 방법입니다:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;통과하는 수준 중 가장 낮은 thinking 레벨을 고르세요.&lt;/strong&gt; Google의 조언은 높은 &lt;code&gt;max_output_tokens&lt;/code&gt;로 네 가지 레벨 모두에서 평가를 실행한 다음, 품질 기준을 충족하는 가장 낮은 &lt;code&gt;thinking_level&lt;/code&gt;을 선택하는 것입니다.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;긴 프롬프트를 재사용하세요.&lt;/strong&gt; 암시적 캐싱은 기본적으로 4,096 토큰 이상의 프롬프트에 적용되며, 캐시된 입력 비용을 백만 개당 $3.00에서 $0.15로, 95%나 절감합니다. 프롬프트에서 길고 안정적인 부분(시스템 텍스트, 문서, 스키마)은 앞쪽에 두세요.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;실행은 Hydrogen에 맡기세요.&lt;/strong&gt; 위의 조합 패턴을 참조하세요.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;모든 토큰을 세세요.&lt;/strong&gt; Google은 모델이 처리하는 모든 토큰에 과금합니다. 여기에는 thinking 토큰과 grounding 사용 시 추가되는 내부 지침도 포함됩니다. Google Search를 이용한 grounding은 쿼리당 과금됩니다.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;간단한 계산 예시: 입력 20,000 토큰, 출력 8,000 토큰(thinking 포함)인 호출은 입력에 $0.06, 출력에 $0.12가 들어 정가 기준 $0.18입니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  Apidog CLI로 코딩 에이전트가 Neon과 Hydrogen을 비교하게 하세요
&lt;/h2&gt;

&lt;p&gt;당신의 프롬프트에서 Neon이 Hydrogen의 두 배 가격 값을 할까요? 코딩 에이전트(Claude Code, Codex, Cursor)가 &lt;a href="https://apidog.com/apidog-cli/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog CLI&lt;/a&gt;로 테스트 케이스를 하나 만들어 두 모델에 대해 실행하도록 해보세요.&lt;/p&gt;

&lt;p&gt;한 번만 설정하면 됩니다:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm install -g apidog-cli@latest
apidog login --with-token &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;YOUR_TOKEN&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
npx -y skills add https://apidog.com   &lt;span class="c"&gt;# pick your agent when prompted&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;그다음 에이전트에 프롬프트 하나를 주세요:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;In Apidog project &amp;lt;projectId&amp;gt;, create an environment "gemini" with base URL
https://generativelanguage.googleapis.com and variables GEMINI_API_KEY,
MODEL (default "gemini-4-hydrogen") and THINKING (default "high"). Add an
endpoint for POST /v1beta/interactions with the x-goog-api-key header from
GEMINI_API_KEY. Create a test case that sends model {{MODEL}}, our code-review
prompt and generation_config.thinking_level {{THINKING}}, and asserts: HTTP 200,
status is "completed", a non-empty model_output step, and usage.total_tokens
exists. Run it for gemini-4-hydrogen and gemini-4-neon, then compare
usage.total_thought_tokens and usage.total_output_tokens.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;에이전트는 무언가를 작성하기 전에 각 페이로드 스키마를 읽고 JSON을 검증합니다:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;apidog environment create gemini --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;projectId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --base-url https://generativelanguage.googleapis.com
apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file endpoint.json
apidog endpoint create --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;projectId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --file endpoint.json
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;projectId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --file case.json
apidog run --test-case &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;caseId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;projectId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -e &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;envId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --env-var &lt;span class="s2"&gt;"MODEL=gemini-4-hydrogen"&lt;/span&gt; -r cli,json
apidog run --test-case &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;caseId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --project &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;projectId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; -e &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;envId&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; --env-var &lt;span class="s2"&gt;"MODEL=gemini-4-neon"&lt;/span&gt; -r cli,json
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;각 실행의 토큰 수에 모델 가격을 곱하면, 출시 발표용 평균 수치가 아닌 당신의 프롬프트에 대한 실제 작업당 비용이 나옵니다. &lt;code&gt;--upload-report&lt;/code&gt;를 추가하면 Apidog 앱에서 실행 결과를 볼 수 있고, &lt;code&gt;-r cli,json&lt;/code&gt;을 &lt;code&gt;-r junit&lt;/code&gt;으로 바꾸면 같은 검증을 CI에 넣을 수 있습니다. 파이프라인은 &lt;a href="https://apidog.com/kr/blog/apidog-cli-ci-cd-pipeline?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog CLI CI/CD 가이드&lt;/a&gt;에서, 에이전트 설정은 &lt;a href="https://apidog.com/kr/blog/apidog-cli-in-claude-code?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Code에서의 Apidog CLI&lt;/a&gt;에서 확인하세요. Apidog의 무료 플랜은 최대 4명까지 사용할 수 있습니다.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQ
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon의 모델 ID는 무엇인가요?&lt;/strong&gt; &lt;code&gt;gemini-4-neon&lt;/code&gt;입니다. Interactions API와 &lt;code&gt;generateContent&lt;/code&gt; 모두에서 동작합니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon API는 무료인가요?&lt;/strong&gt; 아닙니다. Neon은 Gemini API의 유료 등급에서만 사용할 수 있으며, 입력 토큰 백만 개당 $3, 출력 토큰 백만 개당 $15입니다. Google AI Pro 및 Ultra 구독자는 AI Studio 채팅에서 사용해 볼 수 있습니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Hydrogen용으로 작성한 코드가 Neon에서도 동작하나요?&lt;/strong&gt; 네. Google에 따르면 Gemini 4 모델 간 전환에는 요청 스키마 변경이 필요 없습니다. &lt;code&gt;model&lt;/code&gt; 문자열만 업데이트한 다음, 기본 &lt;code&gt;high&lt;/code&gt; thinking 레벨을 그대로 사용할지 결정하면 됩니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon API의 최대 출력은 얼마인가요?&lt;/strong&gt; 동기 요청당 65,536 토큰입니다. &lt;code&gt;background&lt;/code&gt;를 &lt;code&gt;true&lt;/code&gt;로 설정하고 &lt;code&gt;max_output_tokens&lt;/code&gt;를 더 높게 지정하면, Neon은 입력을 제외한 1,048,576 토큰 윈도우까지 생성할 수 있습니다.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Gemini 4 Neon은 temperature를 지원하나요?&lt;/strong&gt; 아니요. 서버는 범위 내의 &lt;code&gt;temperature&lt;/code&gt;, &lt;code&gt;top_p&lt;/code&gt;, &lt;code&gt;top_k&lt;/code&gt; 값은 무시하고, 범위를 벗어난 값에는 &lt;code&gt;400&lt;/code&gt;을 반환합니다. 품질과 속도·비용 사이의 균형은 &lt;code&gt;thinking_level&lt;/code&gt;로 조절하세요.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Neon은 명시적 컨텍스트 캐싱을 지원하나요?&lt;/strong&gt; 아니요. 요청에서 &lt;code&gt;cached_content&lt;/code&gt;를 제거하세요. 암시적 캐싱은 4,096 토큰 이상의 프롬프트에 자동으로 계속 적용되며, 캐시된 입력은 95% 할인됩니다.&lt;/p&gt;

</description>
    </item>
  </channel>
</rss>
