Como desenvolvedores transformaram o CLI Claude Code em um ambiente de desktop gráfico chamado cc-haha

Se você já tentou executar agentes de codificação no console, provavelmente encontrou o mesmo problema. O terminal é ótimo para emitir um único comando. Mas quando a IA começa a editar uma dúzia de arquivos, acompanhar um fluxo contínuo de diffs se torna desorganizado. Você quer uma interface adequada, destaque de sintaxe, abas de sessão e um botão desfazer claro para as alterações.

É assim que o projeto cc-haha surgiu. O autor pegou o código-fonte da ferramenta CLI do Claude Code e construiu um aplicativo desktop ao redor dela. O resultado é um ambiente de desktop para agentes de IA autônomos, disponível para macOS, Windows e Linux.

O que está dentro do aplicativo

Utilitários de console convencionais prendem o desenvolvedor a uma janela de terminal. O projeto cc-haha adota uma abordagem diferente e envolve a lógica do agente em uma camada Electron com interface React. Você obtém um ambiente gráfico onde o diálogo com a rede neural coexiste com uma árvore de arquivos, uma janela de visualização de alterações e um navegador integrado.

A interface é projetada para que você mantenha controle total sobre as ações do modelo. Cada alteração de código é exibida em um painel lateral antes de ser gravada no disco.

Quatro recursos que vale a pena conferir no cc-haha

Ao trabalhar com versões CLI de agentes, você constantemente precisa encontrar um equilíbrio entre velocidade e segurança. Os criadores do cc-haha tentaram resolver os principais pontos problemáticos para desenvolvedores.

Isolamento de tarefas via Git Worktree

Executar uma rede neural diretamente no seu branch de trabalho pode ser arriscado. Uma decisão descuidada do modelo, e você gastará meia hora limpando alterações locais. No cc-haha, ao criar uma sessão, você pode enviar o agente para trabalhar em um Git Worktree separado com um único clique. As alterações de código acontecem em um diretório isolado, enquanto seu branch principal permanece intocado.

Revisão visual e configurações flexíveis de permissões

Em vez de inserir confirmações constantemente no console, o aplicativo permite configurar cinco níveis de autonomia. Você pode solicitar permissão para cada execução de comando bash, ou confiar no modelo para trabalhar de forma independente. Todos os arquivos modificados são exibidos com destaque de diff claro.

Libertando-se de um único provedor

O Claude Code original está vinculado à API da Anthropic. No cc-haha, essa limitação é removida. Pronto para uso, ele suporta conectar modelos locais via Ollama e LM Studio, bem como APIs de terceiros incluindo DeepSeek, GLM, Kimi e ChatGPT. Com um servidor local poderoso, o agente pode operar sem enviar dados para serviços externos.

Gerenciamento via mensageiros e web mobile

Iniciou uma tarefa longa de refatoração e se afastou do computador? As sessões podem ser vinculadas ao Telegram, WhatsApp, 飞书 (Feishu), ou acessadas via código QR através de uma interface web mobile. Se o agente parar e solicitar permissão para executar um comando, você pode aprovar a ação diretamente da tela do seu smartphone.

Como a pilha técnica é organizada

A arquitetura do cc-haha combina várias tecnologias web familiares:

• O runtime nativo Bun lida com execução de scripts e lógica de servidor.
• Electron paired with React e Vite forma o ambiente de desktop.
• Interfaces de console são construídas com a biblioteca Ink e o parser Commander.js.
• Suporte aos protocolos MCP (Model Context Protocol) e LSP ajuda o agente a ler o contexto do projeto e a estrutura de tipos.
• O módulo Computer Use dá à rede neural a capacidade de capturar telas e controlar o cursor se uma tarefa não puder ser resolvida com edição simples de arquivos.

Como executar o projeto localmente

A forma mais fácil é ir até a seção de releases no GitHub e baixar um instalador pronto para sua plataforma. No entanto, se você quiser depurar a parte CLI ou compilar a partir do código-fonte, o build leva alguns minutos.

Você precisará ter o Bun instalado. A sequência de comandos fica assim:

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

cp .env.example .env

./bin/claude-haha

Após o primeiro lançamento, você precisará ir até as configurações, inserir a chave API do seu provedor escolhido, ou especificar o endereço de um servidor Ollama local.

Considerações práticas

Antes de usar a ferramenta em projetos de produção, vale a pena considerar suas origens. O código-fonte depende de fontes que foram tornadas públicas do registro npm da Anthropic. Por esse motivo, o repositório não possui uma licença open source padrão, e o arquivo LICENSE mostra um status de NOASSERTION.

Pacotes pré-construídos para macOS e Windows ainda não incluem assinaturas digitais de desenvolvedor. Na primeira execução no macOS, o sistema operacional bloqueará a execução, então você precisará permitir manualmente o aplicativo nas configurações de segurança do SO.

Quem achará o cc-haha útil

A ferramenta é adequada para quem usa ativamente agentes de IA para escrever código, mas prefere uma interface gráfica com controle claro de alterações. A capacidade de alternar entre DeepSeek, Claude e redes locais torna o ambiente de trabalho versátil para uma ampla gama de cenários.