Conectar un modelo
Hasta que conectes una IA, el chat y los agentes de Kernl quedan apagados. Todo lo demás funciona. El modelo se conecta desde el dashboard, y podés conectar varios para que uno cubra al otro.
Abrir los ajustes de AI
En la barra de la izquierda, hacé clic en Sistema. Después elegí Configuración en las pestañas de arriba, y AI en la lista de ajustes. También podés ir directo a http://localhost:3086/settings?section=ai.

La página se llama Conectá tu IA. Tocá + Conectar proveedor para ver todos los proveedores, o Conectar NVIDIA gratis para ir directo al recomendado.

Elegir un proveedor
Los proveedores están agrupados por lo que cuestan y por dónde corren. Si no sabés cuál elegir, empezá por NVIDIA: es gratis y no pide tarjeta.
Cerebras, Mistral, Together AI, Fireworks AI, Kimi, Qwen, Z.ai, Xiaomi MiMo y el servidor compatible con OpenAI llegan en la próxima versión de Kernl. Si no los ves, actualizá Kernl.
| Proveedor | Grupo | Cuánto cuesta | Dónde sacás la key | La key empieza con |
|---|---|---|---|---|
| NVIDIA ★ | Gratis | gratis, sin tarjeta | build.nvidia.com | nvapi- |
| Google Gemini | Gratis | gratis, Google usa tus datos | aistudio.google.com/apikey | AIza o AQ. |
| Groq | Gratis | gratis, límites chicos | console.groq.com/keys | gsk_ |
| OpenRouter | Gratis | gratis, 50 pedidos por día | openrouter.ai/settings/keys | sk-or- |
| Cerebras | Gratis | prueba gratis, límites chicos | cloud.cerebras.ai | — |
| Mistral | Gratis | gratis, sin tarjeta | console.mistral.ai | — |
| Ollama | En tu computadora | gratis, corre en tu máquina | sin key | — |
| LM Studio | En tu computadora | gratis, corre en tu máquina | sin key | — |
| Servidor compatible con OpenAI | En tu computadora | gratis, tu propio servidor | opcional | — |
| Anthropic | Pago por uso | tu saldo de API | platform.claude.com | sk-ant- |
| OpenAI | Pago por uso | tu saldo de API | platform.openai.com/api-keys | sk- |
| DeepSeek | Pago por uso | tu saldo de API, barato | platform.deepseek.com/api_keys | sk- |
| xAI Grok | Pago por uso | tu saldo de API | console.x.ai | xai- |
| MiniMax | Pago por uso | tu saldo de API, barato | platform.minimax.io | — |
| Together AI | Pago por uso | tu saldo de API, desde USD 15 | api.together.ai | — |
| Fireworks AI | Pago por uso | tu saldo de API, créditos de prueba | app.fireworks.ai | — |
| Moonshot (Kimi) | Pago por uso | tu saldo de API, desde USD 1 | platform.kimi.ai | — |
| Qwen (Alibaba Cloud) | Pago por uso | cuota gratis, después tu saldo | Alibaba Cloud Model Studio | sk- |
| Z.ai (GLM) | Pago por uso | tu saldo de API, algunos modelos gratis | z.ai | — |
| Xiaomi MiMo | Pago por uso | tu saldo de API, barato | platform.xiaomimimo.com | sk- |
| Claude Code | Con tu suscripción | tu plan Claude Pro o Max | sin key | — |
Conectar con una API key
Todos los proveedores de las filas Gratis y Pago por uso se conectan igual:
- Tocá la tarjeta del proveedor. El formulario muestra tres pasos para sacar la key, con un enlace al sitio del proveedor al lado del primero.
- Creá la key en ese sitio y copiala.
- Pegala en API key.
- Dejá el Modelo que viene elegido, o elegí otro. La lista marca uno como "recomendado" y otro como "rápido". También podés escribir el id de cualquier modelo que ofrezca el proveedor.
- Tocá Conectar.

Kernl prueba la conexión antes de guardar nada: le pide al modelo que use una herramienta, porque los agentes de Kernl lo necesitan. Cuando funciona ves "Conectado · usa herramientas · respondió en … ms" y el proveedor aparece en Tus conexiones.
Si la key no tiene el formato de ese proveedor, Kernl te avisa: "Esta key no tiene el formato habitual de …". Igual te deja probar, así que si la copiaste completa, tocá Conectar de todos modos.
Ya conectado, podés tocar Cargar más modelos en el formulario para ver todos los modelos que el proveedor tiene para vos.
NVIDIA
Gratis y sin tarjeta. Es la primera opción recomendada. NVIDIA no publica sus límites de uso.
- Creá tu cuenta gratis en build.nvidia.com.
- Abrí cualquier modelo y tocá Get API Key.
- Copiá la key (empieza con
nvapi-) y pegala en Kernl.
Google Gemini
Gratis. En el plan gratis, Google usa lo que le mandás para mejorar sus productos. No lo uses para nada privado.
- Entrá a Google AI Studio (aistudio.google.com/apikey) con tu cuenta de Google.
- Tocá Create API key.
- Copiá la key y pegala en Kernl.
Groq
Gratis, pero con límites chicos: 8.000 tokens por minuto. Los agentes con muchas herramientas pueden pasarse, así que Groq anda mejor como respaldo.
- Creá tu cuenta en console.groq.com.
- Abrí API Keys y tocá Create API Key.
- Copiá la key (empieza con
gsk_) y pegala en Kernl.
OpenRouter
Da acceso a muchos modelos con una sola key. Los modelos gratis permiten 20 pedidos por minuto y 50 por día, o 1.000 por día una vez que compraste USD 10 de saldo.
- Creá tu cuenta en openrouter.ai.
- Abrí Settings → Keys y tocá Create Key.
- Copiá la key (empieza con
sk-or-) y pegala en Kernl.
Anthropic
Los modelos Claude por la API de Anthropic, pagando por uso. Es algo aparte de una suscripción Claude Pro o Max. Para eso, mirá Claude Code.
- Entrá a platform.claude.com y cargá saldo.
- Abrí Settings → API keys y tocá Create key.
- Copiá la key (empieza con
sk-ant-) y pegala en Kernl.
OpenAI
- Entrá a platform.openai.com.
- Abrí API keys y tocá Create new secret key.
- Copiá la key (empieza con
sk-) y pegala en Kernl.
DeepSeek
Pago por uso, y barato.
- Entrá a platform.deepseek.com y cargá saldo.
- Abrí API keys y creá una.
- Copiá la key y pegala en Kernl.
xAI Grok
- Entrá a console.x.ai y cargá saldo.
- Abrí API Keys y creá una.
- Copiá la key (empieza con
xai-) y pegala en Kernl.
MiniMax
Pago por uso, y barato. Las keys de MiniMax no tienen un prefijo fijo, así que Kernl nunca avisa por su formato.
- Entrá a platform.minimax.io.
- Abrí User Center → Interface key y creá una.
- Copiá la key y pegala en Kernl.
- En Región, elegí Global, o China si tu cuenta es de minimax.cn.
Cerebras
Muy rápido. La prueba gratis permite 5 pedidos por minuto y 1 millón de tokens por día por modelo: alcanza como respaldo, pero queda justo para agentes que trabajan mucho.
- Creá tu cuenta en cloud.cerebras.ai.
- Abrí API Keys en la barra de la izquierda y creá una.
- Copiá la key y pegala en Kernl.
Mistral
El modo gratis no pide tarjeta, pero Mistral puede pedirte un número de teléfono. Mistral puede usar lo que mandás en el modo gratis para entrenar sus modelos, así que no lo uses para nada privado.
- Creá tu cuenta en console.mistral.ai.
- Abrí API Keys y tocá Create new key. Ponele un nombre y una fecha de vencimiento.
- Copiá la key y pegala en Kernl. Mistral la muestra una sola vez.
Together AI
Cientos de modelos abiertos, como GLM, Kimi y gpt-oss, con una sola key. No hay prueba gratis: la primera compra es de USD 15 como mínimo.
- Creá tu cuenta en together.ai y cargá saldo.
- Abrí Settings → API Keys y tocá Create key.
- Copiá la key y pegala en Kernl. Together la muestra una sola vez.
Los ids de modelo llevan adelante el dueño, por ejemplo zai-org/GLM-5.3.
Fireworks AI
Modelos abiertos rápidos y baratos. Sin medio de pago tenés créditos de prueba y 10 pedidos por minuto.
- Creá tu cuenta en fireworks.ai.
- Abrí Settings → API Keys y tocá Create API key.
- Copiá la key y pegala en Kernl.
Los ids de modelo son rutas largas, por ejemplo accounts/fireworks/models/glm-5p3.
Moonshot (Kimi)
Los modelos Kimi, fuertes en agentes y código. Cargás saldo desde USD 1, y el primer nivel permite 3 pedidos por minuto.
- Entrá a platform.kimi.ai y cargá saldo.
- Abrí API Keys y creá una.
- Copiá la key y pegala en Kernl.
- En Región, elegí Internacional, o China si tu cuenta es de platform.kimi.com.
Kernl elige kimi-k2.6. Podés elegir kimi-k3 en Modelo, pero siempre razona antes de responder, así que fijate que tus agentes anden con él.
Qwen (Alibaba Cloud)
En la región Singapur tenés 1 millón de tokens gratis por modelo durante 90 días. Después pagás por uso.
- Entrá a Alibaba Cloud Model Studio y elegí la región arriba a la derecha.
- Abrí API Key y tocá Create API Key. Dejá el workspace por defecto y dale todos los permisos.
- Copiá la key (empieza con
sk-) y pegala en Kernl. Se muestra una sola vez. - En Región, elegí la misma región donde creaste la key: Internacional (Singapur) o China (Pekín). Una key de otra región se rechaza.
Z.ai (GLM)
Los modelos GLM, buenos para agentes. GLM-4.7-Flash y GLM-4.5-Flash son gratis; el resto se paga por uso.
- Creá tu cuenta en z.ai.
- Abrí la página de API keys y creá una.
- Copiá la key y pegala en Kernl.
- En Región, elegí Internacional, o China si tu cuenta es de bigmodel.cn.
Xiaomi MiMo
Los modelos MiMo de Xiaomi: baratos y con lugar para un millón de tokens de contexto. Kernl usa MiMo-V2.6-Pro, y MiMo-V2.6-Flash como modelo rápido.
- Creá tu cuenta en platform.xiaomimimo.com y cargá saldo.
- Abrí API Keys y creá una.
- Copiá la key (empieza con
sk-) y pegala en Kernl.
MiMo también vende un Token Plan, un plan mensual cuyas keys empiezan con tp-. Esas keys no sirven acá: usá una key de pago por uso.
Usar un modelo local
Ollama, LM Studio y cualquier servidor compatible con OpenAI corren en tu propia máquina o en tu red. No necesitan key, y nada de lo que mandás sale de tu computadora.
Para Ollama: instalalo desde ollama.com, descargá un modelo con el comando de abajo y dejá Ollama corriendo.
ollama pull qwen3
Para LM Studio: instalalo desde lmstudio.ai, descargá y cargá un modelo, y en Developer activá Start server (LM Studio no tiene esa pantalla en español).
De vuelta en Kernl:
- Elegí Ollama o LM Studio en En tu computadora.
- Tocá Detectar. Kernl busca en la dirección habitual y muestra "Encontrado en … · N modelos" cuando encuentra tu servidor.
- Elegí uno de tus modelos en Modelo.
- Tocá Conectar.

La Dirección del servidor viene completa: http://localhost:11434/v1 para Ollama y http://127.0.0.1:1234/v1 para LM Studio. Cambiala solo si los corrés en otro puerto o en otra computadora.
Si corrés Kernl en Docker, Detectar también prueba host.docker.internal, que llega a tu computadora desde adentro del contenedor. Si igual no encuentra tu servidor, escribí la dirección a mano, por ejemplo http://host.docker.internal:11434/v1 para Ollama.
El modelo tiene que saber usar herramientas. Si responde pero no las usa, Kernl te lo dice y los agentes no van a andar con él. Elegí otro modelo.
Cualquier servidor compatible con OpenAI
Usá esta tarjeta para llama.cpp, vLLM, Jan, LocalAI o un proxy como LiteLLM: cualquier servidor que responda la API de OpenAI.
- Arrancá tu servidor con su API compatible con OpenAI.
- En En tu computadora, elegí OpenAI-compatible server.
- Tocá Detectar, o escribí vos la dirección en Dirección del servidor. Normalmente termina en
/v1. - Si tu servidor pide una key, pegala en API key (opcional).
- Elegí un modelo y tocá Conectar.
Detectar busca en los puertos 8080 (llama.cpp y LocalAI), 8000 (vLLM) y 1337 (Jan), en tu computadora y, con Docker, en host.docker.internal. Un servidor en otra computadora o en otro puerto lo tenés que escribir a mano, por ejemplo http://192.168.0.20:8000/v1.
Usar tu suscripción de Claude Code
Podés dejar que Kernl use tu suscripción Claude Pro o Max como su IA. Es lo contrario de conectar Claude Code a Kernl, donde Claude Code usa las herramientas de Kernl. Las dos cosas no tienen relación y podés hacer ambas.
Si instalaste la app o el paquete de Kernl (no Docker):
- En Con tu suscripción, elegí Claude Code.
- Tocá Conectar con mi suscripción. Se abre en tu navegador una página de aprobación de Claude.
- Aprobala. Kernl se conecta solo.
Si Kernl corre en Docker
En Docker hay un paso más. Cuando aprobás, Claude manda tu navegador a una dirección que solo existe adentro del contenedor, así que tu navegador no la puede abrir. Esa dirección la tenés que copiar y pegar vos en Kernl.

- En Con tu suscripción, elegí Claude Code y tocá Conectar con mi suscripción. La página de aprobación de Claude se abre en una pestaña nueva. Si tu navegador bloquea la pestaña nueva, tocá Abrí la página de aprobación.
- En la página de Claude, iniciá sesión con tu cuenta de Claude si te lo pide, y aprobá.
- Ahora tu navegador muestra una página de error: "No se puede acceder a este sitio" o parecido. Es lo esperado. No la cierres.
- Hacé clic en la barra de direcciones de esa pestaña y copiá la dirección completa. Empieza con
http://localhosty tiene/callback?code=y&state=. Por ejemplo:http://localhost:…/callback?code=…&state=… - Volvé a la pestaña de Kernl. Pegá la dirección en Dirección de la página que no cargó.
- Tocá Conectar. Claude Code aparece en Tus conexiones.
Copiá la dirección tal cual, desde la primera h hasta el final. Un pedazo no alcanza.
Si algo sale mal:
| Mensaje | Qué hacer |
|---|---|
| Eso no parece la dirección: tiene que incluir ?code= y &state=. | Copiaste solo una parte. Volvé a copiar la dirección completa desde la barra de direcciones. |
| Esa dirección es de otro intento. | Pegaste la dirección de un intento anterior. Tocá Abrir de nuevo la página de aprobación, aprobá y pegá la dirección nueva. |
| Este inicio de sesión ya no está en curso. Empezá de nuevo. | El intento venció o cerraste el formulario. Tocá Conectar con mi suscripción otra vez. |
| La página de aprobación venció. Probá de nuevo. | Pasaron más de 10 minutos. Empezá de nuevo con Conectar con mi suscripción. |
| Kernl no pudo entregarle la aprobación a Claude Code. Probá de nuevo. | Empezá de nuevo. Si sigue fallando, iniciá sesión desde una terminal. |
Iniciar sesión desde una terminal
Si el botón no funciona, con Docker o sin Docker, tocá O iniciá sesión desde una terminal:
- Tocá Copiar comando y pegá el comando en una terminal. En Windows, usá el Símbolo del sistema (cmd), no PowerShell.
- Se abre Claude Code. Si no te pide iniciar sesión, escribí
/loginy aprobá en el navegador. - Salí de Claude Code con
/exit, volvé a Kernl y tocá Detectar.
Usar varios proveedores
Podés conectar todos los proveedores que quieras. Cada uno que conectás va al final de una lista, y Kernl usa el primero que responda. Si falla, porque está caído, sin saldo o muy lento, Kernl pasa solo al siguiente.
La línea de arriba de Tus conexiones muestra el orden: "Kernl piensa con … → si falla: …".
- Para cambiar el orden, tocá Reordenar, mové los proveedores con las flechas y tocá Guardar. El botón aparece cuando tenés dos o más.
- Para cambiar el modelo de un proveedor, tocá Editar en su fila, elegí otro Modelo y tocá Conectar. No hace falta volver a pegar la key.
- Para ver si sigue andando, tocá Probar. La fila muestra cuándo se probó por última vez y qué tan rápido respondió.
- Para quitarlo, tocá Quitar y confirmá. Kernl borra su key y lo saca de la lista.
Una buena combinación: NVIDIA primero, con Groq o un modelo local de respaldo.
Cuando la conexión falla
Kernl explica el problema y ofrece un botón para resolverlo. Tocá Ver detalle para ver el mensaje del propio proveedor.

| Mensaje | Qué hacer |
|---|---|
| La key no es válida o fue revocada. | Tocá Generar otra key y pegá la nueva. |
| Llegaste al límite gratis o te quedaste sin saldo. | Esperá, cargá saldo, o tocá Sumar un proveedor de respaldo. |
| Ese modelo ya no está disponible. | Tocá Elegir otro modelo. |
| El modelo está saturado y no respondió a tiempo. | Tocá Usar el modelo rápido, o probá más tarde. |
| Responde, pero no usa herramientas: los agentes no van a funcionar. | Tocá Elegir otro modelo. |
| No encuentro Ollama (o LM Studio) en … | Fijate que esté corriendo y tocá Volver a detectar. |
| No hay una sesión de Claude Code en esta máquina. | Iniciá sesión con Copiar comando, como en Claude Code. |
| No hay conexión con … | Revisá tu conexión a internet y tocá Reintentar. |
Keys en el archivo .env
Kernl guarda las keys cifradas en su base de datos, no en archivos. Si tenías una key en .env (por ejemplo NVIDIA_API_KEY u OPENAI_API_KEY) la primera vez que arrancó Kernl, la importó, conectó ese proveedor y borró la línea del .env. También dejó una copia del archivo llamada .env.bak-….
Después de ese primer arranque, Kernl ignora las keys que agregues al .env. Conectá los proveedores nuevos en Configuración → AI.
Próximo paso
Para usar las herramientas de Kernl desde otra app, leé Conceptos básicos de MCP.