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

Scegliere e cambiare modello

Trovare un modello utilizzabile

Prima collega un fornitore. Nel terminale digita /models, cerca tra i fornitori connessi e seleziona un modello. Preferiti e scelte recenti aiutano a ritrovarlo.

Il selettore raggruppa per fornitore. I modelli senza le necessarie capacità di uscita testuale o chiamata agli strumenti possono essere nascosti o disabilitati. I modelli locali gestiti possono apparire prima del download dei pesi; completane la preparazione prima dell’uso.

Per gli ID disponibili nella CLI installata, esegui:

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

Copia l’ID completo provider/model. Lo stesso nome tramite fornitori diversi può avere credenziali, capacità e limiti differenti.

Scegliere per una singola esecuzione

Sostituisci il valore d’esempio con un ID mostrato dalla tua installazione. Il primo comando apre il terminale, il secondo esegue un prompt. Inserisci il prompt dopo --.

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

Gli alias di famiglia deepseek, glm e qwen selezionano modelli Flash supportati tramite le connessioni disponibili. La destinazione può cambiare tra versioni. Usa un ID completo per una versione o fascia specifica; una semplice sigla non è un ID completo.

Salvare una scelta predefinita

Integra questo campo nel file ax-code.json di progetto o globale esistente; sostituisci il segnaposto senza sovrascrivere l’intero file:

{
  "model": "provider/model"
}

Riavvia dopo la modifica. Senza modello esplicito, scelte di agente, sessione o recenti possono influire; controlla il modello attivo prima di inviare il compito. Desktop gestisce impostazioni proprie.

Scegliere in base al compito

Inizia con una piccola domanda sul repository. Per modificare codice verifica le chiamate agli strumenti ed esegui i controlli del progetto. Per immagini verifica il supporto in ingresso. Per compiti lunghi controlla limiti di contesto e uscita, non solo il nome.

Confronta i candidati con lo stesso compito, gli stessi input e controlli di accettazione. Considera latenza, condizioni d’uso, trattamento dei dati e memoria locale. Nessun modello garantisce una modifica corretta.

Lo sforzo di ragionamento e l’instradamento automatico sono controlli distinti. Inizia con un modello esplicito prima di attivare l’instradamento. La generazione Wiki può usare un proprio wiki.model, indipendente dalla sessione in primo piano.

Se il modello non funziona

Non elencato: verifica che il fornitore sia connesso e abilitato, poi filtri di capacità e rilevamento del gateway. Non inventare ID da un nome commerciale.
Non autorizzato o vietato: controlla l’ID esatto richiesto e i permessi di account e chiave. Accesso o elenco riuscito non dimostrano il diritto di esecuzione.
Errore di preparazione locale o memoria: completa download e caricamento e verifica i requisiti hardware. Riduci il carico o scegli un modello supportato più piccolo.

Passaggi successivi

Riferimento fornitori e modelli · Ripristino modelli · Selezione AX Engine · Avvio rapido Wiki · Indice della documentazione