Modelos

Que fornecedores de modelos usa, como inicia sessão neles, e que modelo corre cada agente de código definem-se uma vez para todo o Mac, em Preferências › Modelos. Todas as máquinas (um espaço de trabalho, no editor de definições) herdam esse quadro global. O painel Modelos do editor de uma máquina é onde uma máquina se afasta dele — a sua própria chave de API para um fornecedor, um fornecedor que não deve usar, o seu próprio modelo para um agente — ou, se for preciso, onde recebe uma configuração dela.

Esta página trata do painel por máquina. O quadro global — fornecedores, inícios de sessão, Bedrock, OpenRouter, servidores personalizados, modelos no dispositivo, a coluna dos agentes e os seus tamanhos — está documentado em Modelos e fornecedores.

Preferências › Modelos: o quadro global

Nas Preferências (o modelo Predefinições), o painel Modelos é o próprio quadro global: Fornecedores à esquerda, Agentes à direita, com o título «Registe uma fonte à esquerda. Cada agente corre o modelo predefinido do seu fornecedor, a não ser que escolha um à direita.»

Ao contrário do resto das Preferências, este quadro grava à medida que edita — não há nada a confirmar com Guardar, e Cancelar não o desfaz. Um início de sessão feito aqui é sempre partilhado por todas as máquinas. As alterações chegam de imediato às máquinas em execução: só os agentes cujo fornecedor, credencial ou modelo mudou são reiniciados, e retomam a sua conversa; a própria VM não reinicia.

Quando Definições para: aponta as Preferências a um Mac remoto, o quadro que vê é o desse Mac, editado como rascunho e enviado ao Guardar. Ver Referência de Definições.

O painel Modelos de uma máquina

No editor de uma máquina, o painel abre com um único interruptor.

Definições de modelos personalizadas para este espaço de trabalho — desligado

Desligado é a predefinição: «A herdar as definições globais (Preferências → Modelos).» Sob o interruptor, Modelos herdados resume o que a máquina recebe — o modelo escolhido para os tamanhos Grande, Médio e Pequeno (um travessão onde o quadro global o deixa à predefinição do fornecedor) e a lista de Fornecedores configurados — com o lembrete «Ligue o interruptor acima para dar a este espaço de trabalho as suas próprias chaves, sessões ou modelos — para alguns fornecedores ou para todos.»

Definições de modelos personalizadas — ligado

Ligar o interruptor revela o quadro completo, restringido a esta máquina, e uma escolha entre dois modos:

Voltar de Autónomo para Herdar, com alterações recomeça a partir de um conjunto vazio de alterações.

Herdar, com alterações

Neste modo, cada fonte à esquerda diz-lhe de onde vem:

• Um fornecedor herdado diz Herdado de Preferências → Modelos (chave de API | subscrição | credenciais AWS). e oferece Não usar neste espaço de trabalho — «ou substitua-o abaixo». Escrever uma chave no seu pop-up (sob «Substituição para este espaço de trabalho:») dá à máquina uma dela.
• Um fornecedor para o qual a máquina tem a sua própria credencial diz Credencial própria deste espaço de trabalho., com Usar o fornecedor global para a largar e voltar a herdar.
• Um fornecedor que desligou diz Não usado neste espaço de trabalho — as definições globais têm-no., com Usar o fornecedor global para o trazer de volta.
• O Servidor personalizado funciona da mesma maneira: herdado («Editá-lo abaixo torna-o o deste espaço de trabalho.»), próprio da máquina (Servidor próprio deste espaço de trabalho., com Usar o servidor global), ou desligado nesta máquina.

Na coluna Agentes, um modelo que esta máquina herda mostra · herdado depois do nome. Escolher um modelo define-o só para esta máquina; o botão de reinício ao lado de uma escolha explícita («Herdar a definição global») devolve esse agente ou tamanho à escolha global.

Dica: usos comuns da substituição: um projeto de cliente que tem de ser faturado na chave de API do próprio cliente; uma máquina que nunca deve alcançar um fornecedor de nuvem (desligue os fornecedores e deixe apenas um servidor personalizado ou um modelo no dispositivo); ou uma máquina que experimenta um modelo diferente para um agente enquanto o resto das suas máquinas fica como está.

Iniciar sessão a partir de uma máquina

Um fornecedor que suporte subscrições (Anthropic, OpenAI, xAI e Moonshot) oferece Iniciar sessão com fornecedor no seu pop-up. Quando inicia sessão a partir do editor de uma máquina, a aplicação pergunta Partilhar com todos os espaços de trabalho? quando o início de sessão termina:

• Todos os espaços de trabalho — a sessão passa a ser a partilhada, e substitui qualquer sessão por máquina nesse fornecedor.
• Apenas este espaço de trabalho — a sessão pertence só a esta máquina, e aí tem precedência sobre a partilhada.

Um início de sessão feito nas Preferências é sempre partilhado. Ver Credenciais e a fronteira de transmissão para saber como as sessões são guardadas no Mac e nunca entram na VM.

Quando as alterações se aplicam

A substituição da máquina faz parte das definições da máquina, pelo que se aplica quando clica em Guardar. Numa máquina em execução, os agentes afetados pela alteração são reiniciados com a sua conversa retomada; a VM continua a correr.

Os segredos introduzidos na substituição — chaves de API, a chave do servidor personalizado — são guardados no secrets.enc cifrado da máquina, não no profile.json.

Limites

• O painel Modelos não está disponível no cliente iPhone, iPad ou Vision Pro.
• Uma subscrição só pode alimentar o agente do seu próprio fornecedor: uma subscrição do Claude corre o Claude Code, não o Codex.
• Os limites dos modelos locais (um motor, uma geração de cada vez, apenas servidores personalizados compatíveis com OpenAI) estão descritos em Modelos e fornecedores.

Capítulos relacionados

• Modelos e fornecedores — o quadro global por inteiro: fornecedores, inícios de sessão, Bedrock, OpenRouter, servidores personalizados, modelos no dispositivo, e escolhas de modelo por agente.
• Fusion — usar vários modelos em conjunto numa sessão do Claude Code.
• Credenciais — as credenciais AWS, que também assinam os pedidos ao Amazon Bedrock.
• Referência de Definições — todos os painéis num relance.