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

# Escolher um modelo

> Escolha um Harness, um modelo e o nível de raciocínio na caixa de entrada, saiba como trocar de modelo depois que a sessão começa e entenda o Ultra e o Ultracode.

Um **Harness** é o framework que executa o agente, como Claude Code ou Codex CLI. O **modelo** é o modelo de linguagem de grande porte que o Harness chama. Antes de iniciar uma sessão, escolha os dois na caixa de entrada e ajuste o nível de raciocínio de acordo com a dificuldade da tarefa. Para saber quem fornece o modelo e onde o uso é contabilizado, consulte [Fontes de modelos](https://docs.aihubmix.com/pt/cloud/models/model-sources.md).

## Escolher um Harness e um modelo

**1. Abrir o seletor de modelos**

Na página de nova sessão, clique no botão de modelo no canto inferior direito da caixa de entrada. O botão mostra o Harness e o nome do modelo atuais. "Subscription" depois do nome do modelo significa que ele vem das suas assinaturas, e "BYOK" significa que vem de uma API key que você adicionou. Os modelos Plus não têm rótulo.

**2. Escolher um Harness**

Clique em um Harness na parte superior do seletor. Quando você troca o Harness, o modelo volta para o **Default model**.

**3. Escolher um modelo**

Na parte inferior, alterne entre as abas **Subscriptions** e **BYOK** e clique em um modelo. Os modelos Plus e as suas próprias API keys ficam na aba **BYOK**, com os modelos Plus no primeiro grupo.

**4. Enviar**

Digite sua tarefa e envie. A sessão começa com essa combinação.

Os Harnesses disponíveis no momento são Claude Code, Codex CLI, OpenCode, Hermes Agent, DeepSeek e Pi, conforme mostrado no app.

Uma nova sessão usa o Harness, o modelo e o nível de raciocínio da última sessão que você criou. Na primeira vez, usa o Claude Code com o modelo padrão. Se o modelo escolhido antes não estiver mais disponível, ele volta para o modelo padrão.

### Quais modelos funcionam com qual Harness

O seletor só permite escolher modelos que o Harness atual pode usar:

* **Suas assinaturas** são combinadas pelo tipo de assinatura. Por exemplo, uma assinatura do Claude funciona apenas com o Claude Code, e uma assinatura do ChatGPT funciona com o Codex CLI.
* **Suas próprias API keys** são combinadas pelo formato de API: o Claude Code precisa de uma API compatível com Anthropic, e o Codex CLI precisa de uma API compatível com OpenAI.
* **Os modelos Plus** disponíveis variam conforme o Harness.

Os grupos incompatíveis aparecem no fim da lista com o motivo e não podem ser selecionados. Em uma nova sessão, clicar em um modelo de um desses grupos troca para um Harness que pode usá-lo e seleciona o modelo. Fique atento ao aviso.

> [!NOTE]
>
> Sem o Plus, o seletor abre normalmente, mas o grupo de modelos Plus não pode ser selecionado. Clique em **Get Plus** abaixo do grupo para assinar. Consulte [Plano Plus](https://docs.aihubmix.com/pt/cloud/account/plus.md).

## Ajustar o nível de raciocínio

O nível de raciocínio controla quanto tempo o modelo pensa antes de responder. Níveis mais altos dão respostas mais completas, mas são mais lentos e consomem mais. Clique no botão de nível ao lado do botão de modelo para escolher. O botão fica oculto quando o modelo não permite ajuste.

O menu de nível tem dois estilos: os modelos Claude mostram uma lista de níveis **Effort**, e os modelos GPT mostram um controle deslizante **Effort**. Outros modelos usam a lista no Claude Code e o controle deslizante nos demais Harnesses.

Como escolher:

* Na dúvida, use o nível marcado como **Recommended**.
* Use um nível baixo para edições pequenas e simples, com respostas mais rápidas. Use **Medium** para a maioria das tarefas.
* Use **High** para alterações complexas e **Extra high** para refatorações entre vários arquivos e problemas difíceis.
* **Max** (apenas na lista) pode usar uma grande quantidade de tokens e responder muito devagar. Use-o apenas para as tarefas mais difíceis.

Os níveis que cada modelo oferece e qual é o recomendado dependem da combinação de modelo, fonte e Harness, conforme mostrado no app. Quando você troca de modelo, seu nível se mantém se o novo modelo o oferecer. Caso contrário, volta para o nível recomendado do novo modelo.

![Controle deslizante de nível de raciocínio](https://mintcdn.com/aihubmix/ADcIS2RBGw_ogRXt/images/cloud/en/effort-menu.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=c5857ffd7d39045edd7cd28909df3a2f)

Controle deslizante de nível de raciocínio: arraste para escolher um nível, com uma descrição abaixo do uso indicado para o nível atual

### Ultra e Ultracode

Ambos fazem o agente trabalhar na tarefa em paralelo, consomem bem mais e são indicados para trabalhos realmente difíceis.

* **Ultra**: o nível mais alto de alguns modelos no Codex CLI, na extremidade direita do controle deslizante Effort, com vários subagentes trabalhando em paralelo. O uso é cerca de 2 a 3 vezes o do Extra high, e cada tarefa leva mais tempo. Você precisa confirmar ao escolhê-lo. Clique em **Turn on Ultra** para aplicar.
* **Ultracode**: a chave de paralelismo multiagente no Claude Code, que divide a tarefa em várias subtarefas concluídas ao mesmo tempo. Ela fica abaixo da lista de níveis Effort e não altera o nível. Quando ativada, o botão de nível mostra algo como "High · Ultracode". Ela exige as três condições: o Harness é o Claude Code, o servidor na nuvem está pronto e o modelo selecionado oferece Extra high. Quando alguma condição não é atendida, a chave fica indisponível e mostra o motivo. O Ultracode vem desativado por padrão em novas sessões.

## Trocar de modelo durante uma sessão

Depois que a primeira mensagem é enviada, **o Harness fica fixo**. Para usar outro Harness, inicie uma nova sessão. Se a sessão pertence a um projeto, clique em **New task with another harness** no seletor de modelos para iniciar uma nova sessão no mesmo projeto com outro Harness.

Você ainda pode alterar o modelo, a fonte e o nível de raciocínio durante uma sessão. As alterações valem a partir da próxima mensagem, afetam apenas esta sessão e não mudam os padrões das novas sessões.

**1. Aguardar o agente terminar a tarefa atual**

Não é possível trocar de modelo enquanto o agente está trabalhando.

**2. Escolher um novo modelo**

Clique no botão de modelo e escolha outro modelo. Você pode escolher entre fontes diferentes.

**3. Confirmar a troca**

Se o contexto atual couber no novo modelo, a troca é direta. Todo o histórico da sessão é mantido, e o novo modelo continua a partir dali. Se não couber, você precisa confirmar a compactação primeiro.

A **compactação** condensa a conversa atual em um resumo e o entrega ao novo modelo. Alguns detalhes anteriores podem não ser mantidos. Clique em **Compact and switch** para continuar ou em **Cancel** para manter o modelo atual. Para manter os detalhes, escolha um modelo com limite de contexto maior. Se a sessão for longa demais para compactar, inicie uma nova sessão.

Em uma sessão, o pequeno anel à esquerda do botão de modelo mostra o uso do contexto. Passe o mouse sobre ele para ver a porcentagem usada e o número de tokens. Quando o uso se aproxima do limite, a sessão é compactada automaticamente.

Se uma sessão pausar porque o limite de uso da assinatura acabou ou a conta da assinatura foi desconectada, ela continua automaticamente depois que você troca de modelo ou de conta. Consulte [Fontes de modelos](https://docs.aihubmix.com/pt/cloud/models/model-sources.md).

> [!TIP]
>
> Abrir o seletor de modelos: `⌃⇧M` (Windows: `Ctrl+Shift+M`). Abrir o menu de nível de raciocínio: `⌃⇧I` (Windows: `Ctrl+Shift+I`, indisponível no aplicativo web no Windows). Para mais atalhos, consulte [Atalhos de teclado](https://docs.aihubmix.com/pt/cloud/reference/keyboard-shortcuts.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.