Salta ai contenuti
OpenCode
HomeDocs

Risoluzione dei problemi

Problemi comuni e come risolverli.

Per eseguire il debug di qualsiasi problema con OpenCode, puoi controllare i log o i dati della sessione che memorizza localmente.

Log

I file di log vengono scritti in:

  • macOS/Linux: ~/.local/share/opencode/log/
  • Windows: %USERPROFILE%\.local\share\opencode\log

I file di log sono nominati con timestamp (ad esempio, 2025-01-09T123456.log) e vengono mantenuti i 10 file di log pi recenti.

Puoi impostare il livello di log con l’opzione della riga di comando --log-level per ottenere informazioni di debug pi dettagliate. Ad esempio, opencode --log-level DEBUG.

Archiviazione

opencode memorizza i dati della sessione e altri dati dell’applicazione su disco in:

  • macOS/Linux: ~/.local/share/opencode/
  • Windows: %USERPROFILE%\.local\share\opencode

Questa directory contiene:

  • auth.json - Dati di autenticazione come chiavi API, token OAuth
  • log/ - Log dell’applicazione
  • project/ - Dati specifici del progetto come dati di sessione e messaggio
    • Se il progetto all’interno di un repository Git, viene memorizzato in ./<project-slug>/storage/
    • Se non un repository Git, viene memorizzato in ./global/storage/

Ottenere aiuto

Se stai riscontrando problemi con OpenCode:

  1. Segnala problemi su GitHub

    Il modo migliore per segnalare bug o richiedere funzionalit attraverso il nostro repository GitHub:

    github.com/anomalyco/opencode/issues

    Prima di creare un nuovo problema, cerca nei problemi esistenti per vedere se il tuo gi stato stato segnalato.

  2. Unisciti al nostro Discord

    Per aiuto in tempo reale e discussioni della community, unisciti al nostro server Discord:

    opencode.ai/discord

Problemi comuni

Ecco alcuni problemi comuni e come risolverli.

OpenCode non si avvia

  1. Controlla i log per i messaggi di errore
  2. Prova a eseguire con --print-logs per vedere l’output nel terminale
  3. Assicurati di avere l’ultima versione con opencode upgrade

Problemi di autenticazione

  1. Prova a ri-autenticarti con il comando /connect nel TUI
  2. Verifica che le tue chiavi API siano valide
  3. Assicurati che la tua rete permetta connessioni all’API del fornitore

Modello non disponibile

  1. Verifica di esserti autenticato con il fornitore
  2. Verifica che il nome del modello nella tua configurazione sia corretto
  3. Alcuni modelli potrebbero richiedere accesso o abbonamenti specifici

Se incontri ProviderModelNotFoundError, molto probabilmente stai facendo riferimento in modo errato a un modello. I modelli dovrebbero essere referenziati cos: <providerId>/<modelId>

Esempi:

  • openai/gpt-4.1
  • openrouter/google/gemini-2.5-flash
  • opencode/kimi-k2

Per capire quali modelli hai accesso, esegui opencode models

ProviderInitError

Se incontri un ProviderInitError, probabilmente hai una configurazione non valida o corrotta.

Per risolvere questo:

  1. Prima, verifica che il tuo fornitore sia configurato correttamente seguendo la guida dei fornitori

  2. Se il problema persiste, prova a cancellare la tua configurazione memorizzata:

    Terminal window
    rm -rf ~/.local/share/opencode

  3. Ri-autenticati con il tuo fornitore usando il comando /connect nel TUI.

AI_APICallError e problemi dei pacchetti dei fornitori

Se incontri errori di chiamata API, questo pu essere dovuto a pacchetti dei fornitori obsoleti. opencode installa dinamicamente i pacchetti dei fornitori (OpenAI, Anthropic, Google, ecc.) secondo necessità e li memorizza nella cache localmente.

Per risolvere i problemi dei pacchetti dei fornitori:

  1. Cancella la cache dei pacchetti dei fornitori:

    Terminal window
    rm -rf ~/.cache/opencode

  2. Riavvia opencode per reinstallare gli ultimi pacchetti dei fornitori

Questo forzer opencode a scaricare le versioni pi recenti dei pacchetti dei fornitori, che spesso risolve problemi di compatibilit con i parametri del modello e i cambiamenti dell’API.

Copia/incolla non funziona su Linux

Gli utenti Linux devono avere una delle seguenti utilit degli appunti installate per far funzionare la funzionalit di copia/incolla:

Per sistemi X11:

Terminal window
apt install -y xclip
# o
apt install -y xsel

Per sistemi Wayland:

Terminal window
apt install -y wl-clipboard

Per ambienti headless:

Terminal window
apt install -y xvfb
# ed esegui:
Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
export DISPLAY=:99.0

opencode rilever se stai usando Wayland e preferir wl-clipboard, altrimenti cercher di trovare strumenti degli appunti in ordine: xclip e xsel.