Verentia · Label Grup

Victoria en tu ordenador

Guía para instalar y usar a Victoria en tu propio equipo, trabajando con tus archivos de Office y conectada al cerebro compartido de Verentia.

Qué es esto

Hasta ahora usabas a Victoria entrando por VS Code (Remote-SSH) al servidor. El problema: en el servidor no puedes crear PowerPoints ni trabajar con archivos de Office de verdad, y tus archivos viven en tu ordenador.

Con esta instalación, Victoria corre en tu propio ordenador (donde está PowerPoint, Word y tus archivos) y sigue conectada al cerebro compartido de Verentia en el servidor. Lo mejor de los dos mundos:

Antes de empezar

VPN de LabelGrup activaLa misma que usas para conectarte por Remote-SSH. Si no está activa, nada funciona.
Tu Remote-SSH ya funcionaYa entras al servidor de Verentia desde VS Code. La instalación reutiliza esa misma conexión y tu clave — no hay que crear claves nuevas.
Windows 10 o 11Con el cliente OpenSSH activado (viene de serie). VS Code instalado.
Tu cuenta de ClaudeLa misma con la que usas Claude Code hoy. La sesión se inicia la primera vez desde el navegador.

1Instalar

Abre PowerShell (menú Inicio → escribe PowerShell → Enter) con la VPN activa, y pega esta línea:

irm https://victoria-verentia.pages.dev/instalar-victoria.ps1 | iex

El instalador hace todo solo: comprueba la conexión, instala Claude Code si te falta, crea la carpeta Victoria en tu Escritorio y descarga a Victoria conectada al cerebro.

Si prefieres no pegar la línea: descarga el archivo, haz clic derecho sobre él → Ejecutar con PowerShell.
La primera vez, si no detecta tu acceso al servidor, el instalador te lo crea solo: te mostrará tu clave y te pedirá confirmar tu usuario. Solo tienes que pulsar Enter.

Si te pide una contraseña

La conexión al servidor debe entrar con tu clave privada, sin contraseña. Si en algún momento ves algo como ...@claude.verentia.com's password:, es que no está usando tu clave.

Opción A — usa tu acceso de VS Code (lo más rápido)

Como ya te conectas al servidor desde VS Code, prueba si ese acceso ya sirve. En PowerShell:

ssh claude.verentia.com whoami

Si responde tu usuario (p. ej. jarubio) sin pedir contraseña, no necesitas nada más: vuelve a ejecutar la línea de instalación (paso 1) y listo.

Si en cambio te pide contraseña, pasa a la Opción B.

Opción B — crea el acceso «verentia» (una sola vez)

  1. En PowerShell, pega esto cambiando TU_USUARIO por tu usuario del servidor (p. ej. jarubio) y TU_CLAVE por el nombre de tu archivo de clave dentro de la carpeta .ssh (p. ej. jarubio_id_ed25519):
    Add-Content -Path "$env:USERPROFILE\.ssh\config" -Value @"
    
    Host verentia
        HostName claude.verentia.com
        User TU_USUARIO
        Port 1980
        IdentityFile $env:USERPROFILE\.ssh\TU_CLAVE
        IdentitiesOnly yes
    "@
  2. Comprueba que entra sin pedir contraseña (responde yes si pregunta la primera vez):
    ssh verentia whoami
    Debe imprimir tu usuario (p. ej. jarubio). Si es así, ¡ya está lo difícil!
  3. Vuelve a ejecutar la línea de instalación del paso 1. Ahora detecta verentia sola y no te pregunta nada:
    irm https://victoria-verentia.pages.dev/instalar-victoria.ps1 | iex
¿No sabes tu usuario del servidor? Es el que devuelve ssh claude.verentia.com whoami. Si eso te pide contraseña, míralo en tu configuración con:
Get-Content $env:USERPROFILE\.ssh\config | Select-String "User "
Te mostrará la línea User tu-usuario (por ejemplo User jarubio). También aparece en VS Code, arriba, como tu-usuario@claude.verentia.com.
¿No sabes el nombre de tu clave? Míralo con dir $env:USERPROFILE\.ssh: es el archivo sin extensión .pub (el .pub es la pública, no esa).

2Abrir Victoria

Este es el punto clave: Victoria se abre en una ventana de VS Code de tu propio ordenador, NO en la de Remote-SSH.

  1. Abre VS Code en tu ordenador. Debe ser una ventana normal: si abajo a la izquierda pone el nombre del servidor (en verde: SSH: …), esa NO es — cierra esa conexión o abre una ventana nueva.
  2. Menú Archivo → Abrir carpeta… y elige la carpeta Victoria de tu Escritorio.
  3. Abre la terminal: menú Terminal → Nueva terminal.
  4. Escribe claude y pulsa Enter.
  5. Solo la primera vez: inicia sesión (se abre el navegador) y, cuando pregunte, aprueba el servidor victoria-cerebro.
  6. Salúdala: escribe «Hola, ¿quién eres?». Debe responder que es Victoria.
Regla para recordar: para trabajar con Victoria, abre Claude dentro de la carpeta «Victoria» de tu Escritorio. Ahí caerán los archivos que cree.

3Usarla en el día a día

Le hablas normal, en tu idioma. Ella decide cuándo mirar el cerebro compartido y cuándo trabajar con tus archivos locales.

Sacar conocimiento del cerebro

Traer archivos del cerebro a tu equipo (y subirlos)

Victoria puede descargar archivos reales del cerebro a tu carpeta Victoria —no solo texto, también PowerPoint, Excel o Word— y subir los tuyos. Ella localiza la ruta en el cerebro y hace la transferencia sola.

Crear entregables en tu equipo

Guardar en el cerebro (compartir con el equipo)

Sobre los PowerPoint: Victoria prepara siempre el contenido y la estructura de las diapositivas. Para que genere el archivo .pptx listo para abrir, tu equipo necesita una pieza extra instalada (Python). Si al pedir un PowerPoint te entrega la estructura en texto en lugar del archivo, es que falta esa pieza: avisa a Emilio y se activa para que los .pptx salgan automáticos.
Principio de Victoria: ante la duda, pregunta antes de asumir. Si no encuentra algo en el cerebro, te lo dice — no inventa datos de un cliente.

4Mantenerla al día

Cuando se mejore a Victoria en el servidor (identidad u operadores), actualiza tu copia local. Dos formas:

Si algo no va

SíntomaQué mirar
«No conecto al VPS» durante la instalaciónLa VPN de LabelGrup no está activa, o tu Remote-SSH no funciona hoy. Actívala y reintenta.
Al abrir claude no aparece Victoria¿Estás en la carpeta «Victoria»? ¿La ventana de VS Code es local (no Remote-SSH)? Cierra y abre claude de nuevo.
No aparece el cerebro / herramientas de búsquedaLa primera vez hay que aprobar el servidor victoria-cerebro. Escribe /mcp en Claude para revisarlo.
claude no se reconoce tras instalarEstá instalado pero VS Code aún no ve el PATH nuevo. Cierra VS Code del todo (entero, no solo la ventana) y vuelve a abrirlo. Rápido en la misma terminal: $env:PATH = "$env:USERPROFILE\.local\bin;$env:PATH" y luego claude. Para comprobar que está: & "$env:USERPROFILE\.local\bin\claude.exe" --version.
ssh no se reconoceActiva el «Cliente de OpenSSH» en Configuración → Aplicaciones → Características opcionales.

Si sigue sin ir, contacta con Emilio.

¿Usas Mac? (solo Emilio)

En Terminal, con la VPN activa:

curl -fsSL https://victoria-verentia.pages.dev/instalar-victoria.sh | bash

Mismo resultado: carpeta Victoria en el Escritorio, Claude Code instalado y el cerebro conectado por MCP.