Cambiar la identidad y el modelo del asistente
Cómo elegir la identidad del asistente (Koog / Claude Code / Codex), dónde se cambia el modelo y los cuatro errores típicos cuando el cambio falla.
Qué modelo usa el asistente se elige en dos pasos: primero la identidad del asistente (quién lo ejecuta) y después el modelo (qué ejecuta). La mayoría se atasca porque trata ambos pasos como uno solo.
Paso 1: elige la identidad del asistente
Entra en Ajustes de cuenta → Asistente de IA. El primer campo del formulario es el tipo de identidad del asistente, con tres opciones:
| Identidad | Qué es | Qué credencial necesita |
|---|---|---|
| Koog | El motor integrado: llama a LLM normales indicando proveedor + modelo. Es la opción por defecto. | Una clave de API de ese proveedor (OpenAI, Anthropic, OpenRouter, DeepSeek, etc.) |
| Claude Code | Ejecuta la línea de comandos de Claude Code como el propio asistente. | Un token de suscripción de Claude: guárdalo con provider claude_code_oauth |
| Codex | Ejecuta la línea de comandos de Codex como el propio asistente. | El auth.json de Codex: guárdalo con provider codex_subscription |
Al cambiar a Claude Code o Codex sin la credencial de suscripción correspondiente, aparece «no se encontró una credencial de suscripción utilizable para esta identidad» y se rechaza el guardado, a propósito, para no dejar guardada una configuración que no puede ejecutarse. Solución: añade la credencial en Integraciones → Proveedores de modelos y vuelve a cambiar la identidad.
Paso 2: elige el modelo
Con la identidad Koog
- Primero elige el modo de configuración: plantilla preajustada (una configuración lista) o configuración personalizada (rellenas cada campo).
- Elige el proveedor: la lista de modelos se descarga por proveedor, así que tras cambiarlo vuelve a abrir el desplegable de modelos para recargarla.
- Elige el modelo LLM. Si el que quieres no aparece, escribe el ID del modelo a mano.
- Opcionalmente, fija qué credencial usa cada proveedor. Si lo dejas vacío, busca una credencial del mismo proveedor primero personal y luego de equipo.
Con la identidad Claude Code / Codex
Los modelos disponibles salen de lo que admite tu propia cuenta de suscripción, no del desplegable de proveedor. Sigue las indicaciones del bloque de configuración de ese entorno; en Codex, por ejemplo, son típicos nombres como gpt-5.6-sol.
Lo que más se confunde
Con la identidad Koog hay más abajo otro bloque: «Claude Code / Codex (como subagente externo invocado como herramienta)». Es algo completamente distinto del tipo de identidad del asistente:
- Rol — Decide quién ejecuta toda la conversación. Si eliges Claude Code, el asistente en sí es Claude Code.
- Subagente externo — El asistente sigue siendo Koog y solo llama a Claude Code o Codex como herramienta cuando hace falta. Este bloque aparece únicamente si marcas external_agent en el conjunto de herramientas.
Para sustituir al asistente en sí, cambia la identidad de arriba; para que solo tome prestada una CLI externa de vez en cuando, configura el subagente de abajo.
La identidad también decide si puede editar flujos
La identidad Koog crea y modifica flujos en la conversación de forma nativa. Con Claude Code o Codex depende de un canal de edición configurado en el despliegue; si falta, al pedirle que construya un flujo verás un aviso claro: esta identidad de asistente no admite las herramientas internas de edición de flujos, vuelve a Koog.
Si lo que buscas sobre todo es que el asistente te construya flujos, quedarte en Koog es lo más cómodo. Cambia cuando necesites la capacidad de programación de Claude Code o Codex, o simplemente selecciónalos para un paso de agente dentro del flujo, como explica la página siguiente.
Errores frecuentes y su significado
| Lo que ves | La causa real | Qué hacer |
|---|---|---|
| No se encontró ninguna credencial de suscripción para la identidad actual | Cambiaste a una identidad externa, pero el centro de credenciales no tiene una credencial de suscripción de ese proveedor. | Añade primero una credencial claude_code_oauth o codex_subscription y luego cambia la identidad. |
| Esta identidad de asistente no admite las herramientas internas de edición de flujos | El canal de edición que usan las identidades externas no está listo en este despliegue. | Vuelve a Koog para terminar la edición o pide al administrador que revise la configuración del despliegue. |
| El desplegable de modelos está vacío | No se pudo cargar la lista de modelos de ese proveedor, o acabas de cambiar de proveedor y aún no se ha recargado. | Cierra y vuelve a abrir el desplegable para forzar una nueva carga; si sigue vacío, escribe el ID del modelo. |
| Se guarda bien, pero al primer mensaje se queja de que falta la clave | Hay un proveedor seleccionado pero no se resuelve ninguna credencial: ni personal ni de equipo tienen una de ese proveedor. | Añade una credencial de ese proveedor en el centro de credenciales o selecciona explícitamente una ya existente en la configuración. |
Sigue leyendo
- Cambiar el modelo de un agente del flujo — Los modelos dentro de un flujo son un ajuste aparte y no afectan al asistente.
- BYOK viene con llave — Dónde conseguir la clave de cada proveedor y a quién se le carga el coste.
- Credenciales — Cómo se guardan las credenciales y cómo se resuelven las personales y de equipo.