Guida Completa: Usare OpenCode con Ollama per creare app in Locale

Guida passo passo per installare OpenCode e Ollama in locale: crea app HTML senza programmare, in totale privacy e senza server esterni.

Se desideri sperimentare con la creazione di codice e lo sviluppo di agenti autonomi sfruttando l'intelligenza artificiale in locale, l'accoppiata OpenCode e Ollama rappresenta una soluzione eccellente e gratuita. In questo tutorial, vedremo passo dopo passo come configurare l'ambiente sul tuo PC, partendo dall'installazione dei requisiti base fino alla generazione del tuo primo progetto.

1. Installazione di Node.js

OpenCode è basato su JavaScript e richiede l'ambiente di runtime Node.js per poter essere installato ed eseguito correttamente.

1. Vai sul sito ufficiale di Node.js e scarica la versione LTS (Long Term Support) per Windows.
2. Avvia l'eseguibile appena scaricato e segui la procedura guidata, lasciando tutte le impostazioni predefinite.
3. Per verificare che l'installazione sia andata a buon fine, apri il Terminale di Windows e digita il seguente comando per controllare la versione installata:

node -v

2. Installazione di OpenCode

Con Node.js installato, possiamo procedere all'installazione di OpenCode attraverso NPM, il gestore di pacchetti integrato in Node.

Apri il Terminale di Windows e digita:

npm install -g opencode-ai

Devi andare su Invio per inviare l'input al Terminale e questo vale sempre per tutte le stringhe inserite in quella finestra. Attendi il completamento del download. Il parametro "-g" assicura che OpenCode venga installato globalmente sul tuo sistema, rendendolo accessibile da qualsiasi cartella.

3. Creazione del file di configurazione .json

Per far sì che OpenCode comunichi correttamente con il tuo server locale di Ollama e utilizzi il modello linguistico desiderato, dobbiamo creare un piccolo file di configurazione. Lo faremo in modo semplicissimo utilizzando il Blocco Note di Windows.

1. Apri il Blocco Note.
2. Copia e incolla al suo interno questa configurazione:

{ "llm": { "provider": "ollama", "model": "qwen-3.8-27b", "baseURL": "http://127.0.0.1:11434" } }

In questo esempio stiamo specificando a OpenCode di appoggiarsi al modello qwen-3.8-27b. Il vantaggio di usare Ollama è che questo parametro è totalmente personalizzabile: ti basterà sostituire la stringa "qwen-3.8-27b" con il nome di qualsiasi altro modello che hai già scaricato (ad esempio llama3, phi3, Qwen 3.8 27B Uncensored o altri) per cambiare il "cervello" del tuo agente.

Una volta incollato il testo, vai su File > Salva con nome. Scegli come nome file config.json e, passaggio fondamentale, assicurati di selezionare "Tutti i file (*.*)" nel menu a tendina "Salva come" per evitare che venga salvato come documento di testo (.txt).

4. Estendere la memoria del contesto e avviare Ollama

Per gestire script complessi e non far "dimenticare" al modello le istruzioni passate, è necessario aumentare la finestra di contesto di Ollama. Estenderemo la memoria a 65536 token prima di avviare il server locale.

Apri il Terminale di Windows e digita questi due comandi in sequenza, premendo Invio dopo ciascuno:

set OLLAMA_NUM_CTX=65536
ollama serve

Nota importante: Il server di Ollama è ora attivo con la memoria estesa. Riduci a icona questa finestra del terminale e lasciala aperta in background, altrimenti OpenCode non saprà con chi comunicare!

5. Scegliere la cartella di progetto e avviare OpenCode

L'ultimo passaggio consiste nel decidere dove OpenCode dovrà salvare fisicamente i file di codice che andrà a generare (ad esempio, le tue app web o i tuoi script). Ipotizziamo di voler destinare i nostri progetti a una cartella di lavoro sul disco secondario, chiamata Esperimenti_OpenCode.

Apri una nuova finestra del Terminale di Windows e utilizza il comando cd (Change Directory) per navigare fino al percorso desiderato:

cd D:\Esperimenti_OpenCode

Assicurati di aver spostato il file config.json creato in precedenza proprio all'interno di questa cartella.

Ora che ti trovi nel percorso corretto, puoi avviare OpenCode passando come riferimento il file di configurazione:

opencode --config config.json

Nella riga successiva inserisci il nuovo comando

opencode

e vai su Invio. Fatto! L'interfaccia di OpenCode è ora avviata nel tuo terminale. L'agente è connesso a Ollama, pronto ad ascoltare i tuoi prompt per iniziare a programmare direttamente all'interno della tua cartella. Per vedere alcuni esempi di utilizzo di OpenCode guarda il video tutorial incorporato qui sotto.