Vai al contenuto
Archivio
Di Harness the Agents

DeepSeek Harness non è un ammazza-Claude Code. È qualcosa di più interessante.

L'agent harness open source di DeepSeek ha superato le 168,000 stelle su GitHub nella prima settimana. L'ho installato, ho letto il repository e l'ho fatto girare io stesso. Ecco che cosa regge alla prova.

The DeepSeek Harness wordmark beside the DeepSeek whale logo, in blue on a white background with faint circuit-board traces.

DeepSeek Harness non è un ammazza-Claude Code. È qualcosa di più interessante.

Il README promette un'installazione con una sola riga. Scrivi npx @deepseek-ai/dsh web e sei dentro. Sulla mia macchina, quell'unica riga ha impiegato sedici minuti, ha tirato dentro centinaia di pacchetti nella cache di npx e ha richiesto altri dieci minuti per risolvere di nuovo le dipendenze alla seconda esecuzione. Non ne faccio una colpa a DeepSeek. Lo dico perché il divario tra la promessa da una riga e la realtà da sedici minuti è l'intera storia di DeepSeek Harness in miniatura. Quello che è stato rilasciato il 13 agosto è genuinamente interessante, genuinamente grezzo e ampiamente frainteso.

Il fraintendimento funziona così: DeepSeek ha costruito un concorrente di Claude Code. È la chiave di lettura a cui è ricorsa la maggior parte della copertura del lancio, e capisco perché. Gli somiglia, si muove come lui, e alcune parti sono state letteralmente scritte da lui. Ma è la chiave sbagliata, e dopo una settimana passata a leggere il repository, a far girare il programma e a verificare le affermazioni fatte da altri, penso che la vera storia stia un livello più in alto.

Punti chiave

DeepSeek Harness (dsh) è un harness di coding agentico con licenza MIT, in developer preview, rilasciato il 13 agosto 2026. Ha superato le 168,000 stelle su GitHub e i 552,000 download su npm nella prima settimana.La sua affermazione "tutto è un plugin" è letteralmente vera. L'adattatore del modello, gli strumenti e lo stesso ciclo dell'agente sono tutti sostituibili, costruiti su un framework con quattro anni di storia in produzione al di fuori dell'AI.La fame di token è reale e corroborata, ma percentuali di hit della cache vicine al 99% ammorbidiscono il conto. Trattatelo come una preview per smanettoni, non come uno strumento per l'uso quotidiano.La mossa strategica conta più dello strumento: un laboratorio di modelli sta regalando il livello dell'harness, e questo è un colpo al modello di business dell'harness in abbonamento, non alla lista di funzionalità di Claude Code.

Una nota sul metodo prima di cominciare. Tutto quello che segue sul repository, sull'installazione e sull'esecuzione è di prima mano, di questa settimana. Quando mi affido ai test di altre persone, lo dico e le nomino.

Che cosa ha rilasciato davvero DeepSeek?

Al 20 agosto 2026, il repository ha una settimana di vita, è a quota 168,325 stelle, e il pacchetto npm è stato scaricato 552,210 volte nella settimana del 12-18 agosto. Sono numeri grandi per una developer preview la cui stessa documentazione avverte che la compatibilità si romperà senza preavviso. Quello che quei numeri hanno comprato è un agent harness locale: esegui dsh web, si apre un'interfaccia nel browser sulla porta 3080, la punti su un workspace, scegli un modello e una modalità, e lo lasci lavorare.

Il dettaglio che trovo più rivelatore è cosa c'è dentro. Non è un sottile involucro attorno a un'API. Il checkout che ho compilato dai sorgenti ha 226 pacchetti nel workspace, un sistema di permessi con modalità sandbox che vanno da read-only a danger-full-access, e quattro preset di agente. Standard è l'agente di coding completo, PTC fa scrivere al modello un unico programma e lo esegue, Minimal include due strumenti, e la modalità Creator, auto-estendibile, porta in testa un commento che ti dice di trattarla come un accesso alla shell.

La cosa più notevole di tutte: pacchetti plugin ufficiali permettono all'harness di chiamare Claude Code e Codex come sub-agent. L'harness di DeepSeek delegherà volentieri un sotto-task ai suoi presunti rivali. E ogni sessione viene scritta in un log append-only che registra il system prompt completo, ogni chiamata agli strumenti e ogni conteggio di token. La mia esecuzione di prova ha prodotto 250 eventi per un task da dieci passi, tutto ispezionabile dopo.

Un avvertimento pratico. Esiste un progetto di terze parti non correlato chiamato anch'esso deepseek-harness, un adattatore di protocollo rilasciato a maggio. Se andate a cercare, quello giusto è l'organizzazione deepseek-ai. L'altro non è malevolo, ha solo un nome che confonde.

DeepSeek Harness è un harness di coding agentico con licenza MIT, rilasciato in developer preview il 13 agosto 2026. Il repository GitHub ha superato le 168,000 stelle in una settimana, e lo strumento può orchestrare Claude Code e Codex come sub-agent invece di limitarsi a competere con loro.

Il framework arriva da un ecosistema di chatbot

Ecco la parte che quasi nessuna copertura in lingua inglese ha colto. DeepSeek non ha costruito da zero l'architettura a plugin dell'harness. È costruita su Cordis, un framework di plugin TypeScript con licenza MIT che è in produzione dal 2022 sotto Koishi, un framework per chatbot con migliaia di plugin della community. Il creatore di Cordis, Yifan Shi, è il primo autore del paper che DeepSeek ha pubblicato insieme al rilascio, con un'affiliazione alla Peking University sulla firma. Il paper è un preprint self-hosted, 88 pagine, onestamente etichettato come bozza. Il repository di Cordis stesso era a 6,465 stelle quando ho controllato il 20 agosto.

L'idea che formalizza ha un nome che incute soggezione, componibilità spaziotemporale, e un significato semplice. Temporale: qualsiasi parte del sistema può essere scaricata a runtime, e tutto quello che ha fatto viene annullato in modo pulito. Spaziale: le parti dichiarano da cosa dipendono e si attivano o si spengono man mano che quelle dipendenze arrivano e se ne vanno. Il paper dimostra che l'ordine con cui carichi e scarichi le cose non conta; il sistema converge comunque allo stesso stato. Se vi suona come un problema già risolto, non lo è. La statistica che motiva il paper è che 87 delle 100 estensioni di VSCode più popolari non possono essere scaricate senza riavviare l'editor.

Volevo capire se "tutto è un plugin" fosse marketing o meccanismo, così ho esportato la configurazione risolta. È meccanismo. Il profilo web predefinito compone 135 righe di plugin attraverso 24 livelli di patch YAML, ciascuno annotato con il pacchetto che lo ha contribuito. L'adattatore del modello, il registro degli strumenti, il log di sessione, il ciclo dell'agente: tutti plugin, tutti reversibili. Il repository inoltre impone in CI una copertura dei test del 100% per ogni file sorgente, un'asticella quasi comicamente severa per una preview di una settimana.

DeepSeek Harness gira su Cordis, un framework di plugin in produzione dal 2022 nell'ecosistema del chatbot Koishi, formalizzato in un preprint di 88 pagine della Peking University e di DeepSeek. La sua garanzia fondamentale: qualsiasi componente può essere caricato o scaricato a runtime e il sistema converge allo stesso stato indipendentemente dall'ordine.

È stato costruito con gli strumenti dei rivali

Ora la parte imbarazzante e divertente. Un'analisi di code forensics (winzheng.com, una fonte unica, anche se dichiara che i suoi script sono riproducibili) ha percorso la storia dei commit e ha scoperto che 1,760 dei primi 12,293 commit portano il prefisso di branch codex/, che l'undicesimo commit si intitola "fix issues found in the second round of Codex review", e che un symlink CLAUDE.md puntante ad AGENTS.md esisteva fin dal primissimo commit. In parole semplici: il team di DeepSeek ha costruito l'harness facendo un uso massiccio di Codex di OpenAI e Claude Code di Anthropic nel ciclo di sviluppo.

Io lo archivierei alla voce delizioso, non scandaloso. Ogni team di ingegneria serio che conosco ormai costruisce con questi strumenti, e DeepSeek evidentemente fa lo stesso. Lo stesso rapporto ha verificato anche la voce più piccante, quella secondo cui l'harness sarebbe stato copiato dal codice sorgente trapelato di Claude Code, e non ha trovato alcuna sovrapposizione di stringhe. Vale la pena dirlo, perché quella voce ha fatto il giro. Quello che la forensics mostra davvero è più interessante della voce: la convinzione del laboratorio che il modello sia la commodity e che il prodotto sia il ciclo che lo circonda si estende al modo in cui costruisce il proprio software.

Un'ultima nota di onestà. L'harness è chinese-first in punti che la copertura in inglese non ha menzionato. I file di metadati dei preset sono scritti prima in cinese, e alcune stringhe dell'interfaccia distribuite sono solo in cinese. Se volete un segno piccolo e concreto di chi secondo DeepSeek saranno i suoi primi adottanti, è questo.

L'ho fatto girare io stesso

Leggere di un harness ti porta solo fino a un certo punto, così ho eseguito un task reale. Invece di una chiave API di DeepSeek, ho usato una chiave in abbonamento di OpenCode Go, che instrada attraverso un catalogo di sedici modelli di sette o più laboratori. Quella scelta è stata casuale e si è rivelata la parte più istruttiva dell'intero test: ho fatto girare l'harness di DeepSeek sul modello V4 Flash di DeepSeek senza avvicinarmi affatto all'API ufficiale di DeepSeek. La sostituzione del provider che l'architettura promette non è teorica. È un file YAML e una variabile d'ambiente.

Il task: costruire un sito a pagina singola che mostri orologi in tempo reale per Hangzhou, Londra e New York, e poi verificarlo. L'esecuzione ha impiegato 2 minuti e 8 secondi, 10 passi e 9 chiamate agli strumenti, bruciando circa 108,000 token con il 91% dell'input servito dalla cache. L'agente ha sondato l'ambiente, scritto la pagina, estratto il proprio JavaScript e ne ha controllato la sintassi con node, ha beccato un bug di arrotondamento nel proprio script di verifica, lo ha corretto e ha rieseguito il controllo. Ho poi verificato l'output in modo indipendente: la matematica dei fusi orari era giusta, incluso il fatto che Londra è attualmente in British Summer Time e New York in EDT. Task piccolo, risultato corretto, log completo.

Anche gli spigoli sono reali. Lanciare da un checkout dei sorgenti è delicato rispetto alla working directory in modi che la documentazione non menziona. La modalità headless non stampa alcun riepilogo dei token; ho calcolato i numeri a mano dal log di sessione. E il system prompt diceva al modello di essere deepseek-v4-flash perché così si chiamava la mia rotta configurata, il che va bene finché qualcuno non instrada un modello diverso e l'agente sviluppa una falsa idea della propria identità. Roba da livello preview, tutta quanta.

In un test di prima mano del 20 agosto 2026, DeepSeek Harness ha completato una build verificata di una pagina singola in 2 minuti e 8 secondi su 10 passi, usando circa 108,000 token con una percentuale di letture da cache del 91%, attraverso una chiave di modello OpenCode Go di terze parti invece dell'API ufficiale di DeepSeek.

Il conto onesto

La critica più forte all'harness è che brucia token, e la critica regge. L'AI Success Lab di Julian Goldie lo ha cronometrato contro Claude Code sullo stesso sito di una pagina nella settimana del lancio: lo stack DeepSeek ha usato circa 483,000 token contro i 48,000 di Claude Code, anche se ha finito in 11 minuti contro gli oltre 30 di Claude Code e con un costo di circa cinque centesimi. Il confronto di un utente Reddit su task di code review ha trovato la stessa forma, e il suo follow-up ammette di non aver affatto ottimizzato la configurazione di dsh.

Test

Token

Tempo

Note

Sito di una pagina, dsh + V4 Pro (AI Success Lab)

~483,000

11 min

~$0.05, uso intenso della cache

Sito di una pagina, Claude Code (stesso task)

~48,000

30+ min

Punteggio qualità più alto, 9/10 contro 7/10

Code review, dsh non ottimizzato (Reddit)

500,000

n/a

Percentuale di hit della cache del 70%

Code review, OpenCode (stessi task)

~70,000

n/a

Percentuale di hit della cache del 95%

Build degli orologi, mia esecuzione (20 agosto)

~108,000

2 min 8 s

91% letture da cache, output verificato

Ciò che salva l'economia è la cache. I tester di QbitAI, un media cinese con due settimane di accesso alla beta chiusa, hanno misurato percentuali di hit della cache intorno al 99%, e la mia esecuzione si è attestata al 91%. L'input in cache è quasi gratis, quindi i conteggi di token che fanno paura si traducono in conti piccoli.

L'affidabilità è il ventre più molle. AtlasCloud ha rieseguito la build dell'ISS-tracker della copertura del lancio per tre volte (premessa: un blog di un vendor, eseguito contro il proprio endpoint hosted), e in due delle tre esecuzioni l'harness ha stampato "Done" mentre la pagina nel browser era in realtà rotta. Il mio task degli orologi si è verificato senza problemi, ma il mio task degli orologi era anche banale. Trattate le demo come demo.

DeepSeek Harness ha fame di token ma fa un uso intenso della cache: test indipendenti dell'agosto 2026 mostrano un consumo di token circa dieci volte quello di Claude Code su task identici, compensato da percentuali di hit della cache vicine al 99% e dai prezzi ufficiali di DeepSeek da $0.007 a $0.014 per milione di token di input in cache.

Quanto costa DeepSeek Harness?

I prezzi hanno bisogno di una data, perché gran parte della copertura della settimana del lancio è già sbagliata. Il 16 agosto DeepSeek ha portato la sua API a una tariffazione di punta e fuori punta. Al 20 agosto, la pagina ufficiale dei prezzi elenca V4 Flash da $0.22 a $0.44 per milione di token di input a seconda dell'ora, da $0.66 a $1.32 per milione in output, con hit della cache da $0.007 a $0.014. Pro costa il triplo. Se una recensione vi cita prezzi fissi da $0.14, sta citando giugno. La versione lunga del perché questi numeri restano bassi è in come funziona la guerra dei prezzi dell'AI cinese.

Tra i due modelli, il consenso iniziale coincide con il mio istinto: Flash per il lavoro di tutti i giorni, Pro quando il problema è davvero difficile. Se li state soppesando contro il resto del campo, tengo un confronto aggiornato in Qwen vs DeepSeek vs Llama.

DeepSeek Harness è sicuro da eseguire?

Dichiariamo prima l'assunzione di deployment, come sempre. L'harness gira in locale e la rotta del modello la scegliete voi, quindi la questione della residenza dei dati riguarda a quale provider lo puntate, non l'harness in sé; il mio test ha inviato i prompt ai server di OpenCode Go, non a quelli di DeepSeek. Restano due cautele reali. Le note del repository descrivono una telemetria disabilitata di default ma che, se abilitata, viene distribuita senza regole di redazione. E i plugin vengono eseguiti in-process con i vostri permessi, quindi l'ecosistema dei plugin è una questione di supply chain, la stessa forma di domanda di se DeepSeek sia sicuro per le aziende in primo luogo. Nessuno ha ancora fatto un audit di sicurezza indipendente.

Cosa significa la mossa

La pagina prodotto di DeepSeek per il rilascio dichiara la tesi in quattro parole: Agent equals Model plus Harness. Il modello predice i token; l'harness decide quali strumenti riceve, quando si ferma e cosa ricorda. La copertura del lancio di VentureBeat ha avuto l'inquadratura più acuta: una volta che i modelli di frontiera convergono nelle capacità, il livello che controlla come un agente ragiona e persiste attraverso un flusso di lavoro diventa molto più difficile da sostituire del modello stesso. Il che solleva la domanda sul perché un laboratorio dovrebbe regalare quel livello con licenza MIT.

Perché regalare la cosa costosa è quello che DeepSeek fa. Lo ha fatto al livello del modello con i pesi aperti, e la guida all'ecosistema open-weight cinese è la versione lunga di quella storia. L'harness è lo stesso cuneo spinto un livello più in alto, e il commento di 36Kr citato da un revisore del codice sorgente ha detto chiaramente la parte non detta: questo non è un colpo alla lista di funzionalità di Claude Code, è un colpo all'harness come prodotto a pagamento. Se la scommessa ripagherà dipende da qualcosa che DeepSeek non può controllare, cioè se degli sconosciuti costruiranno davvero dei plugin. È quel numero che terrei d'occhio, non le stelle.

Quindi dovreste provarlo? Se vi piace smanettare, sì. L'installazione è pesante ma la build dai sorgenti è pulita, e c'è un vero piacere nel leggere un codebase così disciplinato. Se fate self-hosting dei modelli o vi importa dei costi su larga scala, sì, con la configurazione del provider come senso dell'esercizio. Se vi serve uno strumento quotidiano stabile, no. Il repository promette per iscritto breaking changes, e fa sul serio.

DeepSeek Harness è un rilascio strategico, non solo uno strumento: licenziando il livello dell'harness con MIT e dichiarando "Agent = Model + Harness", DeepSeek sostiene che l'harness dovrebbe essere una commodity, lo stesso cuneo che in precedenza ha spinto attraverso il livello del modello con i pesi aperti.

Domande frequenti

DeepSeek Harness è sicuro da eseguire con accesso alla shell?

L'harness gira in locale, quindi la domanda si divide in due. I vostri prompt vanno a qualsiasi provider di modelli configuriate, e la sandbox integrata parte da sola lettura con modalità di scrittura nel workspace e accesso completo sopra di essa. Il rischio più affilato sono i plugin: girano in-process con i vostri permessi, e l'ecosistema dei plugin, vecchio di una settimana, non ha ancora alcun audit indipendente.

DeepSeek Harness può davvero chiamare Claude Code e Codex?

Sì, ed è confermato nel repository, non solo affermato nella copertura. Pacchetti plugin opzionali chiamati subagent-claude-code e subagent-codex pilotano l'ufficiale Claude Agent SDK e l'app-server di Codex. Vi servono comunque quegli strumenti installati e autenticati; l'harness fornisce l'orchestrazione, non gli abbonamenti.

Dovrei usare Flash o Pro con DeepSeek Harness?

Flash per la maggior parte del lavoro. I primi test indipendenti mostrano un uso di token circa dieci volte quello di Claude Code su task identici in entrambi i casi, quindi è sul modello più economico che i conti tornano. Al 20 agosto 2026, i prezzi ufficiali di DeepSeek mettono l'output di Flash a un terzo del prezzo di Pro. Riservate Pro ai problemi che richiedono davvero il ragionamento extra.

In sintesi

DeepSeek Harness è un pezzo di ingegneria grezzo, disciplinato e genuinamente nuovo che la maggior parte della copertura del lancio ha descritto come la cosa sbagliata. Non sta cercando di superare Claude Code al suo stesso gioco. È un laboratorio di modelli che dichiara che il livello sopra il modello dovrebbe essere libero, e che costruisce quella dichiarazione con le parti di un framework per chatbot di quattro anni fa e con gli stessi strumenti di coding dei suoi rivali. Se quella dichiarazione attecchirà dipende dagli autori dei plugin, e ci vorranno mesi per giudicarli. Nel frattempo è l'installazione da sedici minuti più istruttiva che abbia fatto quest'anno.

Se state valutando modelli cinesi o strumenti per agenti per qualcosa di serio, mettetevi in contatto.

Fonti (tutte consultate il 2026-08-20):