Jak programiści przekształcili CLI Claude Code w graficzne środowisko desktopowe o nazwie cc-aha

Jeśli kiedykolwiek próbowałeś uruchamiać agenty kodujące w konsoli, prawdopodobnie napotkałeś ten sam problem. Terminal świetnie sprawdza się przy wydawaniu pojedynczych poleceń. Ale gdy AI zaczyna edytować tuzin plików i wyświetla ciągły strumień diffów, robi się niewygodnie. Potrzebujesz odpowiedniego interfejsu, podświetlania składni, kart sesji i wyraźnego przycisku cofania zmian.

Taki był początek projektu cc-haha. Autor wziął kod źródłowy narzędzia CLI Claude Code i zbudował wokół niego aplikację desktopową. Efektem jest środowisko desktopowe dla autonomicznych agentów AI, dostępne na macOS, Windows i Linux.

Co kryje się w środku aplikacji

Zwykłe narzędzia konsolowe zamykają programistę w oknie terminala. Projekt cc-haha idzie inną drogą i opakowuje logikę agenta w powłokę Electron z interfejsem React. Otrzymujesz środowisko graficzne, w którym dialog z siecią neuronową współistnieje z drzewem plików, oknem przeglądania zmian i wbudowaną przeglądarką.

Interfejs zaprojektowano tak, abyś zachował pełną kontrolę nad działaniami modelu. Każda zmiana w kodzie wyświetla się na panelu bocznym, zanim zostanie zapisana na dysku.

Cztery funkcje, które warto sprawdzić w cc-aha

Pracując z wersjami CLI agentów, ciągle musisz znajdować równowagę między szybkością a bezpieczeństwem. Twórcy cc-aha postarali się rozwiązać główne problemy programistów.

Izolacja zadań za pomocą Git Worktree

Uruchamianie sieci neuronowej bezpośrednio w gałęzi roboczej może być ryzykowne. Jedna nieprzemyślana decyzja modelu, a spędzisz pół godziny na sprzątaniu lokalnych zmian. W cc-aha, tworząc sesję, możesz jednym kliknięciem wysłać agenta do pracy w osobnym Git Worktree. Zmiany w kodzie odbywają się w izolowanym katalogu, podczas gdy główna gałąź pozostaje nietknięta.

Wizualna recenzja i elastyczne ustawienia uprawnień

Zamiast ciągle wpisywać potwierdzenia w konsoli, aplikacja pozwala skonfigurować pięć poziomów autonomii. Możesz żądać zgody na każde wykonanie polecenia bash lub zaufać modelowi, że będzie pracować samodzielnie. Wszystkie zmodyfikowane pliki wyświetlane są z wyraźnym podświetleniem diffów.

Rezygnacja z powiązania z jednym dostawcą

Oryginalny Claude Code jest powiązany z API Anthropic. W cc-aha to ograniczenie zostało usunięte. Out of the box obsługuje połączenia z modelami lokalnymi przez Ollama i LM Studio, a także z zewnętrznymi API, w tym DeepSeek, GLM, Kimi i ChatGPT. Dzięki mocnemu serwerowi lokalnemu agent może działać bez wysyłania danych do usług zewnętrznych.

Zarządzanie przez komunikatory i mobilny internet

Rozpocząłeś długie zadanie refaktoryzacji i odszedłeś od komputera? Sesje można powiązać z Telegram, WhatsApp, 飞书 (Feishu) lub uzyskać do nich dostęp przez kod QR przez mobilny interfejs webowy. Jeśli agent zatrzyma się i poprosi o zgodę na wykonanie polecenia, możesz zatwierdzić działanie prosto z ekranu smartfona.

Jak zorganizowany jest stos technologiczny

Architektura cc-aha łączy kilka znanych technologii webowych:

• Natywne środowisko uruchomieniowe Bun obsługuje wykonywanie skryptów i logikę serwera.
• Electron w połączeniu z React i Vite tworzy środowisko desktopowe.
• Interfejsy konsolowe zbudowane są na bibliotece Ink i parserze Commander.js.
• Obsługa protokołów MCP (Model Context Protocol) i LSP pomaga agentowi odczytywać kontekst projektu i strukturę typów.
• Moduł Computer Use daje sieci neuronowej możliwość robienia zrzutów ekranu i kontrolowania kursora, jeśli zadania nie można rozwiązać prostą edycją plików.

Jak uruchomić projekt lokalnie

Najłatwiej jest przejść do sekcji releases na GitHub i pobrać gotowy instalator dla swojej platformy. Jeśli jednak chcesz debugować część CLI lub zbudować projekt ze źródeł, kompilacja zajmuje kilka minut.

Będziesz potrzebować zainstalowanego Bun. Sekwencja poleceń wygląda tak:

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

cp .env.example .env

./bin/claude-haha

Po pierwszym uruchomieniu musisz przejść do ustawień, wprowadzić klucz API dla wybranego dostawcy lub podać adres lokalnego serwera Ollama.

Praktyczne niuanse

Przed użyciem narzędzia w projektach produkcyjnych warto wziąć pod uwagę jego pochodzenie. Kod bazuje na źródłach udostępnionych publicznie z rejestru npm Anthropic. Z tego powodu repozytorium nie ma standardowej licencji open source, a plik LICENSE pokazuje status NOASSERTION.

Wstępnie zbudowane pakiety dla macOS i Windows nie zawierają jeszcze podpisów cyfrowych dewelopera. Przy pierwszym uruchomieniu na macOS system operacyjny zablokuje wykonanie, więc musisz ręcznie zezwolić na aplikację w ustawieniach bezpieczeństwa OS.

Komu przyda się cc-aha

Narzędzie jest odpowiednie dla osób aktywnie korzystających z agentów AI do pisania kodu, ale preferujących interfejs graficzny z wyraźną kontrolą zmian. Możliwość przełączania się między DeepSeek, Claude i sieciami lokalnymi sprawia, że środowisko pracy jest wszechstronne w szerokim zakresie scenariuszy.