Proveedores de IA

Los Genios de IA de VMark necesitan un proveedor de IA para generar sugerencias. Puedes usar una herramienta CLI instalada localmente o conectarte directamente a una API REST.

Configuración rápida

La forma más rápida de comenzar:

1. Abre Ajustes > Integraciones
2. Haz clic en Detectar para buscar herramientas CLI instaladas
3. Si se encuentra una CLI (por ejemplo, Claude, Gemini), selecciónala — ya está listo
4. Si no hay ninguna CLI disponible, elige un proveedor REST, introduce tu clave de API y selecciona un modelo

Solo puede haber un proveedor activo a la vez.

Proveedores CLI

Los proveedores CLI usan herramientas de IA instaladas localmente. VMark las ejecuta como subprocesos y transmite su salida de vuelta al editor.

Proveedor	Comando CLI	Instalación
Claude	claude	Claude Code
Codex	codex	OpenAI Codex CLI
Gemini	gemini	Google Gemini CLI

Cómo funciona la detección CLI

Haz clic en Detectar en Ajustes > Integraciones. VMark busca en tu $PATH cada comando CLI e informa sobre su disponibilidad. Si se encuentra una CLI, su botón de radio queda disponible para selección. Detectar vuelve a buscar cada vez que haces clic; la detección automática (al iniciar la app, al abrir Ajustes y en el selector de proveedor del selector de genios) reutiliza la última búsqueda. Al hacer clic en Detectar también se vuelve a leer el $PATH de tu shell de inicio de sesión, así que una CLI en un directorio que acabas de añadir a tu perfil de shell se encuentra sin reiniciar VMark; la detección automática usa el último $PATH leído. Si VMark nunca ha conseguido leer el $PATH de tu shell de inicio de sesión, busca en el $PATH heredado del programa que lo inició y, mientras falte alguna CLI, Ajustes muestra un aviso con la shell, el motivo y los directorios en los que buscó. Si la lectura falla al usar Detectar, se conserva cualquier $PATH leído correctamente antes.

Ventajas

• Sin clave de API — la CLI gestiona la autenticación usando tu inicio de sesión existente
• Mucho más barato — las herramientas CLI usan tu plan de suscripción (por ejemplo, Claude Max, ChatGPT Plus/Pro, Google One AI Premium), que tiene una tarifa mensual fija. Los proveedores de API REST cobran por token y pueden costar entre 10 y 30 veces más para un uso intensivo
• Usa tu configuración CLI — las preferencias de modelo, los prompts del sistema y la facturación son gestionados por la propia CLI

Suscripción vs API para desarrolladores

Si también usas estas herramientas para programación asistida por IA (Claude Code, Codex CLI, Gemini CLI), la misma suscripción cubre tanto los Genios de IA de VMark como tus sesiones de programación — sin coste adicional.

Configuración: Claude CLI

1. Instala Claude Code: npm install -g @anthropic-ai/claude-code
2. Ejecuta claude una vez en tu terminal para autenticarte
3. En VMark, haz clic en Detectar y luego selecciona Claude

Configuración: Gemini CLI

1. Instala Gemini CLI: npm install -g @google/gemini-cli (o desde el repositorio oficial)
2. Ejecuta gemini una vez para autenticarte con tu cuenta de Google
3. En VMark, haz clic en Detectar y luego selecciona Gemini

Proveedores de API REST

Los proveedores REST se conectan directamente a APIs en la nube (o locales). Cada uno requiere un endpoint, una clave de API y un nombre de modelo. Las respuestas llegan de una sola vez cuando la solicitud termina — los proveedores REST no transmiten tokens en streaming; los proveedores CLI sí.

Proveedor	Endpoint predeterminado	Variable de entorno
Anthropic	https://api.anthropic.com	ANTHROPIC_API_KEY
OpenAI	https://api.openai.com	OPENAI_API_KEY
Compatible con OpenAI	(lo defines tú)	—
Google AI	(integrado)	GOOGLE_API_KEY o GEMINI_API_KEY
Ollama (API)	http://localhost:11434	—

Campos de configuración

Al seleccionar un proveedor REST, aparecen tres campos:

• Punto de acceso de API — La URL base (oculta para Google AI, que usa un endpoint fijo). Un /v1 final no es problema — VMark lo normaliza para que la ruta no se duplique (p. ej., tanto https://host/v1 como https://host funcionan)
• Clave de API — Tu clave secreta. Se guarda en el almacén de credenciales de tu sistema operativo, nunca en localStorage ni en un archivo de ajustes en texto plano — consulta Dónde se guardan las claves de API
• Modelo — El identificador del modelo (por ejemplo, claude-sonnet-4-5-20250929, gpt-4o, gemini-2.0-flash)

Autorrelleno con variables de entorno

VMark lee las variables de entorno estándar de su propio entorno de proceso. Si ANTHROPIC_API_KEY, OPENAI_API_KEY o GOOGLE_API_KEY / GEMINI_API_KEY (comprobadas en ese orden) está definida, el campo de clave de API se rellena automáticamente al seleccionar ese proveedor.

Las variables que VMark ve dependen de cómo se inició. Una clave exportada en un perfil de shell como ~/.zshrc o ~/.bashrc:

export ANTHROPIC_API_KEY="sk-ant-..."

solo llega a VMark cuando inicias la aplicación desde ese shell. Si se inicia desde el Dock, el Finder, Spotlight o un lanzador de escritorio, VMark no lee tu perfil de shell, así que el campo queda vacío — pega la clave en su lugar. En Windows, una variable de entorno de usuario o del sistema funciona sin importar cómo se inicie VMark.

Configuración: Anthropic (REST)

1. Obtén una clave de API en console.anthropic.com
2. En Ajustes > Integraciones de VMark, selecciona Anthropic
3. Pega tu clave de API
4. Elige un modelo (predeterminado: claude-sonnet-4-5-20250929)

Configuración: OpenAI (REST)

1. Obtén una clave de API en platform.openai.com
2. En Ajustes > Integraciones de VMark, selecciona OpenAI
3. Pega tu clave de API
4. Elige un modelo (predeterminado: gpt-4o)

Configuración: compatible con OpenAI (DeepSeek, Groq, OpenRouter, …)

Muchos proveedores hablan el mismo protocolo que OpenAI (/v1/chat/completions, autenticación Bearer). La opción Compatible con OpenAI se conecta a cualquiera de ellos — DeepSeek, Groq, OpenRouter, Together, Moonshot, una pasarela autoalojada, etc. — sin necesidad de una entrada por proveedor.

Añade un campo más que los otros proveedores REST: un Nombre del proveedor editable, para que la fila muestre "DeepSeek" (o lo que definas) en lugar de la etiqueta genérica.

Ejemplo — DeepSeek:

1. Obtén una clave de API en platform.deepseek.com
2. En Ajustes > Integraciones de VMark, selecciona Compatible con OpenAI
3. Establece Nombre del proveedor en DeepSeek (opcional, solo estético)
4. Establece Punto de acceso de API en https://api.deepseek.com (un /v1 final no es problema — VMark lo normaliza)
5. Pega tu clave de API
6. Establece Modelo en deepseek-chat (o deepseek-reasoner). Escríbelo directamente o haz clic en actualizar para obtener la lista de modelos del endpoint

El endpoint es obligatorio — esta opción no tiene host predeterminado. Usa los botones Probar (⚡) y Probar modelo (🧪) para confirmar la conectividad antes de ejecutar un genio.

Configuración: Google AI (REST)

1. Obtén una clave de API en aistudio.google.com
2. En Ajustes > Integraciones de VMark, selecciona Google AI
3. Pega tu clave de API
4. Elige un modelo (predeterminado: gemini-2.0-flash)

Configuración: Ollama API (REST)

Úsalo cuando quieras acceso estilo REST a una instancia local de Ollama, o cuando Ollama esté ejecutándose en otra máquina de tu red.

1. Asegúrate de que Ollama esté en ejecución: ollama serve
2. En Ajustes > Integraciones de VMark, selecciona Ollama (API)
3. Establece el endpoint en http://localhost:11434 (o tu host de Ollama)
4. Deja la clave de API vacía
5. Establece el modelo con el nombre del modelo que hayas descargado (por ejemplo, llama3.2)

Elegir un proveedor

Situación	Recomendación
Ya tienes Claude Code instalado	Claude (CLI) — cero configuración, usa tu suscripción
Ya tienes Codex o Gemini instalado	Codex / Gemini (CLI) — usa tu suscripción
Necesitas privacidad / uso sin conexión	Instala Ollama → Ollama (API) en http://localhost:11434
Modelo personalizado o alojado en tu servidor	Ollama (API) con tu endpoint
DeepSeek / Groq / OpenRouter / cualquier API compatible con OpenAI	Compatible con OpenAI — define el endpoint, la clave y el modelo
Quieres la opción en la nube más económica	Cualquier proveedor CLI — la suscripción es mucho más barata que la API
Sin suscripción, solo uso ocasional	Configura la variable de entorno con la clave de API → Proveedor REST (pago por token)
Necesitas la mayor calidad de salida	Claude (CLI) o Anthropic (REST) con claude-sonnet-4-5-20250929

Modelo personalizado por genio

Los genios individuales pueden anular el modelo predeterminado del proveedor usando el campo model en el frontmatter:

---
name: quick-fix
description: Quick grammar fix
scope: selection
model: claude-haiku-4-5-20251001
---

Esto es útil para dirigir tareas simples a modelos más rápidos y económicos, manteniendo un modelo potente como predeterminado.

Fiabilidad y tiempos de espera

VMark protege cada llamada al proveedor para que una CLI bloqueada o una respuesta de API mal formada nunca pueda bloquear el editor:

• Tiempo de espera de subproceso CLI: cada invocación de proveedor CLI se ejecuta bajo un tiempo de espera de ejecución. Si la CLI no responde, VMark cancela la llamada, devuelve el error al genio y libera el trabajador — el grupo de hilos no puede quedar atascado por un subproceso descontrolado.
• Seguridad en el análisis JSON de REST: si un proveedor REST devuelve una respuesta con una forma inesperada (página de error HTML, JSON truncado, cambio de esquema tras una actualización en el servidor), VMark muestra un error tipado en el frontend en lugar de dejar al listener de IA esperando indefinidamente. Verás el error en el banner de estado del genio con la opción de reintentar.
• Tokens de cancelación: las tareas de genio o workflow de larga duración pueden cancelarse en cualquier momento — pulsa Cancelar en el selector de genio o cierra el panel y la solicitud en curso se cancela limpiamente.
• Cliente HTTP compartido: los proveedores REST comparten un único cliente reqwest con pool de conexiones, de modo que las ejecuciones consecutivas de genios no pagan el coste del handshake TCP/TLS cada vez.
• Descubrimiento de PATH en Windows: en Windows, VMark lee el PATH completo del usuario (incluidas las entradas exclusivas de PowerShell) al detectar CLIs, de modo que las herramientas instaladas por el usuario que funcionan en un terminal también funcionan dentro de VMark.

Dónde se guardan las claves de API

Las claves de API se guardan en el almacén de credenciales del sistema operativo — el Llavero de macOS, el Administrador de credenciales de Windows o el Secret Service de Linux — bajo el nombre de servicio app.vmark.secrets, una entrada por proveedor. VMark mantiene una copia en memoria solo durante la sesión en curso; los ajustes de proveedor persistidos nunca contienen una clave y no se escribe nada en localStorage. Una clave que una versión anterior de VMark guardó en un archivo de ajustes en texto plano se traslada al llavero la primera vez que la versión nueva la carga, y la copia en texto plano solo se elimina después de que la escritura en el llavero se haya vuelto a leer correctamente.

Si el llavero rechaza una escritura, VMark muestra un aviso de error en lugar de conservar la clave en memoria sin decir nada. En macOS, una compilación de desarrollo con firma ad hoc puede volver a pedir acceso al llavero tras cada nueva firma; una compilación de lanzamiento lo pide una sola vez.

Notas de seguridad

• Las claves de API se guardan en el llavero del sistema operativo — ver arriba; nunca se escriben en los archivos de ajustes de VMark ni en localStorage
• Las variables de entorno se leen al seleccionar un proveedor y solo rellenan un campo de clave vacío
• Los proveedores CLI usan tu autenticación CLI existente — VMark nunca ve tus credenciales
• Todas las solicitudes van directamente desde tu máquina al proveedor — no hay servidores de VMark intermediarios

Solución de problemas

"No hay proveedor de IA disponible" — Haz clic en Detectar para buscar CLIs, o configura un proveedor REST con una clave de API.

La CLI muestra "No encontrado" — La CLI no está en tu $PATH. Instálala o verifica tu perfil de shell. En macOS, las aplicaciones GUI pueden no heredar el $PATH del terminal — intenta añadir la ruta a /etc/paths.d/. Si Ajustes también muestra un aviso de que VMark no pudo leer tu $PATH, puede que la CLI sí esté instalada: corrige lo que hace fallar o ralentiza tu perfil de shell (VMark espera solo unos segundos) y luego haz clic en Detectar.

La CLI se bloquea / sin respuesta — El tiempo de espera de ejecución de VMark cancelará la llamada automáticamente; verás un error en el banner de estado del genio. Si una CLI en particular alcanza el tiempo de espera de forma sistemática, ejecútala una vez desde el terminal para confirmar que funciona allí y luego comprueba si requiere autenticación interactiva.

El proveedor REST devuelve 401 — Tu clave de API no es válida o ha expirado. Genera una nueva desde la consola del proveedor.

El proveedor REST devuelve 429 — Has alcanzado el límite de solicitudes. Espera un momento e inténtalo de nuevo, o cambia a un proveedor diferente.

El proveedor REST devuelve JSON ilegible / inesperado — VMark muestra un error de análisis tipado (p. ej. "list_models returned an unexpected response shape"). Verifica la URL del endpoint y que el contrato de la API coincida con el tipo de proveedor seleccionado; algunas pasarelas autoalojadas anuncian URLs compatibles con OpenAI pero envían un esquema diferente.

Respuestas lentas — Los proveedores CLI añaden sobrecarga de subprocesos. Para respuestas más rápidas, usa proveedores REST que se conectan directamente. Para la opción local más rápida, usa Ollama con un modelo pequeño.

Error de modelo no encontrado — El identificador del modelo no coincide con lo que ofrece el proveedor. Consulta la documentación del proveedor para los nombres de modelo válidos.

Ver también

• Genios de IA — Cómo usar la asistencia de escritura con IA
• Configuración de MCP — Integración de IA externa mediante el Protocolo de Contexto de Modelo