Qué es cc-haha: un proyecto que convierte Claude Code en un banco de trabajo de escritorio

cc-haha es un proyecto construido alrededor de un flujo de trabajo modificado de Claude Code. Su repositorio completo es NanmiCoder/cc-haha. La página del proyecto lo dice de forma directa: está basado en el código fuente de Claude Code filtrado desde el Anthropic npm registry el 2026-03-31, y su forma principal actual es un banco de trabajo de escritorio para Claude Code.

Proyecto: https://github.com/NanmiCoder/cc-haha

Hay dos puntos importantes en esa descripción.

Primero, no es Claude Code oficial de Anthropic. El README también indica que el copyright del código fuente original pertenece a Anthropic y que el proyecto es solo para aprendizaje e investigación.

Segundo, su foco ya no es simplemente “ejecutar un Claude Code CLI local”. Por lo que muestran el README y el release más reciente, cc-haha se parece más a una app de escritorio que reúne sesiones de Claude Code, proyectos, permisos, diffs, Computer Use, acceso remoto y configuración de proveedores de modelos.

Qué problema intenta resolver

Claude Code nació como una herramienta orientada a la terminal. Las sesiones, la ejecución de comandos, las confirmaciones de permisos, las ediciones de archivos y el cambio de contexto ocurren en la terminal. Para quien está cómodo con CLI, eso funciona. Pero en uso prolongado aparecen varias incomodidades:

Varios proyectos y sesiones son difíciles de gestionar a la vez.
Para ver qué archivos modificó la IA, hay que cambiar a Git o al editor.
Las aprobaciones, la ejecución de comandos y los diffs quedan repartidos en varias superficies.
Ver la sesión actual desde un teléfono u otro dispositivo requiere una solución adicional.
Conectar modelos que no sean de Anthropic exige manejar compatibilidad de protocolos.

La dirección de cc-haha es empaquetar todo eso en un banco de trabajo gráfico. No es solo una capa visual para Claude Code; mueve la gestión de sesiones y el control del flujo de desarrollo local a la app de escritorio.

Banco de trabajo de escritorio: de terminal a centro de control

Según el README, la app de escritorio de cc-haha reúne estas capacidades en macOS / Windows:

Banco de trabajo multisesión: pestañas, cambio de proyecto, entrada a terminal e historial de sesiones.
Arranque por branch / Worktree: una nueva sesión puede elegir rama del repositorio y decidir entre el árbol actual o un Worktree aislado.
Panel derecho de cambios de código: ver archivos modificados, líneas añadidas/eliminadas y estado del workspace mientras se chatea.
Visualización de cambios: inspeccionar ediciones de la IA, diffs y proceso de ejecución.
Flujo de permisos y confirmaciones: aprobar comandos peligrosos, tool calls y preguntas de la IA desde el escritorio.
Varios proveedores de modelos: API compatibles con Anthropic, modelos de terceros, WebSearch fallback y configuración local.
Acceso remoto H5: usar un token de un solo uso para entrar a la sesión de escritorio desde un teléfono u otro dispositivo.
Integración con IM: conversar, cambiar proyectos y aprobar permisos desde Telegram, Feishu, WeChat o DingTalk.
Tareas programadas y uso de tokens: crear tareas planificadas y ver tendencias de consumo local de tokens.

Estas funciones lo acercan más a un “banco de trabajo de programación con IA” que a un simple sustituto de la línea de comandos. Intenta poner en un solo lugar las superficies más comunes al programar con IA: chat, cambios de archivos, permisos, proyectos, entrada remota y configuración de modelos.

Instalación y arranque

Para usuarios normales, lo más razonable es descargar el instalador de escritorio desde Releases.

El flujo indicado en el README es:

Ir a GitHub Releases y descargar el instalador de macOS o Windows.
En el primer arranque, configurar proveedor de modelo, API Key y modelo por defecto en los ajustes de escritorio.
Si macOS indica que la app no se puede abrir, seguir la guía de instalación para resolver permisos de Gatekeeper.

La página del release más reciente muestra que v0.2.6 se publicó el 2026-05-13. Esa versión se centra en recuperar de forma segura el acceso móvil H5, mejorar la gestión de sesiones de escritorio, la búsqueda de menciones de archivos y detalles de experiencia de escritorio.

Si quieres arrancar el CLI desde código fuente, el README da estos comandos:

1
2
3


bun install
cp .env.example .env
./bin/claude-haha

Ese camino es más adecuado para quien quiera depurar el CLI inferior, el servidor o desarrollar cambios propios. Para uso normal, la app de escritorio es más directa.

Qué cambió en v0.2.6

El punto principal de v0.2.6 es que el acceso H5/LAN volvió de una apertura temporal a un modelo de activación explícita y emparejamiento por token.

Cambios destacados:

El acceso H5/LAN debe activarse explícitamente en local.
Los enlaces QR llevan un token visible una sola vez.
Las API remotas, proxy y WebSocket ya no quedan expuestos sin protección.
Settings añadió una página independiente de H5 Access.
La barra lateral de escritorio añadió modo de gestión masiva, con selección múltiple y borrado de sesiones.
La búsqueda de menciones de archivos ahora es git-first, respeta reglas ignore y reduce ruido de node_modules y artefactos de build.
Se añadió un tema blanco puro y se corrigieron problemas como URLs largas rompiendo el layout del chat o borradores cruzados entre tabs.

Esto muestra que el proyecto ya no está solo en la fase de “funciona”, sino que empieza a cubrir límites de seguridad y detalles diarios propios de un producto de escritorio.

La parte de H5 merece especial cuidado. El autor avisa en el release que H5 es una entrada de navegador para individuos o equipos confiables, no un sistema público de login multi-tenant. En la práctica, no debería tratarse como un panel SaaS expuesto a internet.

Computer Use: dejar que el Agent opere el escritorio

Otro punto importante de cc-haha es Computer Use.

La documentación del proyecto explica que esta función parte de una versión muy modificada del Computer Use interno del código filtrado de Claude Code. La implementación oficial depende de módulos nativos privados de Anthropic, como @ant/computer-use-swift y @ant/computer-use-input, que no están disponibles públicamente. cc-haha reemplaza la capa inferior por un Python bridge basado en bibliotecas públicas como pyautogui, mss y pyobjc.

Computer Use soporta operaciones como:

Captura de pantalla: screenshot, zoom
Ratón: clic, arrastre, movimiento, scroll y lectura de posición del cursor
Teclado: escribir texto, pulsar teclas, mantener teclas
Aplicaciones: abrir apps, cambiar pantalla
Permisos: solicitar acceso a apps, listar aplicaciones autorizadas
Portapapeles: leer y escribir contenido
Otros: esperar, operaciones por lote

Su flujo es un ciclo de “captura - análisis - acción”:

El modelo recibe la solicitud del usuario.
Llama a screenshot para capturar la pantalla.
El modelo usa visión para identificar botones, campos y coordenadas.
Llama a herramientas de clic, escritura u operación de apps.
Vuelve a capturar pantalla para confirmar el resultado y continúa.

Según la documentación, la plataforma con soporte completo es principalmente macOS, tanto Apple Silicon como Intel. Windows / Linux son teóricamente posibles, pero las partes de gestión de aplicaciones basadas en pyobjc deben reemplazarse por soluciones de cada plataforma, y hoy no están completamente adaptadas.

Los requisitos de ejecución incluyen:

Bun >= 1.1.0
Python >= 3.8
permiso de Accessibility en macOS
permiso de Screen Recording en macOS

Esta función es potente, pero también aumenta el riesgo de permisos. Al dejar que la IA opere apps de escritorio, conviene autorizar solo las aplicaciones realmente necesarias y no dejar contenido sensible abierto en ventanas no relacionadas.

Varios modelos mediante una capa compatible con Anthropic

La comunicación base de cc-haha sigue siendo el protocolo Anthropic Messages API. La documentación recomienda usar LiteLLM como proxy de conversión de protocolo.

La estructura básica es:

1

claude-code-haha ──Anthropic协议──▶ LiteLLM Proxy ──OpenAI协议──▶ 目标模型 API

Es decir, cc-haha envía solicitudes Anthropic Messages API, LiteLLM las convierte a formatos como OpenAI Chat Completions y las reenvía a OpenAI, DeepSeek, Ollama u otros servicios de modelos.

La instalación de LiteLLM indicada en la documentación es:

1

pip install 'litellm[proxy]'

Después se pueden configurar OpenAI, DeepSeek, Ollama y otros modelos en litellm_config.yaml. Una vez iniciado el proxy, se configuran estas variables en .env o ~/.claude/settings.json:

1
2
3
4
5
6
7
8
9


ANTHROPIC_AUTH_TOKEN=sk-anything
ANTHROPIC_BASE_URL=http://localhost:4000
ANTHROPIC_MODEL=gpt-4o
ANTHROPIC_DEFAULT_SONNET_MODEL=gpt-4o
ANTHROPIC_DEFAULT_HAIKU_MODEL=gpt-4o
ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-4o
API_TIMEOUT_MS=3000000
DISABLE_TELEMETRY=1
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

Hay varios detalles prácticos:

drop_params: true es importante, porque parámetros de Anthropic como thinking o cache_control no existen en la API de OpenAI.
Extended Thinking es una función propia de Anthropic y no está disponible con modelos de terceros.
Prompt Caching tampoco funciona en la forma nativa de Anthropic.
Los tool calls pasan de Anthropic tool_use a OpenAI function calling, así que algunos tool calls complejos pueden tener problemas de compatibilidad.
Modelos locales pequeños en Ollama pueden no manejar de forma estable este flujo intensivo en herramientas.

Así que conectar varios modelos puede funcionar, pero no significa que todos ofrezcan la misma experiencia. cc-haha sigue exigiendo al modelo buena capacidad de tool use, comprensión de código y contexto largo.

Para quién tiene sentido

cc-haha encaja mejor con:

Usuarios que ya conocen Claude Code y quieren gestión de sesiones en escritorio.
Personas que trabajan con varios repositorios, ramas y sesiones de IA al mismo tiempo.
Quienes quieren ver cambios de archivos, diffs y estado del workspace en un panel lateral.
Usuarios que quieren probar Computer Use y dejar que un Agent opere apps de escritorio.
Personas que quieren conectar OpenAI, DeepSeek, Ollama u otros modelos mediante un protocolo compatible con Anthropic.
Usuarios que necesitan ver sesiones o aprobar permisos desde móvil o IM.

Encaja peor con:

Usuarios que solo quieren la experiencia oficial y estable de Claude Code.
Personas que no aceptan el origen en código filtrado y la incertidumbre de copyright.
Usuarios que no quieren conceder permisos altos del sistema a herramientas locales.
Equipos que necesitan cumplimiento empresarial, auditoría y soporte oficial.
Personas que no están cómodas con API keys, proxies, compatibilidad de modelos y servicios locales.

Riesgos y límites

Este artículo no puede hablar solo de funciones; también debe hablar de riesgos.

El origen de cc-haha hace que no sea una reimplementación comunitaria normal. El README indica claramente que está basado en código fuente filtrado de Claude Code, y que el código original pertenece a Anthropic. Eso crea incertidumbre de copyright, cumplimiento y mantenimiento a largo plazo.

Además, Computer Use, acceso remoto H5, integración IM y aprobación local de permisos son capacidades de alto privilegio. Cuanto más cómodas son, más claros deben ser sus límites:

No abrir H5 access en redes no confiables.
No tratar el token como una credencial pública de login a largo plazo.
No permitir que el Agent opere aplicaciones sensibles no relacionadas.
No integrarlo casualmente en producción o entornos corporativos regulados.
No exponer configuración de proxies de modelos ni API keys en repositorios públicos.

Si el objetivo es estudiar arquitectura de herramientas de programación con IA, flujos de escritorio e implementación de Computer Use, es una referencia útil. Si se quiere usar en un flujo de producción a largo plazo, hay que evaluar primero riesgos legales, de permisos, seguridad y mantenimiento.

Resumen

Lo más interesante de cc-haha no es si puede replicar Claude Code, sino que empuja las herramientas de programación con IA tipo Claude Code hacia una forma de banco de trabajo de escritorio.

Sesiones, proyectos, Worktree, diffs, permisos, acceso remoto, Computer Use, proveedores de modelos, tareas programadas y estadísticas de tokens se reúnen en una sola experiencia de escritorio. Esto muestra que el siguiente paso de las herramientas de programación con IA no es solo tener modelos más fuertes, sino también interfaces de flujo de trabajo más completas.

Pero sus límites también son claros: no es un producto oficial de Anthropic, tiene un origen sensible y sus funciones de alto permiso requieren cuidado. La actitud más razonable es verlo como un proyecto para observar la evolución de las herramientas de programación con IA, no como un reemplazo despreocupado de Claude Code oficial.

Referencias

Repositorio de GitHub: https://github.com/NanmiCoder/cc-haha
Último release: https://github.com/NanmiCoder/cc-haha/releases/tag/v0.2.6
Documentación de Computer Use: https://github.com/NanmiCoder/cc-haha/blob/main/docs/computer-use.md
Documentación de modelos de terceros: https://github.com/NanmiCoder/cc-haha/blob/main/docs/guide/third-party-models.md