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 interactiveya 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.
| Modo | Mecánica | Cómo se factura |
|---|---|---|
| UI tradicional | Click en “Procesar” → backend llama a Claude vía SDK | Cuenta contra Pool de Agentes de Claude |
| Terminal Glosa | Humano escribe en PowerShell, Claude responde en la misma terminal | Cuenta 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 TMECEl 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
- Abre Glosa Desktop normalmente (doble clic en el acceso directo).
- En la barra lateral izquierda, sección Modos, da clic en
⚡ Terminal Glosa. - Da clic en “▶ Abrir Terminal Glosa”. Se abrirá una ventana de PowerShell con
glosa interactiveen ejecución. - 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