Usa DeepSeek in Claude Code: Guida alla configurazione V4 Flash / Pro
Esegui DeepSeek V4 Flash e Pro in Claude Code tramite APIMaster. Imposta il gateway e la chiave API, cambia modello, verifica gli strumenti di lettura file e correggi gli errori di configurazione.
Claude Code può usare DeepSeek? I nostri test con Claude Code 2.1.239 hanno utilizzato con successo deepseek-v4-flash e deepseek-v4-pro tramite l'endpoint Messages di APIMaster. Imposta ANTHROPIC_BASE_URL su https://apimaster.ai, fornisci una chiave APIMaster e seleziona il modello esplicitamente. Questa configurazione esegue DeepSeek, anche se il client si chiama Claude Code.
Ultimo test: 2026-09-07, Claude Code 2.1.239, Linux. Entrambi i modelli hanno restituito il testo previsto e completato un round trip con lo strumento di lettura file. Tutte le esecuzioni sono terminate con codice 0. La CLI ha stampato
unrecognized_model, ma le richieste testate sono riuscite. Questi controlli non stabiliscono il supporto per ogni funzionalità di Claude Code, sessioni lunghe o versioni future. I comandi di configurazione per Windows / macOS sono inclusi; il test registrato è stato eseguito su Linux.
1. Prepara la CLI e la chiave API
Segui la guida all'ambiente e la guida alla configurazione di Claude Code per l'installazione. Controlla la tua versione:
claude --version
Ottieni una chiave API APIMaster con accesso al modello DeepSeek selezionato e quota sufficiente. Usa le impostazioni di sessione di seguito per questo tutorial; non è necessario sovrascrivere il tuo settings.json normale.
2. Imposta il gateway e la chiave
Apri un nuovo terminale per mantenere queste impostazioni separate dalla tua sessione CLI abituale.
macOS / Linux:
export ANTHROPIC_BASE_URL='https://apimaster.ai'
export ANTHROPIC_API_KEY='YOUR_APIMASTER_API_KEY'
unset ANTHROPIC_AUTH_TOKEN
Windows PowerShell:
$env:ANTHROPIC_BASE_URL = 'https://apimaster.ai'
$env:ANTHROPIC_API_KEY = 'YOUR_APIMASTER_API_KEY'
Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue
Usa qui l'origine del sito, senza /v1: Claude Code aggiunge /v1/messages. La chiave API deve provenire da APIMaster. Questi comandi influenzano questo terminale e i suoi processi figli, non i tuoi file di accesso salvati. Non inserire una chiave reale in un file di impostazioni condiviso o in un repository.
3. Invia una richiesta di test minima
claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools "" --output-format json -p "Reply with exactly: DEEPSEEK_TEST_OK"
Previsto: is_error è false, result è DEEPSEEK_TEST_OK e il processo esce con codice 0. Cambia --model in deepseek-v4-pro ed esegui di nuovo.
La modalità --bare della versione testata usa l'autenticazione esplicita con chiave API e salta le integrazioni di background normali. --setting-sources "" esclude le fonti di impostazioni salvate, mentre --tools "" disabilita gli strumenti per questo singolo test di testo. Queste sono impostazioni diagnostiche deliberate, non requisiti per disabilitare gli strumenti durante l'uso normale. Le versioni CLI più vecchie potrebbero non accettare tutti questi flag.
4. Verifica gli strumenti di lettura file
Crea probe.txt nella directory corrente con questo contenuto:
TOOL_PROBE_739182
Esegui:
claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools Read --allowedTools Read --output-format json -p "Use the Read tool to read probe.txt in the current directory. Reply with only the exact content. Do not guess."
Previsto: la CLI legge il file e restituisce TOOL_PROBE_739182. Ripeti con deepseek-v4-pro. Questo controlla che il modello possa richiedere uno strumento, ricevere il risultato e poi rispondere. Solo lo strumento Read è abilitato per questo test.
Per il lavoro interattivo ordinario con le stesse impostazioni del terminale:
claude --bare --setting-sources "" --model deepseek-v4-flash
Per iniziare con Pro:
claude --bare --setting-sources "" --model deepseek-v4-pro
I comandi interattivi omettono --tools "", quindi gli strumenti predefiniti sono disponibili. Rivedi i prompt di autorizzazione come al solito. --bare salta comodità come hook e istruzioni di progetto automatiche; abilita le tue impostazioni normali deliberatamente dopo che la configurazione minima funziona e controlla che non sovrascrivano il gateway o il modello. Chiudi questo terminale quando hai finito per lasciare l'ambiente di questa sessione.
Risoluzione dei problemi
| Sintomo | Cosa controllare |
|---|---|
unrecognized_model |
Osservato per entrambi gli ID DeepSeek in 2.1.239. Non ha impedito il completamento delle nostre richieste. Controlla il risultato finale piuttosto che trattare l'avviso da solo come un errore. |
| 401 o un prompt di accesso inaspettato | Conferma che ANTHROPIC_API_KEY sia impostato, rimuovi un ANTHROPIC_AUTH_TOKEN in conflitto in questo terminale e riprova la modalità bare. |
| 404 | ANTHROPIC_BASE_URL dovrebbe essere https://apimaster.ai, non l'endpoint completo /v1/messages o una base che termina con /v1. |
Opzione --bare sconosciuta |
Controlla la tua versione rispetto alla 2.1.239 testata. Usa la guida all'installazione generale per aggiornare se appropriato. |
Impossibile leggere probe.txt |
Esegui dalla directory del file. Per il test dello strumento, abilita Read piuttosto che usare --tools "". |
| È selezionato un modello diverso | Passa l'ID modello completo con --model e controlla le impostazioni salvate o le override dell'alias del modello prima di abilitarle. |
| Limite di velocità, quota insufficiente o errore a monte | Leggi il corpo dell'errore, controlla quota e permessi del modello e registra il timestamp per il supporto. |
Domande frequenti
È lo stesso che usare un modello Claude?
No. Claude Code è il client qui; il modello selezionato è DeepSeek. Le funzionalità che dipendono da un particolare modello Claude non sono automaticamente coperte da questa configurazione.
Perché l'URL di base è diverso dall'esempio dell'SDK Python?
L'SDK Python OpenAI usa https://apimaster.ai/v1 e aggiunge /chat/completions. Claude Code usa https://apimaster.ai e aggiunge /v1/messages. Usa il formato di base documentato di ciascun client.
Posso usare una chiave ufficiale DeepSeek con questo gateway?
Questo tutorial richiede una chiave emessa da APIMaster. Le chiavi sono specifiche del provider che le emette; cambiare solo l'endpoint non trasferisce credenziali o quota.
È stato testato l'uso effettivo degli strumenti, o solo una risposta di testo?
Entrambi sono stati testati per entrambi i modelli. Il test dello strumento ha letto un file locale e restituito il suo contenuto. Non stabilisce che tutti gli strumenti, gli agenti in background o le attività di codifica lunghe siano supportati.