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

FornitoreANTHROPIC_BASE_URLNote
DeepSeekhttps://api.deepseek.com/anthropicGuida ufficiale. I nomi claude-opus* corrispondono a V4 Pro, tutto il resto a V4 Flash
Ollama (locale)http://localhost:11434Integrazione ufficiale da Ollama 0.14; ollama launch claude la configura
Kimi (Moonshot)https://api.moonshot.ai/anthropicGuida ufficiale; kimi-k2.7-code richiede il thinking attivo
Z.ai GLMhttps://api.z.ai/api/anthropicGuida ufficiale
Alibaba Coding Planhttps://coding-intl.dashscope.aliyuncs.com/apps/anthropicGuida ufficiale; gli endpoint a consumo sono per regione
OpenRouterhttps://openrouter.ai/apiGarantito solo con Anthropic come provider a monte; imposta ANTHROPIC_API_KEY a una stringa vuota
LM Studio (locale)http://localhost:1234Pagina 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
claude

Sono 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 claude

Questo 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.5

Ollama 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_control di 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=1 elimina 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_KEY rimasta, un login salvato o vecchi valori env in settings.json possono scavalcare la configurazione; /status mostra 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 oharness
oharness -m deepseek/deepseek-v4-flash

Poi, a metà sessione, /model anthropic/claude-sonnet-5 per il passaggio che lo richiede, e di nuovo indietro.

Fonti

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.

Correlati