O modelo certo
para cada turno.

Selecionar, fixar e variar modelos é parte do fluxo — por sessão, por agente e por variante de reasoning. O MVCode trata modelo como escolha de engenharia, não como configuração escondida.

01Selecionando

/models

A lista agrupa por provedor conectado, com tags de free/latest e busca. Poucos modelos são bons em código e tool calling ao mesmo tempo — bons pontos de partida hoje: GPT 5.2, GPT 5.1 Codex, Claude Opus 4.5, Claude Sonnet 4.5, Minimax M2.1 e Gemini 3 Pro.

02Modelo padrão

{
  "model": "anthropic/claude-sonnet-4-5"
}

O formato é sempre provider_id/model_id. Para provedores customizados, os ids vêm das chaves da sua config.

03Opções por modelo

Configure comportamento global de um modelo — reasoning, verbosidade, thinking budget — na seção do provedor:

{
  "provider": {
    "openai": {
      "models": {
        "gpt-5": {
          "options": { "reasoningEffort": "high", "textVerbosity": "low" }
        }
      }
    },
    "anthropic": {
      "models": {
        "claude-sonnet-4-5": {
          "options": { "thinking": { "type": "enabled", "budgetTokens": 16000 } }
        }
      }
    }
  }
}

A config do agente sobrepõe essas opções globais — o plan pode pensar mais, o build pode responder mais direto.

04Variantes

O mesmo modelo, em intensidades diferentes. O MVCode embarca variantes padrão por provedor e aceita as suas:

{
  "provider": {
    "openai": {
      "models": {
        "gpt-5": {
          "variants": {
            "thinking": { "reasoningEffort": "high", "textVerbosity": "low" },
            "fast": { "disabled": true }
          }
        }
      }
    }
  }
}

Na TUI, alterne com ctrl+t (keybind variant_cycle). Em mvcode run, use --variant.

05Ordem de resolução

Na inicialização, o modelo ativo é decidido nesta ordem:

1. Flag --model / -m na linha de comando.
2. model na config.
3. O último modelo usado.
4. O primeiro disponível, por prioridade interna.