Guida all'uso dei fornitori terze parti di Claude Code - Analisi approfondita e best practice

Questo articolo descrive in dettaglio come configurare Claude Code utilizzando fornitori terze parti (come DeepSeek, Z-AI, Moonshot, ecc.), inclusa la configurazione delle variabili d’ambiente, l’ottimizzazione della selezione dei modelli, i suggerimenti per l’uso della modalità Plan e consigli pratici per evitare le trappole comuni di configurazione.
Tags:
Categories:

Guida all’uso dei fornitori terze parti di Claude Code

Introduzione

Basato sulla mia esperienza pluriennale con Claude Code, questo articolo condivide come configurare efficientemente i fornitori terze parti ed evitare le comuni trappole di configurazione. A differenza dei media che si limitano a inoltrare le informazioni ufficiali, i contenuti qui presenti sono tutti suggerimenti pratici verificati sul campo.

Configurazione delle variabili d’ambiente

Configurazione di base (menzionata nella maggior parte delle guide)

ANTHROPIC_BASE_URL=Il tuo indirizzo API del fornitore
ANTHROPIC_AUTH_TOKEN=Il tuo token di autenticazione
ANTHROPIC_MODEL=Nome del modello predefinito

ANTHROPIC_SMALL_FAST_MODEL è stato deprecato, sostituito da ANTHROPIC_DEFAULT_HAIKU_MODEL.

Configurazione avanzata (meno comunemente menzionata)

Attualmente Claude Code supporta la selezione di diversi modelli per diverse attività:

# Configurare separatamente le diverse serie di modelli
ANTHROPIC_DEFAULT_OPUS_MODEL=modello serie opus
ANTHROPIC_DEFAULT_SONNET_MODEL=modello serie sonnet
ANTHROPIC_DEFAULT_HAIKU_MODEL=modello serie haiku

# Modello utilizzato dai sub-agenti
CLAUDE_CODE_SUBAGENT_MODEL=modello sub-agente
# Impostare il timeout
BASH_DEFAULT_TIMEOUT_MS=10000
# Disabilitare traffico non essenziale
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
# Disabilitare avvisi di costo, altrimenti verrà generato un avviso ogni 5 dollari spesi in base alle tariffe di Claude sonnet
DISABLE_COST_WARNINGS=1
# Disabilitare chiamate ai modelli non essenziali
DISABLE_NON_ESSENTIAL_MODEL_CALLS=1
# Disabilitare telemetry
DISABLE_TELEMETRY=1

claudecod-with-third-party-vendor-2025-09-17-22-22-43

Per maggiori configurazioni, fare riferimento a: https://docs.claude.com/en/docs/claude-code/settings#environment-variables

Suggerimenti per l’uso della Plan Mode

La Plan Mode di Claude Code è una funzione molto utile; fa sì che l’AI effettui maggiori riflessioni senza modificare direttamente i file. Questa modalità è particolarmente adatta all’uso combinato con il modello Reasoner di DeepSeek. In modalità plan puoi:

  • Ridurre le modifiche ai file non necessarie
  • Fornire processi di pensiero più dettagliati
  • Adatta a revisioni complesse del codice e decisioni di design

Rapido cambio tra fornitori terze parti

Alcuni hanno creato lo strumento Claude Code Router per integrare fornitori di modelli terze parti in Claude Code, mentre altri hanno creato commutatori di variabili d’ambiente, ma sconsiglio vivamente l’uso di queste operazioni aggiuntive. Tutto ciò di cui hai veramente bisogno è aprire le impostazioni di VS Code, cercare terminal.integrated.env e configurare i primi tre elementi configurabili.

vscode设置项

Così:

claudecod-with-third-party-vendor-2025-09-17-22-23-05

Quindi ogni volta che apri un nuovo terminale all’interno di VS Code, verranno utilizzate le nuove variabili d’ambiente. Non è necessario usare strumenti terze parti aggiuntivi, configura semplicemente il tuo VS Code.

Perché non consigliare l’uso di strumenti di conversione API

Molti utenti, per usare comodamente Claude Code, tentano di usare Claude Code Router o scrivere script di conversione, ma questi metodi spesso derivano da una scarsa familiarità con VS Code e le interfacce API.

Consiglio: scegli fornitori che supportano nativamente ufficialmente l’API Anthropic, invece di spendere tempo per convertire le API. I motivi sono i seguenti:

  • La conversione dell’API Anthropic è complessa e difficile da adattare perfettamente
  • I fornitori con supporto ufficiale offrono servizi più stabili
  • Evita problemi di compatibilità e tempi di debug non necessari

Esiste un enorme divario tra le normali API e l’API Anthropic. Questa è la tabella di compatibilità della conversione ufficiale da DeepSeek all’API Anthropic: DeepSeek-anthropic_api#anthropic-api-兼容性细节

Considerando che anche la conversione ufficiale ha così tante incompatibilità, a maggior ragione non pensare a farla da soli; consiglio di non sprecare tempo su queste cose.

Fornitori terze parti nazionali che supportano Claude Code

Attualmente, tra i fornitori nazionali che conoscono e che supportano nativamente l’API Anthropic, ci sono:

  • DeepSeek - Prestazioni complessive eccellenti
  • Z-AI - Fornisce buon supporto API
  • Moonshot - Grande numero di parametri
  • ModelScope - Solo GLM-4.5 può essere utilizzato fluidamente

Nessuno di essi supporta perfettamente Claude Code e esistono vari problemi; ad esempio, DeepSeek non supporta il sub-agent, e nessuno dei quattro supporta immagini e documenti. Se vuoi sperimentare la piena potenza di Claude Code, la soglia minima di accesso è il piano Max da 100 dollari, non il piano Pro da 20 dollari, perché con Pro non è possibile usare il modello Opus.

DeepSeek

"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-reasoner",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat",
"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-reasoner",

Z-AI

"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
"CLAUDE_CODE_SUBAGENT_MODEL": "glm-4.5",

Moonshot

"ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_MODEL": "kimi-k2-turbo-preview",

ModelScope

"ANTHROPIC_BASE_URL": "https://api-inference.modelscope.cn",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-ai/DeepSeek-R1-0528",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "ZhipuAI/GLM-4.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "Qwen/Qwen3-Coder-480B-A35B-Instruct",
"CLAUDE_CODE_SUBAGENT_MODEL": "ZhipuAI/GLM-4.5",

Conclusione

Ogni volta che pubblico documenti relativi all’AI, qualcuno incolla pubblicità spam sotto l’articolo. Qui avverto seriamente tutti: non usare mai alcun API di inoltro, esistono enormi rischi per la sicurezza.

Per problemi specifici di sicurezza, fare riferimento a: Analisi dei rischi di sicurezza del router di modelli