Configurar Lumi: búsqueda local, CLI y API personalizadas
Encuentra primero un archivo local. Después conecta un CLI, un modelo local o una API y verifica la respuesta completa, el modelo real y la cuenta que registra el uso.
Índice
En Lumi, buscar archivos y hacer preguntas a la IA son operaciones distintas. La búsqueda consulta el índice del sistema; la pregunta se envía al CLI o a la API que selecciones. Empieza por encontrar un archivo conocido, configura una sola conexión, envía una pregunta breve sin datos privados y comprueba el modelo y el consumo. Encontrar un documento no significa que la IA lo haya leído. El nombre de un CLI en el menú tampoco demuestra que la solicitud utilice la cuota de una suscripción.
La interfaz y el comportamiento descritos corresponden a esta revisión concreta de Lumi. En otras versiones pueden cambiar los controles o el menú. Copia los identificadores de modelos del servicio actual, no de un menú antiguo.
Instala Lumi y comprueba primero la búsqueda
Descarga la versión de tu sistema desde los Releases del proyecto. En macOS, abre el DMG y arrastra Lumi a Applications; Windows ofrece instalador y versión portátil. Si aparece una advertencia de firma o seguridad, comprueba el origen del archivo y la política de tu organización antes de continuar. No desactives la protección de todo el sistema. Consulta las instrucciones de macOS y Windows.
El atajo predeterminado es Option más la tecla física situada justo a la izquierda del 1 en macOS, o Alt más esa tecla en Windows. Su carácter depende de la distribución del teclado. Si hay un conflicto, cambia el atajo con Change en la ventana de bienvenida. Los nombres de los campos que siguen corresponden a la interfaz en inglés.
Busca un archivo o una aplicación que sepas que existe y está indexado. Comprueba nombre y ruta, selecciona el resultado con las flechas y pulsa Enter para abrirlo. Option+Enter en macOS o Alt+Enter en Windows muestra el archivo seleccionado en Finder o el Explorador. No necesitas una API Key de modelo para esta comprobación. Mac usa Spotlight; Windows usa accesos directos del menú Inicio para aplicaciones y Windows Search para archivos. Si falta un archivo, revisa el índice y su alcance antes de cambiar de modelo. Búsqueda y atajos
Distingue los resultados locales del contenido enviado
Un resultado permite abrir un archivo o localizarlo; no adjunta automáticamente el documento a la conversación. Que el índice encuentre texto dentro de un archivo tampoco significa que el modelo reciba su contenido.
La conexión API personalizada normalmente envía una instrucción de sistema, el historial del diálogo y la pregunta nueva. Los modelos Ollama incluidos de la familia lumi tienen una variante que omite la instrucción de sistema. La estructura de la solicitud no incorpora automáticamente todos los resultados ni el contenido de archivos arbitrarios. El texto que pegues, la conversación previa y el tratamiento por parte del servicio elegido siguen necesitando una decisión de privacidad. Construcción de la solicitud
Los CLI tampoco comparten los mismos límites. Claude se inicia en la carpeta personal y Lumi especifica WebSearch,WebFetch. Codex utiliza un directorio propio, --sandbox read-only y una instrucción de no ejecutar comandos ni leer archivos. Gemini utiliza su directorio y --approval-mode plan. Un directorio, una zona aislada y una instrucción escrita son controles distintos: no prueban que el proceso no pueda leer otra configuración o conectarse a la red. Los CLI conservan su autenticación y configuración. macOS hereda el entorno y ajusta PATH; Windows tampoco borra las variables de autenticación. Implementación macOS; implementación Windows
Elige la conexión y la cuenta responsable del consumo
| Lo que ya tienes | Por dónde empezar | Qué comprobar |
|---|---|---|
| Un CLI instalado y acceso válido con tu cuenta | Claude, Codex o Gemini CLI | Autenticación activa y cuenta cuya cuota o factura registra la solicitud |
| Un modelo descargado para ejecutarlo en tu equipo | Servidor local Ollama o LM Studio | Modelo cargado, equipo de ejecución y posibles reenvíos a la nube; también se usan hardware y electricidad |
| Un modelo externo y una cuenta API concreta | API personalizada | Endpoint, clave, Model ID exacto y consumo o saldo de esa cuenta |
Es una decisión de configuración, no una clasificación por precio. Suscripción, consumo adicional medido y recursos locales son partidas diferentes. No afirmes que una opción sale más barata sin comprobar sus requisitos de suscripción, consumo y recarga.
Con un CLI existente, verifica primero la autenticación
Prepara solo el CLI que vayas a utilizar. Para Claude, ejecuta claude, completa el inicio de sesión oficial y consulta /status en la interfaz interactiva. Presta atención a ANTHROPIC_API_KEY: la documentación indica que una clave presente se utiliza en modo no interactivo -p, y existen métodos con prioridad superior. Lumi invoca Claude con -p. Por eso, ver una suscripción en una sesión interactiva no demuestra cómo se cobra la solicitud desde Lumi. Revisa el entorno que hereda Lumi y el consumo resultante sin mostrar el valor de la clave. Prioridad de autenticación de Claude
Con Codex, utiliza codex login y después codex login status. OpenAI distingue el acceso mediante suscripción ChatGPT del uso de API Key facturado por consumo. Revisa también cualquier custom provider ya configurado: la etiqueta Codex de Lumi no identifica el servicio real. Autenticación de Codex
Con Gemini, ejecuta gemini y elige Sign in with Google cuando ese sea el método deseado. El inicio de sesión de Google, una Gemini API Key y Vertex AI son vías distintas. Una ejecución sin interfaz puede reutilizar credenciales guardadas, pero no se convierte automáticamente en un plan de suscripción determinado. Autenticación de Gemini
Vuelve a Lumi y selecciona ese CLI en el menú de modelos. Tras cambiar la autenticación o el entorno de inicio, cierra Lumi y vuelve a abrirlo. Siguen vigentes las restricciones de cuenta, región y organización del proveedor. Ni Lumi ni otra conexión API eliminan las restricciones de acceso de un servicio distinto.
Guarda la conexión local o la API externa
Sal de cualquier respuesta y vuelve al campo vacío antes de abrir Connect a model…. En Service, selecciona Ollama, LM Studio u Other address. Completa Name, Address, Model y API key, pulsa Connect y confirma que el menú ha seleccionado la conexión guardada. Formulario
Address contiene la Base URL, no el endpoint completo. Lumi añade /chat/completions por su cuenta. Pegar la ruta completa provoca su duplicación. Name es una etiqueta para reconocer la conexión; Model debe ser el identificador exacto que admite el servidor.
| Destino | Ejemplo de Address | Modelo y clave |
|---|---|---|
| Ollama local | http://localhost:11434/v1 | Nombre de un modelo local realmente descargado; el servidor local estándar no requiere una clave de nube |
| LM Studio local | http://localhost:1234/v1 | Identificador de LM Studio; añade la credencial del servidor si tiene autenticación activada |
| Conexión BetterToken | https://www.bettertoken.ai/v1 | Tu API Key y un Model ID vigente copiado de model plaza o Key Setup |
Inicia primero el servidor de Ollama o LM Studio y prepara un modelo utilizable. Los puertos de la tabla son los valores de los ejemplos oficiales; usa los tuyos si los cambiaste. localhost indica únicamente el primer destino de red. Para trabajar sin conexión, verifica dónde se ejecutan los pesos y que el servidor no reenvíe la solicitud a un modelo en la nube. API de Ollama; servidor y API de LM Studio
BetterToken es aquí una cuenta API opcional, no otro modo de iniciar sesión con una suscripción CLI. Comprueba que puedes utilizar el servicio, crea una clave en tu propia cuenta siguiendo la configuración actual, y revisa saldo o cuota y disponibilidad del modelo. YOUR_API_KEY y YOUR_MODEL_ID son marcadores que debes sustituir. Introduce la clave real en el campo oculto, nunca en preguntas, capturas o registros. La documentación indica actualmente Rusia como región de servicio; si estás en otro lugar, confirma primero con el servicio que tu cuenta puede utilizarlo.
La tabla de entradas para desarrolladores de la documentación BetterToken incluye https://www.bettertoken.ai/v1. Al añadir la ruta de Lumi resulta https://www.bettertoken.ai/v1/chat/completions, correspondiente a Chat Completions. Es una configuración deducida del formato de la solicitud, no una prueba de funcionamiento de extremo a extremo con tu cuenta ni una garantía para todas las funciones. Guardar esta conexión no modifica el provider del CLI existente.
Comprueba una respuesta completa y su consumo
Abre una conversación vacía, selecciona la conexión y pregunta: «Convierte 2.5 pulgadas a centímetros. Responde en una frase sin buscar en la web». Envía con Cmd+Enter en macOS o Ctrl+Enter en Windows para no abrir por error un archivo seleccionado con Enter. Ask in ChatGPT, Cmd+Shift+Enter y Ctrl+Shift+Enter llevan al navegador, no a esta prueba de API. Acciones del teclado
Espera a que termine la respuesta: el resultado esperado es 6,35 centímetros. Con la entrada vacía y sin texto seleccionado, copia la respuesta completa con Cmd+C o Ctrl+C. Guárdala de forma privada junto con la hora y el nombre de la conexión, sin la clave. La conversión correcta solo verifica el contenido. Debes confirmar por separado el resultado local visible, la respuesta completa, el provider/model real y el consumo de la cuenta prevista.
Para la API, compara la solicitud con sus registros de uso. El Dashboard de BetterToken muestra solicitudes, consumo de tokens y saldo. Para un CLI, revisa la cuota o factura API de la cuenta autenticada. Para inferencia local, comprueba el registro del servidor y el modelo cargado en lugar de buscar un cargo en la nube. Si solo tienes consumo agregado, sin evidencia del modelo por solicitud, deja ese dato como no confirmado. La identidad que afirma el propio modelo no es una prueba. Control de uso BetterToken
Localiza el fallo antes de repetir
Pulsa Esc para detener una respuesta activa y otra vez Esc para salir de la respuesta o del error. En esta versión, cambiar de modelo después de un fallo, o pulsar Enter con la entrada vacía, puede reenviar la pregunta anterior. Sal del estado de error antes de cambiar de conexión para evitar un reintento involuntario o enviar la pregunta a otro servicio. Detener el cliente no demuestra que el servidor no haya consumido recursos facturables. Reintento y salida
| Síntoma | Siguiente comprobación |
|---|---|
| Aparecen aplicaciones, pero falta un archivo | Revisar el índice y su alcance; no cambiar la API Key |
| CLI no encontrado o acceso fallido | Hacer funcionar ese CLI mediante su proceso oficial en terminal y comprobar qué ejecutable encuentra Lumi |
401 o 403 | Leer el cuerpo del error y distinguir credenciales de políticas de red, región u organización |
404 o modelo desconocido | Eliminar un /chat/completions duplicado, comprobar el Model ID y que el modelo local esté preparado |
429 o cuota agotada | Revisar cuota, saldo y límites; seguir las instrucciones de reintento del servidor, sin bucles |
HTTP 200 con salida vacía, incompleta o con error | Revisar todo el flujo y el error final; aceptar la solicitud no equivale a responder correctamente |
El runner de API detecta errores dentro del flujo y respuestas vacías. Ver algunas palabras no basta. Corrige una causa identificada, envía una sola pregunta nueva y repite las cuatro comprobaciones. Gestión de errores
Antes de usar la conexión a diario, haz funcionar una búsqueda de archivo normal y una pregunta sin datos privados, sabiendo quién la procesa y dónde se registra el consumo.
