클로드 코드 윈도우 설치, 네이티브로 할지 WSL로 할지 고르는 기준
클로드 코드는 윈도우에서 PowerShell이나 CMD에 설치 명령 한 줄을 넣으면 관리자 권한 없이 네이티브로 설치돼요. 공식 문서는 윈도우 프로젝트와 도구라면 네이티브를, 리눅스 도구 체인이나 샌드박스 안 명령 실행이 필요하면 WSL 2를 고르라고 안내해요. 네이티브 윈도우에서는 샌드박스가 지원되지 않아요.
AI 기술을 누구나 쉽게 활용할 수 있도록 실전 가이드를 작성합니다. ChatGPT, Claude, AI 자동화, SEO 분야를 전문으로 다룹니다.
제미나이 API 요금을 확인하려고 공식 요금 문서를 열면 보통 숫자 하나만 보고 닫아요. 그런데 이 문서에는 한 칸에 값이 두 개 적힌 자리가 있어요. 2026년 12월 31일까지 쓰는 값과 2027년 1월 1일부터 쓰는 값이 같은 칸에 나란히 붙어 있는 자리예요.
그런 자리가 몇 개인지, 두 값의 비율이 어떻게 되는지 문서를 기계로 전수 파싱해 세어 봤어요. 결론부터 적을게요. 병기된 자리는 58개이고, 2027년 값을 2026년 값으로 나눈 비율은 58개 전부 정확히 2.0 이었어요. 예외가 한 개도 없었어요.
다만 범위를 먼저 못박아 둘게요. 이건 제미나이 요금이 전부 두 배가 된다는 이야기가 아니에요. 달러 금액이 적힌 표 칸 290개 중 2027년 값이 병기된 칸은 44개뿐이고, 그 44칸이 모여 있는 모델은 문서에 실린 35종 중 5종이에요. 나머지 246칸에는 2027년 표기가 아예 없어요. 이 글은 가격 인상을 예고하는 해설이 아니라, 요금표라는 문서가 어떤 구조로 생겼는지 세어 본 기록이에요.
화면을 눈으로 훑는 대신 문서 전문을 받아 표 구조를 직접 읽었어요. 요금 문서 한 장 안에 표가 81개, 표 칸이 1,170개 들어 있어요. 눈으로 세는 방식으로는 짝을 놓치기 쉬운 규모예요.
세는 기준은 세 가지로 잡았어요.
첫 번째 결과가 이미 한 가지를 알려줘요. 두 문구는 각각 58회로 정확히 짝이 맞았어요. 한쪽만 적힌 짝 없는 자리가 없다는 뜻이에요. 그래서 58쌍을 전부 꺼내 나눗셈을 걸 수 있었어요.
58쌍을 하나씩 나눠 비율 분포를 세었어요. 결과는 이렇게 나왔어요.
| 비율 | 자리 수 |
|---|---|
| 정확히 2.0 | 58 |
| 그 밖의 값 | 0 |
반올림해서 2가 된 자리가 아니라 나눗셈 결과가 그대로 2인 자리가 58개예요. 어떤 단위의 칸들인지도 갈라 봤어요.
| 값의 단위 | 자리 수 |
|---|---|
| 1M 토큰당 단가(입력·출력·컨텍스트 캐싱) | 41 |
| 캐시 저장 요금(1M 토큰을 한 시간 보관) | 14 |
| 텍스트와 이미지와 영상과 음성을 함께 묶은 단가 | 3 |
| 합계 | 58 |
처리 모드로 갈라도 빈 곳 없이 들어차 있어요. 이 문서는 모델에 따라 표준, 배치, 플렉스, 프라이어리티 네 가지 처리 모드로 표를 나눠 싣는데, 네 모드가 모두 붙은 모델 구획은 33개 중 13개예요.
| 처리 모드 | 병기된 자리 수 |
|---|---|
| 표준 | 18 |
| 배치 | 16 |
| 플렉스 | 12 |
| 프라이어리티 | 12 |
| 합계 | 58 |
즉 어떤 모드로 부르든, 어떤 단위의 칸이든 병기가 붙은 자리는 예외 없이 두 배 관계였어요. 단가가 낮은 배치라고 해서 완만하게 오르거나, 이미 비싼 프라이어리티라고 해서 덜 오르는 구조가 아니에요.
여기가 가장 오해하기 쉬운 자리예요. 비율이 깔끔하게 하나로 모이니 문서 전체가 그렇다고 읽히기 쉬운데, 구획 단위로 다시 세면 그림이 달라져요.
요금 문서의 모델 구획은 33개이고, 그중 한 구획이 라이브 계열 세 종을 함께 싣고 있어서 모델 수로는 35종이에요. 이 중 2027년 병기가 하나라도 있는 구획은 다섯 개였어요.
| 모델 ID | 병기된 자리 수 |
|---|---|
gemini-3.8-flash | 16 |
gemini-3.7-flash | 16 |
gemini-3.6-flash | 16 |
gemini-robotics-er-2-preview | 8 |
gemini-robotics-er-2-streaming-preview | 2 |
| 합계 | 58 |
Flash 세 개가 각각 16인 이유는 앞서 본 구조 그대로예요. 처리 모드 네 가지에 입력, 출력, 컨텍스트 캐싱 단가, 캐시 저장 요금 네 자리씩 들어 있어서 4에 4를 곱한 값이에요. 로보틱스 계열 두 구획은 표가 더 단순해서 8자리와 2자리로 끝나요.
반대로 적어 두면 더 분명해져요. Pro 계열, 이미지 생성 계열, 음성과 영상 계열, 임베딩, 구세대 Flash 구획에는 2027년 표기가 하나도 없어요. 이 칸들이 앞으로 어떻게 될지는 문서가 말하지 않아요. 적혀 있지 않은 것을 추측으로 채우지 않는 편이 안전해요.
병기를 뽑는 과정에서 예상하지 못한 것이 하나 나왔어요. gemini-3.8-flash와 gemini-3.7-flash와 gemini-3.6-flash의 요금 칸이 네 가지 모드 전부에서 서로 같은 값이었어요.
표준 모드 입력이 세 모델 모두 1M 토큰당 0.75달러에서 1.50달러, 출력이 3.75달러에서 7.50달러예요. 배치와 플렉스가 0.375달러에서 0.75달러, 프라이어리티가 1.35달러에서 2.70달러로 역시 동일해요.
세대가 셋인데 단가가 한 줄이라는 것은 요금표를 읽을 때 실무적으로 의미가 있어요. 이 세 모델 사이에서는 가격이 선택 기준이 되지 않아요. 비용을 줄이려고 세대를 내리는 선택은 이 구간에서는 효과가 없고, 세대를 고르는 기준은 가격 밖의 것이어야 해요. 어떤 모델이 아직 살아 있고 어떤 것이 지원 종료 예정인지는 제미나이 모델 지원 종료 표를 65행 전수 확인한 기록 쪽에 따로 정리해 두었어요.
숫자를 나란히 놓으면 병기의 성격이 보여요. gemini-3.5-flash 구획에는 2027년 표기가 없고 값이 고정되어 있어요. 그 고정값과 3.8 Flash 의 2027년 값을 붙여 봤어요.
| 처리 모드 | 3.8 Flash 현재 | 3.8 Flash 2027년 | 3.5 Flash 고정값 |
|---|---|---|---|
| 표준 입력 | $0.75 | $1.50 | $1.50 |
| 표준 출력 | $3.75 | $7.50 | $9.00 |
| 배치 입력 | $0.375 | $0.75 | $0.75 |
| 배치 출력 | $1.875 | $3.75 | $4.50 |
| 플렉스 입력 | $0.375 | $0.75 | $0.75 |
| 플렉스 출력 | $1.875 | $3.75 | $4.50 |
| 프라이어리티 입력 | $1.35 | $2.70 | $2.70 |
| 프라이어리티 출력 | $6.75 | $13.50 | $16.20 |
오른쪽 두 열을 보세요. 입력 단가는 네 가지 모드 전부에서 값이 같아요. 1.50달러, 0.75달러, 0.75달러, 2.70달러가 그대로 맞아떨어져요. 컨텍스트 캐싱 단가도 표준 0.15달러와 프라이어리티 0.27달러가 같고, 캐시 저장 요금은 1M 토큰을 한 시간 보관하는 값이 양쪽 다 1.00달러예요.
다른 점은 출력 한 줄이에요. 3.8 Flash 의 2027년 출력은 7.50달러인데 3.5 Flash 는 9.00달러예요. 배치는 3.75달러와 4.50달러, 프라이어리티는 13.50달러와 16.20달러로 모드마다 신세대가 더 낮게 남아요.
그래서 이 병기를 읽는 가장 정확한 방식은 이래요. 2027년에 적용되는 값은 새로 만들어진 숫자가 아니라 이미 문서 안에 있던 구세대 가격대예요. 지금 적용되는 값이 그 절반으로 내려와 있는 상태이고, 병기는 그 상태가 언제까지인지를 적어 둔 것이에요. 모델별 단가 차이를 실제 작업량에 곱해 보는 방법은 Flash 와 Pro 와 타사 모델을 놓고 비용을 가른 7가지 패턴 쪽에 정리되어 있어요.
병기가 없는 칸도 세어 두면 오독을 막을 수 있어요. 달러 금액이 들어 있는 표 칸 290개 중 병기가 붙은 칸은 44개이고, 남은 246칸에는 2027년 값이 없어요. 병기 칸이 44개인데 자리가 58개인 이유는 한 칸이 단가와 저장 요금을 함께 담아 두 쌍이 들어가는 경우가 있기 때문이에요.
표기가 없는 항목 중 자주 쓰이는 것 두 가지만 적어 둘게요.
두 줄 모두 모델 구획 안의 그라운딩 행에서 옮긴 값이에요. 이 구분이 필요한 이유가 있어요. 같은 문서의 별도 「도구 요금」 표가 같은 도구를 다른 값으로 적거든요. 거기서는 지도 초과 단가가 1,000건당 25달러이고, 검색은 2.5 계열 기준 1,000건당 35달러와 3 계열 기준 1,000건당 14달러가 한 칸에 같이 들어 있어요. 무료 건수의 공유 범위도 모델 표는 3.x 계열로, 도구 표는 전 계열로 적혀 갈려요. 그래서 그라운딩 단가를 인용할 때는 어느 표에서 가져온 값인지를 같이 적어야 해요.
문서 끝의 참고 항목에는 계산에 영향을 주는 단서도 몇 개 적혀 있어요. PDF 같은 문서 형식의 토큰은 이미지 토큰 단가로 과금되고, 동적 검색을 써서 비용을 줄이는 경우에는 응답에 웹 근거 링크가 하나 이상 포함된 요청만 그라운딩 요금이 붙어요. AI 스튜디오에서 쓰는 사용량은 제공 지역 전체에서 무료라고 적혀 있어요.
요금 외에 한 줄이 계속 반복돼요. 데이터가 제품 개선에 쓰이는지를 적은 행인데, 문서 전체에서 79번 나오고 등장할 때마다 무료 등급은 그렇다, 유료 등급은 아니다로 값이 갈려요. 79번 중 예외는 없었어요.
이 행이 모든 모델 표마다 붙어 있다는 점이 중요해요. 어느 모델을 쓰든 등급에 따라 데이터 취급이 갈린다는 뜻이고, 요금 비교 표를 만들 때 이 열을 빼면 무료 등급 쪽이 실제보다 좋아 보이게 돼요. 배치 처리에 대해서는 문서가 비용이 절반으로 줄어든다고 적어 두고 있어요.
요금표만 보면 놓치는 것이 하나 있어요. 단가를 알아도 한도에 먼저 걸리면 호출이 안 돼요. 한도는 요금 문서가 아니라 사용 한도 문서에 적혀 있어요.
| 사용 등급 | 올라가는 조건 | 과금 상한 | 10분 단위 지출 한도 |
|---|---|---|---|
| 무료 | 활성 프로젝트 또는 무료 체험 | 해당 없음 | 해당 없음 |
| 1단계 | 결제 계정 연결 | $250 | $10 |
| 2단계 | 누적 100달러 결제 + 첫 결제 후 3일 | $2,000 | $50 |
| 3단계 | 누적 1,000달러 결제 + 첫 결제 후 30일 | 20,000달러에서 100,000달러 이상 | $200 |
10분 단위 지출 한도는 굴러가는 10분 창으로 평가되고, 걸리면 429 RESOURCE_EXHAUSTED 오류가 돌아와요. 실무에서 놓치기 쉬운 단서도 두 개 적혀 있어요. 한도는 API 키가 아니라 프로젝트 단위로 적용되고, 일일 요청 수 한도는 태평양 시간 자정에 초기화돼요. 키를 여러 개 만들어 나눠 쓰는 방식으로는 한도가 늘어나지 않는다는 뜻이에요.
정리하면 이래요.
이 글의 수치는 2026년 9월 21일에 공식 요금 문서와 사용 한도 문서를 직접 받아 파싱한 값이에요. 요금 문서에 적힌 최종 수정일은 2026년 9월 16일, 사용 한도 문서는 2026년 9월 2일이었어요. 어떤 모델을 쓰라고 추천하려는 글이 아니고, 한 칸에 값이 두 개 적힌 자리가 문서에 몇 개이고 그 관계가 무엇인지를 세어 두는 것이 목적이에요. 요금은 바뀌므로 실제 청구액을 계산할 때는 같은 문서를 다시 열어 그날의 값으로 확인하세요.
일부 칸이 기간을 나눠 두 값을 함께 적는 형식으로 되어 있기 때문이에요. 같은 칸 안에 2026년 12월 31일까지 적용되는 값과 2027년 1월 1일부터 적용되는 값이 나란히 들어 있어요. 이 형식이 쓰인 자리를 전부 찾아 세어 보니 58개였고, 두 문구의 등장 횟수도 각각 58회로 정확히 짝이 맞았어요. 즉 한쪽만 적힌 짝 없는 자리는 없었어요. 문서 자체가 미래 가격을 미리 공개해 두는 방식으로 쓰여 있는 셈이에요.
58쌍을 하나씩 꺼내 2027년 값을 2026년 값으로 나눠 봤더니 결과가 전부 2.0으로 나왔다는 뜻이에요. 비율 분포를 세면 2.0이 58개, 다른 값은 0개예요. 입력 단가든 출력 단가든 캐싱 단가든 캐시 저장 요금이든 예외가 없었어요. 예를 들어 입력은 1M 토큰당 0.75달러에서 1.50달러로, 출력은 3.75달러에서 7.50달러로 적혀 있어요. 반올림이나 어림수로 맞춘 자리도 없이 정확히 두 배였어요.
아니에요. 이 부분을 헷갈리면 완전히 다른 결론이 나와요. 달러 금액이 적힌 표 칸은 290개인데 2027년 값이 병기된 칸은 44개뿐이에요. 나머지 246칸에는 2027년 표기가 아예 없어요. 병기가 붙은 모델도 문서에 실린 35종 중 5종이에요. 표기가 없는 칸이 어떻게 될지는 문서에 적혀 있지 않으니, 적혀 있는 범위까지만 읽는 편이 안전해요.
다섯 종이에요. 모델 구획 단위로 다시 세어 보면 gemini-3.8-flash에 16자리, gemini-3.7-flash에 16자리, gemini-3.6-flash에 16자리, gemini-robotics-er-2-preview에 8자리, gemini-robotics-er-2-streaming-preview에 2자리가 들어 있고 합이 58이에요. Flash 세 개가 각각 16인 이유는 처리 모드가 네 가지이고 모드마다 네 자리씩 들어 있기 때문이에요. 구세대 Flash나 Pro 계열, 이미지와 음성 계열 구획에는 병기가 없어요.
흥미로운 대조가 있어요. gemini-3.8-flash의 2027년 입력 단가는 1M 토큰당 1.50달러인데, 이 값은 구세대인 gemini-3.5-flash의 현재 입력 단가와 정확히 같아요. 배치와 플렉스는 0.75달러, 프라이어리티는 2.70달러로 네 가지 처리 모드 전부에서 입력 단가가 일치해요. 다른 점은 출력이에요. 3.8 Flash의 2027년 출력 단가는 7.50달러인데 3.5 Flash는 9.00달러라서, 출력 쪽은 여전히 신세대가 더 낮게 남아요.
네 가지를 순서대로 보면 실수를 줄일 수 있어요. 첫째, 쓰려는 모델 구획에 2027년 병기가 있는지 확인하세요. 있으면 계산기에 두 값을 다 넣어야 해요. 둘째, 처리 모드를 확인하세요. 같은 모델도 표준과 배치와 플렉스와 프라이어리티가 단가가 다르고 배치는 문서에 비용 절감 폭이 따로 적혀 있어요. 셋째, 컨텍스트 캐싱은 단가와 저장 요금이 별도 항목이라 둘 다 세야 해요. 넷째, 무료 등급은 표에 데이터가 제품 개선에 쓰인다고 적혀 있고 유료 등급은 아니라고 적혀 있으니 그 행을 꼭 읽어 보세요.