Cos'e un harness? Claude Code vs Codex vs Pi vs OpenCode

Panoramica

Il modello e il motore. L'harness e l'auto attorno: lo sterzo, i pedali e gli strumenti che fanno davvero portare il motore da qualche parte. Un harness da al modello la capacita di leggere e scrivere file, di eseguire comandi di terminale, di vedere i risultati e di ciclare finche il job e fatto. Questa lezione definisce l'harness e confronta i quattro da conoscere nel 2026, perche tu smetta di confondere il modello con lo strumento che lo circonda.

Cosa imparerai

Imparerai cosa fa un harness, perche lo stesso modello si comporta molto diversamente a seconda degli harness, e come Claude Code, Codex, Pi e OpenCode si confrontano per filosofia, controllo e integrazione. Riparti con una regola di decisione, incluso il caso non ovvio in cui l'harness minuscolo Pi batte il potente Claude Code.

Prerequisiti

Le due lezioni precedenti. Devi essere a tuo agio con il fatto che un modello si limita a predire token e che la disciplina di contesto conta, perche un harness e in gran parte una macchina che nutre il modello del contesto giusto e reagisce al suo output.

Il problema

Le persone dicono "Claude e migliore di GPT" o "Codex non sa fare X", ma in realta parlano dell'harness, non del modello. Lo stesso modello Claude sembra brillante in uno strumento e goffo in un altro, perche l'harness decide quali file vede, quali comandi ha il diritto di eseguire e come cicla. Se non separi il modello e l'harness nella tua testa, trai conclusioni sbagliate e scegli lo strumento sbagliato.

Cosa fa realmente un harness

Un harness e il programma che si interpone tra te e il modello e da mani al modello. A ogni passo, raccoglie il contesto (la tua istruzione piu i file pertinenti e gli output dei comandi), lo invia al modello, rilegge l'azione proposta, esegue quell'azione nel tuo ambiente e rimanda il risultato perche il modello decida il passo successivo. Questo ciclo - contesto, modello, azione, risultato, ricomincia - e tutto il gioco. Tutto cio che rende un harness migliore di un altro e una variazione della qualita con cui gestisce questo ciclo.

• Legge e modifica i file del tuo progetto.
• Esegue comandi di terminale e ne legge l'output (test, build, Git).
• Gestisce il context window: decide cosa metterci e quando comprimere.
• Gira in autonomia in ciclo finche il compito e finito o ha bisogno di te.

Claude Code

Claude Code e l'harness da riga di comando ufficiale di Anthropic, costruito attorno ai modelli Claude. E il peso massimo: integrazione profonda del progetto, un sistema di permessi ricco, il supporto di regole di progetto in un file CLAUDE.md, skill riutilizzabili, hook e sub-agent. E lo strumento con cui questo corso e costruito e mantenuto. Se vuoi un agente che vive in un vero repository, fa girare i tuoi test, rispetta le tue convenzioni e abbatte un lavoro in piu passi, Claude Code e la raccomandazione predefinita. L'inghippo e che e opinionato e abbastanza potente da sembrare pesante su minuscoli job singoli.

Codex

Codex e l'agente di coding da riga di comando di OpenAI, che avvolge i modelli GPT. E pragmatico e forte nel leggere codice sconosciuto, spiegarlo e fare modifiche mirate e ben delimitate. Se vivi nell'ecosistema OpenAI o vuoi un secondo parere di un modello della famiglia GPT su una modifica delicata, Codex e una presa naturale. Trattalo come un collega capace di Claude Code piuttosto che un rivale da temere: molti builder seri hanno entrambi installati e scelgono secondo il compito.

Pi e OpenCode

Pi e il minimalista. E un harness volutamente minuscolo, trasparente, estensibile: vedi esattamente cosa fa, e lo pieghi al tuo workflow invece del contrario. OpenCode e un harness open source nello stesso spirito, agnostico al modello e portato dalla comunita, spesso usato con modelli instradati tramite OpenRouter. Entrambi scambiano la guida a mano contro il controllo e la trasparenza. La verita sorprendente e che per certi job - un compito rapido scriptato, un ciclo su misura, un setup in cui vuoi piena visibilita e zero magia - l'harness minimale batte il peso massimo, perche c'e meno roba tra te e il modello e niente e nascosto.

• Pi: minimale, trasparente, altamente estensibile. Possiedi il comportamento.
• OpenCode: open source, agnostico al modello, si accorda bene con OpenRouter.
• Quando il minimale vince: compiti scriptati o ripetibili, setup a piena visibilita, cicli su misura, o quando un harness pesante lotta contro il tuo workflow.

Passo passo: una regola di decisione

Non devi torturarti. Fai passare il tuo compito per questa regola e scegli in pochi secondi. L'obiettivo e smettere di trattare la scelta come una questione di fedelta e trattarla come una questione di adeguatezza.

• Lavoro profondo in un vero repo con test, convenzioni e modifiche multi-passo: Claude Code.
• Leggere o spiegare codice sconosciuto, o un secondo parere di GPT: Codex.
• Un ciclo scriptato, ripetibile o totalmente trasparente su misura: Pi.
• Un setup open source, agnostico al modello, instradato tramite OpenRouter: OpenCode.
• Incerto: comincia con Claude Code, perche il resto di questo corso lo suppone.

Errori frequenti

Il grosso errore e rimproverare al modello cio che dipende dall'harness. Il secondo e il tribalismo di strumento - insistere sul fatto che un harness sia universalmente il migliore quando la risposta onesta e "dipende dal compito". Il terzo e afferrare lo strumento piu pesante per job banali, dove un harness minuscolo o persino una semplice chat sarebbe piu veloce. Tieni due harness installati e lascia decidere al compito.

ROI business

Scegliere il giusto harness significa scegliere quanto del lavoro del tuo team puoi delegare serenamente a un agente. Un harness pesante con buone regole di progetto ti permette di cedere veri compiti di engineering dall'inizio alla fine, ed e li che i guadagni di tempo si accumulano. Un harness minimale ti permette di costruire automazioni economiche, trasparenti e ripetibili. Conoscere entrambi fa si che non paghi mai troppa complessita per un job semplice ne sotto-armi mai un job difficile.

Checklist

Assicurati di saper fare quanto segue prima di andare avanti, perche la prossima lezione diventa pratica con l'installazione.

• Spiegare la differenza tra un modello e un harness in una frase.
• Descrivere il ciclo contesto-modello-azione-risultato.
• Attribuire un compito a Claude Code, Codex, Pi o OpenCode.
• Citare un esempio in cui un harness minimale batte Claude Code.

Risorse

Non hai ancora niente da installare - la prossima lezione percorre l'installazione passo passo. Per ora, tieni solo il modello mentale: il modello e il motore, l'harness e l'auto. La pagina dei fondamenti sul terminale aiuta se la riga di comando ti sembra ancora estranea.

La tua missione

Scrivi il solo compito che ti piacerebbe di piu vedere abbattere da un agente questa settimana, poi applica la regola di decisione e nomina l'harness che useresti. Lo installerai alla prossima lezione, quindi scegli qualcosa di reale.

Prossima lezione

Il momento di smettere di leggere e cominciare a installare. La prossima lezione mette in marcia Claude Code e Codex sulla tua macchina, spiega i piani di subscription e difende l'idea che il piano da 200 dollari al mese sia in realta economico per un builder serio.