# Proveedores y modelos {#providers-and-models} > Conecta una API, una suscripción compatible o un servidor local y elige tu modelo por defecto. ## Distingue las tres decisiones {#understand-the-three-separate-choices} Clarvis separa la configuración del proveedor, la selección del modelo y el esfuerzo de razonamiento: - `/settings/providers` gestiona conexiones, credenciales y modelos disponibles de cada proveedor. - `/model` elige el modelo por defecto para futuras ejecuciones del agente principal. - `/effort` elige un nivel de razonamiento admitido por ese modelo. Añadir un modelo no lo convierte automáticamente en el predeterminado. Editar un proveedor tampoco sobrescribe el modelo o esfuerzo actuales. La excepción es el asistente inicial: al crear el primer proveedor y modelo, guarda ese modelo como valor global por defecto. Consulta las rutas de API, suscripción y servidor local en [Primeros pasos](/es-ES/getting-started#complete-the-first-run-setup). ## Revisa los proveedores configurados {#review-configured-providers} Abre `/settings/providers`. La lista muestra tipo de API, número de modelos, estado de credenciales, origen de configuración y qué proveedor contiene el modelo por defecto.

Pantalla Providers con local-lab y team-gateway en ámbito global — Providers en un terminal de 120 × 36. El ámbito aparece junto al título.

Pulsa **Ctrl+T** para alternar entre ámbito global y del espacio. Usa el global para una conexión disponible en todos tus proyectos; el del espacio para una API o conjunto de modelos de ese proyecto. Las suscripciones son personales y deben configurarse globalmente: un repositorio no puede crearlas, sustituirlas ni redirigirlas. ## Añade un proveedor del catálogo {#add-a-provider-from-the-catalog} 1. Pulsa **A** en Providers. 2. Escribe parte del nombre para filtrar el catálogo de models.dev. 3. Selecciona el proveedor y pulsa **Intro**. 4. Selecciona uno o varios modelos. El selector permanece abierto para añadir o quitar varios. 5. Pulsa **Escape** para volver a los detalles. Si no se resuelve la variable de credencial, se solicita la clave de API. 6. Revisa URL, variable de credencial, límites, cabeceras y campos adicionales del cuerpo. 7. Pulsa **Ctrl+S** para guardar los cambios pendientes del proveedor y sus modelos. El mismo diálogo muestra las suscripciones beta de Clarvis, separadas de models.dev. Aparecen indisponibles si la compilación o el anfitrión no ofrecen esa integración.

Diálogo Add provider con suscripciones y catálogo de proveedores con búsqueda — Pulsa A para buscar un proveedor o iniciar la conexión de una suscripción beta.

Tras seleccionar un proveedor, se abre su selector de modelos. Las columnas derechas resumen los límites de contexto y salida y las capacidades publicadas. Elige **manual entry…** si no aparece el identificador que necesitas.

Diálogo de modelos de Anthropic con identificadores y capacidades publicadas — Los metadatos del catálogo proporcionan los límites y capacidades iniciales del modelo.

Usa `/refresh` si la copia local de models.dev está desactualizada. Actualiza el catálogo, no tus elecciones guardadas. Si el catálogo falla antes de abrir el espacio principal, sal y ejecuta: ```bash clarvis --refresh-models clarvis ``` ## Añade un proveedor propio o local {#add-a-custom-or-local-provider} Usa entrada manual para un servidor local, una pasarela privada o un proveedor ausente: 1. Abre Add provider y escribe `manual`. 2. Selecciona **manual entry…**. 3. Asigna un nombre estable. 4. Elige el tipo de API; para un servidor compatible con OpenAI, `openai-compatible`. 5. Indica la URL base HTTP o HTTPS completa, como `http://127.0.0.1:11434/v1`. 6. Indica la variable de entorno de la clave. Déjala vacía solo si el servidor realmente no necesita clave. 7. Pulsa **A** en los detalles para añadir un identificador de modelo. 8. Define un tamaño positivo de ventana de contexto y revisa salida, caché, cabeceras y cuerpo opcionales. 9. Pulsa **Ctrl+S** para guardar. Un proveedor `local-lab` y modelo `qwen2.5-coder:7b` forman `local-lab/qwen2.5-coder:7b`. Usa el identificador exacto del servidor; se admiten etiquetas nativas tras `:`.

Diálogo de proveedor filtrado a la opción de entrada manual — La entrada manual siempre está disponible al final del catálogo filtrado.

Abre el proveedor con **Intro** para editarlo. Pulsa **A** para añadir modelos y selecciona una fila para revisar sus límites. Los cambios no se guardan hasta **Ctrl+S**; salir con cambios pendientes pide confirmación para descartarlos.

Detalles del proveedor con tipo de API, URL, credenciales, mapas de petición y modelos — El proveedor gestiona credenciales y modelos disponibles, no el modelo por defecto.

::: warning Atención Nunca guardes una clave de API literal en `settings.json`. Indica una variable de entorno o utiliza el flujo de credenciales. Clarvis no vuelve a mostrar un secreto guardado en el terminal. ::: ## Conecta una suscripción beta {#connect-a-beta-subscription} Las suscripciones y modelos disponibles dependen del proveedor y tu cuenta. La integración está en beta y no implica respaldo del proveedor. Si una opción no está disponible, usa una API o un servidor compatible. Las pruebas automáticas simulan conexiones; no demuestran que una cuenta real tenga acceso. Antes de depender de la integración, prueba el inicio de sesión, los modelos disponibles, la renovación de conexión y una tarea real con tu cuenta. Elige la suscripción en Add provider y sigue la vinculación de dispositivo: 1. Inicia la conexión. 2. Abre o copia la URL de verificación cuando estés listo. 3. Introduce el código público del dispositivo en la web del proveedor. 4. Vuelve a Clarvis y espera al catálogo autorizado de tu cuenta. 5. Selecciona los modelos que quieres tener disponibles. Los detalles ofrecen volver a autenticar o desconectar con confirmación en lugar de campos de clave y URL. Añadir modelos vuelve a cargar el catálogo autorizado; no lo sustituye por el catálogo público de nombres. ## Elige el modelo por defecto {#choose-the-default-model} Abre `/model`. Pulsa **Ctrl+T** si quieres un valor del espacio en lugar del global. Selecciona un modelo configurado y pulsa **Intro**. Se guarda al instante y se aplica a la siguiente ejecución.

Pantalla de modelo por defecto con tres modelos y la elección global actual — La fila seleccionada se usa en futuras ejecuciones del principal dentro del ámbito visible.

Si hay metadatos del modelo, elegirlo también aplica su esfuerzo recomendado. Si una ventana menor no puede contener la sesión, Clarvis pregunta antes de descartar permanentemente contexto antiguo. Cancelar conserva el modelo actual. Para el principal prevalece el valor del usuario. Un subagente puede declarar su propio modelo en el perfil; si no, usa el predeterminado del usuario. ## Elige el esfuerzo de razonamiento {#choose-the-default-reasoning-effort} Abre `/effort`, elige un nivel admitido por el modelo por defecto y pulsa **Intro**. **Provider default** deja la decisión al proveedor. El cambio es inmediato para la siguiente ejecución.

Selector de esfuerzo con valor del proveedor y niveles low, medium y high para qwen3-coder — Solo aparecen los niveles publicados o configurados para el modelo por defecto.

Si `/effort` indica compatibilidad desconocida, revisa el modelo en `/settings/providers`, actualiza el catálogo o añade sus metadatos publicados. Clarvis no inventa niveles. ## Consulta también {#see-also} - [Configuración](/es-ES/reference/configuration) - [Agentes](/es-ES/guide/agents) - [Ámbitos y confianza](/es-ES/explanation/scopes-and-trust) - [Solución de problemas](/es-ES/operations/troubleshooting) --- [HTML canónico](https://clarvis.dev/es-ES/guide/providers-and-models) [Índice de documentación](https://clarvis.dev/es-ES/llms.txt)