Claude Code + DeepSeek V4 Flash: come collegarli e quanto costa un task

DeepSeek ha un endpoint in formato Anthropic — https://api.deepseek.com/anthropic — e una guida ufficiale per Claude Code. La chiave si crea nella dashboard di DeepSeek (platform.deepseek.com) e il saldo va ricaricato in anticipo. Le variabili dalla guida DeepSeek al 2 novembre 2026 sono:

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-your-deepseek-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
export CLAUDE_CODE_EFFORT_LEVEL=max
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=786432
claude

Ecco cosa conviene sapere prima del primo avvio:

• Nome del modello. Dal 10 settembre 2026 deepseek-flash è V4.1 Flash, mentre dal 17 ottobre è il suo aggiornamento 1017 allo stesso prezzo. Il vecchio nome deepseek-v4-flash è ancora accettato da DeepSeek, ma risponde con lo stesso V4.1 Flash. Il suffisso [1m] comunica a Claude Code che la finestra del modello è di 1 milione di token, mentre CLAUDE_CODE_AUTO_COMPACT_WINDOW stabilisce a quale volume comprimere la cronologia.
• Nomi Claude. Se in Claude Code si lascia un modello con nome Claude, DeepSeek ne inserisce uno proprio: i nomi che contengono claude-opus finiscono su V4 Pro e vengono fatturati al prezzo di V4 Pro, gli altri su deepseek-flash. Per questo nella guida tutti gli alias sono fissati esplicitamente.
• Ore di punta. Dal 16 agosto 2026 DeepSeek applica il doppio del prezzo nei giorni feriali dalle 01:00 alle 04:00 e dalle 06:00 alle 10:00 UTC, esclusi i giorni festivi cinesi. In ora di Pechino è quasi tutta la giornata lavorativa, in Europa è la mattina, negli Stati Uniti è la sera e la notte.
• Ricerca web. Quando Claude Code cerca su internet con lo strumento integrato, la ricerca viene eseguita da DeepSeek stessa. Dal 31 ottobre 2026 è a pagamento: $0,75 per 1000 richieste riuscite, più i token che il modello consuma per leggere i risultati trovati.

Sulla rete Gonka è disponibile DeepSeek V4 Flash versione 0731 — pesi aperti con licenza MIT. Il gateway accetta direttamente le richieste di Claude Code nel formato Anthropic (/v1/messages), senza bisogno di alcun livello intermedio.

Passo 1. La chiave. Registrati su JoinGonka Gateway — ai nuovi account vengono accreditati 3M token gratuiti — e crea nella dashboard una chiave jg-….

Passo 2. L'installer.

npx @joingonka/setup --tool claude-code --model deepseek

L'installer chiederà la chiave, salverà una copia di ~/.claude/settings.json e scriverà nel blocco env solo le proprie variabili: l'indirizzo del gateway e la chiave; il modello per la sessione corrente e quelle nuove, per gli alias opus, sonnet, fable e per i subagent; MiniMax M2.7 per l'alias haiku, su cui Claude Code tiene le attività in background; i limiti reali del modello — finestra di 380.000 token e risposta fino a 32.768. Le altre tue impostazioni non vengono toccate, e al file con la chiave vengono assegnati i permessi 600. Alla fine l'installer verifica la chiave con una richiesta reale. Lo stesso installer configura anche altri programmi — ormai 25, tra cui Codex CLI e OpenCode.

Passo 3. Verifica. Avvia claude e apri /status: dovresti vedere la riga Anthropic base URL con l'indirizzo del gateway e la riga Auth token con ANTHROPIC_AUTH_TOKEN. Poi assegna un compito sul codice, ad esempio Read calc.py and tell me in one sentence whether it has a bug.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gate.joingonka.ai",
    "ANTHROPIC_AUTH_TOKEN": "jg-your-key",
    "ANTHROPIC_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMaxAI/MiniMax-M2.7",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "380000",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32768"
  }
}

Tutte le varianti di configurazione, comprese Windows e la configurazione per un singolo progetto, sono nella guida a Claude Code.

Cosa significa in pratica:

• Versione del modello. V4.1 Flash è più recente e, secondo i test della stessa DeepSeek, è più potente: in Terminal-Bench 2.1 V4.1 Flash ottiene 90,6 contro 82,7 di V4 Flash 0731 (dati dei rilasci del 10 settembre e del 31 luglio). Se ti servono immagini, una finestra da un milione di token o la versione più recente, scegli l'API ufficiale di DeepSeek. Se invece contano di più il costo su grandi volumi e un prezzo unico a qualsiasi ora, prova V4 Flash tramite gateway sulle tue attività: puoi iniziare con i token gratuiti.
• Sessioni lunghe. In una finestra da 380.000 token entra meno cronologia rispetto a un milione. Per il lavoro quotidiano basta: la richiesta media di Claude Code a DeepSeek V4 Flash tramite il nostro gateway a ottobre 2026 è di circa 96 mila token.

Per saperne di più sul modello, leggi l'articolo su DeepSeek V4 Flash nella rete Gonka.

Iniziamo dai prezzi per 1M di token al 2 novembre 2026 — dalla pagina dei prezzi di DeepSeek e dall'API di OpenRouter. Accanto a DeepSeek c'è lo stesso V4 Flash 0731 dei fornitori più economici su OpenRouter:

L'input normale da noi costa 24–49 volte meno che da DeepSeek, l'output 32–65 volte meno. Ma la lettura dalla cache di DeepSeek nelle ore di punta costa più o meno come il nostro input, e nel resto della giornata la metà, e Claude Code quasi sempre rilegge le stesse cose: il system prompt, la descrizione degli strumenti e la cronologia della sessione. Perciò bisogna confrontare l'intera attività, non il prezzo del token.

L'attività. Prendiamo un'attività da 30 chiamate al modello — per esempio trovare un bug, correggere il codice e lanciare i test. Secondo i dati del nostro gateway di ottobre 2026, una richiesta di Claude Code a DeepSeek V4 Flash è in media di circa 96 mila token in input e 0,9 mila in output. In totale l'attività è di 2,9 milioni di token in input e 27,5 mila in output. Claude Code a ogni passaggio invia di nuovo la sessione, e quasi tutta coincide con la richiesta precedente, perciò supponiamo che su DeepSeek e OpenRouter il 95% dell'input venga letto dalla cache.

Gli importi sono calcolati sui prezzi al 2 novembre 2026; il nostro prezzo per token in questa pagina è live e cambia con il cambio di GNK. Per un'attività così il gateway costa circa 5 volte meno di DeepSeek nelle ore di punta, 2,5 volte meno nel resto della giornata e 2,3 volte meno del fornitore più economico dello stesso modello su OpenRouter.

La differenza dipende dalla cache. Se dalla cache viene letto il 98% dell'input, DeepSeek costa circa 1,8 volte più di noi fuori punta e 3,7 volte nelle ore di punta. Se il 90% — 3,7 e 7,4 volte. Da noi la quota di cache non incide sul totale: tutto l'input ha lo stesso prezzo. Il calcolo su un mese, la variante con GLM-5.3 Flash e i prezzi di Claude stesso come riferimento sono nell'articolo «Claude Code costa meno».

Claude Code Router (CCR) è un progetto open source con licenza MIT: un gateway locale sul tuo computer, per impostazione predefinita http://127.0.0.1:3456. Claude Code e altri agenti gli inviano le richieste, e lui le inoltra ai provider scelti: converte le richieste tra i formati (Anthropic Messages, OpenAI Chat e Responses, Gemini), instrada le attività verso i modelli in base alle regole, passa a un modello di riserva in caso di errore e tiene un registro delle richieste con token e stima dei costi. Si installa come applicazione per macOS, Windows e Linux oppure con il comando npm install -g @musistudio/claude-code-router (richiede Node.js 22 o superiore).

Per un solo DeepSeek non serve: DeepSeek ha un proprio endpoint in formato Anthropic, e anche JoinGonka Gateway accetta direttamente le richieste di Claude Code. CCR ha senso se vuoi:

• gestire più provider e regole su dove inviare ogni attività;
• passare automaticamente a un modello di riserva quando quello principale non risponde;
• vedere in un unico posto il registro di richieste, token e costi;
• collegare un provider che capisce solo il formato OpenAI.

CCR collega un endpoint personalizzato con il protocollo Anthropic Messages o OpenAI Chat, e il gateway supporta entrambi: l'indirizzo base https://gate.joingonka.ai per Anthropic e https://gate.joingonka.ai/v1 per OpenAI. I dettagli sono nella documentazione di Gonka API, sezione Anthropic Messages.

Claude Code prende la chiave di un'API di terze parti da una di queste due variabili:

• ANTHROPIC_AUTH_TOKEN — la chiave viene inviata nell'header Authorization: Bearer ed è attiva subito. È così che fanno sia la guida di DeepSeek sia il nostro installer.
• ANTHROPIC_API_KEY — la chiave viene inviata nell'header x-api-key; in modalità interattiva Claude Code chiederà una volta se usarla.

DeepSeek e JoinGonka accettano entrambi gli header. Finché la variabile con la chiave è impostata, l'abbonamento a claude.ai non viene consumato: Claude Code ricorda il tuo accesso, ma non lo invia, e le richieste vengono pagate dal saldo di quella chiave. Se imposti solo l'indirizzo senza la chiave, Claude Code invierà al nuovo indirizzo il tuo accesso a claude.ai e la richiesta non andrà a buon fine.

Conserva la chiave in ~/.claude/settings.json o nel .claude/settings.local.json del progetto, ma non nel .claude/settings.json condiviso del repository — di solito viene committato. L'installer con il flag --scope local scrive in settings.local.json e lo aggiunge da solo al .gitignore.

Tornare a Claude — rimuovi dal blocco env le righe che puntano a DeepSeek o al gateway e riavvia Claude Code: tornerà a usare il tuo accesso a claude.ai.