> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Referencia de códigos de error de Devin aislado de la red

> Catálogo completo de los códigos de error LIC, MDL, IDP, NET y CFG que muestran Devin CLI y Desktop en entornos aislados de la red, con su significado y la acción que debe tomar el administrador en cada caso.

> [!NOTE]
>
> Esta documentación corresponde a los despliegues federales de Devin. [Volver a la documentación de Devin](/es/get-started/devin-intro)

Todos los fallos que la CLI y Desktop aislados de la red pueden diagnosticar se notifican con un código estable con el formato `XXXnnn`. Los códigos aparecen al inicio del mensaje de error en la terminal, en la salida de `devin airgap doctor`, en los diagnósticos de Desktop y en el campo `error_code` de los [eventos de auditoría](/es/federal/air-gapped/on-disk-formats#auth) de `auth`. El número identifica la condición, no el texto del mensaje, así que puedes usarlo como referencia en tus manuales de procedimientos de soporte y en tus alertas del SIEM.

| Espacio de nombres | Ámbito | Página de detalle |
| - | - | - |
| `LIC` | Validación del archivo de licencia | [Licencia](/es/federal/air-gapped/license) |
| `MDL` | Validación del archivo de modelos | [Archivo de modelos](/es/federal/air-gapped/models-file) |
| `IDP` | SSO y proveedor de identidad | [SSO](/es/federal/air-gapped/sso) |
| `NET` | Accesibilidad de endpoints, TLS, sondeo HTTP | [Red y certificados](/es/federal/air-gapped/network-and-certificates) |
| `CFG` | Rutas locales, configuración, entorno | [Red y certificados](/es/federal/air-gapped/network-and-certificates), [Archivo de modelos](/es/federal/air-gapped/models-file) |

## `LIC` Licencia

Se muestra como `LIC00n: <message>`, seguido de la ruta que se comprobó y de cómo anularla (`DEVIN_LICENSE_FILE`).

| Código | Significado | Qué hacer |
| - | - | - |
| `LIC001` | El archivo de licencia no existe o no se puede leer en `/etc/devin/license.devin-onprem-license` (`C:\ProgramData\Devin\license.devin-onprem-license` en Windows) ni en la ruta de `DEVIN_LICENSE_FILE`. En Windows, también se devuelve cuando un usuario estándar intenta reemplazar desde Desktop una licencia cuyo propietario es un administrador. | Instala el archivo en la ruta predeterminada o define `DEVIN_LICENSE_FILE`; comprueba que el usuario que ejecuta Devin tenga permiso de lectura. |
| `LIC002` | Archivo con formato incorrecto: no es un JWT EdDSA válido o no hay `kid` en el encabezado. | Vuelve a descargar la licencia desde el portal y transfiérela byte a byte (sin añadir saltos de línea, ajustes de línea ni cambios de codificación). |
| `LIC003` | Error en la verificación de la firma. | La carga útil se modificó después de firmarse. Vuelve a descargar la licencia. |
| `LIC004` | `kid` desconocido: esta compilación no incluye ninguna clave pública que coincida. | Ejecuta la [comprobación de `kid`](/es/federal/air-gapped/license#check-the-key-id). La licencia la emitió otro entorno o tu compilación es anterior a una rotación de claves; instala la versión actual. |
| `LIC005` | Caducada y fuera del período de gracia de 24 horas. | Renueva la licencia desde el portal. |
| `LIC006` | Aún no es válida: la fecha de emisión está más de 24 horas en el futuro. | Comprueba el reloj del host; si es correcto, ponte en contacto con tu equipo de soporte. |
| `LIC007` | Claim `product` incorrecto (no es `devin-onprem`). | El archivo no es una licencia de Devin para entornos aislados de la red. Vuelve a descargarla desde el portal. |

## `MDL` Archivo de modelos

Lo notifican `devin models validate`, `devin airgap doctor`, la configuración de modelos de Desktop y el agente al iniciarse. Cada diagnóstico indica la entrada de modelo a la que corresponde.

| Código | Significado | Qué hacer |
| - | - | - |
| `MDL001` | El archivo no es un JSON válido para el esquema v0 (por ejemplo, contiene campos desconocidos). | Corrige el JSON; elimina los campos que no figuren en el [esquema](/es/federal/air-gapped/models-file#schema-reference-version-0). |
| `MDL002` | `schema_version` no compatible. | Establece `"schema_version": 0`. |
| `MDL003` | `models` está vacío. | Agrega al menos una entrada de modelo. |
| `MDL004` | Un modelo tiene un `name` vacío. | Asigna a cada entrada un `name` único. |
| `MDL005` | `name` de modelo duplicado. | Renombra una de las entradas. |
| `MDL006` | `base_url` vacío. | Establece la URL del endpoint. |
| `MDL007` | `api_key.env` vacío. | Indica el nombre de la variable de entorno que contiene la clave. |
| `MDL008` | `max_context_tokens` es cero. | Establece la ventana de contexto del modelo. |
| `MDL009` | Hay más de un modelo marcado como `default`. | Deja `default: true` en una sola entrada. |
| `MDL010` | `base_url` no es una URL `https://` con un host (`http://` solo se acepta para direcciones de loopback). | Usa `https://` o una dirección de loopback para un servidor en el mismo host. |
| `MDL011` | `max_output_tokens` supera `max_context_tokens`. | Reduce `max_output_tokens`. |
| `MDL012` | El archivo existe, pero no se pudo leer (por permisos o por UTF-8 no válido). | Corrige el permiso de lectura para el usuario que ejecuta Devin; guarda el archivo en UTF-8. |
| `MDL013` | `max_output_tokens` es cero. | Elimina el campo o establece un valor positivo. |
| `MDL014` | El archivo pertenece a otro usuario, por lo que Desktop se niega a reemplazarlo. | Edita el archivo en disco como su propietario o haz que `DEVIN_MODELS_FILE` apunte a un archivo de tu propiedad. |

## `IDP` SSO y proveedor de identidad

Lo notifican `devin auth login`, `devin auth status`, el agente al iniciarse y el flujo de inicio de sesión de Desktop. `IDP004` e `IDP005` también se escriben en el registro de auditoría en los eventos `sso_login_denied`, y cualquier código `IDP` puede aparecer en `sso_revalidation_failed`.

| Código | Significado | Qué hacer |
| - | - | - |
| `IDP001` | El archivo de autenticación no se puede leer o no es válido. | Corrija `/etc/devin/auth.json` (`C:\ProgramData\Devin\auth.json` en Windows) o el archivo indicado en la ruta `DEVIN_AUTH_FILE`; el mensaje indica el campo problemático. |
| `IDP002` | No hay ningún inicio de sesión en caché para el emisor configurado. | Ejecute `devin auth login`. |
| `IDP003` | El inicio de sesión no es válido o ha caducado y no se pudo renovar automáticamente (incluida una respuesta `invalid_grant` del IdP). | Vuelva a ejecutar `devin auth login`. |
| `IDP004` | La sesión está iniciada, pero el usuario no es miembro de `required_group`. | Agregue el usuario al grupo en el IdP o corrija `required_group` / `groups_claim` en el archivo de autenticación. |
| `IDP005` | No se pudo contactar con el IdP, este devolvió un error o devolvió un token de ID que no superó la validación. | Compruebe la conectividad de red, la confianza TLS (`DEVIN_CA_BUNDLE`), el valor de `issuer` y los registros del propio IdP. |
| `IDP006` | La caché local de tokens de SSO no se puede leer, tiene un formato incorrecto o no es privada del usuario actual. | Ejecute `devin auth login`; al volver a iniciar sesión, la caché se reescribe con permisos exclusivos para el propietario. |

## `NET` Red

Estos errores los notifican las sondas de endpoint de `devin airgap doctor` y las solicitudes de inferencia y al IdP. Cada fallo `NET` incluye la cadena de errores subyacente.

| Código | Significado | Qué hacer |
| - | - | - |
| `NET001` | Falló la resolución DNS del host del endpoint. | Compruebe el nombre de host en el archivo de modelos o en el archivo de autenticación, así como el DNS de la estación de trabajo. |
| `NET002` | No se pudo establecer la conexión TCP (rechazada, restablecida o sin ruta). | Compruebe que el endpoint esté escuchando en el puerto y que los firewalls o las reglas del proxy permitan que la estación de trabajo acceda a él. |
| `NET003` | Falló el protocolo de enlace TLS: certificado no confiable, caducado o que no coincide. `devin airgap doctor` muestra el certificado que presentó el servidor (sujeto, emisor, caducidad) cuando es posible obtenerlo, e indica si `DEVIN_CA_BUNDLE` estaba en vigor. | Configure la confianza en la CA privada con [`DEVIN_CA_BUNDLE`](/es/federal/air-gapped/network-and-certificates#trust-a-private-ca-with-devin_ca_bundle) o corrija el certificado del servidor (nombre, cadena, caducidad). |
| `NET004` | El endpoint devolvió un estado HTTP de error distinto de 401/403. Un `404` en `GET {base_url}/models` se notifica como advertencia, ya que algunos servidores compatibles con OpenAI no implementan `/models`. | Revise el registro del propio endpoint y la ruta `base_url` (por ejemplo, si falta `/v1`). |
| `NET005` | Se agotó el tiempo de espera de la solicitud (10 s para las sondas de doctor, 30 s para las solicitudes al IdP, 30 s de conexión / 300 s de lectura para la inferencia). | Compruebe la carga del endpoint y de cualquier proxy intermedio; consulte [tiempos de espera](/es/federal/air-gapped/network-and-certificates#timeouts). |
| `NET006` | El endpoint rechazó las credenciales configuradas (HTTP 401/403). | Compruebe el valor de la variable `api_key.env` y que la clave sea válida para el endpoint. |

## Configuración de `CFG`

Lo notifican `devin airgap doctor` y el arranque de la aplicación.

| Código | Significado | Qué hacer |
| - | - | - |
| `CFG001` | Falta un directorio de configuración o de estado obligatorio, o no se puede escribir en él (`~/.config/devin`, `~/.local/share/devin` o el directorio del producto `cli-federal`; en Windows, `%APPDATA%\devin` o su subdirectorio `cli-federal`). | Cree el directorio o corrija su propietario y sus permisos para el usuario que ejecuta Devin. |
| `CFG002` | Una variable de entorno a la que hace referencia la configuración (el `api_key.env` de un modelo) no está definida en el entorno del agente. | Exporte la variable o defínala mediante el ajuste `devin.acp.agentEnv` de Desktop; consulte [Variables de entorno de la clave de API](/es/federal/air-gapped/models-file#api-key-environment-variables). |
| `CFG003` | No se encontró el archivo de modelos en `/etc/devin/models.json` (`C:\ProgramData\Devin\models.json` en Windows) ni en la ruta indicada por la anulación `DEVIN_MODELS_FILE`. | Instale el archivo de modelos; consulte [Archivo de modelos](/es/federal/air-gapped/models-file). |
| `CFG004` | El archivo `DEVIN_CA_BUNDLE` no existe, no se puede leer o no contiene certificados PEM válidos. | Corrija la ruta o el contenido del archivo; consulte [Red y certificados](/es/federal/air-gapped/network-and-certificates). |
| `CFG005` | No se pudo analizar la definición de un subagente personalizado (`agents/**/AGENT.md` o un archivo plano `agents/<name>.md`), normalmente debido a un frontmatter YAML no válido; el perfil se omite. También se notifica como advertencia cuando una definición declara claves de frontmatter que Devin no lee (por ejemplo, `allowed_tools` en lugar de `allowed-tools`); en ese caso, el perfil se carga igualmente. | Corrija el archivo indicado y el error de análisis que muestra `devin doctor`. |
| `CFG006` | Hay definida una variable de entorno `OTEL_EXPORTER_OTLP_*` que la exportación OTLP ignora (cualquier campo distinto de `ENDPOINT`, `HEADERS`, `TIMEOUT` y `PROTOCOL`; cualquier variable `TRACES_`; o un `PROTOCOL` no compatible). Es una advertencia; se muestra el nombre de la variable, pero nunca su valor. | Elimine o corrija la variable. |

`CFG005` y `CFG006` provienen de las comprobaciones estándar de `devin doctor` y no son exclusivas de la compilación aislada de la red.

## Cómo interpretar un fallo

Este es un fallo de validación típico:

```sh theme={null}
devin models validate
```

```text theme={null}
/etc/devin/models.json: 1 problem(s) found
  MDL010 [model 'qwen3-vl-32b']: model 'qwen3-vl-32b': `base_url` must be an https:// URL (plain http:// is only allowed for loopback addresses: localhost, 127.0.0.0/8, or [::1])
```

Busca el código en las tablas anteriores, aplica la acción correspondiente y vuelve a ejecutar `devin airgap doctor` hasta que se superen todas las comprobaciones. Si un código no aparece aquí, tu compilación es más reciente que esta página; ejecuta `devin --version` e incluye el mensaje completo en tu solicitud de soporte, como se describe en [Solución de problemas](/es/federal/air-gapped/troubleshooting).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.