Guide pratiche

Come eseguire un modello di programmazione in locale con Ollama

Installare Ollama su macOS, Linux o Windows, scegliere un modello adatto al codice, impostare la finestra di contesto e collegare OpenCode o Cline, secondo la documentazione ufficiale.

Di Audryk · 20 ottobre 2026

• Guide pratiche
• Modelli
• Agenti di programmazione
• #guide
• #open source
• #Ollama

Ollama scarica ed esegue modelli linguistici sulla vostra macchina, poi li espone tramite un'API locale all'indirizzo http://localhost:11434. Un agente di programmazione può collegarvisi e lavorare senza inviare il vostro codice a un fornitore di API. Questa guida segue la documentazione di Ollama, verificata il 2026-10-20; i limiti hardware sono trattati alla fine.

Installare Ollama

macOS: macOS Sonoma (v14) o successivo. I chip della serie Apple M sono supportati su CPU e GPU, i Mac Intel solo su CPU (Ollama). Il metodo preferito è montare ollama.dmg e trascinare l'app nella cartella Applicazioni; all'avvio propone di collegare il comando ollama in /usr/local/bin. La pagina di download offre anche l'installazione da riga di comando, la stessa di Linux.

Linux (Ollama):

curl -fsSL https://ollama.com/install.sh | sh

Windows: Windows 10 22H2 o successivo, Home o Pro. L'installazione non richiede diritti di amministratore, avviene nella vostra cartella personale e occupa almeno 4 GB (Ollama). Da PowerShell, secondo la pagina di download:

irm https://ollama.com/install.ps1 | iex

Poi verificate che il comando risponda:

ollama -v

Prevedete spazio su disco: secondo Ollama i modelli vanno da decine a centinaia di gigabyte. Su Windows, la variabile OLLAMA_MODELS permette di archiviarli fuori dalla cartella personale.

Scegliere un modello adatto al codice

La libreria di Ollama comprende famiglie specializzate nel codice. Due esempi comuni, con le cifre tratte dalle loro pagine ufficiali:

• qwen3-coder (Alibaba): la versione 30b pesa 19 GB, ha 30 miliardi di parametri di cui 3,3 miliardi attivi (un'architettura a miscela di esperti) e accetta 256.000 token di contesto. La versione 480b pesa 290 GB e richiede almeno 250 GB di memoria, o di memoria unificata, per essere eseguita in locale (Ollama).
• qwen2.5-coder: sei dimensioni, da 0.5b (398 MB) a 32b (20 GB), tutte con una finestra di contesto di 32.000 token (Ollama).

Per scaricare ed eseguire qwen3-coder 30B, il comando della sua pagina ufficiale:

ollama run qwen3-coder:30b

I modelli in grado di chiamare strumenti, di cui un agente ha bisogno, si possono filtrare nella libreria. La pagina di un modello non indica sempre la memoria necessaria: confrontate la dimensione del file con la memoria della vostra scheda grafica, o con la memoria unificata di un Mac.

Impostare la finestra di contesto

È l'impostazione che conta di più per un agente. Per impostazione predefinita, Ollama sceglie la finestra di contesto in base alla memoria video (VRAM) disponibile (Ollama):

• meno di 24 GiB di VRAM: 4.000 token;
• da 24 a 48 GiB: 32.000 token;
• 48 GiB o più: 256.000 token.

Ollama raccomanda almeno 64.000 token per gli agenti e gli strumenti di programmazione. Si imposta con il cursore nelle impostazioni dell'app, oppure all'avvio del server:

OLLAMA_CONTEXT_LENGTH=64000 ollama serve

Un contesto più grande usa più memoria. Verificate dove gira il modello: la colonna PROCESSOR dovrebbe indicare 100% GPU; un valore come 48%/52% CPU/GPU significa che una parte del modello è finita nella memoria di sistema, cosa che Ollama sconsiglia per ottenere le migliori prestazioni.

ollama ps

Collegare un agente di programmazione

**Il modo più semplice: ollama launch.** Dalla cartella del progetto, Ollama configura e avvia l'agente scelto e propone di installarlo se necessario (Ollama):

ollama launch opencode

Lo stesso comando esiste per Claude Code (ollama launch claude) e per Codex CLI (ollama launch codex, una volta installato Codex CLI). Poi scegliete un modello dall'elenco.

OpenCode, configurazione manuale (Ollama). OpenCode richiede una finestra di contesto di 64.000 token o più, quindi i modelli limitati a 32.000 token, come qwen2.5-coder, non bastano. Installazione:

curl -fsSL https://opencode.ai/install | bash

npm install -g opencode-ai

Poi dichiarate Ollama come provider in opencode.json (esempio ufficiale, con il modello qwen3.5):

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

Poi eseguite opencode. Nota: ollama launch opencode non sovrascrive ~/.config/opencode/opencode.json.

Cline, nel vostro IDE (Ollama):

1. Aprite le impostazioni di Cline, sezione API Configuration, e impostate API Provider su Ollama.
2. Selezionate un modello in Model, oppure digitatene il nome.
3. Portate la finestra di contesto ad almeno 32.000 token in Context Window.

E Continue? Il suo repository GitHub afferma di non essere più mantenuto e di passare in sola lettura (vedi il nostro articolo sugli agenti di programmazione open source su GitHub). Aider, un altro agente open source, accetta anch'esso un modello locale secondo la sua pagina dello strumento.

Limiti hardware

• Schede NVIDIA: compute capability 5.0 o superiore e driver 550 o più recente; le schede con compute capability da 5.0 a 6.2 richiedono il driver 570 (Ollama). Su Windows, driver NVIDIA 551.61 o più recente.
• Schede AMD su Windows: stack ROCm v7 / HIP7, oppure un driver Radeon compatibile con Vulkan; Vulkan è l'alternativa consigliata per alcune schede RX 6000.
• Mac: accelerazione GPU solo sui chip della serie Apple M; un Mac Intel funziona su CPU.
• Memoria: per le migliori prestazioni, Ollama consiglia di evitare che il modello, contesto compreso, esca dalla memoria grafica per finire sulla CPU. Con meno di 24 GiB di VRAM, la finestra predefinita (4.000 token) è troppo corta per un agente: bisogna aumentarla, a costo di più memoria.
• Disco: prevedete diverse decine di gigabyte per un modello di dimensioni medie (19 GB per qwen3-coder 30B).

Un modello locale non costa nulla per ogni uso, ma i suoi risultati non sono direttamente confrontabili con quelli dei modelli di frontiera: vedi il confronto dei modelli per i punteggi pubblicati dai fornitori.

Per approfondire

• Agenti compatibili: OpenCode, Cline, Aider; il confronto OpenCode, Aider e Cline e la sfida diretta Cline contro OpenCode.
• Modelli a pesi aperti: la pagina dello strumento Modelli open source e pesi aperti e open source nel glossario.
• Il costo delle altre opzioni: Scegliere un agente di programmazione in base al budget.

Fonti

• Ollama Docs: Quickstart, verificato il 2026-10-20
• Ollama Docs: Linux, macOS e Windows, verificati il 2026-10-20
• Ollama: download (comandi di installazione), verificato il 2026-10-20
• Ollama Docs: Context length, verificato il 2026-10-20
• Ollama Docs: Hardware support, verificato il 2026-10-20
• Ollama Docs: OpenCode e Cline, verificati il 2026-10-20
• Ollama: qwen3-coder e qwen2.5-coder, verificati il 2026-10-20

In sintesi: Ollama si installa con un solo comando, ma un agente di programmazione richiede almeno 64.000 token di contesto secondo Ollama, che le impostazioni predefinite offrono solo a partire da 48 GiB di memoria video.

Avete notato un errore in questo articolo? Segnalatelo · La nostra politica sulle correzioni