Compañero: UI web para Claude Code CLI

resumen rápido

• este compañero Proporciona una interfaz web basada en React para Claude Code CLI.
• Utiliza el protocolo WebSocket oculto para habilitar múltiples sesiones, seguimiento de herramientas visuales y contexto de persistencia.
• Con la herramienta complementaria, puede ejecutar Claude Corder En un navegador web o dispositivo móvil, no sólo en el terminal.
• Está construido utilizando herramientas modernas como pan relleno al vapor Al correr, Reacción 19y viento de cola v4.

¿Qué es un socio?

este compañero es un código abierto Interfaz de usuario web Diseñado para Claude Corder. Le permite ejecutar sesiones de Claude Code en su navegador o dispositivo móvil, en lugar de limitarse al terminal.

El proyecto se estableció porque los desarrolladores sintieron que, si bien Claude Code era poderoso, su naturaleza basada en terminal dificultaba la gestión de múltiples sesiones, llamadas al visualizador o mantener el contexto en caso de una falla del proceso.

Las características principales de la herramienta incluyen:

• Múltiples sesiones simultáneas: Puede ejecutar varias instancias de Claude Code simultáneamente, cada una con su propia configuración.
• Visibilidad del visualizador: Los comandos Bash, la edición de archivos y los «greps» se muestran en secciones plegables con resaltado de sintaxis.
• Transmisión en vivo: Puede ver que la respuesta del agente se escribe token por token.
• Persistencia de la sesión: La sesión se guarda en su disco y puede continuar trabajando incluso después de reiniciar.
• No se requiere clave API: Se ejecuta utilizando su suscripción existente a Claude Code conectándose a la CLI.

¿Cómo conecta Companion la CLI y el navegador?

Los desarrolladores descubrieron un indocumentado. --sdk-url Banderas en Claude Code CLI. Este indicador redirige la salida del terminal a un servidor WebSocket utilizando el formato NDJSON.

La herramienta complementaria actúa como servidor que captura estos datos. Luego envía el mensaje a la página web local. Esta configuración le permite utilizar su suscripción Claude existente sin requerir una clave API separada.

¿Por qué trasladar su flujo de trabajo fuera de la terminal?

Para tareas complejas de IA, la terminal a menudo parece una prisión. No es fácil ejecutar varias sesiones simultáneamente y, si el proceso falla, normalmente se pierde el contexto.

Companion resuelve estos problemas proporcionando un panel web dedicado. Muestra respuestas token por token para que puedas ver instantáneamente la lógica del agente.

También muestra cada comando bash y edición de archivos en una sección plegable con resaltado de sintaxis.

¿Cómo maneja la interfaz de usuario jerarquías de proxy complejas?

Claude Code a veces genera subagentes para manejar tareas más pequeñas. Rastrearlos en una terminal es difícil porque el texto se desplaza rápidamente.

La interfaz web presenta a estos agentes en una estructura jerárquica clara. Puede seguir visualmente la cadena de mando completa. Esta característica facilita la auditoría de lo que está haciendo cada parte del sistema de IA.

¿Qué sucede con su trabajo si el sistema se reinicia?

Las sesiones de terminal estándar generalmente desaparecen si se cierra la ventana o se reinicia el sistema. Companion almacena cada sesión en su disco local.

utiliza el código claude --resume Mark reanudará automáticamente su trabajo. Esta persistencia garantiza que la IA recuerde el estado de su proyecto incluso después de una falla o reinicio del servidor.

Comience con Mate

No necesita una nueva clave API para utilizar esta herramienta; se ejecuta en su suscripción existente de Cloud Code.

1. Requisitos previos de instalación:

Asegúrate de tener Tiempo de ejecución de Baozi y Código Claude CLI instalado en su máquina.

2. Instalar compañero:

Abra una terminal y ejecute el siguiente comando:

bunx the-companion

3. Acceda a la interfaz de usuario:

Una vez que se inicie el servidor, abra un navegador y navegue hasta: http://localhost:3456

La interfaz complementaria es la siguiente:

4. Opcional (solo macOS):

Si desea que la herramienta se ejecute como un servicio en segundo plano iniciado al iniciar sesión, utilice:

bun install -g the-companion
the-companion install

Limitaciones y riesgos

Este proyecto se basa en protocolos ocultos que Anthropic no admite oficialmente. Si se eliminó Anthropic --sdk-url bandera, la herramienta dejará de funcionar hasta que los desarrolladores encuentren una nueva solución.

La seguridad es otro problema ya que la herramienta ejecuta comandos bash nativos. Debe revisar cada llamada de herramienta antes de hacer clic en «Aprobar» en su navegador. Actualmente, el servicio automatizado en segundo plano solo brinda soporte oficial para macOS.

Errores comunes

Los usuarios a menudo olvidan instalar el tiempo de ejecución de Bun antes de ejecutar el comando de inicio. Esto provoca una falla inmediata porque la herramienta requiere un Bun para ejecutarse.

Otro error es ignorar la configuración del puerto. Si otros servicios utilizan el puerto 3456, el servidor no podrá iniciarse. Debe asignar manualmente el nuevo puerto usando el siguiente comando --port marca en estas situaciones.

en conclusión

Para los desarrolladores que gestionan proyectos complejos de IA, la herramienta complementaria puede ser una buena opción. Úselo cuando necesite ejecutar varios agentes simultáneamente o necesite registros de auditoría visuales. Cíñete a una terminal estándar para responder preguntas simples y únicas.

Esta herramienta proporciona claridad visual de la que carecen los agentes basados ​​en terminales. Convierte el flujo de texto en un espacio de trabajo profesional. Pruébelo hoy y vea su código bajo una nueva luz.

recurso: