DeepSeek Harness: cosa è stato rilasciato e come installarlo

DeepSeek Harness (DSH) è l'harness per agenti di coding destinato a V4-Pro e V4-Flash. È stato pubblicato su npm come @deepseek-ai/dsh il 13 agosto 2026, nello stesso giorno in cui V4-Pro è diventato generalmente disponibile. Richiede quattro semplici passaggi, usa una normale chiave API DeepSeek e arriva con un sistema di plugin. Attenzione però a un dettaglio importante: su PyPI esiste da maggio un pacchetto Python del tutto indipendente chiamato deepseek-harness, che espone anch'esso il comando dsh. Non sono lo stesso strumento.

Che cos'è DeepSeek Harness (DSH)

Un harness per coding agent gestisce, attorno al modello, la selezione del contesto, gli errori degli strumenti, la ripianificazione e il rilevamento del completamento. Anche a parità di modello, la configurazione dell'harness può cambiare i risultati dei benchmark. È per questo che DeepSeek pubblica le impostazioni dell'harness insieme alle valutazioni agentiche, invece di limitarsi ai numeri grezzi del modello.

Gli esempi più noti aiutano a inquadrare il concetto: Claude Code è un harness per i modelli Claude di Anthropic; Cursor integra più provider in un IDE; GitHub Copilot funge da harness per modelli OpenAI dentro VS Code. Un agente nasce dall'unione di un modello e di un harness: un sistema capace di modificare file, eseguire comandi e chiamare API, non soltanto di rispondere a un singolo prompt. DSH svolge questo ruolo per V4-Pro e V4-Flash.

DSH è l'harness first-party di DeepSeek, progettato per V4-Pro e V4-Flash come Claude Code lo è per Sonnet e Opus. Il changelog della beta di V4-Flash del 31 luglio lo ha citato pubblicamente per la prima volta: i benchmark agentici erano stati eseguiti con "DeepSeek Harness minimal mode (to be released soon)", effort=max, top_p=0.95 e temperature=1.0.

La "minimal mode" è una configurazione ridotta all'essenziale, con sforzo di ragionamento massimo e parametri di sampling fissi. Lo scopo è rendere riproducibili i benchmark degli agenti, anziché ottimizzarli caso per caso. Il prodotto completo, incluso il sistema di plugin anticipato nei resoconti della beta, va oltre il runner di benchmark usato per generare i punteggi pubblicati.

Sia V4-Pro sia V4-Flash supportano una finestra di contesto da 1 milione di token e tre livelli di reasoning effort: low per le attività semplici, high per il lavoro agentico ordinario e max per i compiti complessi (changelog ufficiale, voce del 13 agosto).

Come installare @deepseek-ai/dsh

Serve Node.js 18 o successivo, lo stesso requisito indicato nella guida ufficiale all'integrazione con Claude Code di DeepSeek.

1. Verifica Node: node --version (è richiesto 18+; su macOS, se manca, usa brew install node).
2. Installa globalmente: npm install -g @deepseek-ai/dsh.
3. Imposta la chiave: export DEEPSEEK_API_KEY=<your key> dalla piattaforma DeepSeek.
4. Avvialo: cd /path/to/my-project && dsh.

Su macOS gli errori di permesso durante l'installazione globale con npm sono frequenti. La soluzione raccomandata da npm consiste nel configurare un prefisso globale scrivibile dall'utente (npm config set prefix ~/.npm-global); sudo funziona, ma può creare conflitti di proprietà nei futuri aggiornamenti dei pacchetti.

Non è stato annunciato un prezzo separato per il software dell'harness. Il costo del modello API sottostante cambia il 16 agosto alle 16:00 UTC: i prezzi della famiglia V4 passeranno a tariffe di picco e fuori picco, con la fascia fuori picco pari alla metà di quella di picco (changelog ufficiale).

I benchmark della GA di V4-Pro e il ruolo dell'harness

Questi sono i numeri ufficiali pubblicati da DeepSeek nella voce del changelog del 13 agosto, tutti ottenuti con la configurazione dell'harness descritta sopra:

V4-Pro supera Flash da 0.5 a 8.3 punti in questi benchmark; i divari maggiori sono su DeepSWE (+8.3) e NL2Repo (+7.3). Il dato di maggiore rilievo è 87.9 su Terminal Bench 2.1. Una riproduzione indipendente con harness pubblico su r/LocalLLaMA ha assegnato a Flash 0731 un punteggio di 82.7 in 445 prove, in linea con quanto dichiarato da DeepSeek entro i margini di variazione dovuti alla configurazione. DSBench-FullStack e DSBench-Hard sono set di valutazione interni: quelle due righe riportano quindi misurazioni di DeepSeek.

Tutti i benchmark pubblicati sono stati eseguiti con effort max. Per l'uso in produzione, DeepSeek raccomanda low per i task semplici, high per il normale lavoro agentico e max per quelli complessi.

@deepseek-ai/dsh e pip install deepseek-harness: non sono la stessa cosa

I due pacchetti hanno nomi quasi identici, ma sono usciti a mesi di distanza e non hanno alcuna relazione tra loro.

Il progetto su PyPI è una libreria adattatore di protocollo, non un coding agent. L'autore ha documentato 16 comportamenti dell'API V4 in oltre 270 prove e li ha codificati in un contratto di 10 regole distribuito in quattro formati: libreria Python, CLI dsh, server MCP e Anthropic Skill. I tre aspetti più insidiosi per chi costruisce su V4 sono:

• I loop di tool multi-turn restituiscono HTTP 400 se reasoning_content non viene mantenuto nei messaggi dell'assistente: risultato riprodotto 3/3 su entrambi i modelli.
• L'endpoint /beta rimappa silenziosamente v4-pro in deepseek-reasoner.
• I cache hit compaiono in blocchi da 256 token dopo un prefisso da 1,024 token; in un loop di cinque turni si è raggiunto un equilibrio del 95%, riducendo il costo effettivo dell'input di circa 50x.

La principale fonte di confusione è che entrambi i pacchetti forniscono un comando dsh. Se hai installato tramite pip, hai la libreria adattatore. Se hai usato npm nello scope @deepseek-ai, hai l'harness.

Usare DeepSeek V4 come coding agent senza DSH

Se vuoi usare un coding agent basato su DeepSeek prima che la documentazione di DSH si stabilizzi, la guida ufficiale alle integrazioni di DeepSeek copre tre percorsi supportati:

La configurazione di Claude Code associa i modelli DeepSeek agli slot di Claude Code:

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API key>
export ANTHROPIC_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

C'è una particolarità nella mappatura: le richieste per claude-sonnet vengono risolte su Flash, non su Pro. La documentazione DeepSeek instrada Pro nello slot Opus e Flash nello slot Haiku. Tutti e tre gli strumenti sono documentati come integrazioni di terze parti, per le quali DeepSeek non garantisce efficacia né sicurezza. Per un confronto più ampio, consulta il nostro confronto tra LLM per coding agent e la guida API alla GA di V4-Pro.

FAQ

@deepseek-ai/dsh è il DeepSeek Harness ufficiale?

Lo scope npm @deepseek-ai coincide con l'organizzazione GitHub di DeepSeek, e la data di rilascio coincide con la finestra promessa nel changelog del 31 luglio. I post della community confermano che l'installazione funziona. Il changelog di DeepSeek del 13 agosto documenta la GA di V4-Pro, ma non cita l'harness; inoltre npm impedisce la verifica automatizzata della pagina del pacchetto.

Che differenza c'è tra DSH e deepseek-harness su PyPI?

Sono prodotti diversi, mantenuti da soggetti diversi. @deepseek-ai/dsh è l'harness per coding agent pubblicato su npm il 13 agosto. pip install deepseek-harness installa invece una libreria Python indipendente di Henry Zhang (MIT, 9 maggio), che gestisce le particolarità dell'API V4. Entrambi forniscono un comando dsh.

Per usare DSH serve una chiave API DeepSeek?

Sì. L'harness usa V4-Pro e V4-Flash tramite la API DeepSeek, quindi l'utilizzo viene fatturato per token. Il pacchetto npm è gratuito da installare; il costo dipende dal consumo dell'API. I prezzi della famiglia V4 passano a tariffe di picco e fuori picco il 16 agosto alle 16:00 UTC, con la fascia fuori picco pari alla metà di quella di picco.

Come si confronta DSH con Claude Code?

Claude Code è un coding agent da terminale maturo e documentato, già utilizzabile con DeepSeek tramite l'endpoint compatibile con Anthropic. La proposta di DSH è un'ottimizzazione specifica per il modello: un harness costruito attorno al comportamento del protocollo V4, non semplicemente adattato ad esso. È un vantaggio plausibile, alla luce della trasparenza sulla configurazione dei benchmark, ma resta da dimostrare nell'uso indipendente finché documentazione e test della community di DSH non saranno più maturi.

Qual è la differenza tra un AI harness e un AI agent?

L'harness è lo strato infrastrutturale: gestione del contesto, instradamento degli strumenti e orchestrazione del task. L'agente è il sistema completo, cioè un modello in esecuzione dentro un harness e capace di azioni in più passaggi. Ogni agente necessita di un harness, ma lo stesso harness può servire modelli diversi. Claude Code, Cursor, Copilot e DSH sono tutti harness; diventano "agenti" grazie al modello che li alimenta.

Stato del rilascio: confermato e segnalato dalla community

I fatti riportati in questo articolo provengono da due livelli di evidenza.

Confermato ufficialmente (changelog API DeepSeek, voci datate):

• deepseek-v4-pro ha raggiunto la GA il 13 agosto con supporto nativo all'OpenAI Responses API e tre livelli di reasoning effort (changelog).
• V4-Flash è entrato in beta pubblica il 31 luglio, con benchmark prodotti usando "DeepSeek Harness minimal mode (to be released soon)."
• Tutti i numeri dei benchmark della GA di V4-Pro e della beta di V4-Flash provengono da queste voci del changelog.
• I prezzi della famiglia V4 passano a tariffe di picco e fuori picco il 16 agosto alle 16:00 UTC.
• La guida all'integrazione con Claude Code, OpenCode e OpenClaw è documentazione ufficiale.

Segnalato dalla community (post Reddit, screenshot riprodotti):

• @deepseek-ai/dsh è installabile e funzionante. u/Testx01 ha pubblicato il link al pacchetto alle 12:56 UTC del 13 agosto; u/Available_Yam_6267 è intervenuto pochi minuti dopo. Lo scope npm @deepseek-ai coincide con l'organizzazione GitHub di DeepSeek.
• La pagina del pacchetto npm blocca le richieste automatizzate, perciò versione, licenza e metadati del maintainer non sono confermati tramite il registry.

"Deepseek harness is out on npm :)" — u/Testx01, r/DeepSeek, 13 agosto

• Un messaggio interno della beta riprodotto descrive un gruppo beta di 369 membri che ha pubblicato una build interna finale l'11 agosto, invitando gli sviluppatori di plugin a taggare i repository con #dsh in vista della beta pubblica del 13 agosto. Dopo il lancio, i plugin sarebbero diventati trasferibili ai singoli account.
• Un resoconto della community ha citato stampa tecnologica cinese che a maggio riferiva della formazione, da parte di DeepSeek, di un team dedicato all'harness e del reclutamento per ruoli di prodotto Agent Harness.

Finché DeepSeek non pubblicherà documentazione formale sul proprio sito, considera le affermazioni su funzioni, CLI e plugin di DSH come confermate dalla community.