DeepSeek V4 Flash e Pro in Claude Code: impostazioni e cambio modello

Configura DeepSeek in Claude Code tramite APIMaster. Configura settings.json su Windows, macOS e Linux, avvia claude, seleziona un modello con /model e inizia a chattare.

Configura APIMaster in settings.json, avvia claude, poi inserisci /model MODEL_ID nella conversazione per usare DeepSeek. Gli ID disponibili trattati qui sono deepseek-v4-flash, deepseek-v4-pro. Claude Code è il client; DeepSeek è il modello che risponde.

Prima di iniziare

Completa il controllo dell'ambiente e la configurazione di Claude Code. Ottieni una chiave API APIMaster con credito sufficiente e accesso ai modelli selezionati.

claude --version

L'URL di base del gateway è https://apimaster.ai, senza /v1. Claude Code aggiunge /v1/messages da sé.

1. Apri la directory di configurazione

Windows

Premi Win + R, inserisci il percorso seguente e premi Invio:

%USERPROFILE%\.claude

Crea la cartella se necessario. Apri o crea settings.json. Assicurati che non sia denominato settings.json.txt.

macOS / Linux

Su macOS, in Finder premi Command + Shift + G e inserisci:

~/.claude

Su Linux, apri la stessa directory con il tuo file manager o editor. Creala se necessario:

mkdir -p ~/.claude

Apri o crea settings.json lì. Se hai impostato una directory di configurazione personalizzata per Claude Code, usa quella directory.

2. Modifica settings.json

Windows, macOS e Linux usano la stessa configurazione. Sostituisci YOUR_APIMASTER_API_KEY con la tua chiave APIMaster:

{
  "model": "deepseek-v4-flash",
  "env": {
    "ANTHROPIC_BASE_URL": "https://apimaster.ai",
    "ANTHROPIC_API_KEY": "YOUR_APIMASTER_API_KEY",
    "ANTHROPIC_AUTH_TOKEN": "",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

Se il file esiste già, creane una copia di backup e unisci questi campi nell'oggetto JSON esistente e nell'oggetto env. Mantieni le altre impostazioni di cui hai bisogno. Non aggiungere un secondo oggetto JSON né duplicare una chiave env. JSON non consente commenti né virgole finali.

La guida generale di Claude Code mostra l'autenticazione tramite token. Questa guida usa l'autenticazione tramite chiave API verificata nei nostri test di integrazione. Mantieni ANTHROPIC_AUTH_TOKEN vuoto quando usi ANTHROPIC_API_KEY e rimuovi le credenziali in conflitto da altre impostazioni o dal tuo terminale. Usa una chiave APIMaster per questo gateway.

Il campo model imposta il modello iniziale. Puoi selezionarne un altro dopo l'avvio. Mantieni questo file di impostazioni utente privato; non committare chiavi reali in un repository condiviso. Salva il file e riavvia Claude Code per caricare la nuova configurazione.

3. Avvia Claude Code

In un terminale aperto nella directory del tuo progetto, esegui:

claude

Completa le normali richieste della prima esecuzione e rivedi la richiesta di attendibilità del progetto. Il modello iniziale dovrebbe essere deepseek-v4-flash. Questa è una normale sessione interattiva con i consueti strumenti e le impostazioni del progetto.

4. Seleziona un modello e inizia a chattare

Nella conversazione di Claude Code, inserisci uno dei comandi seguenti e premi Invio:

/model deepseek-v4-flash
/model deepseek-v4-pro

Esegui una riga alla volta, scegliendo il modello che desideri. Dopo che Claude Code ha confermato il cambio, invia un breve messaggio:

Reply with exactly OK.

Una normale risposta testuale conferma la connessione di base. Puoi quindi continuare a chattare o chiedere di lavorare sul tuo progetto. Per cambiare di nuovo nella stessa conversazione, inserisci un altro comando /model MODEL_ID.

Inserire solo /model apre il selettore dei modelli. Gli ID personalizzati del gateway potrebbero non comparire nell'elenco predefinito. Digita invece l'ID completo come mostrato sopra. Il comando slash appartiene all'interno di Claude Code, non a PowerShell o Bash. I nomi dei modelli descrivono modelli DeepSeek, non Claude Sonnet o Opus.

Puoi anche scegliere un modello al lancio dal terminale. Esegui un comando alla volta:

claude --model deepseek-v4-flash
claude --model deepseek-v4-pro

Per impostare esplicitamente il modello predefinito per le sessioni future, modifica model in settings.json. Un flag di lancio, la variabile d'ambiente ANTHROPIC_MODEL o un'impostazione di progetto/gestita possono influire sul modello selezionato; controlla questi elementi se il modello iniziale differisce dal valore salvato.

Risoluzione dei problemi

Sintomo	Verifica
401 / richiesta di login inattesa	Controlla la chiave APIMaster, l'URL di base e le variabili di autenticazione in conflitto; riavvia la CLI dopo aver modificato le impostazioni.
404	Usa `https://apimaster.ai`, senza `/v1` o `/v1/messages`.
Le impostazioni non hanno effetto	Controlla la posizione del file, la validità del JSON e le sovrascritture da terminale, progetto o impostazioni gestite.
Modello assente nel selettore	Inserisci `/model MODEL_ID` con l'ID esatto, oppure avvia con `claude --model MODEL_ID`.
Modello non disponibile / 403	Controlla l'ortografia, i modelli consentiti dalla chiave, il saldo dell'account e la disponibilità della rotta corrente.
`unrecognized_model`	Osservato con ID personalizzati nei nostri test. Controlla la risposta effettiva e il risultato dello strumento; i comportamenti predefiniti delle capacità integrate di Claude non sono verificati per DeepSeek.
Permesso negato per file o comando	Rivedi e approva l'operazione prevista tramite le consuete richieste di permesso.
429 / 5xx / risposta interrotta	Conserva l'errore, l'ID del modello, la versione della CLI, l'ora UTC e l'ID della richiesta se disponibile, per il supporto.

Validazione e diagnostica opzionale

Test di integrazione registrati: 2026-09-07 UTC, Claude Code 2.1.239, Linux. Tutti i modelli elencati qui hanno restituito il testo previsto e letto un file locale tramite uno strumento. Attività di codifica complesse erano fuori dall'ambito di quel test. Windows e macOS non facevano parte di quelle esecuzioni registrate.

I controlli automatizzati precedenti usavano la modalità bare per isolare la configurazione. L'uso quotidiano normale segue le impostazioni settings.json e i passaggi interattivi sopra indicati. La modalità bare e --setting-sources "" saltano le integrazioni normali o le impostazioni salvate, quindi non dovrebbero essere aggiunti al comando di avvio quotidiano di questa guida.

Per un rapido controllo non interattivo usando la configurazione salvata:

claude --model deepseek-v4-flash -p "Reply with exactly OK."

Per un controllo degli strumenti, crea probe.txt contenente FILE_PROBE_739182, avvia Claude Code in quella directory e chiedigli di leggere il file usando uno strumento e di restituirne il contenuto esatto. Conferma che lo strumento venga effettivamente eseguito.

Questi sono controlli di integrazione limitati, non una garanzia di ogni funzionalità di Claude Code, del comportamento nelle sessioni lunghe o del contesto massimo. La documentazione del gateway di Anthropic non supporta ufficialmente il routing di Claude Code verso modelli non Claude; questa guida descrive l'integrazione di APIMaster.

FAQ

Il mio abbonamento Claude copre queste richieste?

No. Con questa configurazione APIMaster, le richieste usano la tua chiave e il tuo saldo APIMaster.

Posso continuare a chattare dopo aver cambiato modello?

Sì, usa il comando di cambio modello nella conversazione aperta e attendi la conferma prima di inviare il messaggio successivo. Per un confronto pulito tra modelli, avvia una sessione separata con claude --model MODEL_ID.