OpenCode Ollama Setup - 7 controlli per modelli locali

La pagina copre l'intento specifico OpenCode Ollama: modello locale, endpoint, validazione e troubleshooting, senza duplicare la guida generale di installazione.

OpenCode connected to Ollama as a local model provider on a developer laptop — OpenCode can use Ollama as a local provider, but the setup should be verified in layers: server, model, config, and a real repository task.

Verdetto rapido

Verifica prima tutta la catena: servizio Ollama, modello caricato e visibilità in OpenCode.

Quando funziona, documenta modello, endpoint e compiti consentiti per rendere il setup ripetibile.

Tabella decisionale

La scelta dipende dall'uso. Una prova personale richiede velocità; un team richiede configurazione revisionabile.

Installa, confronto e session storage restano intenti separati.

Question	Use ollama launch	Use opencode.json
First-time setup	Best default because it guides model selection and startup.	Useful only if you already know the exact provider fields.
Team repeatability	Good for demos, but easy to leave undocumented.	Better because the endpoint and model choice are explicit.
Local privacy	Works when the selected model actually runs locally.	Better for review because you can verify the local base URL.
Remote Ollama server	Less ideal unless the integration exposes the right host choice.	Better because you can point OpenCode at the server endpoint.
Troubleshooting	Good for confirming whether launch itself works.	Better when comparing machines, ports, and model names.

Prima di iniziare

Prova Ollama da solo. Un modello lento o troppo pesante non migliora con il contesto del repository.

Usa un piccolo repository Git con un task sicuro.

Separa cronologia di sessione, configurazione e segreti. Un modello locale non protegge automaticamente `.env`, token provider o percorsi privati. Un repository con esclusioni chiare offre a OpenCode un contesto più pulito.

In un team, assegna un owner per modello consigliato, porta, aggiornamenti e troubleshooting. Senza owner, ogni macchina diventa una variante personale difficile da confrontare.

7 controlli

I controlli separano servizio, modello, config, lettura, modifica, comandi e note di errore.

Confirm the service Run Ollama directly and make sure the default local service is reachable before opening OpenCode.
Pull the model Use a model that is appropriate for coding and fits your memory budget.
Choose launch or config Use `ollama launch opencode` for the first proof, then document `opencode.json` if the workflow will be reused.
Select the model in OpenCode Open the model picker or equivalent provider selection and confirm the Ollama model is visible.
Run a read-only task Ask OpenCode to summarize a small file before allowing edits.
Run a low-risk edit Change documentation or a test fixture and inspect the Git diff.
Record failure notes Save the model name, port, OS, shell, and fix for any timeout, missing model, or spawn error.

Esempio di configurazione

Controlla sempre i campi ufficiali. L'idea è puntare OpenCode all'endpoint compatibile OpenAI di Ollama.

Non salvare token cloud reali negli esempi locali.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      }
    }
  }
}

Risoluzione problemi

Se il modello non compare, eseguilo direttamente in Ollama e poi controlla porta, URL e nome.

Se modifica male, riduci il task o usa un modello più forte.

Se Ollama risponde ma OpenCode fallisce, salva comando, modello, porta, sistema operativo e messaggio di errore. Questa traccia rende il problema riproducibile senza toccare file produttivi.

Se il problema è la latenza, misura prima di cambiare prompt. Prova domanda breve, lettura file e piccola modifica. Se tutto è lento, il limite è modello o hardware; se solo la modifica è lenta, guarda contesto e permessi.

Four troubleshooting checks for OpenCode and Ollama: server, model, config, and test — Most failures are easier to isolate when you check the Ollama service before changing OpenCode configuration.

Quando non usarlo come default

Non usare Ollama come default se hardware, contesto o manutenzione non bastano.

Spesso conviene un flusso misto.

Una configurazione ibrida è spesso più solida. Ollama funziona bene per spiegazioni private e prove offline, mentre un modello cloud più forte resta utile per modifiche complesse.

FAQ OpenCode Ollama

Metodo più rapido?

`ollama launch opencode`.

Keyword principale?

`opencode ollama`.

Server remoto?

Sì, se endpoint e rete sono sicuri.

Locale o cloud?

Usa il modello con diff affidabili.

Perché fallisce?

Modello mancante, servizio fermo, URL, nome o PATH.

Sources

Verify commands and supported models against official documentation because OpenCode and Ollama integration details can change.

OpenCode Ollama Setup: 7 controlli prima dei modelli locali