Table of Contents

Gli strumenti agentici di Claude ora funzionano con modelli sul tuo hardware, senza chiave API, abbonamento o dati che lasciano il computer. Ollama espone un’API compatibile con Anthropic, a cui Claude Code e Claude Desktop si collegano con pochi comandi.

Molte guide tralasciano un dettaglio importante. Parlano di Claude Cowork e poi forniscono istruzioni per configurare lo strumento a riga di comando. Si tratta di due integrazioni diverse e solo una offre Cowork.

Questa guida illustra separatamente i due percorsi, la variabile d’ambiente che molte guide popolari omettono, i modelli adatti a ciascuno nel settembre 2026 e le funzioni che restano disponibili solo nel cloud, qualunque configurazione tu scelga.

Al termine della guida: saprai quale integrazione ti serve, la collegherai tramite il percorso documentato di Ollama e verificherai l’endpoint con un test di chiamata a uno strumento. L’inferenza locale mantiene locali le richieste al modello solo se scegli un modello locale ed eviti le funzioni cloud.

Risposta breve

Ollama si collega a Claude in due modi distinti. Scegliere quello sbagliato è il motivo più comune per cui si completa una guida con un terminale funzionante ma senza Cowork.

IntegrazioneCosa offrePercorso di configurazionePiattaforma
Claude DesktopCowork, subagenti, ricerca sul web, modalità automaticaApp Ollama, poi Apps e Connect ClaudeSolo macOS
Claude CodeL’agente di programmazione CLI con chiamate agli strumenti e modifiche ai fileollama launch claude oppure variabili d’ambientemacOS, Linux, Windows

Se ti serve Cowork, usa l’integrazione con Claude Desktop. Si configura tramite l’interfaccia grafica dell’app Ollama ed è disponibile solo su macOS. Il supporto per Windows è indicato come in arrivo.

Se vuoi un agente nel terminale, usa Claude Code. Basta un comando.

Entrambi sono gratuiti. L’unico costo riguarda l’hardware e l’elettricità.

Due integrazioni diverse

La confusione parte dai nomi. Claude Cowork è una funzione di Claude Desktop, non un’applicazione separata e non un sinonimo di Claude Code.

La documentazione di Ollama elenca le due integrazioni su pagine e sezioni distinte. Claude Desktop si trova sotto Assistants, insieme a OpenClaw e Hermes. Claude Code è sotto Coding, insieme a OpenCode, Cline e Codex CLI.

La distinzione conta perché la configurazione cambia del tutto:

  • Claude Desktop si configura dall’interfaccia di Ollama. Non devi modificare il profilo della shell.
  • Claude Code si configura con variabili d’ambiente o un solo comando di avvio.

Una guida che ti fa esportare ANTHROPIC_BASE_URL e poi eseguire claude configura lo strumento a riga di comando. Se ti aspettavi l’esperienza desktop di Cowork, la configurazione non si è guastata. Hai configurato un prodotto diverso.

Configurare Claude Desktop e Cowork

Questo percorso usa l’app Ollama invece del terminale.

Prerequisiti

  • Ollama installato su macOS. Il supporto per Windows è indicato come in arrivo.
  • Un modello già scaricato se vuoi eseguire tutto in locale. Per un modello cloud, accedi a Ollama e abilita i modelli cloud. Alcuni richiedono un piano a pagamento.
  • Claude installato. Se non è presente, Ollama offre di scaricarlo durante la configurazione.

Passaggi

  1. Apri Ollama e seleziona Apps.
  2. Seleziona Connect Claude.
  3. Segui le istruzioni. Se richiesto, installa Claude e riavvialo quando viene indicato.

La procedura termina qui. Per cambiare modello in seguito, apri Ollama Settings, vai ad Apps, scegli i modelli e seleziona Restart Claude.

Funzioni disponibili

La documentazione di Ollama elenca quattro funzioni supportate da questa integrazione:

  • Cowork, per completare attività difficili
  • Subagenti, per suddividere attività più grandi tra agenti
  • Web search, fornita per impostazione predefinita da Ollama
  • Auto mode, che lascia all’agente la decisione su quando chiedere prima di apportare modifiche

Cowork compare nell’elenco. È disponibile con questa integrazione, ma non con quella a riga di comando.

Disconnettere

La disconnessione ripristina la configurazione precedente di Claude, quindi la modifica non è distruttiva.

  • Nell’interfaccia, apri Apps, disconnetti Claude e riavvialo quando richiesto.
  • Da un terminale, esegui ollama launch claude-desktop --restore.
  • Chiudere Ollama mentre Claude è connesso ripristina anche la configurazione abituale di Claude. Se vuoi mantenere la configurazione locale, lascia Ollama in esecuzione.
Diagramma dell'app Ollama che si collega a Claude Desktop dal pannello Apps, con selezione dei modelli nelle impostazioni Ollama e percorso di ripristino della configurazione originale

Configurare Claude Code dalla CLI

Quasi tutte le guide trattano questo percorso. È quello giusto per lavorare nel terminale.

Metodo con un solo comando

ollama launch claude

Il comando imposta le variabili d’ambiente necessarie, indirizza Claude Code all’istanza locale di Ollama e avvia il programma. Scegli un modello dall’elenco e premi Invio. Per indicare prima il modello, aggiungi il flag:

ollama launch claude --model qwen3.5

Il wrapper prepara l’ambiente. Leggi comunque la sezione seguente, perché sapere cosa imposta aiuta a risolvere eventuali problemi.

Impostare manualmente le variabili d’ambiente

export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
export ANTHROPIC_BASE_URL=http://localhost:11434

claude --model qwen3.5

La seconda riga è quella che molte guide popolari omettono. Impostare ANTHROPIC_API_KEY a una stringa vuota evita che una chiave reale già presente nell’ambiente interferisca con la connessione locale. Se una guida pubblicata salta questa riga, chi ha già esportato una chiave incontra un errore difficile da capire.

Per evitare modifiche al profilo della shell, passa tutto direttamente nel comando:

ANTHROPIC_AUTH_TOKEN=ollama ANTHROPIC_BASE_URL=http://localhost:11434 ANTHROPIC_API_KEY="" claude --model kimi-k2.7-code:cloud

Due dettagli della documentazione ufficiale:

  • ANTHROPIC_AUTH_TOKEN contiene l’autenticazione bearer, quindi in modalità locale il suo valore letterale è ollama.
  • I file delle impostazioni di Claude hanno la precedenza sulle variabili della shell. Se la connessione si comporta in modo strano dopo aver esportato nuovi valori, controlla quei file e poi esegui /status in Claude Code per vedere quale endpoint viene usato.

Collegarsi direttamente a Ollama Cloud

Per questa opzione non occorre installare Ollama. Imposta una chiave API e indirizza Claude Code all’endpoint ospitato da Ollama:

ANTHROPIC_BASE_URL=https://ollama.com \
ANTHROPIC_AUTH_TOKEN="$OLLAMA_API_KEY" \
ANTHROPIC_API_KEY="" \
claude --model glm-5.3-flash

C’è una limitazione. La documentazione di Ollama segnala che la ricerca web ospitata e i controlli avanzati degli strumenti non sono supportati completamente con questo percorso. Chat di base, modifiche ai file e chiamate agli strumenti funzionano con modelli compatibili.

Modelli per settembre 2026

La selezione dei modelli è cambiata molto nel 2026. Conviene ricontrollare i consigli scritti in primavera.

ModelloTipoContestoPerché sceglierlo
Qwen3.8 27BLocale, 18 GB256KMiglior modello locale tuttofare attuale, con visione, chiamate agli strumenti e controllo del ragionamento
Qwen3 Coder NextLocale, MoE 80B totali / 3B attivi256KCreato per agenti di programmazione sempre attivi, con modalità rapida senza ragionamento
Qwen3.6 35B A3BLocale, MoE 35B / 3B attivi262KApache 2.0 ed efficiente con poca memoria
kimi-k2.7-code:cloudCloudAmpioModello cloud orientato alla programmazione senza requisiti hardware locali
glm-5.3-flashCloudAmpioIl modello indicato per primo dalla documentazione Ollama

Inizia con Qwen3.8 27B se hai memoria sufficiente. Funziona localmente con una finestra di contesto 256K, visione nativa, chiamate agli strumenti e ragionamento attivabile per richiesta. Una scheda con almeno 24 GB lo rende adatto all’uso quotidiano.

Scegli un modello cloud se non hai quella memoria. Collegare Claude Code a un modello ospitato non costa nulla per una prova e elimina il problema dell’hardware, ma il tuo codice lascia il computer.

Attenzione ai modelli ternari

Nella nostra guida all’IA locale spieghiamo che il modello ternario Bonsai 2 27B esegue un modello completo da 27B in 5,53 GiB. Sembra una scelta allettante anche qui.

Questo flusso di lavoro non lo supporta. I kernel ternari fanno parte del fork di llama.cpp di Prism ML e Ollama standard non riesce a caricare quei file. Un comando come ollama launch claude --model Ternary-Bonsai-2-27B fallisce prima di avviare l’inferenza. Usa il pacchetto standard Qwen3.8 27B per Claude Code e tieni i pacchetti ternari per un runtime compatibile.

In questo caso, praticità e massima efficienza portano a scelte diverse. Gli strumenti integrati richiedono un GGUF standard.

Imposta un contesto da 64K prima di incolpare il modello

La documentazione di Ollama dà un’indicazione diretta per lavorare sui repository: scegli un modello e imposta una finestra di contesto di almeno 64K, aumentandola per i repository più grandi.

Claude Code inserisce nella finestra di contesto i contenuti dei file, le differenze e l’output dei comandi. Con un valore predefinito ridotto, lo spazio finisce a metà attività. Il problema sembra di ragionamento, ma dipende dalle impostazioni.

ContestoCosa gestisce
Meno di 32KModifiche a un file e domande rapide
64KLavoro su più file in un repository contenuto
128KRepository più grandi e output dei comandi esteso
256KL’intera finestra di Qwen3.8 27B

Se Claude Code perde il filo a metà di un’attività, controlla il contesto prima di cambiare modello.

Verificare le chiamate agli strumenti con un comando

Le chiamate agli strumenti distinguono un agente da un generatore di testo. Verifica che funzionino.

Dopo aver avviato Claude Code, chiedigli:

Read the current directory and list all files

Se elenca file reali, le chiamate agli strumenti funzionano. Se dice che leggerebbe la directory e descrive cosa si aspetta di trovare, la funzione non è collegata. Stai usando un modello di chat con un prompt di programmazione, non un agente. Nessun prompt aggiuntivo risolve il problema.

Controlla le cause in quest’ordine:

  1. Passa a un modello con supporto verificato per gli strumenti. Non tutti i modelli lo offrono e il numero di parametri non rivela questa differenza.
  2. Verifica che l’ambiente punti a Ollama. Esegui ollama --version e controlla che ANTHROPIC_BASE_URL indichi l’endpoint locale.
  3. Esegui /status in Claude Code. Un URL base o una credenziale nei file delle impostazioni di Claude prevale sulle variabili della shell appena esportate.

Funzioni disponibili solo nel cloud

Conosci i limiti prima di ricostruire un flusso di lavoro attorno all’inferenza locale.

FunzioneModelli localiCloud
Chat e modifica dei fileSìSì
Chiamate agli strumentiDipende dal modelloSì
SubagentiSìSì
Ricerca webFornita tramite OllamaSì
CoworkTramite Claude DesktopSì
Modalità automaticaTramite Claude DesktopSì
Prompt pianificatiTramite /loop in Claude CodeSì

Tre limiti riguardano l’uso locale:

  • Il ragionamento su più file peggiora prima della velocità. Un modello locale gestisce bene un file, in modo accettabile tre file e male un intero repository. Dimensiona il lavoro di conseguenza.
  • Alcuni modelli cloud richiedono un piano Ollama a pagamento. Devi anche avere effettuato l’accesso e averli abilitati.
  • Il percorso diretto al cloud ha limiti funzionali. Se salti l’installazione locale, la ricerca web ospitata e i controlli avanzati degli strumenti non sono completamente supportati.

L’inferenza locale è adatta a lavori circoscritti e verificabili, meno a quelli ampi e ambigui. Organizza le attività tenendo presente questa distinzione.

Automatizzare

Due funzioni ampliano l’uso oltre le sessioni interattive.

Esecuzioni headless per script e CI

Il flag --yes salta le selezioni interattive e scarica il modello se necessario. Richiede --model; tutto ciò che segue -- passa direttamente a Claude Code:

ollama launch claude --model gemma4:cloud --yes -- -p "how does this repository work?"

Fai attenzione alle autorizzazioni. Claude Code chiede conferma prima della maggior parte delle azioni. Un’esecuzione headless richiede quindi regole di autorizzazione configurate o un ambiente isolato. Non affidare una repository importante a un agente senza supervisione.

Prompt pianificati con /loop

Durante una sessione di Claude Code, /loop esegue a intervalli un prompt o un comando slash:

/loop 30m Check my open PRs and summarize their status
/loop 1h Research the latest AI news and summarize key developments
/loop 15m Check for new GitHub issues and triage by priority

Funziona finché la sessione resta aperta. Non è un demone in background e termina con la sessione.

Risolvere i problemi

SintomoCausa probabileSoluzione
Connessione rifiutataOllama non è in esecuzioneEsegui ollama serve e verifica con curl http://localhost:11434/api/tags
Descrive le azioni invece di eseguirleIl modello selezionato non supporta le chiamate agli strumentiPassa a un modello con supporto verificato
Viene usata una chiave API reale al posto dell’endpoint localeANTHROPIC_API_KEY è ancora esportataImpostala su una stringa vuota, come sopra
Cowork non compare dopo la configurazioneÈ stata configurata la CLI di Claude Code anziché Claude DesktopPer Cowork, usa il percorso Ollama Apps
La generazione è lentaIl contesto è troppo grande oppure il modello è denso mentre ne basta uno sparsoRiduci il contesto e poi prova un modello mixture-of-experts
Le variabili esportate non hanno effettoI file delle impostazioni di Claude prevalgono sulle variabili della shellControlla i file delle impostazioni, poi esegui /status
Le richieste in background fallisconoClaude Code sceglie un modello piccolo per le attività interneImposta il modello piccolo sullo stesso modello locale

Due di questi sette problemi hanno la stessa causa. La maggior parte degli errori di configurazione deriva dall’endpoint sbagliato o da un modello senza supporto per gli strumenti.

Punti chiave

  • Claude Desktop e Claude Code sono integrazioni separate. Cowork è disponibile in Claude Desktop e si configura su macOS dal pannello Apps di Ollama. Il percorso CLI non offre Cowork.
  • Un comando avvia il percorso CLI: ollama launch claude. La configurazione manuale richiede tre variabili e molte guide omettono ANTHROPIC_API_KEY="".
  • L’installazione locale non è indispensabile. Indirizza Claude Code a https://ollama.com con una chiave API.
  • Imposta un contesto di almeno 64K prima di valutare un modello. Una finestra ridotta può sembrare un problema di ragionamento.
  • Verifica le chiamate agli strumenti con una richiesta. Se il modello descrive cosa farebbe, hai un generatore di testo, non un agente.
  • I pacchetti ternari Bonsai non funzionano in questo caso. Richiedono il fork llama.cpp di Prism ML, che Ollama standard non può caricare.
  • Disconnettersi è sicuro. Chiudere Ollama ripristina la configurazione precedente di Claude; dal terminale puoi anche usare ollama launch claude-desktop --restore.

Passaggi successivi

  1. Installa Ollama e scarica un modello con supporto verificato per gli strumenti prima di configurare Claude: Libreria dei modelli Ollama
  2. Consulta la pagina Ollama per Claude Code per i flag e i modelli aggiornati: Integrazione Claude Code
  3. Se vuoi Cowork, consulta la pagina Claude Desktop: Integrazione Claude Desktop
  4. Scegli l’hardware prima di acquistarlo, usando le fasce di memoria della nostra guida all’inferenza locale: IA locale nel 2026: un modello 27B supera Sonnet 4.6
  5. Controlla cosa gestisce l’hardware più piccolo se vuoi un agente sempre attivo su un dispositivo a basso consumo: Quali modelli IA funzionano su Raspberry Pi 4 o 5?

Articoli correlati

ArticoloContenuto
IA locale nel 2026: un modello 27B supera Sonnet 4.6Benchmark per l’inferenza locale, quantizzazione ternaria e scelta dell’hardware
Quali modelli IA funzionano su Raspberry Pi 4 o 5?Inferenza locale per un piccolo assistente sempre attivo
Creare un assistente IA per Meshtastic che tutela la privacyUn modello locale per una radio off-grid, con la privacy come obiettivo principale
Le migliori estensioni VS Code per lo sviluppo IAStrumenti per l’editor da affiancare a un agente di programmazione locale

Riferimenti

  1. Integrazione Claude Code - documentazione Ollama
  2. Integrazione Claude Desktop - documentazione Ollama
  3. Libreria dei modelli Ollama
  4. Qwen3.8 - libreria dei modelli Ollama
  5. Claude Cowork con modelli locali - PromptSpace
  6. Fork llama.cpp di Prism ML - kernel ternari