⚙️Ajustes y claves

Todo se configura desde Ajustes; no hace falta editar ningún archivo.

Cambiar aquí la zona horaria no cambia el reloj del servidor: ejecuta también timedatectl set-timezone <Zone> && systemctl restart cron, para que las tareas programadas la sigan (consulta Crons).

Instalar la app

Harness Maxxing se instala como una app (su propia ventana, un icono en el Dock, la barra de tareas o la pantalla de inicio, pantalla completa en el móvil). Dos lugares: Instalar la app en el menú de la cuenta (el icono de persona en la parte inferior de la barra lateral; en un móvil, en el menú ⊞) y Ajustes -> General -> App.

• Chrome, Edge (ordenador o Android): un clic cuando el navegador lo ofrece; si no, el botón muestra los pasos (el icono de instalación al final de la barra de direcciones, o el menú del navegador).
• Safari en un Mac (macOS 14 o posterior): Archivo -> Añadir al Dock.
• iPhone / iPad: el botón Compartir de Safari -> Añadir a pantalla de inicio.
• Firefox no puede instalar apps web en un ordenador: usa Chrome, Edge o Safari.
• La tarjeta App muestra un código QR de la dirección: escanéalo con el móvil, inicia sesión y luego añádela a la pantalla de inicio.
• Para instalar hace falta la dirección https (acceso por dominio). Con Tailscale (http://100.x.y.z:8787) los navegadores no lo ofrecen.

En un móvil o una tableta

Los móviles y las tabletas usan el diseño táctil (Ajustes -> General -> Diseño lo cambia por dispositivo): sin barra lateral, sin barra en la parte inferior, la conversación ocupa toda la pantalla. Hay dos botones en la parte superior de cada pantalla: - ☰ (arriba a la izquierda) abre tus sesiones - consulta Sesiones. Su contador muestra las respuestas sin leer. - ⊞ (arriba a la derecha) abre todo lo demás: un campo de búsqueda (el mismo que ⌘K), todas las páginas (Panel, Sesiones, Archivos, Tareas, Crons, Notificaciones, Git e Infra cuando están activados, Extensiones y páginas fijadas), la actualización pendiente, el estado de salud del servidor, el uso de tu plan de Claude, el tema, el modo presentación, Ajustes, Ayuda (recorrido, tutorial, documentación) y Cerrar sesión. Un punto en ⊞ significa que hay una actualización pendiente o que el servidor necesita atención.

Además: - En la app instalada, desliza desde el borde izquierdo para abrir las sesiones y desde el borde derecho para abrir el menú; desliza un cajón de vuelta hacia su borde para cerrarlo. - Los paneles que suben desde la parte inferior se cierran deslizando hacia abajo (desde su asa, su título o su contenido cuando está desplazado hasta arriba), o tocando la zona atenuada que hay encima. - Los botones de micrófono y de enviar son más grandes; mientras escribes, los paneles se quedan por encima del teclado. - La página no hace zoom (ni pellizco ni doble toque), como una app nativa; los campos nunca hacen que el iPhone amplíe la pantalla.

Autenticación de Claude

Tres maneras, de la mejor a la menos buena: 1. Token de larga duración: ejecuta claude setup-token en cualquier ordenador con navegador y pega el token. 2. Clave de API de la consola de Anthropic (se factura por uso). 3. Inicio de sesión de la CLI hecho en el servidor (claude, luego /login): se detecta automáticamente.

Probar hace una llamada real de una línea y muestra el modelo y la latencia.

Los turnos inician Claude sin su comprobación de actualizaciones, sin telemetría y sin la descarga de indicadores de funciones (arranque más rápido, prompt más corto); "claude_quiet_start": false en config.json lo desactiva.

Claude ejecuta sus agentes auxiliares en primer plano: recibes su resultado en el mismo turno (varios agentes siguen ejecutándose en paralelo). El hábito propio de Claude Code es enviarlos a segundo plano, donde el turno espera a que informen, lo cual es más lento; "background_agents": true en config.json vuelve a ese comportamiento. Siempre puedes pedirle a Claude un agente en segundo plano en tu mensaje.

Actualizaciones de Claude Code

Actualizar Claude Code automáticamente (desactivado por defecto): cada 6 horas el servidor busca una versión estable más reciente de Claude Code (la que Anthropic marca como estable: ya usada durante algunos días, no la última de todas). Cuando hay una, la instala él mismo - pero solo cuando no hay nada en marcha: ningún turno de conversación, ningún mensaje esperando en una cola, ninguna tarea programada, y el último turno terminó hace más de 10 minutos. Si no, espera y lo vuelve a intentar unos minutos después, de modo que una actualización nunca corta un turno, y un turno que empieza durante la actualización la espera (la conversación lo indica; como máximo 7 minutos). Solo lo hace el servidor instalado: un segundo Harness Maxxing iniciado en la misma máquina para desarrollo o pruebas nunca actualiza el Claude Code de la máquina. Funciona con el instalador oficial y con una instalación global de npm (cualquier otro tipo de instalación se deja como está). Si la nueva versión no arranca, se restaura la anterior.

Cada actualización aparece en las notificaciones («Claude Code actualizado a 2.1.5»), y el interruptor muestra la última (2.1.4 -> 2.1.5 y su fecha). Un fallo también se notifica, una vez por versión, con el motivo; el servidor lo intenta de nuevo 6 horas después. Deja el interruptor desactivado para actualizar a mano (claude update en un terminal); entonces maxxing doctor indica Claude Code bajo claude_version cuando está desactualizado.

Modo de permisos

Un tema puede tener su propio modo (lista de sesiones -> menú del tema -> Permisos), y también una tarea programada de Claude (Modo de permisos en el editor de tareas): usa un modo más estricto cuando Claude lee contenido del exterior - páginas web, correos, mensajes reenviados - para que las instrucciones ocultas en ese contenido no puedan hacerle hacer cualquier cosa. Orden: el modo de la tarea, si no el del tema, si no este modo global.

Proteger los secretos (activado por defecto): en todos los modos, las herramientas de Claude se niegan a leer o editar los secretos del servidor (secrets.json) y las claves SSH (~/.ssh). Esto evita que una instrucción oculta simplemente los lea; un script escrito a propósito para abrir el archivo no se detiene, así que no sustituye a un modo más estricto. Más reglas: claude_deny en config.json (sintaxis de reglas de Claude Code, por ejemplo "Bash(rm -rf:*)").

Consulta Seguridad.

Claves (bóveda de secretos)

Guarda las claves de API y los tokens que necesitan tus proyectos (por ejemplo OPENAI_API_KEY, SHOP_TOKEN):

• los nombres van en MAYÚSCULAS (A-Z, dígitos, _), los valores están ocultos y solo se muestran con Revelar;
• añade una nota (para qué sirve, de dónde viene);
• Exponer hace que el secreto esté disponible como variable de entorno para todas las sesiones de Claude y todas las tareas cron de shell – útil para scripts, y Claude nunca necesita ver el valor en un chat;
• algunos nombres están reservados (variables del sistema, variables que hacen que shells, Node, Python o git carguen código - NODE_OPTIONS, BASH_ENV, GIT_SSH_COMMAND... -, ANTHROPIC_BASE_URL, cualquier nombre que empiece por MAXXING_); una clave existente con un nombre así se conserva pero ya no se expone.

Desde scripts y sesiones: maxxing keys list|get|set|delete (el valor de set se lee desde stdin) - un script que renueva un token escribe así el nuevo valor. Los scripts leen las claves del entorno (os.environ["NAME"]), nunca de un archivo propio.

Escribe solo el nombre de la clave en los archivos de memoria («API de la tienda: clave SHOP_TOKEN»). Las extensiones leen las claves con ctx["secret"]("NAME").

Las claves viven en /var/lib/claude-maxxing/secrets.json (modo 600) y no se incluyen en la copia de seguridad.