Risoluzione dei problemi

L'app non verrà installata né aperta

Windows

Se SmartScreen blocca il programma di installazione, scegli Ulteriori informazioni → Esegui comunque. La build desktop è firmata in codice, quindi normalmente non viene visualizzata.

macOS

Se macOS si rifiuta di aprire l'app, apri Impostazioni di sistema → Privacy e sicurezza e consenti l'accesso, quindi avvialo di nuovo.

Assicurati di aver trascinato 9xChat in Applicazioni, anziché eseguirlo dall'immagine disco montata.

Linux

Verifica che il file scaricato sia contrassegnato come eseguibile. In caso contrario, imposta il bit eseguibile su di esso ed eseguilo di nuovo.

Mobile

Installalo tramite Google Play o App Store in modo che gli aggiornamenti arrivino automaticamente. Se l'app non si avvia, aggiornala, quindi riavvia il dispositivo.

Le risposte falliscono o si interrompono parzialmente

Lavora attraverso questi in ordine:

1. Controlla la tua connessione. I modelli cloud richiedono l'accesso a Internet. I modelli locali lo fanno senza bisogno di Internet. Se le richieste cloud falliscono ma quelle locali funzionano, il problema è la rete o il fornitore, non 9xchat.

2. Controlla il saldo del tuo credito. Se stai utilizzando i crediti 9xchat e loro li hanno finiscono, le richieste si fermano. Ricarica o passa alla tua chiave API.

3. Controlla la tua chiave API. Se hai portato la tua chiave, conferma che sia ancora valido e ha una quota rimasta con quel fornitore.

4. Prova un modello diverso. Se un modello fallisce e un altro ha successo, il problema è con quello specifico modello o fornitore.

Un modello manca o non verrà caricato

• I modelli cloud necessitano di crediti o di una chiave API configurata per questo fornitore. In Libreria → Modelli, un fornitore resta contrassegnato come Inattivo finché non aggiungi la sua chiave. Questa etichetta è il modo più rapido per capire a quali fornitori non puoi ancora accedere.

• Modelli locali: devi avviare il motore locale prima che 9xChat possa raggiungerli. Avvialo prima, quindi riapri l'elenco dei modelli.

La tua chiave API è stata rifiutata

L'errore è a carico del provider, quindi c'è anche la correzione:

1. Incolla di nuovo la chiave, senza spazi iniziali o finali.
2. Conferma che la chiave appartiene al provider sotto cui l'hai aggiunta.
3. Verificare che la chiave esista ancora e che non sia stata revocata o ruotata.
4. Verifica di aver impostato la fatturazione e la quota rimanente con quel fornitore: a una chiave valida senza saldo fallisce allo stesso modo di una chiave errata.
5. Conferma che il modello che hai scelto sia quello che il tuo account può utilizzare. Alcuni i modelli necessitano di un livello separato con il fornitore.

Le chiavi vengono archiviate crittografate sul tuo computer. Se una chiave smette di funzionare ovunque, sostituiscila presso il provider invece di reinstallare 9xchat.

Un modello locale non si connetterà

1. Avvia il tuo runner locale e verifica che risponda all'esterno di 9xchat.
2. Verifica che sia in ascolto all'indirizzo e sulla porta previsti da 9xChat.
3. Conferma che il modello stesso venga tirato e caricato, non solo il corridore che corre.
4. Riapri Libreria → Modelli in modo che l'elenco si aggiorni.

I modelli locali non necessitano di chiavi né crediti. Se un modello locale funziona e uno cloud no, il problema è la tua chiave, il tuo saldo o la rete.

Uno strumento o un server MCP non funziona

1. Verifica che lo strumento sia abilitato. Ogni strumento ha un interruttore Abilitato sotto Libreria → Strumenti.

2. Verifica il piano. Gli strumenti agentici e la ricerca web in tempo reale richiedono Pro. Vedi Gratis e Pro.

3. Leggi la riga sulla sicurezza. Indica di quali autorizzazioni ha bisogno lo strumento. Uno strumento che non riesce a raggiungere ciò di cui ha bisogno fallisce invece di chiedere.

4. Per i server MCP, verificare che siano stati forniti i segreti richiesti: una voce ancora contrassegnato con Richiede configurazione non è stato configurato. L'anteprima della configurazione mostra il comando esatto che esegue, che vale la pena rileggere se il server non si avvia mai.

5. Isolalo. Disattiva lo strumento, fai la stessa domanda e verifica se il cambiamenti di comportamento. Questo ti dice se lo strumento è coinvolto.

La ricerca della conoscenza non trova nulla

Una raccolta deve essere indicizzata prima di poter essere ricercata.

• Verifica che i file siano stati aggiunti a una raccolta e non solo allegati a una chat.
• Verifica che lo strumento Cerca nella conoscenza sia abilitato.
• Se il tuo fornitore di incorporamenti non era raggiungibile quando hai aggiunto i file, la ricerca ricade sulla corrispondenza delle parole chiave e mancherà tutto ciò che necessitava dell'indice. Aggiungere nuovamente i file una volta che il provider è raggiungibile.

Vedi Conoscenze e ricordi.

Un allegato non verrà elaborato

• Conferma che il modello selezionato accetta quel tipo di file. Un modello di solo testo non riesce a leggere un'immagine e l'elenco dei modelli contrassegna quelli che gestiscono la visione.
• File molto grandi possono superare il contesto di un modello. Prova un estratto più piccolo o a modello con una finestra di contesto più ampia.
• Se il file si apre correttamente altrove ma non funziona qui, prova a convertirlo in un file innanzitutto il formato comune.

La generazione dell'immagine non riesce

• La modifica di un'area di un'immagine, la rigenerazione di un'immagine generata e le immagini in chat richiedono Pro. L'area di sperimentazione Immagini è gratuita.
• Verifica di aver selezionato un modello per le immagini. La scelta è separata da quella del modello di chat.
• Controlla il saldo del tuo credito se stai generando crediti tramite 9xchat.
• Alcuni prompt vengono rifiutati dal fornitore, non da 9xChat; riformularli è di solito più veloce del nuovo tentativo.

La dettatura o la lettura ad alta voce falliscono

Entrambi necessitano di un fornitore audio funzionante e nessuno dei due dispone di un'opzione locale.

• Verifica che il tuo Provider di trascrizione sia impostato in Impostazioni → Predefinito Modelli.
• Concedi a 9xChat l'accesso al microfono nelle impostazioni della privacy del sistema operativo. Su macOS, Impostazioni di Sistema → Privacy e sicurezza → Microfono.
• Entrambi necessitano di una connessione anche quando il modello di chat è locale.

La dettatura e la chat vocale richiedono Pro; la lettura ad alta voce è gratuita.

I crediti si esauriscono più velocemente del previsto

Ogni messaggio mostra il proprio costo, la latenza e la suddivisione dei token e la sessione mostra un totale parziale. Se il totale sembra sbagliato, apri le cifre per messaggio per vedere quale scambio lo spiega: contesto lungo, gettoni di ragionamento e allegati di grandi dimensioni aumentano il costo di un singolo turno.

Puoi limitare questo valore per chat abbassando i token di completamento massimi e il limite di contesto nelle impostazioni del modello e Protezione contesto riduce la quantità di cronologia inviata nuovamente con ciascun messaggio.

Per interrompere completamente la spesa dei crediti, aggiungi la tua chiave API o utilizza un modello locale.

Una funzione è disattivata o mancante

Su un account gratuito, le funzionalità che richiedono Pro aprono la finestra Funzionalità Pro e le impostazioni Pro mostrano l'etichetta Premium: tra queste ci sono schede multiple, finestra di chat, Assistente rapido, strumenti agentici, ricerca web in tempo reale, modifica delle immagini, dettatura e chat vocale. Gratis e Pro elenca tutte le differenze.

Se hai già pagato, verifica che questo dispositivo abbia effettuato l'accesso con l'UID a cui appartiene l'abbonamento. Apri Profilo per controllare il piano e i giorni rimasti. Segui Il tuo UID e i dispositivi per collegare, cambiare o rimuovere un dispositivo.

«Crediti insufficienti per questa richiesta»

Il costo della richiesta supera il saldo rimasto. Scegli Acquista crediti oppure passa la chat a un modello con una tua chiave API o a un modello locale, che non usano mai crediti. Il saldo si trova in Profilo.

«Limite di dispositivi raggiunto»

Tutti i posti per i dispositivi del tuo UID sono occupati: uno con un account gratuito o durante la prova, tre con Pro. Scegli Gestisci dispositivi e rimuovi un dispositivo che non usi più (su iOS usa la pagina della licenza in un browser), poi accedi di nuovo. Non creare un nuovo UID: non avrebbe il tuo piano né i tuoi crediti. Vedi Il tuo UID e i dispositivi.

«Pagamento non rilevato»

Dopo il pagamento nel browser, 9xChat controlla il tuo account quando scegli Conferma pagamento. Se compare Pagamento non rilevato, il pagamento potrebbe essere ancora in elaborazione: attendi un minuto e scegli Riprova. Se hai chiuso per errore la pagina di pagamento, scegli Apri pagina di pagamento. Puoi recuperare gli acquisti effettuati su Google Play o App Store con Ripristina acquisti nella schermata dei prezzi.

Un codice Handoff non funziona

• I codici scadono dopo pochi minuti e funzionano una sola volta. Annulla sul dispositivo mittente e scegli di nuovo Ottieni un codice di abbinamento.
• Inserisci tutte e 6 le cifre sul dispositivo ricevente in Ricevi chat….
• Mantieni aperte entrambe le finestre e lascia entrambi i dispositivi online fino al termine del trasferimento.

Vedi Handoff.

Manca qualcosa su un altro dispositivo

Il tuo spazio di lavoro è archiviato localmente su ciascun dispositivo, quindi un secondo computer su cui è stato effettuato l'accesso con lo stesso UID non eredita le tue chat, note o ricordi. Ciò è previsto piuttosto che una colpa.

• Le memorie sono per dispositivo. Una nuova installazione inizia senza alcuna memoria.
• Handoff associa due dispositivi per una conversazione; non copia il resto del tuo spazio di lavoro.
• Per spostare tu stesso il materiale, utilizza Impostazioni → Dati ed esportazioni.

Il tuo abbonamento segue l'UID, quindi un dispositivo che verifica con esso accetta Pro anche se il contenuto non viaggia.

Niente qui ha aiutato

Seleziona Includi diagnostica quando scrivi all'assistenza. Allega versioni, dati sull'archiviazione, conteggi e categorie degli errori recenti, mai prompt, titoli, nomi di file o chiavi. È il modo più rapido per evitare uno scambio di domande; Privacy elenca esattamente ciò che viene inviato.

Contatta il supporto con:

• il tuo sistema operativo e la versione di 9xChat,
• il modello e il fornitore che stavi utilizzando,
• che tu avessi crediti, la tua chiave o un modello locale,
• cosa hai fatto e l'esatto errore visibile.