OpenCode 무료 모델 가이드
완전한 무료 LLM 모델과 함께 OpenCode를 사용합니다. API 키나 신용카드가 필요하지 않습니다.
무료 모델 옵션
| Provider | 모델 | 무료 등급 | 요건 |
|---|---|---|---|
| Google Gemini | Gemini 2.5 Flash | 250 요청/일 | Google 계정 |
| Groq | Llama 3.1 8B | 무료 등급 | Groq 계정 |
| Ollama | 다양한 로컬 모델 | 무제한 | GPU 권장 |
| GitHub Copilot | GPT-4o | 무료 등급 | GitHub 계정 |
옵션 1: Google Gemini (권장)
Google Gemini는 신용카드 없이 하루 250개의 무료 요청을 제공합니다.
무료 API 키 받기
- Google AI Studio로 이동
- Google 계정으로 로그인
- “Get API key” 클릭
- API 키 복사
OpenCode 구성
# TUI 시작
opencode tui
# 그런 다음 provider 구성
/connect
# Google 선택하고 API 키 입력
또는 명령줄에서 인증:
opencode auth login --provider google
권장 모델
# Gemini로 OpenCode 시작
opencode tui --model google/gemini-2.5-flash
옵션 2: Ollama (100% 로컬, 무제한)
인터넷 없이 완전히 로컬에서 AI 모델을 실행합니다.
Ollama 설치
macOS/Linux:
curl -fsSL https://ollama.com/install.sh | sh
Windows: ollama.com에서 다운로드
모델 다운로드
# Qwen 2.5 Coder 다운로드 (코딩 권장)
ollama pull qwen2.5-coder
# 또는 Llama 3.1 다운로드
ollama pull llama3.1
# 또는 Code Llama 다운로드
ollama pull codellama
OpenCode 구성
# TUI 시작
opencode tui
# Ollama를 provider로 구성
/connect
# Ollama 선택 (기본값으로 localhost:11434에서 실행)
코딩 시작
opencode tui --model ollama/qwen2.5-coder
옵션 3: Groq (무료 등급)
Groq는 API를 통해 빠른 모델에 무료 액세스를 제공합니다.
API 키 받기
- console.groq.com으로 이동
- 무료 계정 가입
- API 키 생성
- API 키 복사
OpenCode 구성
# TUI 시작
opencode tui
# Groq 구성
/connect
# Groq 선택하고 API 키 입력
코딩 시작
opencode tui --model groq/llama-3.1-8b-instant
옵션 4: GitHub Copilot
GitHub 계정이 있으면 GitHub Copilot을 OpenCode와 함께 사용할 수 있습니다.
OpenCode 구성
# TUI 시작
opencode tui
# GitHub Copilot 구성
/connect
# GitHub 선택하고 브라우저로 인증
무료 옵션 비교
| 기능 | Google Gemini | Ollama | Groq | GitHub Copilot |
|---|---|---|---|---|
| 무료 등급 | 250 요청/일 | 무제한 | 제한됨 | 무료 등급 |
| 개인정보 | 클라우드 | 로컬 | 클라우드 | 클라우드 |
| 속도 | 빠름 | 하드웨어에 따라 | 매우 빠름 | 빠름 |
| 모델 품질 | 우수 | 좋음 | 좋음 | 우수 |
| 오프라인 | ❌ | ✅ | ❌ | ❌ |
무료 모델 사용 팁
- Gemini로 시작: 설정이 가장 쉽고 무료 등급이 가장 많습니다
- 개인정보를 위해 Ollama 사용: 코드를 완전히 로컬에 유지
- 모델 전환: 다양한 작업에 다양한 모델 사용
- 사용량 모니터링:
opencode stats로 API 사용량 확인
문제 해결
레이트 제한
제한에 도달하면:
- 제한이 초기화될 때까지 대기
- 다른 무료 provider로 전환
- 무제한 로컬 사용을 위해 Ollama 사용
느린 성능
모델이 느리면:
- 다른 모델 시도 (Gemini Flash가 Pro보다 빠름)
- 가장 빠른 응답 시간을 위해 Groq 사용
- Ollama의 경우 좋은 GPU가 있는지 확인
인증 문제
인증이 실패하면:
- API 키가 올바른지 확인
- 계정이 활성 상태인지 확인
/connect로 다시 인증 시도