모델 및 제공업체
OpenCode는 모델에 구애받지 않으며 Models.dev를 통해 75개 이상의 LLM 제공업체를 지원합니다. 내장 무료 모델을 사용하거나, 기존 구독에 연결하거나, 자신의 API 키를 가져오세요.
빠른 모델 선택
| 사용 사례 | 추천 모델 | 제공업체 |
|---|---|---|
| 시작하기 | Zen Default | OpenCode (무료) |
| 복잡한 작업 | Zen Advanced | OpenCode (무료) |
| 빠른 응답 | Zen Fast | OpenCode (무료) |
| 최고의 추론 | Claude 3.5 Sonnet | Anthropic |
| 큰 컨텍스트 | Gemini 1.5 Pro | |
| 기존 구독 | GPT-4o | OpenAI |
내장 모델 (Zen)
가장 쉬운 시작 방법은 OpenCode Zen을 사용하는 것입니다 - API 키 불필요:
opencode auth login --provider zen
내장 모델에 대한 자세한 내용은 OpenCode Zen을 참조하세요.
주요 제공업체
Anthropic (Claude)
Claude 모델은 뛰어난 추론과 코드 이해로 알려져 있습니다.
사용 가능한 모델:
- Claude 3.5 Sonnet (추천)
- Claude 3.5 Haiku
- Claude 3 Opus
설정:
opencode auth login --provider anthropic
또는 수동으로 구성:
{
"provider": "anthropic",
"model": "claude-3-5-sonnet-20241022",
"apiKey": "your-api-key"
}
API 키 얻기: Anthropic Console
OpenAI (GPT)
GPT 모델은 강력한 범용 기능을 제공합니다.
사용 가능한 모델:
- GPT-4o (추천)
- GPT-4o Mini
- GPT-4 Turbo
- o1-preview
- o1-mini
설정:
opencode auth login --provider openai
또는 수동으로 구성:
{
"provider": "openai",
"model": "gpt-4o",
"apiKey": "your-api-key"
}
API 키 얻기: OpenAI Platform
Google (Gemini)
Gemini는 가장 큰 컨텍스트 윈도우(최대 1M 토큰)를 제공합니다.
사용 가능한 모델:
- Gemini 1.5 Pro (추천)
- Gemini 1.5 Flash
- Gemini 1.0 Pro
설정:
opencode auth login --provider google
또는 수동으로 구성:
{
"provider": "google",
"model": "gemini-1.5-pro",
"apiKey": "your-api-key"
}
API 키 얻기: Google AI Studio
구독 통합
GitHub Copilot
기존 GitHub Copilot 구독 사용:
opencode auth login --provider github
브라우저가 열리고 GitHub로 인증합니다.
ChatGPT Plus/Pro
ChatGPT Plus 또는 Pro 구독 사용:
opencode auth login --provider openai
인증 중에 ChatGPT 옵션을 선택합니다.
로컬 모델
OpenCode는 프라이버시와 오프라인 사용을 위해 로컬 모델을 지원합니다:
Ollama
# Ollama 설치
curl -fsSL https://ollama.ai/install.sh | sh
# 모델 풀
ollama pull codellama
# OpenCode 구성
opencode auth login --provider ollama
LM Studio
- LM Studio 다운로드 및 설치
- LM Studio에서 모델 로드
- 로컬 서버 시작
- OpenCode 구성:
{
"provider": "openai-compatible",
"baseUrl": "http://localhost:1234/v1",
"model": "local-model"
}
지원되는 모든 제공업체
OpenCode는 Models.dev를 통해 75개 이상의 제공업체를 지원합니다:
| 제공업체 | 모델 | 최적 |
|---|---|---|
| Anthropic | Claude 3.5, Claude 3 | 추론, 코드 |
| OpenAI | GPT-4o, GPT-4, o1 | 범용 |
| Gemini 1.5, Gemini 1.0 | 큰 컨텍스트 | |
| Mistral | Mistral Large, Medium | 유럽 데이터 |
| Cohere | Command R+ | 기업 |
| Replicate | 다양한 | 오픈 소스 모델 |
| Together AI | 다양한 | 오픈 소스 모델 |
| Groq | Llama, Mixtral | 빠른 추론 |
| Perplexity | 다양한 | 웹 검색 |
| Azure OpenAI | GPT-4, GPT-4o | 기업 |
| AWS Bedrock | 다양한 | AWS 통합 |
| … | … | … |
모델 구성
구성 파일
모델은 ~/.config/opencode/config.json에서 구성됩니다:
{
"provider": "anthropic",
"model": "claude-3-5-sonnet-20241022",
"apiKey": "your-api-key",
"baseUrl": "optional-custom-url",
"contextWindow": 200000,
"maxTokens": 4096
}
모델 전환
TUI에서:
/model gpt-4o
/provider openai
CLI를 통해:
opencode tui --model claude-3-5-sonnet-20241022 --provider anthropic
환경 변수:
export OPENCODE_PROVIDER=anthropic
export OPENCODE_MODEL=claude-3-5-sonnet-20241022
export ANTHROPIC_API_KEY=your-key
모델 매개변수
컨텍스트 윈도우
모델이 볼 수 있는 컨텍스트 양 제어:
{
"contextWindow": 128000
}
최대 토큰
응답 길이 제어:
{
"maxTokens": 4096
}
온도
무작위성 제어 (모든 모델이 지원하지 않음):
{
"temperature": 0.7
}
모범 사례
모델 선택
- Zen으로 시작: 무료이며 코딩에 최적화
- 특정 요구에 맞게 업그레이드: 추론을 위해 Claude, 큰 컨텍스트를 위해 Gemini
- 구독 사용: 기존 GitHub Copilot 또는 ChatGPT 구독 활용
비용 최적화
- Zen 무료 티어 사용: 하루 100 요청
- 적절한 모델 선택: 간단한 작업에 GPT-4 사용하지 않기
- 사용량 모니터링: 정기적으로
opencode stats실행
성능
- 컨텍스트 윈도우: 더 큰 것이 항상 더 좋은 것은 아님
- 모델 선택: 간단한 작업에 더 빠른 모델
- 캐싱: OpenCode는 가능한 경우 응답을 캐시
문제 해결
API 키 문제
# API 키가 설정되었는지 확인
opencode auth status
# 재인증
opencode auth login --provider anthropic
모델을 사용할 수 없음
- 모델 이름이 올바른지 확인
- API 키가 모델에 액세스할 수 있는지 확인
- 제공업체 상태 페이지 확인
속도 제한
- 요청 빈도 줄이기
- 플랜 업그레이드
- 다른 제공업체로 전환