Versão da documentação · CLI 7.30.1 · SDK 2.6.53. O Desktop usa o runtime incluído na própria versão. Comandos e exemplos são preservados do original em inglês. Original em inglês

Escolher e trocar modelos

Encontrar um modelo utilizável

Primeiro conecte um provedor. No terminal, digite /models, pesquise entre os provedores conectados e selecione um modelo. Favoritos e escolhas recentes ajudam a encontrá-lo novamente.

O seletor agrupa modelos por provedor. Modelos sem saída de texto ou chamadas de ferramentas necessárias podem ficar ocultos ou desativados. Modelos locais gerenciados podem aparecer antes do download dos pesos; conclua a preparação antes de usá-los.

Para os IDs disponíveis na CLI instalada, execute:

ax-code models
ax-code models --json --verbose

Copie o ID completo provider/model. O mesmo nome exibido em dois provedores pode ter credenciais, capacidades e limites diferentes.

Selecionar para uma execução

Substitua o valor de exemplo por um ID mostrado pela sua instalação. O primeiro comando abre o terminal; o segundo executa um prompt. Coloque o prompt depois de --.

MODEL='provider/model'
ax-code --model "$MODEL"
ax-code run --model "$MODEL" -- "Explain the project entry point without changing files."

Os aliases de família deepseek, glm e qwen escolhem modelos Flash compatíveis pelas conexões disponíveis. Os destinos podem mudar entre versões. Use um ID completo para uma versão ou categoria específica; um SKU isolado não é um ID completo.

Salvar um padrão

Adicione este campo ao ax-code.json de projeto ou global existente; substitua o marcador, sem sobrescrever todo o arquivo:

{
  "model": "provider/model"
}

Reinicie após editar. Sem modelo explícito, escolhas de agente, sessão ou recentes podem influenciar a seleção; confira o modelo ativo antes de enviar a tarefa. O Desktop gerencia suas próprias configurações.

Escolher conforme a tarefa

Comece com uma pergunta pequena sobre o repositório. Para editar, verifique chamadas de ferramentas e execute as verificações do projeto. Para imagens, confirme suporte a entrada de imagem. Para tarefas longas, consulte limites de contexto e saída, sem depender apenas do nome.

Compare candidatos com a mesma tarefa, entradas e critérios de aceitação. Considere latência, termos do provedor, tratamento de dados e memória local necessária. Nenhum modelo garante uma alteração correta.

Esforço de raciocínio e roteamento automático são controles separados. Comece com um modelo explícito antes de ativar o roteamento. A geração Wiki pode usar seu próprio wiki.model, independente da sessão em primeiro plano.

Se o modelo não executar

Não listado: verifique conexão e ativação do provedor, depois filtros de capacidades e descoberta do gateway. Não invente IDs a partir de nomes comerciais.
Não autorizado ou proibido: confira o ID exato solicitado e os acessos da conta e da chave. Login ou listagem bem-sucedidos não comprovam permissão de execução.
Erro de preparação local ou memória: termine o download e carregamento e confira os requisitos de hardware. Reduza a carga ou escolha um modelo menor compatível.

Próximos passos

Referência de provedores e modelos · Recuperação de modelos · Seleção AX Engine · Início rápido Wiki · Central de documentação