Ch9. 모델 선택
75개+ LLM 프로바이더 지원, model·small_model 분리, 추론 강도 변형(variants), 모델 선택 우선순위, 사내 게이트웨이 커스텀 프로바이더 등록을 정리합니다.
핵심 요약
- OpenCode는 Anthropic·OpenAI·Google부터 Ollama·OpenRouter까지 75개+ LLM 프로바이더와 로컬 모델(OpenAI 호환 엔드포인트)을 지원합니다.
- 메인 작업은
model, 요약·탐색·세션 제목 같은 보조 작업은small_model로 분리해 비용을 절감합니다. - 모델 선택은 CLI
--model→ 설정model→ 마지막 사용 모델 → 내부 기본 모델 순으로 결정됩니다. - 프로바이더별 추론 강도 변형(Anthropic
high/max, OpenAIminimal~xhigh)으로 품질과 비용을 조절합니다. @ai-sdk/openai-compatible로 사내 AI 게이트웨이를 커스텀 프로바이더로 등록하고 모델별 컨텍스트·출력 한도를 지정할 수 있습니다.
OpenCode는 75개 이상의 LLM 프로바이더를 지원합니다. 작업 성격에 맞춰 모델을 나눠 쓰면 비용 대비 효율이 가장 좋습니다.
주요 프로바이더
퍼스트파티
| 서비스 | 설명 |
|---|---|
| OpenCode Zen | 팀이 검증한 큐레이션 모델 (/connect로 설정) |
| OpenCode Go | 저비용 구독형 오픈 코딩 모델 |
클라우드 프로바이더
| 프로바이더 | 주요 모델 |
|---|---|
| Anthropic | Claude Opus 4.6, Claude Sonnet 4.6, Claude Haiku 4.5 |
| OpenAI | GPT 5.4, GPT 5.2, GPT 5.1 Codex, O1/O3/O4 패밀리 |
| Gemini 3 Pro, Gemini 3.1 Medium, Gemini 2.5 Flash | |
| Amazon Bedrock | AWS 경유 Claude 모델 |
| Azure OpenAI | Azure 경유 GPT 모델 |
| Google Vertex AI | GCP 경유 Gemini 모델 |
| GitHub Copilot | 멀티모델 접근 (구독 필요) |
기타 프로바이더
DeepSeek, Groq, Fireworks AI, Together AI, OpenRouter, Ollama, xAI, Hugging Face, Cloudflare AI Gateway, SAP AI Core, Venice AI 등 75+ 프로바이더를 지원합니다.
로컬 모델 사용
| 도구 | 설정 방식 |
|---|---|
| Ollama | OpenAI 호환 엔드포인트 |
| LM Studio | OpenAI 호환 엔드포인트 |
| llama.cpp | llama-server 경유 |
모델 설정
{
"model": "anthropic/claude-sonnet-4-5",
"small_model": "anthropic/claude-haiku-4-5"
}small_model은 요약·탐색·세션 제목 생성 같은 보조 작업에 쓰입니다.
모델 선택 우선순위
| 우선순위 | 소스 |
|---|---|
| 1 | CLI 플래그 (--model 또는 -m) |
| 2 | 설정 파일의 model 값 |
| 3 | 마지막 사용한 모델 |
| 4 | 내부 우선순위 기본 모델 |
모델 변형 (Variants)
프로바이더별로 추론 강도를 조절할 수 있습니다.
| 프로바이더 | 변형 옵션 |
|---|---|
| Anthropic | high (기본), max |
| OpenAI | none, minimal, low, medium, high, xhigh |
low, high |
v1.2.8+ 추가
Claude Sonnet 4.6에 대한 어댑티브 씽킹이 v1.2.8에서 추가되었습니다. Claude Opus 4.6은 v1.2.0부터 어댑티브 리즈닝을 지원합니다. v1.2.19에서 GPT-5.4 Codex 지원, v1.2.24에서 Copilot GPT-5.4 xhigh 추론 지원이 추가되었습니다.
v1.3.x 프로바이더 업데이트
| 변경 | 버전 | 설명 |
|---|---|---|
| Poe 인증 프로바이더 | v1.3.1 | Poe 내장 인증으로 모델 접근 |
| Amazon Bedrock 토큰 캐싱 | v1.3.1 | Bedrock 인증 토큰을 캐싱하여 API 호출 속도 개선 |
| Azure 비-OpenAI 엔드포인트 | v1.2.25 | Azure 경유 비-OpenAI 모델 completions 지원 |
| Vertex AI 위치(location) | v1.2.25 | GCP 리전별 Vertex AI 엔드포인트 지정 |
| SAP 추론 변형 | v1.2.25 | SAP AI Core thinking variant 지원 |
| GitLab 1M 컨텍스트 | v1.2.24 | context-1m-2025-08-07 헤더 지원 |
| Cloudflare 메타데이터 | v1.2.16 | AI Gateway 메타데이터 포워딩 |
커스텀 프로바이더 등록
사내 AI 게이트웨이나 비표준 프로바이더를 등록할 수 있습니다.
{
"provider": {
"internal-gateway": {
"npm": "@ai-sdk/openai-compatible",
"name": "사내 AI 게이트웨이",
"options": {
"baseURL": "https://ai-gateway.company.com/v1",
"apiKey": "{env:INTERNAL_API_KEY}"
},
"models": {
"company-model-v2": {
"name": "Company Model V2",
"limit": {
"context": 200000,
"output": 65536
}
}
}
}
}
}고급 팁
- Plan vs Build 분리: Plan은 추론이 강한
claude-opus-4-5, Build는claude-sonnet-4-5 - small_model 활용: 요약/탐색 작업은
claude-haiku-4-5로 비용 절감 - 커맨드별 모델 지정: 고비용 커맨드만 제한적으로 프리미엄 모델 사용
- F2 키 활용: 최근 사용 모델 간 빠른 전환
/connect활용: OpenCode Zen 구독으로 프로바이더 설정 간소화