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

Esta documentación corresponde a los despliegues federales de Devin. Volver a la documentación de Devin

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 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
`MDL`	Validación del archivo de modelos	Archivo de modelos
`IDP`	SSO y proveedor de identidad	SSO
`NET`	Accesibilidad de endpoints, TLS, sondeo HTTP	Red y certificados
`CFG`	Rutas locales, configuración, entorno	Red y certificados, Archivo de modelos

`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`. 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.
`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` 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.
`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.
`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.
`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.
`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:

devin models validate

/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.

​LIC Licencia

​MDL Archivo de modelos

​IDP SSO y proveedor de identidad

​NET Red

​Configuración de CFG

​Cómo interpretar un fallo

`LIC` Licencia

`MDL` Archivo de modelos

`IDP` SSO y proveedor de identidad

`NET` Red

Configuración de `CFG`

Cómo interpretar un fallo