Come gli sviluppatori hanno trasformato la CLI di Claude Code in un ambiente desktop grafico chiamato cc-haha

Se hai mai provato a eseguire agenti di codifica nella console, probabilmente ti sei imbattuto nello stesso problema. Il terminale è ottimo per impartire un singolo comando. Ma quando l'AI inizia a modificare una dozzina di file, osservare un flusso continuo di diff diventa poco pratico. Vuoi un'interfaccia corretta, l'evidenziazione della sintassi, schede di sessione e un chiaro pulsante Annulla per le modifiche.

È così che è nato il progetto cc-haha. L'autore ha preso il codice sorgente dello strumento CLI di Claude Code e ha costruito un'applicazione desktop attorno ad esso. Il risultato è un ambiente desktop per agenti AI autonomi, disponibile per macOS, Windows e Linux.

Cosa c'è all'interno dell'applicazione

Le utility console regolari bloccano lo sviluppatore in una finestra del terminale. Il progetto cc-haha adotta un approccio diverso e racchiude la logica dell'agente in un wrapper Electron con un'interfaccia React. Ottieni un ambiente grafico in cui il dialogo della rete neurale coesiste con un albero dei file, una finestra di visualizzazione delle modifiche e un browser integrato.

L'interfaccia è progettata in modo che tu mantenga il pieno controllo sulle azioni del modello. Ogni modifica al codice viene visualizzata su un pannello laterale prima che venga scritta su disco.

Quattro funzionalità da provare in cc-haha

Quando si lavora con le versioni CLI degli agenti, devi costantemente trovare un equilibrio tra velocità e sicurezza. I creatori di cc-haha hanno cercato di affrontare i principali punti critici per gli sviluppatori.

Isolamento delle attività tramite Git Worktree

Eseguire una rete neurale direttamente nel tuo branch di lavoro può essere rischioso. Una decisione imprudente del modello e passerai mezz'ora a ripulire le modifiche locali. In cc-haha, quando crei una sessione, puoi inviare l'agente a lavorare in un Git Worktree separato con un solo clic. Le modifiche al codice avvengono in una directory isolata, mentre il tuo branch principale rimane intatto.

Revisione visiva e impostazioni di autorizzazione flessibili

Invece di inserire costantemente conferme nella console, l'applicazione ti permette di configurare cinque livelli di autonomia. Puoi richiedere l'autorizzazione per ogni esecuzione di comando bash, oppure fidarti del modello per lavorare in modo indipendente. Tutti i file modificati vengono visualizzati con un'evidenziazione chiara delle diff.

Liberarsi da un singolo provider

Claude Code originale è legato all'API di Anthropic. In cc-haha, questa limitazione viene rimossa. Out of the box, supporta la connessione di modelli locali tramite Ollama e LM Studio, oltre ad API di terze parti tra cui DeepSeek, GLM, Kimi e ChatGPT. Con un server locale potente, l'agente può operare senza inviare dati a servizi esterni.

Gestione tramite messenger e web mobile

Hai avviato un lungo compito di refactoring e ti sei allontanato dal computer? Le sessioni possono essere collegate a Telegram, WhatsApp, 飞书 (Feishu) o accessibili tramite codice QR attraverso un'interfaccia web mobile. Se l'agente si ferma e richiede l'autorizzazione per eseguire un comando, puoi approvare l'azione direttamente dallo schermo del tuo smartphone.

Come è organizzato lo stack tecnico

L'architettura di cc-haha combina diverse tecnologie web familiari:

• Il runtime nativo Bun gestisce l'esecuzione degli script e la logica del server.
• Electron combinato con React e Vite forma l'ambiente desktop.
• Le interfacce console sono costruite sulla libreria Ink e sul parser Commander.js.
• Il supporto per i protocolli MCP (Model Context Protocol) e LSP aiuta l'agente a leggere il contesto del progetto e la struttura dei tipi.
• Il modulo Computer Use offre alla rete neurale la capacità di acquisire screenshot e controllare il cursore se un'attività non può essere risolta con una semplice modifica dei file.

Come eseguire il progetto localmente

Il modo più semplice è andare nella sezione delle release su GitHub e scaricare un installer già pronto per la tua piattaforma. Tuttavia, se vuoi eseguire il debug della parte CLI o compilare da sorgente, la build richiede un paio di minuti.

Avrai bisogno di Bun installato. La sequenza di comandi è la seguente:

git clone https://github.com/NanmiCoder/cc-haha.git
cd cc-haha
bun install

cp .env.example .env

./bin/claude-haha

Dopo il primo avvio, dovrai andare nelle impostazioni, inserire la chiave API per il provider scelto, oppure specificare l'indirizzo di un server Ollama locale.

Considerazioni pratiche

Prima di utilizzare lo strumento in progetti di produzione, vale la pena considerare le sue origini. Il codebase si basa su sorgenti che sono state rese pubbliche dal registro npm di Anthropic. Per questo motivo, il repository non ha una licenza open source standard e il file LICENSE mostra uno stato NOASSERTION.

I pacchetti precompilati per macOS e Windows non includono ancora firme digitali per sviluppatori. Al primo avvio su macOS, il sistema operativo bloccherà l'esecuzione, quindi dovrai consentire manualmente l'app nelle impostazioni di sicurezza del sistema operativo.

A chi tornerà utile cc-haha

Lo strumento è adatto a chi utilizza attivamente agenti AI per scrivere codice ma preferisce un'interfaccia grafica con un controllo chiaro delle modifiche. La possibilità di passare da DeepSeek, Claude e reti locali rende l'ambiente di lavoro versatile per un'ampia gamma di scenari.