Versione della documentazione · CLI 7.30.1 · SDK 2.6.53. Desktop usa il runtime incluso nella propria versione. Comandi ed esempi restano identici al testo inglese. Testo inglese

Collegare il primo fornitore di modelli

Scegliere la connessione

Il fornitore è la connessione a un servizio; il modello è la scelta specifica attraverso tale connessione. Collegare un fornitore non seleziona tutti i modelli e non concede diritti di accesso all’account.

Nell’interfaccia terminale, digita /connect e scegli uno dei percorsi seguenti. Desktop ha impostazioni e runtime integrato propri; questi comandi con barra iniziale riguardano il terminale.

API cloud: scegli API Cloud Provider, seleziona il servizio e segui le richieste delle credenziali. Un abbonamento chat non include necessariamente accesso o credito API.
CLI di programmazione: installa prima una CLI supportata ed effettua l’accesso, poi scegli CLI Provider. AX Code riutilizza quell’accesso locale; le capacità dipendono dall’adattatore.
Modello locale: avvia Ollama o LM Studio e carica un modello con chiamate agli strumenti, poi scegli Local LLM runtime e conferma l’endpoint. AX-Engine runtime offre un proprio percorso di configurazione e download sui Mac supportati.
Gateway: scegli AX Trust per il relativo endpoint, API Cloud Provider → Custom API provider per altri gateway, o Private GPU cloud per un’implementazione compatibile dedicata. Inserisci URL del servizio, token e ID esatti dei modelli annunciati.

Verificare la connessione

Esegui questi comandi in un terminale interattivo. Il comando di accesso richiede fornitore e credenziali; non incollare una vera chiave in comandi condivisi o file del repository.

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

Dovrebbero comparire il fornitore e gli ID dei modelli utilizzabili. Salvare le credenziali o ottenere l’elenco non dimostra il diritto di inferenza. Prosegui con la selezione del modello e invia una piccola richiesta di prova.

Gestire credenziali e configurazione

Usa /providers per gestire le connessioni e /connect per sostituire una chiave. Disabilitare conserva le credenziali salvate; disconnettere le elimina. Variabili d’ambiente e chiavi configurate possono ancora consentire l’accesso.

Usa ax-code.json del progetto per impostazioni condivise non segrete o ~/.config/ax-code/ax-code.json globale per le preferenze personali. Tieni i segreti fuori dal controllo versione; usa la richiesta di credenziali o i riferimenti d’ambiente della guida ai gateway. Riavvia dopo modifiche manuali.

Se la configurazione non riesce

Errore di autenticazione: verifica che la chiave corrisponda a servizio, endpoint e piano API scelti. Per una CLI, controlla prima il suo accesso.
Elenco vuoto o connessione rifiutata: verifica server locale avviato, modello caricato, URL e porta corretti. Ollama usa normalmente http://localhost:11434/v1; LM Studio usa http://localhost:1234/v1.
Modello rifiutato: usa l’ID esatto restituito dall’endpoint e verifica i permessi dell’account. Il nome visualizzato dal gateway può differire dall’ID inviato a monte.
Fornitore assente: controlla enabled_providers e disabled_providers. Per diagnosticare l’installazione esegui ax-code doctor; non verifica l’account del fornitore.

Passaggi successivi

Catalogo e metodi di accesso · Gateway personalizzati ed endpoint GPU privati · Scegliere un modello · Creare un AX Wiki · Indice della documentazione