Pular para o conteúdo
Docs de V1
Provedores

Modelos

O opencode usa o AI SDK e Models.dev para suportar 75+ provedores LLM e suporta a execução de modelos locais.

Os provedores mais populares são pré-carregados por padrão. Se você adicionou as credenciais para um provedor através do comando /connect, elas estarão disponíveis quando você iniciar o opencode.

Saiba mais sobre provedores.

Depois de configurar seu provedor, você pode selecionar o modelo que deseja digitando:

Terminal
/models

Existem muitos modelos disponíveis, com novos modelos sendo lançados toda semana.

No entanto, há apenas alguns deles que são bons tanto em gerar código quanto em chamar ferramentas.

Aqui estão vários modelos que funcionam bem com o opencode, em nenhuma ordem específica. (Esta não é uma lista exaustiva nem necessariamente atualizada):

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

Para definir um desses como o modelo padrão, você pode definir a chave model na sua configuração do opencode.

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

Aqui, o ID completo é provider_id/model_id. Por exemplo, se você estiver usando OpenCode Models, você usaria opencode/gpt-6.1-sol para GPT-6.1 Sol.

Se você configurou um provedor personalizado, o provider_id é a chave da parte provider da sua configuração, e o model_id é a chave de provider.models.

Você pode configurar globalmente as opções de um modelo através da configuração.

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

Aqui estamos configurando as configurações globais para dois modelos integrados: gpt-6.1-sol quando acessado via o provedor openai, e claude-sonnet-5-5 quando acessado via o provedor anthropic. Os nomes dos provedores e modelos integrados podem ser encontrados em Models.dev.

Você também pode configurar essas opções para quaisquer agentes que estiver usando. A configuração do agente substitui quaisquer opções globais aqui. Saiba mais.

Você também pode definir variantes personalizadas que estendem as integradas. As variantes permitem que você configure diferentes configurações para o mesmo modelo sem criar entradas duplicadas:

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

Muitos modelos suportam várias variantes com diferentes configurações. O opencode vem com variantes padrão integradas para provedores populares.

O opencode vem com variantes padrão para muitos provedores:

Anthropic:

  • high - Orçamento de pensamento alto (padrão)
  • max - Orçamento de pensamento máximo

OpenAI:

Varia por modelo, mas aproximadamente:

  • none - Sem raciocínio
  • minimal - Esforço de raciocínio mínimo
  • low - Baixo esforço de raciocínio
  • medium - Esforço de raciocínio médio
  • high - Alto esforço de raciocínio
  • xhigh - Esforço de raciocínio extra alto

Google:

  • low - Orçamento de esforço/token mais baixo
  • high - Orçamento de esforço/token mais alto

Você pode substituir variantes existentes ou adicionar as suas:

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

Use a tecla de atalho variant_cycle para alternar rapidamente entre variantes. Saiba mais.

Quando o opencode é iniciado, ele verifica modelos na seguinte ordem de prioridade:

  1. A flag de linha de comando --model ou -m. O formato é o mesmo que no arquivo de configuração: provider_id/model_id.

  2. A lista de modelos na configuração do opencode.

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

    O formato aqui é provider/model.

  3. O último modelo usado.

  4. O primeiro modelo usando uma prioridade interna.