Guía de uso

Basado en las pantallas verificadas con Claude Code 2.1.288~2.1.291

1. Preparación

Conecte los Mac de sus desarrolladores a un único servidor de la empresa.

• Servidor de la empresa: un servidor de aplicaciones web (WAS) y una base de datos en un servidor interno. La consola web va detrás del proxy HTTPS de la empresa, y las conexiones de los Agent (/ws/agent·/agent/) solo se abren dentro de la red interna (VPN). El inicio de sesión web exige usuario · contraseña y OTP.
• Cada Mac: tmux y Claude Code. Claude Code debe ejecutarse dentro de una ventana de tmux para poder escribir y aprobar desde la web.
• Instalación del Agent: ejecute en la terminal del Mac del desarrollador (dentro de la red interna) el comando de una línea que el administrador genera en la web con Administración › Hosts › «Agregar host». El código de registro solo se puede usar una vez y en un plazo de 15 minutos.

# Forma del comando que genera «Agregar host» (la dirección y el código son los que muestra la pantalla)
curl -fsSL <dirección del servidor>/agent/install.sh | bash -s -- --code XXXX-XXXX

El script de instalación verifica el ejecutable, lo registra, lo deja residente con launchd, configura los hooks de Claude Code y, por último, hace una comprobación. A partir de ahí, el Agent se actualiza con «Actualizar ahora» desde la web.

2. Ver sesiones

La lista de sesiones muestra las sesiones de todos los Mac ordenadas por estado.

Al pulsar una sesión se abre su conversación. La conversación, las llamadas a herramientas y sus resultados se van acumulando en tiempo real en el mismo orden que en la terminal, y si se ha desplazado hacia arriba para leer, conserva su posición aunque lleguen mensajes nuevos (vuelva al final con el botón «Mensajes nuevos»).

3. Aprobaciones · preguntas

• Solicitud de permiso: «Permitir» · «Permitir siempre este comando» · «Denegar». «Permitir siempre» solo guarda la regla que propone Claude (normalmente, ese único comando). Si le resulta molesto que pregunte por cada comando, cambie el modo de permisos a «Automático».
• Preguntas de Claude: en la tarjeta de pregunta, elija opciones (una o varias) o escriba su respuesta y pulse «Enviar respuesta». Si hay varias preguntas, debe responderlas todas para poder enviar.
• El mismo diálogo aparece también en la terminal, y se aplica la primera respuesta.
• Los diálogos de confirmación que solo aparecen en la terminal (p. ej., «Background work is running» al ejecutar /exit o «Switch model?» al cambiar de modelo) también se muestran como una tarjeta «Pregunta en la terminal» y se responden desde la web.
• Las solicitudes pendientes se reúnen en la columna de notificaciones (en el móvil, la pestaña «Notificaciones»).

4. Prompts · archivos · interrupción

• Escriba en el campo de entrada y envíe (⌘/Ctrl+Enter). Los textos largos se envían tal cual, y el campo de entrada solo se vacía cuando llega la confirmación del envío.
• Los archivos que arrastre o pegue en el campo de entrada se suben a uploads/ en la carpeta de la sesión, y se inserta @ruta en el campo. También puede elegir una carpeta con el botón de adjuntar y subirlos allí.
• «Interrumpir» equivale a Esc en la terminal. Los comandos como /compact·/clear se envían con los botones rápidos.

5. Nueva sesión · Reanudar

1. En «Nueva sesión», elija el Mac (host) · la cuenta · el modelo · el effort · la carpeta del proyecto · el modo de permisos. Solo se pueden abrir carpetas dentro de las permitidas en ese Mac.
2. «Conversación nueva» o «Reanudar» (elegir una conversación terminada). La lista se lee del disco de ese Mac, así que también aparecen las conversaciones de carpetas que solo se usaban desde la terminal (la primera es la conversación más reciente, la misma que claude --continue). Al reanudar, se abre con el modo de permisos y el effort que usaba esa conversación.
3. Si reanuda con una cuenta distinta de la que guardó la conversación, el archivo de conversación se copia a esa cuenta y se continúa allí (el archivo de la cuenta original no cambia).

6. Modelo · effort · modo de permisos

• Se cambian con el botón «Modelo · effort» de la cabecera de la sesión. De forma predeterminada solo afecta a esa sesión; si activa «Guardar también como predeterminado para sesiones nuevas», también cambia el valor predeterminado de esa cuenta.
• Si cambia de modelo en mitad de una conversación, en el siguiente mensaje se vuelve a leer toda la conversación con el nuevo modelo, lo que es más lento y consume más tokens.
• Modos de permisos: Predeterminado (pregunta siempre) · Aceptar ediciones · Plan · Automático (solo pregunta lo que parece arriesgado) · Permitir todo (solo en carpetas de confianza).

7. Mover sesiones

Menú de la sesión › «Mover a otro host». Solo se mueven las sesiones que han terminado en el Mac de origen.

• Mueva solo la conversación o también la carpeta de trabajo. La carpeta de trabajo se empaqueta sin las carpetas regenerables como node_modules·target, pasa por el servidor y se extrae en una carpeta vacía del Mac de destino.
• Siga los pasos con la barra de progreso (exportar → empaquetar → subir → recibir → extraer → reanudar). El proceso sigue aunque cierre la web y, al volver, verá el progreso.
• Lo habitual es sincronizar el código con git. La ventana de mover compara y muestra el estado de git de los dos Mac.

8. Explorador de archivos

• Abra la carpeta de la sesión con «Archivos» en la cabecera de la sesión. Admite pestañas · vista lado a lado · vista previa de Markdown · vista previa de imágenes.
• Para editar, desbloquee, modifique y pulse ⌘+S. Si mientras tanto Claude ha modificado el mismo archivo, se le avisa del conflicto.
• Puede cambiar nombre · duplicar · eliminar. Eliminar solo mueve a la papelera, y no se escribe en .git·.claude.
• Si en Configuración › Este navegador › «Abrir explorador de archivos» elige «En una ventana nueva», «Archivos» se abre en una ventana aparte y puede ver los archivos mientras sigue la conversación.

9. Tareas · uso

• Tareas: vea, a través de todas las sesiones, los agentes en segundo plano y los flujos de trabajo en ejecución, y los que terminaron en las últimas 24 horas.
• Uso: elija periodo · cuenta · host y compare con el periodo anterior el costo estimado · las solicitudes · los tokens de salida · los aciertos de caché. Incluye los límites de la cuenta (5 horas · semanal · semanal por modelo) con la previsión al ritmo actual, barras diarias por modelo, clasificaciones por proyecto · sesión y un mapa de calor de día de la semana × hora.
• El costo es una estimación según los precios de la API. No es la cuota de suscripción.

10. Administración · configuración

• Hosts: estado de conexión · versión · métricas, «Agregar host» · dar de baja, «Actualizar ahora» del Agent.
• Cuentas · Uso: estado de inicio de sesión de las cuentas de Claude · Ollama en cada Mac, e inicio · cierre de sesión desde la web.
• Modelos: activar · desactivar los modelos disponibles y el modelo predeterminado de cada tipo.
• Copias de seguridad: el Agent sube el historial de conversaciones de cada Mac al servidor de la empresa cada 10 minutos. Tamaño del archivo del servidor · espacio libre en disco, estado de las copias por host y «Hacer copia ahora», búsqueda de conversaciones respaldadas y «Restaurar» (administradores). Las conversaciones restauradas se abren con Nueva sesión › Reanudar.
• Configuración: ajustes del servidor, como el límite de vista previa de archivos · los periodos de retención (administradores), y ajustes de este navegador, como el tema · el editor.

11. En el móvil · en el escritorio

Móvil: en Safari, use «Añadir a pantalla de inicio» para abrirla como una app y muévase con las pestañas inferiores (sesiones · notificaciones · tareas · uso · administración). Desde la pestaña de notificaciones, las aprobaciones y preguntas llevan directamente a la sesión con «Responder en la sesión».

Escritorio: la lista de sesiones · la conversación · las notificaciones se ven en tres columnas. Las columnas laterales pueden contraerse a líneas de resumen · filas de iconos (este navegador lo recuerda), y el explorador de archivos abre dos archivos uno al lado del otro. Si arrastra un archivo al área de la conversación, se sube al instante.

12. Terminal web

Abra desde la web el shell del Mac del desarrollador (Administración › Hosts › «Terminal») y la pantalla tmux real de una sesión de claude (menú de la sesión › «Ver en la terminal»). Como es un shell con los permisos del usuario de ese Mac, su uso tiene condiciones.

• Debe activarse directamente en ese Mac — no se puede activar desde la web. Al desactivarla, también se cierran las terminales abiertas.
• Solo para administradores, y cada vez que se abre se vuelve a verificar el OTP. La apertura · el cierre · la duración · el número de bytes quedan en el registro de auditoría, pero no el contenido de lo tecleado. Se cierra tras 30 minutos sin actividad.
• En el escritorio se abre en una ventana aparte (Configuración › Este navegador › «Abrir terminal web»). Aunque cierre o recargue la ventana de la consola, la terminal sigue igual.
• Vea la salida anterior con la rueda · deslizando · PgUp/PgDn · Shift+PageUp, y vuelva a la pantalla normal pulsando cualquier tecla. Al seleccionar arrastrando se copia al instante; ⌘+K borra la pantalla y la salida anterior, y ⌘+L solo la pantalla.
• El número de líneas de salida anterior que se recuerdan se define en Configuración › «Terminal web › Líneas de historial» (10.000 líneas de forma predeterminada).

# En la terminal de ese Mac — activar · desactivar · estado
~/.ssemtong/bin/ssemtong-agent terminal on
~/.ssemtong/bin/ssemtong-agent terminal off
~/.ssemtong/bin/ssemtong-agent terminal status

13. Lista de prompts

• En «Prompts» de la columna derecha (en el móvil, la pestaña «Notificaciones») solo aparece lo que una persona escribió en esa sesión, de lo más reciente a lo más antiguo — número · hora · primeras tres líneas; al pulsar, el texto completo.
• El botón ↳ salta a ese prompt en la conversación y lo resalta un momento. Mientras lee desde ahí, la pantalla no se desplaza hacia abajo aunque llegue nueva salida; vuelva con el botón «Ir al final».
• Si elige un prompt anterior que aún no se ha cargado en pantalla, se carga del servidor la conversación de alrededor y se salta a él; siga leyendo con «Cargar la conversación siguiente».

14. Idioma

La consola web está disponible en coreano · inglés · japonés · chino simplificado · francés · español · indonesio · vietnamita · jemer · árabe. Elija el idioma con el botón 🌐 de la parte superior (en la pantalla de inicio de sesión, en la parte inferior) o en Configuración › Este navegador › «Idioma». Al principio sigue el idioma del navegador, y ese navegador recuerda el idioma elegido. Algunos avisos que envían el servidor · el Agent todavía se muestran en coreano.