모델

LLM 프로바이더와 모델 설정하기.

OpenCode는 AI SDK (opens in a new tab)와 Models.dev (opens in a new tab)를 사용하여 75개 이상의 LLM 프로바이더를 지원하며 로컬 모델 실행도 지원합니다.

프로바이더

대부분의 인기 프로바이더는 기본적으로 사전 로드됩니다. /connect 명령을 통해 프로바이더의 자격 증명을 추가했다면 OpenCode 시작 시 사용할 수 있습니다.

프로바이더에 대해 자세히 알아보세요.

모델 선택

프로바이더를 설정한 후 다음을 입력하여 원하는 모델을 선택할 수 있습니다:

/models

권장 모델

많은 모델이 있으며 매주 새로운 모델이 출시됩니다.

팁: 권장 모델 중 하나를 사용하는 것을 고려해 보세요.

그러나 코드 생성과 도구 호출 모두에 뛰어난 모델은 소수에 불과합니다.

다음은 OpenCode와 잘 작동하는 몇 가지 모델입니다(순서 무관). (이것은 완전한 목록이 아니며 반드시 최신 정보는 아닙니다):

GPT 5.2
GPT 5.1 Codex
Claude Opus 4.5
Claude Sonnet 4.5
Minimax M2.1
Gemini 3 Pro

기본값 설정

이 중 하나를 기본 모델로 설정하려면 OpenCode 설정에서 model 키를 설정할 수 있습니다.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "lmstudio/google/gemma-3n-e4b"
}

여기서 전체 ID는 provider_id/model_id입니다. 예를 들어 OpenCode Zen을 사용하는 경우 GPT 5.1 Codex에 opencode/gpt-5.1-codex를 사용합니다.

사용자 정의 프로바이더를 설정한 경우 provider_id는 설정의 provider 부분의 키이고 model_id는 provider.models의 키입니다.

모델 설정

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

opencode.jsonc

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

여기서 두 개의 내장 모델에 대한 전역 설정을 구성합니다: openai 프로바이더를 통해 액세스하는 gpt-5와 anthropic 프로바이더를 통해 액세스하는 claude-sonnet-4-20250514. 내장 프로바이더 및 모델 이름은 Models.dev (opens in a new tab)에서 찾을 수 있습니다.

사용 중인 에이전트에 대해서도 이러한 옵션을 구성할 수 있습니다. 에이전트 설정은 여기의 전역 옵션을 재정의합니다. 자세히 알아보기.

내장 변형을 확장하는 사용자 정의 변형도 정의할 수 있습니다. 변형을 사용하면 중복 항목을 만들지 않고 동일한 모델에 대해 다른 설정을 구성할 수 있습니다:

opencode.jsonc

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "opencode": {
      "models": {
        "gpt-5": {
          "variants": {
            "high": {
              "reasoningEffort": "high",
              "textVerbosity": "low",
              "reasoningSummary": "auto",
            },
            "low": {
              "reasoningEffort": "low",
              "textVerbosity": "low",
              "reasoningSummary": "auto",
            },
          },
        },
      },
    },
  },
}

변형

많은 모델이 다른 구성을 가진 여러 변형을 지원합니다. 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": {
          "variants": {
            "thinking": {
              "reasoningEffort": "high",
              "textVerbosity": "low",
            },
            "fast": {
              "disabled": true,
            },
          },
        },
      },
    },
  },
}

변형 순환

키바인드 variant_cycle을 사용하여 변형 간에 빠르게 전환합니다. 자세히 알아보기.

모델 로딩

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

--model 또는 -m 명령줄 플래그. 형식은 설정 파일과 동일합니다: provider_id/model_id.

OpenCode 설정의 모델 목록.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-20250514"
}

여기서 형식은 provider/model입니다.

마지막으로 사용된 모델.
내부 우선순위에 따른 첫 번째 모델.

에이전트 테마