OpenCode에서 Gemini 4 Argon 사용하기
Gemini 4 Argon은 Google이 2026-10-13에 정식 출시한 Gemini 4 시리즈의 첫 모델이며, API ID는 gemini-4-argon입니다. Google 공식 API 가격은 입력 토큰 100만 개당 $2, 출력 토큰 100만 개당 $10입니다. 이는 2026-11-30까지의 출시 기념 가격이며, 이후에는 $4 / $20으로 돌아갑니다.
OpenCode 사용자를 위한 결론: Argon은 이미 OpenCode에서 Google API, OpenCode Zen, Gemini 프로토콜을 지원하는 게이트웨이로 쓸 수 있습니다. 모델은 어디서나 같고, 다른 것은 가격입니다. 코딩 에이전트를 종량제로 계속 돌리면 차이가 빠르게 커집니다. 이 사이트의 제휴사인 AI Code With 채널은 공식 가격의 19%, 즉 $0.38 / $1.90으로 과금합니다.
모델 ID와 사양
| 항목 | 값 |
|---|---|
| API ID | gemini-4-argon |
| 출시 | 2026-09-30 발표, 2026-10-13 Gemini API 정식 제공(유료 등급 전용) |
| 컨텍스트 | 1,048,576 토큰(입력, 사고, 출력이 공유) |
| 최대 출력 | 기본 65,536 토큰. long decode를 켜면 남은 창 전체까지 사용 가능 |
| 사고 수준 | low, medium, high. 기본값은 medium |
| 입력 | 멀티모달: 텍스트, 이미지, 문서, 동영상 |
출처: Google 발표 (opens in a new tab), kingy.ai의 Gemini API 문서 사양 정리 (opens in a new tab). 사고 토큰은 출력 가격으로 과금되므로 high를 쓰면 출력 비용이 크게 늘어납니다.
Gemini 4 Argon 가격
단위는 미국 달러 / 100만 토큰입니다.
| 채널 | 입력 | 출력 | 캐시 읽기 |
|---|---|---|---|
| Google 공식, 2026-11-30까지(출시 기념가) | $2 | $10 | $0.10 |
| Google 공식, 2026-11-30 이후 | $4 | $20 | 미공개 |
| OpenCode Zen | $2 | $10 | $0.10 |
| AI Code With 채널(81% 할인) | $0.38 | $1.90 | — |
Zen 가격은 models.dev의 현재 등록값이며, 정확한 값은 Zen 페이지를 확인하세요. AI Code With 콘솔은 위안화(¥2.736 / ¥13.68)로 표시하며, 콘솔이 쓰는 1달러 ≈ 7.2위안으로 환산했습니다. 서비스 문서에 따르면 과금 규칙은 "공식 단가 × 채널 할인율"입니다. 11-30 이후 공식 가격이 $4 / $20으로 돌아가면 이 규칙으로 추산한 채널 가격은 $0.76 / $3.80입니다. 실제 값은 콘솔에서 확인하세요.
코딩 작업 한 번에 드는 비용
OpenCode는 호출할 때마다 시스템 프롬프트, 도구 정의, 파일 내용, 대화 기록을 다시 보내므로 입력 토큰이 출력보다 훨씬 많습니다. 중간 규모 작업에서 모델을 30번 호출하고, 호출마다 입력 80K, 출력 4K 토큰(사고 포함)이라고 하면 합계는 입력 2.4M, 출력 120K입니다.
| 채널 | 계산 | 비용 |
|---|---|---|
| Google 공식(출시 기념가) | 2.4 × $2 + 0.12 × $10 | $6.00 |
| Google 공식(11-30 이후) | 2.4 × $4 + 0.12 × $20 | $12.00 |
| AI Code With 채널 | 2.4 × $0.38 + 0.12 × $1.90 | $1.14 |
캐시는 계산에 넣지 않았습니다. 캐시가 적중하면 모든 채널에서 입력 비용이 내려갑니다. 실제 토큰 수는 서비스의 사용 기록에서 확인하세요.
OpenCode에서 Argon 연결하기
OpenCode의 모델 카탈로그는 models.dev에서 가져오며, Google, Zen, GitHub Copilot 등이 이미 Argon을 등록했습니다. /models에 보이지 않으면 먼저 OpenCode를 업데이트하세요. 연결 방법은 다음 중 하나를 고르면 됩니다.
| 방법 | opencode.json의 모델 값 | 과금 주체 |
|---|---|---|
| Google AI Studio API 키 | google/gemini-4-argon | Google 계정, 공식 가격 |
| OpenCode Zen | opencode/gemini-4-argon | Zen |
| GitHub Copilot | github-copilot/gemini-4-argon | Copilot 요금제와 조직 정책에 따름 |
| AI Code With | aicodewith-gemini/gemini-4-argon | 채널 가격, 공식 가격의 19% |
방법 1: Google 공식 API
OpenCode에서 /connect를 실행하고 Google을 선택한 뒤 Google AI Studio (opens in a new tab)의 API 키를 입력합니다. Argon은 유료 등급 전용입니다. 무료 등급 키로는 /models에 표시되지 않거나 호출 시 권한 오류가 납니다. 연결한 뒤 /models에서 Gemini 4 Argon을 고르거나 설정에 적습니다.
{
"$schema": "https://opencode.ai/config.json",
"model": "google/gemini-4-argon"
}방법 2: OpenCode Zen
/connect에서 OpenCode Zen을 선택하고 모델 값으로 opencode/gemini-4-argon을 씁니다. 엔드포인트와 팀 설정은 Zen 문서를 참고하세요.
방법 3: AI Code With 사용(81% 할인)
- 이 페이지의 버튼으로 가입한 뒤 콘솔의 "키 관리"에서 API 키를 만듭니다. "채널"에서 Gemini 채널이 켜져 있는지도 확인하세요.
- 터미널에서
export AICODEWITH_API_KEY=내_키를 실행합니다. 키를 프로젝트 파일에 적지 마세요. - 아래 설정을 프로젝트 루트의
opencode.json에 저장하고,opencode를 실행한 뒤/models에서 Gemini 4 Argon을 선택합니다.
{
"$schema": "https://opencode.ai/config.json",
"model": "aicodewith-gemini/gemini-4-argon",
"provider": {
"aicodewith-gemini": {
"npm": "@ai-sdk/google",
"name": "AI Code With Gemini",
"options": {
"baseURL": "https://api.aicodewith.ai/gemini_cli/v1beta",
"apiKey": "{env:AICODEWITH_API_KEY}"
},
"models": {
"gemini-4-argon": {
"name": "Gemini 4 Argon",
"limit": { "context": 1048576, "output": 65536 }
}
}
}
}
}이 엔드포인트는 Gemini 네이티브 프로토콜을 쓰므로 OpenAI 호환 어댑터가 아니라 @ai-sdk/google을 사용합니다. limit은 이 모델의 컨텍스트와 출력 상한을 OpenCode에 알려 줍니다. 같은 채널에서 Claude도 쓴다면 이 provider와 API 플랫폼 페이지의 aicodewith-anthropic을 같은 provider 객체 안에 함께 넣으면 됩니다.
사고 수준 고르기
OpenCode에는 Google 모델용 low, high 변형이 내장되어 있으며 variant_cycle 단축키로 바꿀 수 있습니다(변형 참고). 변형을 고르지 않으면 모델 기본값인 medium이 쓰입니다.
- 대규모 리팩터링, 여러 모듈에 걸친 디버깅:
high. - 문구 수정, 테스트 추가, 작은 수정:
low. 사고 토큰은 출력 가격으로 과금되므로 이런 작업에 더 낼 필요가 없습니다. - 사용자 정의 provider에서 변형이 보이지 않으면 사용자 정의 변형으로 직접 추가하세요.
Gemini 4 Argon 벤치마크
아래 수치는 Google이 자체 발표한 값으로, 발표문과 kingy.ai가 옮겨 적은 제조사 비교표 (opens in a new tab)에서 가져왔습니다. Argon은 가장 높은 사고 수준에서 1회 시도로 측정했고, 비교 모델의 점수는 출처가 제각각입니다. 이 사이트는 이 테스트를 직접 실행하지 않았습니다.
| 벤치마크(작업 유형) | Gemini 4 Argon | Claude Opus 5.5 | GPT-6 Astra | Claude Fable 5.1 |
|---|---|---|---|---|
| DeepSWE v1.1(소프트웨어 엔지니어링) | 77.9% | 74.2% | 74.1% | 67.4% |
| FrontierSWE v2(소프트웨어 엔지니어링) | 55.0% | 62.3% | 65.5% | 56.3% |
| Terminal-bench 4.0(터미널 작업) | 57.4% | 66.4% | 58.2% | 57.9% |
| PostTrainBench(OpenCode에서 10시간 실행) | 45.3% | 49.3% | 44.3% | 40.2% |
| GraphWalks 256K–1M(긴 컨텍스트, F1) | 84.2% | 66.8% | 71.8% | 65.0% |
코딩 관점에서 보면:
- PostTrainBench는 Google이 네 모델 모두를 같은 설정의 OpenCode로 실행했으므로 OpenCode 사용자의 실제 사용 방식에 가장 가깝습니다. Argon은 Opus 5.5보다 약간 낮고, GPT-6 Astra와 Fable 5.1보다는 높습니다.
- 긴 컨텍스트 검색에서는 차이가 큽니다. 큰 저장소나 긴 문서에서 정보를 찾는 작업이라면 Argon을 먼저 시험해 볼 만합니다.
- 긴 터미널 작업(Terminal-bench)에서는 Opus 5.5가 약 9%p 앞섭니다.
- 출시 기념가 기간에는 Argon 공식 가격이 Opus 5.5의 절반입니다. 채널 가격으로는 $0.38 / $1.90으로, 같은 채널의 Sonnet 5.5와 같습니다.
벤치마크에는 여러분의 저장소, 규칙, 도구가 반영되지 않습니다. 기본 모델을 바꾸기 전에 같은 작업을 후보 모델마다 한 번씩 실행해 결과와 실제 비용을 비교하세요.
문제 해결
/models에 Argon이 없음: OpenCode가 오래되어 모델 카탈로그가 갱신되지 않았습니다. Google 키를 쓴다면 계정이 유료 등급인지도 확인하세요.- 404 또는 모델을 찾을 수 없음: 표시 이름이 아니라
gemini-4-argon을 정확히 쓰고, provider 접두사가 설정의 provider ID와 같은지 확인하세요. - 401:
opencode를 실행한 것과 같은 터미널에서 환경 변수를 설정했는지 확인하세요. - 긴 출력이 잘림: 동기 출력의 기본 상한은 65,536 토큰입니다. 작업을 나누거나 모델에게 파일을 나눠서 쓰도록 요청하세요.
- 청구액이 예상보다 높음: 사고 수준을 확인하세요.
high는 출력 가격으로 과금되는 사고 토큰을 많이 만듭니다. 11-30 이후 공식 가격이 두 배가 된다는 점도 기억하세요. - 429 또는 시간 초과: Provider 설정과 문제 해결을 확인하세요.
관련 페이지
- API 플랫폼: Claude, GPT, Gemini 채널 가격
- 모델: 기본 모델, 변형, 모델 옵션.
- Provider: 사용자 정의 provider 작성법.
- Claude Haiku 5.5 가격과 설정