모델 및 제공업체

OpenCode는 모델에 구애받지 않으며 AI SDK와 Models.dev를 통해 75개 이상의 LLM 제공업체를 지원하며, 로컬 모델 실행도 지원합니다.

제공업체

대부분의 인기 제공업체는 기본적으로 사전 로드됩니다. /connect 명령어로 제공업체의 자격 증명을 추가한 경우, OpenCode 시작 시 사용할 수 있습니다.

제공업체에 대한 자세한 내용은 여기를 참조하세요.

모델 선택

제공업체를 구성한 후 다음 명령어로 모델을 선택할 수 있습니다:

/models

권장 모델

시장에는 많은 모델이 있으며, 매주 새로운 모델이 출시되고 있습니다.

팁 권장 모델 사용을 고려하세요.

하지만 코드 생성과 도구 호출 모두에 뛰어난 모델은 몇 개뿐입니다.

다음은 OpenCode와 잘 작동하는 모델입니다 (권장순, 완전한 목록은 아님):

모델	제공업체	특징
GPT 5.5	OpenAI	최신 플래그십, 종합적으로 가장 강력
Claude Fable 5	Anthropic	최신 Claude, 뛰어난 추론 능력
Claude Sonnet 4.6	Anthropic	가성비 최고, 코드 이해 우수
GPT 5.4	OpenAI	안정적이고 널리 사용됨
Gemini 3.5 Flash	Google	초고속 응답, 큰 컨텍스트
Qwen3.7 Max	Alibaba Cloud	중국어 이해 최적
DeepSeek V4 Flash	DeepSeek	가성비 우수
MiniMax M2.7	MiniMax	균형 잡힌 성능

기본 모델 설정

모델을 기본값으로 설정하려면 OpenCode 구성에서 model 필드를 설정합니다:

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-fable-5"
}

전체 ID 형식은 provider_id/model_id입니다. 예를 들어, OpenCode Zen을 사용하는 경우 opencode/gpt-5.5를 사용합니다.

사용자 정의 제공업체를 구성한 경우, provider_id는 구성의 provider 부분의 키이고, model_id는 provider.models의 키입니다.

모델 구성

구성 파일을 통해 모델 옵션을 전역적으로 설정할 수 있습니다:

opencode.jsonc

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openai": {
      "models": {
        "gpt-5.5": {
          "options": {
            "reasoningEffort": "high",
            "textVerbosity": "low",
            "reasoningSummary": "auto",
            "include": ["reasoning.encrypted_content"]
          }
        }
      }
    },
    "anthropic": {
      "models": {
        "claude-fable-5": {
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 16000
            }
          }
        }
      }
    }
  }
}

여기서는 openai 제공업체를 통해 접근하는 gpt-5.5와 anthropic 제공업체를 통해 접근하는 claude-fable-5에 대한 전역 설정을 구성합니다. 내장 제공업체 및 모델 이름은 Models.dev에서 확인할 수 있습니다.

사용하는 에이전트에도 이러한 옵션을 구성할 수 있습니다. 에이전트 구성은 여기의 전역 옵션을 재정의합니다. 자세히.

모델 변형

많은 모델이 다른 구성을 가진 여러 변형을 지원합니다. OpenCode는 인기 제공업체에 내장 기본 변형을 제공합니다.

내장 변형

OpenCode는 많은 제공업체에 기본 변형을 제공합니다:

Anthropic:

high - 높은 사고 예산 (기본값)
max - 최대 사고 예산

OpenAI: 모델에 따라 다르지만 대략:

none - 추론 없음
minimal - 최소 추론
low - 낮은 추론
medium - 중간 추론
high - 높은 추론
xhigh - 매우 높은 추론

Google:

low - 낮은 노력/토큰 예산
high - 높은 노력/토큰 예산

팁 이 목록은 완전하지 않습니다. 다른 많은 제공업체에도 내장 기본값이 있습니다.

사용자 정의 변형

기존 변형을 재정의하거나 자신만의 변형을 추가할 수 있습니다:

opencode.jsonc

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openai": {
      "models": {
        "gpt-5.5": {
          "variants": {
            "thinking": {
              "reasoningEffort": "high",
              "textVerbosity": "low"
            },
            "fast": {
              "disabled": true
            }
          }
        }
      }
    }
  }
}

변형 순환

variant_cycle 키바인드를 사용하여 변형을 빠르게 전환할 수 있습니다. 자세히.

내장 모델 (Zen)

가장 쉬운 시작 방법은 OpenCode Zen을 사용하는 것입니다 - API 키 불필요:

opencode auth login --provider zen

내장 모델에 대한 자세한 내용은 OpenCode Zen을 참조하세요.

주요 제공업체

Anthropic (Claude)

Claude 모델은 뛰어난 추론과 코드 이해로 알려져 있습니다.

최신 모델:

Claude Fable 5 (최신 플래그십)
Claude Opus 4.8, 4.7, 4.6, 4.5
Claude Sonnet 4.6, 4.5
Claude Haiku 4.5

설정:

opencode auth login --provider anthropic

또는 수동으로 구성:

{
  "provider": "anthropic",
  "apiKey": "sk-ant-..."
}

사용 사례:

복잡한 추론: 다단계 문제 해결에 최적
코드 이해: 대규모 코드베이스 분석에 우수
문서 생성: 상세 문서 생성에 적합

API 키 얻기: Anthropic Console

OpenAI (GPT)

GPT 모델은 범용 코딩 작업에 뛰어나며 강력한 도구 사용 기능을 갖추고 있습니다.

최신 모델:

GPT 5.5, GPT 5.5 Pro (최신 플래그십)
GPT 5.4, GPT 5.4 Pro, GPT 5.4 Mini, GPT 5.4 Nano
GPT 5.3 Codex, GPT 5.3 Codex Spark
GPT 5.2, GPT 5.2 Codex
GPT 5.1, GPT 5.1 Codex

설정:

opencode auth login --provider openai

또는 수동으로 구성:

{
  "provider": "openai",
  "apiKey": "sk-..."
}

사용 사례:

범용 코딩: 대부분의 코딩 작업에 적합
빠른 반복: 빠른 개발을 위한 빠른 응답
도구 통합: 강력한 함수 호출 기능

API 키 얻기: OpenAI Platform

Google (Gemini)

Gemini 모델은 큰 컨텍스트 윈도우와 강력한 멀티모달 기능을 제공합니다.

최신 모델:

Gemini 3.5 Flash (권장, 초고속)
Gemini 3.1 Pro (큰 컨텍스트)
Gemini 3 Flash

설정:

opencode auth login --provider google

또는 수동으로 구성:

{
  "provider": "google",
  "apiKey": "AIza..."
}

사용 사례:

대규모 코드베이스: 초대형 컨텍스트 윈도우
빠른 응답: 빠른 작업을 위한 Flash 모델
멀티모달: 이미지 및 다이어그램 분석 가능

API 키 얻기: Google AI Studio

Alibaba Cloud (Qwen)

Qwen 모델은 중국어 이해와 코드 생성에 뛰어납니다.

최신 모델:

Qwen3.7 Max (플래그십)
Qwen3.7 Plus
Qwen3.6 Plus
Qwen3.5 Plus

설정:

opencode auth login --provider qwen

사용 사례:

중국어 코딩: 중국어 이해에 최적
코드 생성: 프로그래밍에 최적화
가성비: 비교적 저렴한 가격

DeepSeek

DeepSeek는 가성비 높은 코딩 모델을 제공합니다.

최신 모델:

DeepSeek V4 Flash (유료)
DeepSeek V4 Flash Free (무료, 기간 한정)

설정:

opencode auth login --provider deepseek

MiniMax

MiniMax는 균형 잡힌 성능의 모델을 제공합니다.

최신 모델:

MiniMax M2.7
MiniMax M2.5

설정:

opencode auth login --provider minimax

Zhipu (GLM)

Zhipu는 강력한 중국어 모델을 제공합니다.

최신 모델:

GLM 5.1
GLM 5

설정:

opencode auth login --provider zhipu

Moonshot AI (Kimi)

Kimi 모델은 긴 컨텍스트 이해에 뛰어납니다.

최신 모델:

Kimi K2.6
Kimi K2.5

설정:

opencode auth login --provider moonshot

추가 제공업체

Groq

지원 모델에 대한 초고속 추론.

사용 가능한 모델:

Llama 3.3 70B
Mixtral 8x7B
Gemma 2 9B

설정:

opencode auth login --provider groq

GitHub Copilot

기존 GitHub Copilot 구독 사용:

opencode auth login --provider github

GitHub 인증을 위해 브라우저가 열립니다.

Azure OpenAI

엔터프라이즈 기능을 갖춘 Azure 호스팅 OpenAI 모델 사용:

사용 가능한 모델:

GPT-5.5
GPT-5.4
GPT-4o

설정:

opencode auth login --provider azure

xAI (Grok)

xAI의 Grok 모델.

사용 가능한 모델:

Grok Build 0.1

설정:

opencode auth login --provider xai

무료 모델

OpenCode Zen은 여러 무료 모델을 제공합니다 (기간 한정):

모델	비고
DeepSeek V4 Flash Free	기간 한정 무료, 모델 개선에 사용될 수 있음
MiMo-V2.5 Free	기간 한정 무료, 모델 개선에 사용될 수 있음
North Mini Code Free	기간 한정 무료, 모델 개선에 사용될 수 있음
Nemotron 3 Ultra Free	NVIDIA 제공, 시험용만
Big Pickle	스텔스 모델, 기간 한정 무료

무료 모델 사용:

opencode auth login --provider zen

그런 다음 TUI에서 /models를 실행하여 무료 모델을 선택합니다.

로컬 모델

Ollama를 사용하여 로컬에서 모델을 실행하여 완전한 프라이버시를 보호합니다.

Ollama

설정:

ollama.com에서 Ollama 설치
모델 풀기:

ollama pull llama3.3
ollama pull qwen3-coder
ollama pull deepseek-coder-v2

OpenCode 구성:

opencode auth login --provider ollama

권장 로컬 모델:

Llama 3.3 70B: 최고 품질 (40GB 이상 RAM 필요)
Llama 3.3 8B: 품질과 속도의 균형 (8GB 이상 RAM 필요)
Qwen3 Coder: 우수한 코드 이해
DeepSeek Coder V2: 강력한 코딩 모델

사용 사례:

프라이버시: 코드가 기기를 떠나지 않음
오프라인: 인터넷 연결 없이 작동
비용: 설정 후 API 비용 없음

LM Studio

LM Studio 다운로드 및 설치
LM Studio에서 모델 로드
로컬 서버 시작
OpenCode 구성:

{
  "provider": "lmstudio",
  "npm": "@ai-sdk/openai-compatible",
  "name": "LM Studio (local)",
  "options": {
    "baseURL": "http://127.0.0.1:1234/v1"
  },
  "models": {
    "google/gemma-3n-e4b": {
      "name": "Gemma 3n-e4b (local)"
    }
  }
}

모델 비교

제공업체	최신 모델	최적	속도	프라이버시
Anthropic	Claude Fable 5	복잡한 추론	보통	클라우드
OpenAI	GPT 5.5	범용 코딩	보통	클라우드
Google	Gemini 3.5 Flash	빠른 응답	빠름	클라우드
Alibaba	Qwen3.7 Max	중국어 코딩	보통	클라우드
DeepSeek	V4 Flash	가성비	빠름	클라우드
Groq	Llama 3.3	속도	매우 빠름	클라우드
GitHub	Copilot	기존 구독	보통	클라우드
Ollama	로컬 모델	프라이버시	하드웨어에 따라	로컬

지원되는 모든 제공업체

OpenCode는 Models.dev를 통해 75개 이상의 제공업체를 지원합니다:

주요 제공업체: Anthropic, OpenAI, Google, Microsoft Azure
중국 제공업체: Alibaba Cloud, DeepSeek, MiniMax, Zhipu, Moonshot AI
클라우드 플랫폼: AWS Bedrock, Google Vertex AI, Azure OpenAI
추론 플랫폼: Groq, OpenRouter, Together AI, Fireworks AI
로컬 실행: Ollama, LM Studio, llama.cpp
구독 서비스: GitHub Copilot, ChatGPT Plus/Pro
엔터프라이즈: SAP AI Core, Snowflake Cortex, Scaleway

모든 제공업체 보기 →

모델 로딩

OpenCode 시작 시 다음 우선순위로 모델을 확인합니다:

--model 또는 -m 명령줄 플래그. 형식은 구성 파일과 동일: provider_id/model_id.

OpenCode 구성의 모델 목록.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-fable-5"
}

형식은 provider/model.

마지막으로 사용한 모델.
내부 우선순위를 사용한 첫 번째 모델.

지원 중단된 모델

다음 모델은 지원 중단되었거나 곧 지원 중단됩니다:

모델	지원 중단일
Gemini 3 Pro	2026년 3월 9일
MiniMax M2.1	2026년 3월 15일
Claude Sonnet 4	2026년 6월 15일
GPT 5.1 Codex 시리즈	2026년 7월 23일

이러한 모델의 최신 대체 모델을 사용하세요.

문제 해결

속도 제한

속도 제한에 도달한 경우:

제한이 리셋될 때까지 기다리기
다른 제공업체로 전환
로컬 모델 (Ollama) 사용
무료 모델 (DeepSeek V4 Flash Free 등) 사용

API 오류

일반적인 문제:

401 Unauthorized: API 키 확인
429 Rate Limited: 할당량 초과
500 Server Error: 제공업체 문제, 나중에 재시도

모델을 찾을 수 없음

모델을 사용할 수 없는 경우:

모델 이름이 올바른지 확인
제공업체가 해당 모델을 지원하는지 확인
모델에 특별한 액세스가 필요한지 확인

모델 및 제공업체

제공업체

모델 선택

권장 모델

기본 모델 설정

모델 구성

모델 변형

내장 변형

사용자 정의 변형

변형 순환

내장 모델 (Zen)

주요 제공업체

Anthropic (Claude)

OpenAI (GPT)

Google (Gemini)

Alibaba Cloud (Qwen)

DeepSeek

MiniMax

Zhipu (GLM)

Moonshot AI (Kimi)

추가 제공업체

Groq

GitHub Copilot

Azure OpenAI

xAI (Grok)

무료 모델

로컬 모델

Ollama

LM Studio

모델 비교

지원되는 모든 제공업체

모델 로딩

지원 중단된 모델

문제 해결

속도 제한

API 오류

모델을 찾을 수 없음

다음 단계