> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mka1.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Modelos e provedores

> Escolha um modelo do gateway, configure o padrão e adicione um provedor compatível para Código local.

export const ScreenshotCrop = ({src, alt, width, height, x = 0, y = 0, cropWidth = width, cropHeight = height, maxWidth = "100%"}) => <div className="not-prose" style={{
  position: "relative",
  overflow: "hidden",
  width: "100%",
  maxWidth,
  margin: "0 auto",
  aspectRatio: `${cropWidth} / ${cropHeight}`
}}>
    <img src={src} alt={alt} width={width} height={height} style={{
  position: "absolute",
  display: "block",
  margin: 0,
  maxWidth: "none",
  width: `${width / cropWidth * 100}%`,
  height: "auto",
  left: `${-x / cropWidth * 100}%`,
  top: `${-y / cropHeight * 100}%`
}} />
  </div>;

O modelo gera respostas e solicitações de ferramentas. Projeto e ferramentas fornecem contexto; o modelo usa esse contexto para decidir a próxima ação. Comece com um modelo do gateway MKA1 configurado. Adicione outro provedor apenas quando sua organização fornecer um endpoint compatível para sessões locais de Código.

## Selecione um modelo para a tarefa

Abra o seletor ao lado do compositor antes de enviar. O catálogo do gateway determina quais modelos sua conta pode escolher. Para investigar código, use um modelo adequado para ler arquivos e interpretar resultados de ferramentas. Para capturas e verificações no navegador, modelo e endpoint precisam aceitar imagens.

Alguns modelos oferecem níveis de esforço de raciocínio. Use as opções do modelo selecionado; elas variam por endpoint. Para comparar modelos, escolha uma tarefa verificável: explicar uma função com referências ou corrigir um teste que falha. Compare correção e verificação, não apenas o tamanho da resposta.

Se o seletor estiver vazio, confira acesso e **Ajustes → Conexão → Testar conexão**. Atualize o catálogo após corrigir a conexão. Não substitua uma entrada ausente por um identificador adivinhado.

<Frame caption="Selecione um modelo antes de enviar a solicitação. Este catálogo pertence ao gateway local de demonstração.">
  <ScreenshotCrop src="/images/mka1-code/guides/pt/models.jpg" alt="Seletor de modelos com o modelo de demonstração selecionado" width={2720} height={1660} x={1435} y={1366} cropWidth={530} cropHeight={185} maxWidth="480px" />
</Frame>

## Configure o modelo padrão

Em **Ajustes → Conexão**, escolha o **Modelo** para novas conversas e execuções. Use o catálogo quando disponível. Se sua organização fornecer um ID exato ausente da lista, use a opção de digitar manualmente; a opção de escolher na lista retorna ao catálogo.

Escolha **Salvar** para aplicar mudanças. **Testar conexão** verifica acesso e modelos, mas não salva o formulário. Mantenha o endereço padrão, salvo se a instalação exigir outro gateway. Alterar a origem remove a credencial ativa; autentique-se novamente depois de salvar.

O padrão é a escolha inicial para novos trabalhos. Confira o modelo da sessão ativa antes de enviar, principalmente ao retomar uma conversa.

## Adicione um provedor

**Ajustes → Provedores de modelos** registra modelos adicionais para Código local. Use protocolo, limites e capacidades documentados pelo operador. Os números iniciais do formulário são sugestões, não confirmação de compatibilidade.

1. Escolha **Novo provedor** e informe um nome reconhecível.
2. Selecione **OpenAI Responses**, **OpenAI Chat Completions** ou **Anthropic Messages**, conforme a API do endpoint.
3. Informe URL base e chave de API exigida. Um endpoint local pode dispensar chave se não exigir autenticação.
4. Adicione pelo menos um modelo com ID exato e nome legível.
5. Configure limites de contexto e saída, imagens e níveis de raciocínio conforme as especificações.
6. Salve e experimente uma tarefa local pequena com esse modelo.

| Ajuste | O que determina |
| - | - |
| Contexto | Capacidade de contexto declarada, em tokens. |
| Saída máxima | Limite declarado de tokens de resposta. |
| Aceita imagens | Se imagens e capturas do navegador podem ser enviadas. |
| Níveis de raciocínio | Opções aceitas pelo endpoint. Anthropic Messages usa o padrão do provedor nesse formulário. |

Peça primeiro para ler o README e identificar os testes sem editar. Confira a leitura e a resposta. Se texto funcionar, mas imagens ou ferramentas falharem, verifique essas capacidades antes de uma tarefa maior.

## Atualize ou remova um provedor

Abra um provedor salvo para editar. Chaves não reaparecem no formulário: deixar o campo vazio mantém a chave; **Remover chave salva** a exclui. Excluir o provedor exige confirmação.

Solicitações vão para o endpoint configurado. Use um autorizado para os dados do projeto, incluindo arquivos relevantes e resultados de ferramentas. Trabalho remoto exige selecionar a transferência de configuração e credenciais separadamente; consulte [Desenvolvimento remoto](/pt/docs/mka1-code/remote-development).