Guía operativa

Modo interactivo y Equivalente CLI

Glosa Desktop tiene dos modos de uso bajo el mismo techo: la UI tradicional que ya conoces y un Terminal Glosa interactivo que opera los mismos agentes desde una sesión de PowerShell. Esta guía explica cuándo usar cada uno y por qué la diferencia importa para tu plan de Claude.

TL;DR

  • UI tradicional: la pantalla que abres con doble clic. Default para todo. Botón “Procesar” en cada vista.
  • Terminal Glosa: ventana de PowerShell con glosa interactive ya en ejecución. Operas los mismos agentes con un menú numerado.
  • Misma materialidad probatoria en ambos modos: hash SHA-256, audit trail, datos del cliente nunca salen del equipo.
  • Diferencia operativa: el modo interactivo consume tu suscripción Claude sin pasar por el Pool de Agentes.

Qué es el modo interactivo

Cuando el operador da clic en ⚡ Terminal Glosa en la barra lateral de Glosa Desktop, se abre una ventana de PowerShell que ejecuta automáticamente glosa interactive. Esta es una interfaz de menús numerados que cubre los mismos 13 agentes que la UI: seleccionas uno, contestas las preguntas que te hace (ruta del expediente, régimen, certificado, etc.), y Claude ejecuta la skill localmente.

La interacción es manual: tú escribes, presionas ENTER, lees la respuesta y sigues. No hay automatización oculta — esa cadencia humana es lo que califica como uso interactivo legítimo ante Anthropic, en contraste con el modo programático que la UI usa internamente.

Cuándo usar cada modo

UI tradicional (default)

Usa la UI cuando…

  • Es tu primer mes operando Glosa y aún estás aprendiendo el flujo
  • Procesas volumen normal (5–30 expedientes/mes por operador)
  • Necesitas las vistas ricas (validar CoO, auditoría forense): formularios con descripción de cada TLC, banners de Art. 184 LA, etc.
  • Quieres el bloque “Equivalente CLI” debajo de cada vista para copiar el comando exacto

Terminal Glosa

Usa el Terminal cuando…

  • Procesas volumen alto y quieres maximizar tu suscripción Claude sin tocar el Pool de Agentes
  • Ya conoces los flujos de memoria y prefieres operar con teclado
  • Quieres ejecutar varios agentes seguidos en una sola sesión de Claude
  • Estás en escenario de defensa SAT y quieres dejar evidencia de cadencia humana paso a paso

Impacto en tu plan de Claude

Anthropic separa desde el 15 de junio de 2026 el uso programático (un script que invoca Claude vía SDK) del uso interactivo (un humano que escribe y presiona ENTER en una terminal). El programático cae en el Pool de Agentes, que tiene cuota y precios separados. El interactivo sigue consumiendo tu suscripción Pro/Max normal sin cuotas adicionales.

ModoMecánicaCómo se factura
UI tradicionalClick en “Procesar” → backend llama a Claude vía SDKCuenta contra Pool de Agentes de Claude
Terminal GlosaHumano escribe en PowerShell, Claude responde en la misma terminalCuenta contra tu suscripción Pro/Max normal

Es decisión tuya cuándo apoyarte en cada uno. Si tu volumen cabe en el Pool, la UI es más cómoda. Si el Pool empieza a quedarte corto, el Terminal te da un canal adicional sin contratar más suscripciones.

Equivalente CLI debajo de cada vista

Algunas vistas de la UI (las que tienen Opus verify) muestran al final un bloque “Equivalente CLI” con el comando exacto que el botón “Procesar” va a ejecutar. Por ejemplo, en “Validar Certificado de Origen”:

$ glosa validar-coo --expediente C:\Glosa\expedientes\EXP-001 --tlc TMEC

El bloque ofrece dos botones:

  • 📋 Copiar — el comando va al clipboard y lo pegas donde quieras (PowerShell propio, script, Notion, etc.)
  • ▶ Abrir en terminal — Glosa abre PowerShell externo con el comando ya pre-cargado, listo para ejecutar presionando ENTER. Esto cae bajo modo interactivo automáticamente.

Equivalencia funcional total

Independientemente del modo, Glosa garantiza la misma salida:

  • Mismo expediente probatorio (PDFs firmados con SHA-256, audit trail completo)
  • Mismas alertas operativas (incompatibilidad CoO, NOMs faltantes, materialidad, etc.)
  • Misma persistencia en ~/.glosa/history.db (operaciones recientes en el sidebar derecho aparecen sin importar el modo)
  • Misma telemetría sanitizada al panel de tu agencia (ADR-0004 — datos fiscales nunca salen del equipo del operador)

¿Y el binario standalone glosa-cli.exe?

Para AAs técnicas que NO usan la UI de Glosa Desktop, publicamos glosa-cli.exe (14.5 MB, descarga en glosa.mx/downloads/glosa-cli.exe). Es el mismo motor del Terminal Glosa empaquetado como binario independiente: corre glosa interactive en cualquier PowerShell sin requerir Glosa Desktop. Útil para integradores y operadores avanzados.

Cómo abrir el Terminal Glosa

  1. Abre Glosa Desktop normalmente (doble clic en el acceso directo).
  2. En la barra lateral izquierda, sección Modos, da clic en ⚡ Terminal Glosa.
  3. Da clic en “▶ Abrir Terminal Glosa”. Se abrirá una ventana de PowerShell con glosa interactive en ejecución.
  4. Trabaja con el menú numerado. Para volver a la UI, simplemente cierra la ventana de PowerShell o regresa a Glosa Desktop.

Nota: la ventana de PowerShell es el shell nativo de Windows del operador, no una emulación dentro de Glosa.exe. Eso garantiza que Anthropic la trate como uso interactivo legítimo sin ambigüedad.

Ver también: Cómo invocar Glosa · Organización de carpetas · Documentos por expediente