Hoe ontwikkelaars de CLI van Claude Code omtoverden tot een grafische desktopomgeving genaamd cc-haha

Als je ooit hebt geprobeerd codeeragents uit te voeren in de console, ben je waarschijnlijk tegen hetzelfde probleem aangelopen. De terminal is geweldig voor het uitvoeren van een enkele opdracht. Maar wanneer AI begint met het bewerken van een dozijn bestanden, wordt het volgen van een continue stroom van diffs onhandelbaar. Je wilt een echte interface, syntax highlighting, sessietabs en een duidelijke ongedaan maken-knop voor wijzigingen.

Zo ontstond het cc-haha-project. De auteur nam de broncode van het Claude Code CLI-hulpprogramma en bouwde er een desktoptoepassing omheen. Het resultaat is een desktopomgeving voor autonome AI-agents, beschikbaar voor macOS, Windows en Linux.

Wat er zich in de toepassing bevindt

Reguliere console-hulpprogramma's vergrendelen de ontwikkelaar in een terminalvenster. Het cc-haha-project kiest een andere aanpak en verpakt de agentlogica in een Electron-shell met een React-interface. Je krijgt een grafische omgeving waar de dialoog met het neurale netwerk samengaat met een bestandsstructuur, een venster voor het bekijken van wijzigingen en een ingebouwde browser.

De interface is zo ontworpen dat je volledige controle behoudt over de acties van het model. Elke codewijziging wordt weergegeven in een zijpaneel voordat deze naar schijf wordt geschreven.

Vier functies die de moeite waard zijn om te bekijken in cc-haha

Bij het werken met CLI-versies van agents moet je voortdurend een balans vinden tussen snelheid en veiligheid. De makers van cc-haha hebben geprobeerd de belangrijkste pijnpunten voor ontwikkelaars aan te pakken.

Taakisolatie via Git Worktree

Een neuraal netwerk rechtstreeks uitvoeren in je werkbranch kan riskant zijn. Eén onvoorzichtige beslissing van het model, en je besteedt een half uur aan het opruimen van lokale wijzigingen. In cc-haha kun je bij het maken van een sessie met één klik de agent naar een aparte Git Worktree sturen. Codewijzigingen vinden plaats in een geïsoleerde map, terwijl je hoofdbranch onaangetast blijft.

Visuele review en flexibele machtigingsinstellingen

In plaats van voortdurend bevestigingen in te voeren in de console, kun je in de toepassing vijf niveaus van autonomie configureren. Je kunt toestemming vragen voor elke bash-opdrachtuitvoering, of het model zelfstandig laten werken. Alle gewijzigde bestanden worden weergegeven met duidelijke diff-highlighting.

Afstappen van één provider

De originele Claude Code is gekoppeld aan de Anthropic API. In cc-haha wordt deze beperking opgeheven. Uit de doos ondersteunt het het verbinden van lokale modellen via Ollama en LM Studio, evenals API's van derden waaronder DeepSeek, GLM, Kimi en ChatGPT. Met een krachtige lokale server kan de agent opereren zonder gegevens naar externe services te sturen.

Beheer via messengers en mobiele webinterface

Ben je begonnen met een lange refactoring-taak en weggegaan van je computer? Sessies kunnen worden gekoppeld aan Telegram, WhatsApp, 飞书 (Feishu), of worden geopend via QR-code via een mobiele webinterface. Als de agent stopt en toestemming vraagt om een opdracht uit te voeren, kun je de actie goedkeuren vanaf je smartphonescherm.

Hoe de technische stack is georganiseerd

De architectuur van cc-haha combineert verschillende vertrouwde webtechnologieën:

• De native Bun-runtime verwerkt scriptuitvoering en serverlogica.
• Electron gecombineerd met React en Vite vormt de desktopomgeving.
• Console-interfaces zijn gebouwd op de Ink-bibliotheek en de Commander.js-parser.
• Ondersteuning voor MCP (Model Context Protocol) en LSP-protocollen helpt de agent om projectcontext en typestructuur te lezen.
• De Computer Use-module geeft het neurale netwerk de mogelijkheid om schermafbeeldingen te maken en de cursor te besturen als een taak niet kan worden opgelost met eenvoudig bestandsbeheer.

Het project lokaal uitvoeren

De eenvoudigste manier is om naar de releases-sectie op GitHub te gaan en een kant-en-klaar installatieprogramma voor je platform te downloaden. Als je echter de CLI-component wilt debuggen of vanaf de broncode wilt bouwen, duurt het bouwen een paar minuten.

Je hebt Bun geïnstalleerd nodig. De opdrachtvolgorde ziet er zo uit:

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

cp .env.example .env

./bin/claude-haha

Na de eerste keer opstarten moet je naar de instellingen gaan, de API-sleutel voor je gekozen provider invoeren, of het adres van een lokale Ollama-server opgeven.

Praktische overwegingen

Voordat je het hulpmiddel gebruikt in productieprojecten, is het de moeite waard om naar de oorsprong ervan te kijken. De codebase is afhankelijk van bronnen die openbaar zijn gemaakt vanuit de npm-registry van Anthropic. Om deze reden heeft de repository geen standaard open-source licentie, en het LICENSE-bestand toont een NOASSERTION-status.

Voorgebouwde pakketten voor macOS en Windows bevatten nog geen digitale handtekeningen van ontwikkelaars. Bij de eerste keer opstarten op macOS zal het besturingssysteem de uitvoering blokkeren, dus je moet de app handmatig toestaan in de OS-beveiligingsinstellingen.

Voor wie is cc-haha nuttig

Het hulpmiddel is geschikt voor degenen die actief AI-agents gebruiken voor het schrijven van code, maar de voorkeur geven aan een grafische interface met duidelijke wijzigingscontrole. De mogelijkheid om te schakelen tussen DeepSeek, Claude en lokale netwerken maakt de werkomgeving veelzijdig voor een breed scala aan scenario's.