Claude Code passa a DeepSeek gratuito: configura ora e lancia il 24 novembre

Il Black Friday 2026 di HiAPI inizia il 24 novembre alle 16:00 (ora di Pechino) e termina il 1° dicembre alle 15:59: gli account che hanno effettuato una ricarica ricevono ogni giorno 10 milioni di token DeepSeek V4.1 Flash gratis. Imposta 5 variabili d'ambiente e Claude Code funzionerà su questo modello gratuito. Puoi configurarlo già adesso e verificarlo in anticipo: alle 16:00 del 24 novembre parte subito. Trovi anche le configurazioni per Python e curl qui sotto.

C'è solo una cosa da fare correttamente: le richieste gratuite devono includere l'header della promozione. Senza di esso vengono fatturate a prezzo pieno ($0,44 per milione di token in input, $1,32 in output).

Cosa serve: una Key e un header

export HIAPI_API_KEY="sk-your-key"

Claude Code

Punta Claude Code su HiAPI, imposta sia il modello principale che il modello piccolo in background su DeepSeek e aggiungi l'header:

export ANTHROPIC_BASE_URL="https://api.hiapi.ai"
export ANTHROPIC_AUTH_TOKEN="$HIAPI_API_KEY"
export ANTHROPIC_MODEL="deepseek-v4.1-flash"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4.1-flash"
export ANTHROPIC_CUSTOM_HEADERS="X-HiAPI-Promotion: deepseek-v41-flash-bf2026"
claude

ANTHROPIC_DEFAULT_HAIKU_MODEL va impostata: Claude Code usa il modello piccolo per attività in background come titoli e riassunti, e anche queste chiamate dovrebbero passare al modello gratuito. Si consiglia di impostare queste variabili in una finestra di terminale separata (o in uno script), così da non influire sulla tua configurazione abituale di Claude Code. Per la guida completa al collegamento di HiAPI a Claude Code, vedi la guida a Claude Code.

Python (SDK OpenAI)

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["HIAPI_API_KEY"],
    base_url="https://api.hiapi.ai/v1",
    default_headers={"X-HiAPI-Promotion": "deepseek-v41-flash-bf2026"},
)

resp = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "写一个保持顺序的列表去重 Python 函数"}],
)
print(resp.choices[0].message.content)

default_headers aggiunge l'header a ogni richiesta inviata da questo client, senza modificare il resto del codice.

curl

curl https://api.hiapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-HiAPI-Promotion: deepseek-v41-flash-bf2026" \
  -d '{"model":"deepseek-v4.1-flash","messages":[{"role":"user","content":"解释这个正则：^(?=.*\\d).{8,}$"}]}'

Verifica già adesso: prima della promozione restituisce 403, senza addebiti

Se invii la richiesta sopra prima delle 16:00 del 24 novembre, riceverai un 403 con codice di errore promotion_not_active, e questa chiamata non verrà addebitata. Se lo vedi, significa che l'header è arrivato a HiAPI e la configurazione è corretta: non resta che attendere l'inizio dell'evento. Se invece ricevi una risposta normale, l'header non è stato inviato, la richiesta è stata fatturata a prezzo pieno: controlla l'ortografia e verifica che lo strumento che usi invii davvero gli header personalizzati.

Dopo l'inizio della promozione, invia la prima richiesta e controlla la cronologia utilizzo nella console HiAPI: questa richiesta DeepSeek dovrebbe mostrare $0.

Anche altri strumenti possono essere usati così, purché supportino un Base URL compatibile OpenAI personalizzato, il nome del modello e header HTTP personalizzati; se non riescono a inviare header personalizzati, le richieste vengono fatturate a prezzo pieno.

Limitazioni

• L'account deve aver effettuato almeno una ricarica riuscita (importo libero). Se non hai mai ricaricato, basta una piccola ricarica prima del 24.
• 10 milioni di token al giorno per account, con reset a mezzanotte ora del Pacifico (16:00 ora di Pechino); dal 24 novembre alle 16:00 al 1° dicembre alle 15:59 (ora di Pechino).
• Solo deepseek-v4.1-flash è gratuito; altri modelli come DeepSeek V4 Pro vengono fatturati normalmente.
• I token gratuiti non costano nulla, quindi non concorrono al cashback sulla spesa.
• Gli account aziendali non partecipano.

Cosa farci girare dal 24

• Far smaltire il backlog agli Agent: test mai scritti, refactoring rimandati da tempo, documentazione di un modulo. Un agent di programmazione consuma circa 200.000 token per un ciclo su un repository di medie dimensioni: 10 milioni al giorno bastano per decine di cicli.
• Valutare con dati reali: sostituisci V4.1 Flash nella pipeline esistente e confronta gli output su qualche migliaio di input reali, senza costi per tutta la settimana della promozione.
• Lettura a contesto lungo: con una finestra di 1 milione di token puoi inserire in una volta interi codebase o pile di contratti.

Nella stessa settimana devi anche generare immagini e video? Le ricariche ricevono fino al 10% in più e la spesa per immagini/video/audio dà fino al 20% di cashback: i calcoli sono qui.

Torna alla pagina dell'evento Black Friday →