컨텐츠로 건너뛰기

OpenCode 무료 모델 가이드

완전한 무료 LLM 모델과 함께 OpenCode를 사용합니다. API 키나 신용카드가 필요하지 않습니다.

무료 모델 옵션

Provider모델무료 등급요건
Google GeminiGemini 2.5 Flash250 요청/일Google 계정
GroqLlama 3.1 8B무료 등급Groq 계정
Ollama다양한 로컬 모델무제한GPU 권장
GitHub CopilotGPT-4o무료 등급GitHub 계정

옵션 1: Google Gemini (권장)

Google Gemini는 신용카드 없이 하루 250개의 무료 요청을 제공합니다.

무료 API 키 받기

  1. Google AI Studio로 이동
  2. Google 계정으로 로그인
  3. “Get API key” 클릭
  4. 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 키 받기

  1. console.groq.com으로 이동
  2. 무료 계정 가입
  3. API 키 생성
  4. 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 GeminiOllamaGroqGitHub Copilot
무료 등급250 요청/일무제한제한됨무료 등급
개인정보클라우드로컬클라우드클라우드
속도빠름하드웨어에 따라매우 빠름빠름
모델 품질우수좋음좋음우수
오프라인

무료 모델 사용 팁

  1. Gemini로 시작: 설정이 가장 쉽고 무료 등급이 가장 많습니다
  2. 개인정보를 위해 Ollama 사용: 코드를 완전히 로컬에 유지
  3. 모델 전환: 다양한 작업에 다양한 모델 사용
  4. 사용량 모니터링: opencode stats로 API 사용량 확인

문제 해결

레이트 제한

제한에 도달하면:

  • 제한이 초기화될 때까지 대기
  • 다른 무료 provider로 전환
  • 무제한 로컬 사용을 위해 Ollama 사용

느린 성능

모델이 느리면:

  • 다른 모델 시도 (Gemini Flash가 Pro보다 빠름)
  • 가장 빠른 응답 시간을 위해 Groq 사용
  • Ollama의 경우 좋은 GPU가 있는지 확인

인증 문제

인증이 실패하면:

  • API 키가 올바른지 확인
  • 계정이 활성 상태인지 확인
  • /connect로 다시 인증 시도