# Claude Code con Ollama in locale: guida completa > Fonte: https://francescogruner.it/claude-code-ollama-glm-guida-2026/ **Claude Code con Ollama** permette di usare l’agente di coding di Anthropic con un modello servito da Ollama. La strada ufficiale più semplice è `ollama launch claude`; in alternativa puoi indicare manualmente a Claude Code l’endpoint Anthropic-compatible locale. **In breve:** installa Claude Code e Ollama, avvia `ollama launch claude` e scegli un modello adatto al repository. “Locale” descrive il backend del modello: Claude Code resta il client e le funzioni che richiedono servizi esterni non diventano automaticamente offline. Indice dei contenuti [Toggle](#) - [Claude Code in locale: che cosa significa davvero](#Claude_Code_in_locale_che_cosa_significa_davvero) - [Video: il flusso mostrato in pratica](#Video_il_flusso_mostrato_in_pratica) - [Ti sta piacendo?](#Ti_sta_piacendo) - [Cosa fa Claude Code nel concreto](#Cosa_fa_Claude_Code_nel_concreto) - [Installazione rapida con Ollama](#Installazione_rapida_con_Ollama) - [1. Installa Claude Code e Ollama](#1_Installa_Claude_Code_e_Ollama) - [2. Avvia l’integrazione](#2_Avvia_lintegrazione) - [3. Configurazione manuale](#3_Configurazione_manuale) - [Windows PowerShell e persistenza](#Windows_PowerShell_e_persistenza) - [Contesto, strumenti e permessi](#Contesto_strumenti_e_permessi) - [Locale, cloud e GLM: non confonderli](#Locale_cloud_e_GLM_non_confonderli) - [Troubleshooting essenziale](#Troubleshooting_essenziale) - [Quando usare questa guida e quando l’altra](#Quando_usare_questa_guida_e_quando_laltra) - [Domande frequenti e fonti](#Domande_frequenti_e_fonti) - [Fonti verificate](#Fonti_verificate) ## Claude Code in locale: che cosa significa davvero Claude Code legge il progetto, propone modifiche ed esegue comandi attraverso il proprio flusso di permessi. Ollama sostituisce il backend predefinito esponendo un’API compatibile con il formato Messages di Anthropic. Non stai installando Claude come modello locale: stai collegando il client Claude Code a un altro modello. Questa distinzione evita due promesse sbagliate. Primo: locale non significa qualità identica ai modelli Claude. Secondo: locale non significa che ogni funzione sia offline. Il modello può girare sul computer, ma web search, web fetch, repository remoti e altri strumenti possono generare traffico quando li usi. **Caveat di supporto:** Anthropic non supporta il routing di Claude Code verso modelli non-Claude tramite gateway terzi. La documentazione dell’integrazione pubblicata da Ollama non costituisce un endorsement né supporto Anthropic per il modello alternativo. ## Video: il flusso mostrato in pratica https://www.youtube.com/watch?v=78lN3o9nhlw ## Ti sta piacendo? Ricevi una guida pratica ogni settimana. AI, tool e automazioni. Iscriviti gratis Perfetto, sei dentro. ## Cosa fa Claude Code nel concreto Claude Code lavora su file system, comandi shell, workflow di sviluppo, Git e task multi-step. Il valore del collegamento è mantenere questo harness cambiando il backend del modello, senza confondere client e motore. ## Installazione rapida con Ollama ### 1. Installa Claude Code e Ollama **macOS / Linux / WSL:** usa l’installer ufficiale Claude Code per shell. **Windows PowerShell:** usa l’installer PowerShell ufficiale. Installa poi Ollama dalla pagina ufficiale per la piattaforma e verifica che entrambi i comandi siano disponibili. Non bloccare la guida a un numero di versione: la documentazione corrente resta il riferimento operativo. ### 2. Avvia l’integrazione ``` ollama launch claude ``` Il comando ufficiale prepara il collegamento e apre Claude Code. La selezione del modello dipende da ciò che è disponibile nella tua installazione Ollama; per repository grandi serve anche una finestra di contesto adeguata. ### 3. Configurazione manuale ``` export ANTHROPIC_AUTH_TOKEN=ollama export ANTHROPIC_API_KEY="" export ANTHROPIC_BASE_URL=http://localhost:11434 claude --model qwen3.5 ``` Questi valori seguono la guida Ollama corrente. Il nome del modello è un esempio documentato, non una raccomandazione universale: controlla il catalogo e scegli in base al task, al contesto richiesto e alle risorse realmente disponibili. ### Windows PowerShell e persistenza ``` setx ANTHROPIC_AUTH_TOKEN "ollama" setx ANTHROPIC_BASE_URL "http://localhost:11434" ``` Dopo `setx` apri un nuovo terminale: le variabili persistenti non aggiornano la sessione PowerShell già aperta. Mantieni vuota `ANTHROPIC_API_KEY` come indicato dalla guida Ollama corrente. ## Contesto, strumenti e permessi Ollama raccomanda di scegliere un modello con contesto sufficiente e, per repository più grandi, di impostare 64K o più. Il blog ufficiale dell’integrazione indica almeno 32K come riferimento generale. Non trasformo queste soglie in requisiti di RAM o VRAM: memoria, velocità e stabilità dipendono da modello, quantizzazione, contesto e hardware e vanno misurati sulla macchina usata. Claude Code mantiene il proprio flusso di autorizzazione per comandi e modifiche. Un modello compatibile deve inoltre gestire bene tool calling e istruzioni lunghe. Prima di affidargli un repository importante, prova lettura, modifica, test e annullamento su una copia o su un branch dedicato. ## Locale, cloud e GLM: non confonderli **Modalità**Ollama locale**Dove gira il modello**Sulla macchina o infrastruttura locale configurata**Cosa verificare**Modello, contesto, tool calling, risorse**Modalità**Ollama Cloud**Dove gira il modello**Servizio cloud Ollama**Cosa verificare**Dati inviati, account, limiti e modello**Modalità**Gateway o provider terzo**Dove gira il modello**Provider configurato**Cosa verificare**Compatibilità, credenziali, costi e trattamento dati La pagina prima mescolava setup locale e offerte cloud specifiche. Nel refresh il focus resta sulla query *claude code ollama*; i provider cloud sono una scelta separata e non vengono presentati come equivalenti alla modalità locale. ## Troubleshooting essenziale - **Connessione rifiutata:** verifica che Ollama sia avviato e che `http://localhost:11434` sia raggiungibile dalla stessa macchina o ambiente. - **Parte il provider sbagliato:** controlla le tre variabili ambiente nella shell che avvia Claude Code. - **Il modello non usa gli strumenti:** verifica la compatibilità del modello e prova un task minimo prima del repository reale. - **Il contesto si esaurisce:** riduci il perimetro del task o configura una finestra adeguata seguendo la documentazione Ollama. ## Quando usare questa guida e quando l’altra Questa è la pagina canonica editoriale per installare e configurare Claude Code con Ollama. Se invece vuoi progettare un agente che usa API esterne, documentazione e strumenti WordPress, passa alla guida dedicata su [come costruire un agente AI collegato a un’API](https://francescogruner.it/claude-code-ollama/). ## Domande frequenti e fonti Claude Code diventa un modello locale?No. Claude Code è il client agentico; Ollama fornisce il modello tramite un endpoint compatibile.Posso avviare tutto con un solo comando?La guida Ollama corrente indica `ollama launch claude` come avvio rapido.Il flusso è completamente offline?Non necessariamente. Il modello può essere locale, ma strumenti web, repository remoti e integrazioni esterne possono usare la rete.Quanta RAM o VRAM serve?Non esiste un valore unico affidabile: dipende da modello, quantizzazione e contesto. Va verificato sulla configurazione scelta. ### Fonti verificate [Ollama Docs - integrazione Claude Code](https://docs.ollama.com/integrations/claude-code)[Ollama Blog - compatibilità Anthropic API](https://ollama.com/blog/claude)[Anthropic - panoramica ufficiale Claude Code](https://code.claude.com/docs/en/overview)[Anthropic - configurazione LLM gateway e caveat non-Claude](https://code.claude.com/docs/en/llm-gateway)