In breve: DeepSeek Harness è un assistente AI gratuito e open source, creato da DeepSeek, che lavora direttamente sul tuo computer: gli dai un compito, lui legge e modifica i file, lancia comandi e ti mostra ogni passaggio. Si usa dal browser, in locale, e funziona con DeepSeek ma anche con altri modelli. L'ho installato sul MacBook Air e l'ho provato: è utile e veloce, e con DeepSeek qualità, velocità e prezzo sono ottimi.
Cos'è DeepSeek Harness?
Un modello AI da solo sa scrivere e ragionare, ma non può aprire una cartella o far girare un programma. Un agent harness (letteralmente «imbracatura») è il programma che gli dà queste possibilità: gli permette di leggere e modificare file, eseguire comandi, controllare il risultato e riprovare se qualcosa va storto. Il modello è il cervello, l'harness sono le mani e gli occhi.
DeepSeek lo ha rilasciato il 13 agosto 2026, insieme al modello V4 Pro, come progetto open source con licenza MIT: puoi usarlo, leggerlo e modificarlo liberamente. Il codice è sul repository GitHub ufficiale, che a inizio ottobre supera le 240.000 stelle.
È ancora una developer preview: lo sviluppo va veloce e alcune cose cambiano da una versione all'altra. Al 4 ottobre 2026 l'ultima versione su npm è la 0.2.0-rc.2, pubblicata il 3 ottobre.
Cosa può fare?
Fa il lavoro di un assistente per programmare, che chiamiamo «agente» perché agisce da solo sul computer: legge e modifica file, esegue comandi, lancia test e, se qualcosa fallisce, prova a correggere. Ha una ricerca web integrata e può pianificare un lavoro in più passaggi e affidarne parti ad altri agenti. Nell'interfaccia c'è anche una vista a passaggi, la «trajectory», dove vedi nell'ordine tutto quello che l'agente ha fatto: comodo per capire come è arrivato a un risultato.
Cosa vuol dire che «tutto è un plugin»?
Un plugin è un pezzo che si aggiunge a un programma per dargli una funzione in più, e che puoi togliere o cambiare quando vuoi, come i mattoncini LEGO. DeepSeek Harness è costruito così: il programma di base è piccolo e ogni parte importante è un mattoncino separato.
I mattoncini sono, per esempio, il modello AI (il «cervello» che ragiona e scrive), gli strumenti che l'agente può usare (leggere un file, lanciare un comando), la memoria delle conversazioni e l'interfaccia che vedi a schermo. In molti altri agenti questi pezzi sono fissi. Qui puoi sostituirli: se un modello non ti convince, ne metti un altro senza cambiare nient'altro.
Un esempio concreto: l'agente può affidare un compito a un altro agente. Tra quelli disponibili ci sono Claude Code e Codex: Harness fa da regista e passa il pezzo di lavoro a un agente concorrente, usando le tue credenziali di quel servizio. (Per i più tecnici: il sistema di plugin su cui è costruito si chiama Cordis.)
Quali modalità offre?
| Modalità | A cosa serve |
|---|---|
| Standard | L'uso di tutti i giorni: modifica file, terminale, ricerca web, skill, pianificazione |
| Code | Per sviluppatori: si controlla l'agente scrivendo codice, con un solo strumento di base |
| Minimal | Solo terminale e modifica dei file, il minimo indispensabile; DeepSeek la usa per misurare le prestazioni dei modelli |
| Creator | Per sperimentare con i plugin e ispezionare come funziona |
Per cominciare ti basta la modalità Standard.
Come si installa DeepSeek Harness passo per passo?
Questa è la procedura che uso su Mac. Per Linux e Windows cambiano solo l'installazione di Node.js e il modo di impostare la variabile d'ambiente.
Scorciatoia: se usi già uno strumento come Claude Code, puoi farti installare tutto da lui. Gli dai l'indirizzo del progetto, https://github.com/deepseek-ai/deepseek-harness, e gli scrivi: «installa questo progetto sul mio computer e avvialo». Legge le istruzioni, lancia i comandi al posto tuo e ti chiede solo il permesso di eseguirli e la tua chiave API. Funziona allo stesso modo con Codex e con gli altri agenti simili. Se invece preferisci vedere ogni passaggio, segui la procedura qui sotto.
1. Controlla di avere Node.js 22.19 o superiore
Node.js è il programma che fa partire Harness: sul computer deve esserci. Per controllare apri il Terminale (è l'app dove si scrivono comandi: premi Cmd + Spazio, scrivi «Terminale» e premi Invio) e scrivi:
node -vSe compare un numero uguale o superiore a v22.19, vai al passo 2. Se il comando non esiste o la versione è più vecchia, installa Node.js dal sito nodejs.org (versione LTS) oppure, se usi Homebrew:
brew install nodeChiudi e riapri il Terminale e rilancia node -v per controllare.
2. Crea la tua chiave API di DeepSeek
La chiave API è come una password che autorizza Harness a usare il modello DeepSeek (e che collega l'uso al tuo account, dove paghi a consumo). Entra sulla piattaforma API di DeepSeek, accedi, crea una nuova chiave e copiala subito: non te la mostra più. Serve anche un po' di credito sull'account.
3. Salva la chiave come variabile d'ambiente
Una variabile d'ambiente è un valore che il computer ricorda e che i programmi possono leggere: così Harness trova la chiave da solo, senza che tu la riscriva ogni volta. Incolla questi due comandi nel Terminale:
echo 'export DEEPSEEK_API_KEY="la_tua_chiave"' >> ~/.zshrc
source ~/.zshrcSostituisci la_tua_chiave con quella vera. In alternativa puoi inserirla più tardi dall'interfaccia web, in Settings e poi Models.
4. Avvia DeepSeek Harness
Il modo più rapido non richiede nessuna installazione preliminare:
npx @deepseek-ai/dsh webAl primo avvio scarica il pacchetto e lo lancia. Se preferisci installarlo una volta per tutte, così da usare il comando dsh direttamente:
npm install -g @deepseek-ai/dsh
dsh webIl comando dsh web fa partire Harness sul tuo computer: il Terminale resta aperto e mostra i messaggi, mentre l'interfaccia la usi nel browser.
5. Apri l'interfaccia nel browser
Apri Safari o Chrome e vai all'indirizzo http://127.0.0.1:3080. Non è un sito su internet: è Harness che gira sul tuo computer e si vede solo da lì. Se compare la schermata di Harness, l'installazione è riuscita.
6. Crea il primo workspace e la prima sessione
Nell'interfaccia scegli o crea un workspace, cioè la cartella su cui l'agente lavorerà, poi apri una sessione e controlla il modello selezionato. Scrivi il compito in linguaggio normale, per esempio «leggi questo progetto e dimmi cosa fa», e guarda l'agente al lavoro. Parti da un compito piccolo: ti serve per capire come ragiona prima di dargli lavoro vero.
7. Riavvio e aggiornamenti
Per fermare il server premi Ctrl+C nel Terminale. La volta dopo ti basta rilanciare dsh web (o il comando npx). Se lo hai installato in globale, per aggiornarlo:
npm install -g @deepseek-ai/dsh@latestChi preferisce il codice sorgente può invece clonare il repository ufficiale e lanciare pnpm install, pnpm run build e pnpm dsh web: il passaggio di build è obbligatorio.
Si può usare con modelli diversi da DeepSeek?
Sì. Da Settings e poi Models puoi collegare OpenAI, Anthropic, Kimi, qualsiasi endpoint compatibile con OpenAI e anche modelli ospitati da te, e cambiare modello da una sessione all'altra senza riavviare. Per i costi reali di un agente con DeepSeek trovi i conti nell'articolo su DeepSeek con Hermes, OpenClaw e Nanobot, e i prezzi aggiornati sulla pagina ufficiale.
L'ho provato: com'è andata?
Bene. L'ho installato sul MacBook Air e mi è sembrato utile e soprattutto veloce: si avvia in un attimo dal browser e l'agente risponde senza far aspettare. Il merito è anche del modello: DeepSeek, usato come motore, mi dà un ottimo equilibrio tra qualità, velocità e prezzo, ed è il motivo per cui lo uso già con altri agenti, come racconto nell'articolo su DeepSeek con Hermes, OpenClaw e Nanobot.
Se lo provi, il mio consiglio è di fare lo stesso confronto che farei io: dai lo stesso compito a due modelli diversi dalla scheda Models e guarda quale risponde meglio e più in fretta.
Che differenza c'è con Claude Code e Codex?
La differenza principale è che Harness è aperto e non legato a un solo fornitore, mentre gli altri due sono prodotti proprietari legati ai modelli di Anthropic e OpenAI. In cambio è meno maturo.
| DeepSeek Harness | Claude Code | Codex | |
|---|---|---|---|
| Licenza | MIT, open source | Proprietaria | Proprietaria |
| Modelli | Qualsiasi, tramite plugin | Anthropic | OpenAI |
| Dove gira | In locale | Più superfici, anche servizi ospitati | Più superfici, anche servizi ospitati |
| Maturità | Developer preview | Stabile | Stabile |
Se vuoi capire gli altri due, ho scritto cos'è Claude Code, cos'è Codex e il confronto tra i due.
Per chi ha senso provarlo?
Per chi vuole un agente aperto e modificabile, con un registro leggibile di ogni passaggio e la libertà di scegliere il modello. È una buona strada anche per chi vuole delegare a Claude Code o Codex pagando modelli più economici per il resto del lavoro. Meno adatto se ti serve stabilità assoluta, se hai una consegna vicina o se preferisci un agente ospitato e già pronto, senza installare niente.
Conclusioni
DeepSeek Harness mette in mano a chiunque un agente completo e modificabile, con il modello che preferisci. L'ho provato e mi è piaciuto: è utile, veloce e con DeepSeek costa poco. Resta una developer preview che cambia in fretta, ma è un ottimo punto di partenza per capire come sono fatti questi strumenti. Se vuoi le basi, parti da cos'è un agent harness.
Fonti: repository ufficiale su GitHub, pacchetto npm @deepseek-ai/dsh, documentazione API DeepSeek.
Risorsa gratuita
Vuoi iniziare con l'AI?
Scarica la guida AI da Zero — PDF gratuito, pratico, senza tecnicismi.