Usare Claude Code con DeepSeek, Ollama o altri modelli
Collega Claude Code all'endpoint compatibile con Anthropic di un fornitore con ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN, e indica i modelli del fornitore in ANTHROPIC_MODEL e nelle variabili ANTHROPIC_DEFAULT_*_MODEL. Funziona, ma Anthropic non lo supporta, una sessione dialoga con un solo fornitore e funzioni come il prompt caching possono essere ignorate in silenzio.
Aggiornato il
Come funziona
Claude Code invia ogni richiesta nel formato Messages di Anthropic a qualunque indirizzo indichi ANTHROPIC_BASE_URL. Un fornitore che serve quel formato può prendere il posto di Anthropic, e Claude Code non nota la differenza finché una richiesta non usa qualcosa che il fornitore non ha implementato. La documentazione di Anthropic sui gateway dice esplicitamente che non è supportato: “non supporta l'instradamento di Claude Code verso modelli non Claude tramite alcun gateway”.
Endpoint che funzionano
| Fornitore | ANTHROPIC_BASE_URL | Note |
|---|---|---|
| DeepSeek | https://api.deepseek.com/anthropic | Guida ufficiale. I nomi claude-opus* corrispondono a V4 Pro, tutto il resto a V4 Flash |
| Ollama (locale) | http://localhost:11434 | Integrazione ufficiale da Ollama 0.14; ollama launch claude la configura |
| Kimi (Moonshot) | https://api.moonshot.ai/anthropic | Guida ufficiale; kimi-k2.7-code richiede il thinking attivo |
| Z.ai GLM | https://api.z.ai/api/anthropic | Guida ufficiale |
| Alibaba Coding Plan | https://coding-intl.dashscope.aliyuncs.com/apps/anthropic | Guida ufficiale; gli endpoint a consumo sono per regione |
| OpenRouter | https://openrouter.ai/api | Garantito solo con Anthropic come provider a monte; imposta ANTHROPIC_API_KEY a una stringa vuota |
| LM Studio (locale) | http://localhost:1234 | Pagina di integrazione ufficiale |
Esempio: DeepSeek
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API key>
export ANTHROPIC_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-flash
claudeSono i valori della pagina su Claude Code di DeepSeek. Imposta ogni livello, non solo ANTHROPIC_MODEL: un livello lasciato vuoto invia comunque un nome di modello Claude, che l'endpoint non conosce, e le attività in background e i sub-agenti che lo usano falliscono.
Esempio: un modello locale con Ollama
ollama launch claudeQuesto configura Claude Code al posto tuo. A mano, bastano tre variabili e un modello che supporti la chiamata di strumenti:
export ANTHROPIC_BASE_URL=http://localhost:11434
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
claude --model qwen3.5Ollama consiglia una finestra di contesto di 64K token o più per i repository più grandi; un agente di codice reinvia la conversazione a ogni turno e una finestra piccola si riempie in fretta.
Cosa si rompe
- I marcatori del prompt caching. DeepSeek e Ollama ignorano il
cache_controldi Anthropic, e Kimi lo rispetta solo al livello superiore. Non compare alcun errore; se ottieni ancora i prezzi della cache dipende dal caching del fornitore stesso. - Il cambio di fornitore. Claude Code legge un solo
ANTHROPIC_BASE_URL, quindi passare da DeepSeek a Claude significa riavviare con impostazioni diverse, non un comando/model. - La ricerca web. Lo strumento WebSearch di Claude Code gira sui server di Anthropic. DeepSeek dice che il suo endpoint lo supporta; Ollama dice che la ricerca web ospitata non è pienamente supportata.
- I campi di richiesta sconosciuti. Claude Code tratta un nome di modello non riconosciuto come un modello Claude attuale e invia campi di thinking ed effort che alcuni endpoint rifiutano con un 400.
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1elimina i campi beta, al prezzo della ricerca di strumenti MCP. - Le funzioni dell'account. Remote Control e la dettatura vocale non sono disponibili mentre è impostata una credenziale di gateway.
- Le credenziali residue. Una
ANTHROPIC_API_KEYrimasta, un login salvato o vecchi valorienvinsettings.jsonpossono scavalcare la configurazione;/statusmostra quale è in uso.
Quando conviene un agente indipendente dal modello
Se ti basta un fornitore alla volta e lavori già in Claude Code, le impostazioni qui sopra sono sufficienti. Se vuoi Claude, DeepSeek e un modello locale nella stessa attività, OHarness lo fa in modo nativo: ogni provider è integrato, la conversazione è salvata in un formato indipendente dal fornitore e /model passa da un fornitore all'altro senza riavvio. OHarness vs Claude Code mette a confronto diretto i due.
npm install -g oharnessoharness -m deepseek/deepseek-v4-flashPoi, a metà sessione, /model anthropic/claude-sonnet-5 per il passaggio che lo richiede, e di nuovo indietro.
Fonti
- Anthropic: gateway LLM e variabili d'ambiente
- DeepSeek: Claude Code e compatibilità con l'API Anthropic
- Ollama: Claude Code e compatibilità con Anthropic
- Kimi: Claude Code, Z.ai: Claude Code, Alibaba Model Studio: Claude Code
- OpenRouter: Claude Code, LM Studio: Claude Code
- Verificato il 2026-09-25. I fornitori cambiano questi endpoint; le loro pagine fanno fede.
Domande frequenti
Claude Code può usare i modelli DeepSeek?
Sì, in modo non ufficiale. DeepSeek serve un endpoint compatibile con Anthropic su https://api.deepseek.com/anthropic: imposta ANTHROPIC_BASE_URL su quell'indirizzo, ANTHROPIC_AUTH_TOKEN su una chiave API DeepSeek e le variabili dei modelli sui nomi dei modelli DeepSeek. Anthropic non supporta modelli non Claude in Claude Code.
Claude Code può eseguire un modello locale con Ollama?
Sì. Ollama 0.14 e successivi servono il formato Messages di Anthropic, e `ollama launch claude` configura Claude Code per usarlo. Scegli un modello che supporti la chiamata di strumenti e dagli una finestra di contesto di 64K token o più.
Claude Code può passare da Claude a DeepSeek in una sola sessione?
No. Claude Code legge un solo ANTHROPIC_BASE_URL, quindi una sessione di Claude Code dialoga con un solo fornitore. OHarness passa da Anthropic a DeepSeek, OpenAI, Gemini e modelli locali a metà sessione con /model.
Perché Claude Code restituisce errori 400 con l'endpoint di un altro fornitore?
Claude Code presume che un modello non riconosciuto sia un modello Claude attuale e invia campi come adaptive thinking ed effort che alcuni endpoint rifiutano. Impostare ogni variabile ANTHROPIC_DEFAULT_*_MODEL sui nomi del fornitore, e CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1, ne elimina la maggior parte.