Claude Code es uno de los asistentes de programación con IA más potentes disponibles hoy, pero usarlo desde una ventana de consola local tiene limitaciones reales: estás atado a la máquina donde está instalado, no puedes acceder desde el móvil y no hay una forma fácil de compartir una sesión con un compañero.
sgcClaudeCodeRemote resuelve todo esto. Es un servidor Windows ligero que envuelve Claude Code dentro de un terminal web, permitiéndote conectar desde cualquier navegador — en tu escritorio, portátil, tablet o móvil. Por debajo, usa la API pseudo-console Windows ConPTY para una sesión de terminal real y sgcWebSockets para transmitir la E/S del terminal al navegador en tiempo real.
Este artÃculo cubre las caracterÃsticas, opciones de configuración y ventajas frente a ejecutar Claude Code directamente desde la consola.
¿Por qué usar Claude Code en remoto?
sgcClaudeCodeRemote aborda los puntos de fricción más comunes a los que se enfrentan los desarrolladores al trabajar con Claude Code en consola.
|
Acceso desde cualquier dispositivo Abre un navegador en tu móvil, tablet o portátil y conéctate a Claude Code corriendo en tu máquina de desarrollo. Sin Node.js, sin instalación de CLI — solo una URL. |
Sesiones colaborativas Varios desarrolladores pueden unirse a la misma sesión con nombre y ver la salida de Claude en tiempo real. Pair programming integrado — sin necesidad de herramientas de pantalla compartida. |
Seguro por defecto Autenticación con contraseña con protección contra fuerza bruta, timeouts configurables, bloqueo de IP y cifrado TLS 1.3 opcional para despliegues expuestos a internet. |
Terminal optimizado para móvil
La interfaz web está diseñada para funcionar en dispositivos móviles. Una barra de teclas optimizada para táctil en la parte inferior de la pantalla proporciona las teclas especiales que Claude Code necesita pero que faltan en los teclados móviles:
| Botón | Función |
|---|---|
| Esc | Cancela la operación actual o vuelve atrás |
| Tab | Acepta sugerencias y autocompletado |
| Intro | Confirma la entrada (tecla Enter) |
| Ctrl | Modificador "sticky" — pulsa una vez y luego una letra para combos como Ctrl+C (interrumpir) |
| ↑ ↓ ← → | Navega por el historial de comandos y menús |
La barra de herramientas usa eventos pointerdown para respuesta instantánea en pantallas táctiles y evita el robo de foco para que el terminal siga activo. El viewport se adapta al chrome del navegador móvil usando unidades de viewport dinámicas (dvh), asegurando que la barra siempre sea visible sin scroll.
Sesiones con nombre
Cada conexión puede especificar un nombre de sesión (p. ej. "backend-refactor", "devops", "testing"). Las sesiones persisten durante la vida del servidor, asà que puedes desconectar y reconectar más tarde a la misma instancia de Claude Code.
- Sesiones multicliente. Varios navegadores pueden unirse a la misma sesión simultáneamente — todos ven la misma salida del terminal y pueden escribir en la misma consola.
- Historial de sesiones. El navegador recuerda tus 10 sesiones más recientes en localStorage, con un desplegable para reconectar rápidamente.
- Indicador de sesión. El nombre de la sesión activa se muestra en la barra de cabecera tras la autenticación.
Autenticación y seguridad
sgcClaudeCodeRemote incluye varias capas de protección de fábrica:
|
Autenticación con contraseña Una única contraseña compartida protege el acceso. No se requiere nombre de usuario — solo la contraseña. El formulario de login deshabilita el autocompletado de credenciales del navegador para evitar almacenamiento accidental. |
Protección contra fuerza bruta Tras 5 intentos fallidos desde la misma IP, esa dirección queda bloqueada durante 5 minutos. Las IPs bloqueadas se rechazan a nivel de conexión antes de cualquier procesamiento. |
|
Timeout de autenticación Los clientes deben autenticarse dentro de una ventana configurable (por defecto 15 segundos). Las conexiones inactivas que no envÃen credenciales se desconectan automáticamente. |
Cifrado TLS 1.3 Para despliegues expuestos a internet, habilita TLS con un certificado y un archivo de clave. Todo el tráfico entre navegador y servidor se cifra extremo a extremo. |
Saltarse los prompts de permisos. Una casilla en la pantalla de login (marcada por defecto) lanza Claude Code con el flag --dangerously-skip-permissions. Es esencial para sesiones remotas donde no puedes interactuar con los diálogos de permisos en la consola del servidor.
sgcClaudeCodeRemote vs. Claude Code en consola
Comparación lado a lado de ejecutar Claude Code en local frente a hacerlo a través de sgcClaudeCodeRemote.
| CaracterÃstica | Consola | sgcClaudeCodeRemote |
|---|---|---|
| Acceso desde cualquier dispositivo | No | SÃ |
| Soporte móvil / tablet | No | Sà (barra táctil) |
| Varios usuarios en la misma sesión | No | Sà |
| Sesiones con nombre persistentes | No | SÃ |
| Protección con contraseña | No | Sà (bloqueo por fuerza bruta) |
| Cifrado TLS | N/A | TLS 1.3 |
| Software de cliente requerido | Node.js + CLI | Solo un navegador |
| Pair programming | Herramientas externas | Integrado |
| Visualización de latencia en tiempo real | No | Sà |
| Plataformas cliente | Solo la misma máquina | Windows, macOS, Linux, Android, iOS |
Primeros pasos
Descarga sgcClaudeCodeRemote y ejecútalo desde la lÃnea de comandos con una contraseña:
sgcClaudeCodeRemote.exe --password MySecretPasswordLuego abre tu navegador y ve a http://tu-ip-de-servidor:8765/. Introduce la contraseña, elige un nombre de sesión y ya estás dentro.
Ejemplos
Puerto personalizado con mayor lÃmite de conexiones:
sgcClaudeCodeRemote.exe --port 9000 --password MyPass --max-conn 20Con cifrado TLS para acceso seguro a través de internet:
sgcClaudeCodeRemote.exe --tls --tls-cert cert.pem --tls-key key.pem --password MyPassOpciones de lÃnea de comandos
| Opción | Description | Por defecto |
|---|---|---|
--port |
Puerto de escucha del servidor | 8765 |
--password |
Contraseña de acceso (obligatoria cuando la auth está habilitada) | — |
--command |
Comando a ejecutar en el terminal | claude |
--cols / --rows |
Dimensiones iniciales del terminal | 120 × 40 |
--max-conn |
Máximo de conexiones concurrentes | 10 |
--timeout |
Timeout de autenticación en segundos | 15 |
--no-auth |
Deshabilita la autenticación por completo | — |
--tls |
Habilita cifrado TLS 1.3 | — |
--tls-cert / --tls-key |
Archivos PEM del certificado y la clave privada | — |
--tls-password |
Contraseña de la clave privada (si está cifrada) | — |
--tls-port |
Puerto de escucha TLS | Igual que --port |
Casos de uso
- Trabaja desde el móvil. Revisa código, hazle preguntas a Claude o ejecuta comandos desde cualquier sitio — el sofá, el tren o una cafeterÃa.
- Colaboración en equipo. Varios desarrolladores se conectan a la misma sesión e interactúan con Claude en tiempo real. Sin necesidad de compartir pantalla.
- Servidores de build headless. Ejecuta Claude Code en una máquina remota potente y accede desde un thin client o un entorno sin terminal.
- Demos y presentaciones. Comparte la URL de una sesión con tu audiencia. Todos ven el mismo terminal en vivo y siguen el flujo.
- Acceso remoto seguro. Habilita TLS, establece una contraseña fuerte y usa Claude Code de forma segura sobre internet desde cualquier ubicación.
Cómo funciona
sgcClaudeCodeRemote es una aplicación de consola Delphi construida sobre tres tecnologÃas clave:
|
Windows ConPTY La API pseudo-console de Windows 10 crea una sesión de terminal real con soporte completo de secuencias VT100/ANSI. Claude Code se ejecuta dentro de esta consola exactamente como lo harÃa en una ventana de terminal normal. |
sgcWebSockets La librerÃa sgcWebSockets gestiona toda la comunicación WebSocket, el serving HTTP y el cifrado TLS opcional. Los frames binarios transportan la salida del terminal; los frames de texto JSON manejan la autenticación y los mensajes de control. |
xterm.js El navegador renderiza el terminal usando xterm.js con el addon fit (autoajuste a la ventana) y el addon web-links (URLs clicables). El tema oscuro encaja con la estética de Claude Code. |
Requisitos del sistema. El servidor requiere Windows 10 versión 1809 o posterior (para soporte de ConPTY) y Claude Code instalado en la máquina host. Los clientes solo necesitan un navegador web moderno.
CaracterÃsticas de la interfaz web
La interfaz web de una sola página está embebida directamente en el ejecutable — sin archivos externos que desplegar. Incluye:
- Indicador de estado. Badge con código de color (verde = conectado, rojo = desconectado, azul = login requerido, ámbar = conectando) con animación de pulso.
- Latencia en tiempo real. Muestra la latencia de ida y vuelta en milisegundos, actualizada en cada frame.
- Dimensiones del terminal. Muestra las columnas × filas actuales y se actualiza dinámicamente al redimensionar.
- Botón Fit. Redimensiona instantáneamente el terminal para llenar la ventana del navegador.
- Copiar y pegar. Soporte completo de portapapeles — Ctrl+C copia el texto seleccionado, Ctrl+V pega en el terminal.
- Reconexión automática. Si se cae la conexión, el cliente intenta reconectar automáticamente tras 3 segundos.
- Scrollback de 10.000 lÃneas. Haz scroll hacia arriba para revisar la salida anterior de Claude Code sin perder historial.
sgcClaudeCodeRemote está construido con sgcWebSockets — componentes WebSocket de alto rendimiento para Delphi y .NET.