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

Conectar seu primeiro provedor de modelos

Escolher uma conexão

O provedor é a conexão com um serviço de modelos; o modelo é a opção específica usada por essa conexão. Conectar um provedor não seleciona todos os modelos nem concede acesso à conta.

Na interface de terminal, digite /connect e escolha uma das opções abaixo. O Desktop tem configurações e runtime integrado próprios; estes comandos com barra se referem ao terminal.

API na nuvem: escolha API Cloud Provider, selecione o serviço e siga as instruções de credenciais. Uma assinatura de chat não inclui necessariamente acesso ou créditos de API.
CLI de programação: instale e entre primeiro em uma CLI compatível, depois escolha CLI Provider. O AX Code reutiliza esse login local; os recursos dependem do adaptador.
Modelo local: inicie o Ollama ou LM Studio, carregue um modelo com chamadas de ferramentas, depois escolha Local LLM runtime e confirme o endpoint. AX-Engine runtime possui configuração e download próprios em Macs compatíveis.
Gateway: escolha AX Trust para seu endpoint, API Cloud Provider → Custom API provider para outros gateways, ou Private GPU cloud para uma implantação compatível dedicada. Informe URL do serviço, token e IDs exatos anunciados pelo serviço.

Verificar a conexão

Execute estes comandos em um terminal interativo. O login solicita provedor e credenciais; não cole chaves reais em comandos compartilhados ou arquivos do repositório.

ax-code providers login
ax-code providers list
ax-code models

O provedor e os IDs utilizáveis devem aparecer. Credenciais salvas ou uma listagem bem-sucedida não comprovam permissão de inferência. Continue em seleção de modelos e envie uma pequena requisição de teste.

Gerenciar credenciais e configuração

Use /providers para gerenciar conexões e /connect para trocar uma chave. Desativar mantém as credenciais salvas; desconectar as remove. Variáveis de ambiente e chaves configuradas ainda podem fornecer acesso.

Use o ax-code.json do projeto para configurações compartilhadas sem segredos ou o ~/.config/ax-code/ax-code.json global para preferências pessoais. Mantenha segredos fora do controle de versão; use o prompt de credenciais ou as referências de ambiente do guia de gateways. Reinicie após alterações manuais.

Se a configuração falhar

Falha de autenticação: confirme se a chave pertence ao serviço, endpoint e plano de API escolhidos. Para uma CLI de programação, verifique primeiro o login da própria CLI.
Lista vazia ou conexão recusada: confirme servidor local ativo, modelo carregado, URL e porta corretas. Ollama normalmente usa http://localhost:11434/v1; LM Studio usa http://localhost:1234/v1.
Modelo recusado: use o ID exato do endpoint e confira as permissões da conta. O nome exibido pelo gateway pode diferir do ID enviado ao serviço de origem.
Provedor ausente: confira enabled_providers e disabled_providers. Para diagnosticar a instalação, execute ax-code doctor; isso não valida sua conta no provedor.

Próximos passos

Catálogo e métodos de login · Gateways personalizados e endpoints GPU privados · Escolher modelo · Criar AX Wiki · Central de documentação