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

# Referência de códigos de erro do Devin air-gapped

> Catálogo completo dos códigos de erro LIC, MDL, IDP, NET e CFG exibidos pelo Devin CLI e pelo Desktop air-gapped, com o significado de cada um e a ação que o administrador deve tomar.

> [!NOTE]
>
> Esta documentação é destinada às implantações federais do Devin. [Voltar para a Documentação do Devin](/pt-BR/get-started/devin-intro)

Toda falha que o CLI e o Desktop air-gapped conseguem diagnosticar é informada com um código estável no formato `XXXnnn`. Os códigos aparecem no início da mensagem de erro no terminal, na saída de `devin airgap doctor`, nos diagnósticos do Desktop e no campo `error_code` dos [eventos de auditoria](/pt-BR/federal/air-gapped/on-disk-formats#auth) de `auth`. O número identifica a condição, e não o texto da mensagem, então você pode usá-lo como referência em runbooks de suporte e alertas de SIEM.

| Namespace | Abrange | Página detalhada |
| - | - | - |
| `LIC` | Validação do arquivo de licença | [Licença](/pt-BR/federal/air-gapped/license) |
| `MDL` | Validação do arquivo de modelos | [Arquivo de modelos](/pt-BR/federal/air-gapped/models-file) |
| `IDP` | SSO e provedor de identidade | [SSO](/pt-BR/federal/air-gapped/sso) |
| `NET` | Acessibilidade de endpoints, TLS, verificação HTTP | [Rede e certificados](/pt-BR/federal/air-gapped/network-and-certificates) |
| `CFG` | Caminhos locais, configuração, ambiente | [Rede e certificados](/pt-BR/federal/air-gapped/network-and-certificates), [Arquivo de modelos](/pt-BR/federal/air-gapped/models-file) |

## `LIC` Licença

Exibido como `LIC00n: <message>`, seguido do caminho verificado e de como substituí-lo (`DEVIN_LICENSE_FILE`).

| Código | Significado | O que fazer |
| - | - | - |
| `LIC001` | Arquivo de licença ausente ou ilegível em `/etc/devin/license.devin-onprem-license` (`C:\ProgramData\Devin\license.devin-onprem-license` no Windows) ou no caminho definido em `DEVIN_LICENSE_FILE`. No Windows, também é retornado quando um usuário padrão tenta substituir, pelo Desktop, uma licença pertencente a um administrador. | Instale o arquivo no caminho padrão ou defina `DEVIN_LICENSE_FILE`; verifique se o usuário que executa o Devin tem permissão de leitura. |
| `LIC002` | Arquivo malformado: não é um JWT EdDSA válido ou não há `kid` no cabeçalho. | Baixe a licença novamente no portal e transfira-a byte a byte (sem adicionar quebras de linha, quebra automática de texto nem alterar a codificação). |
| `LIC003` | Falha na verificação da assinatura. | O payload foi alterado após a assinatura. Baixe a licença novamente. |
| `LIC004` | `kid` desconhecido: nenhuma chave pública correspondente está incorporada neste build. | Execute a [verificação do `kid`](/pt-BR/federal/air-gapped/license#check-the-key-id). A licença foi emitida por outro ambiente ou seu build é anterior a uma rotação de chave; instale a versão atual. |
| `LIC005` | Licença expirada há mais de 24 horas (fim do período de tolerância). | Renove a licença pelo portal. |
| `LIC006` | Ainda não válida: emitida com data mais de 24 horas no futuro. | Verifique o relógio do host; se estiver correto, entre em contato com sua equipe de suporte. |
| `LIC007` | Claim `product` incorreta (diferente de `devin-onprem`). | O arquivo não é uma licença do Devin air-gapped. Baixe-o novamente no portal. |

## Arquivo de modelos `MDL`

Reportados por `devin models validate`, `devin airgap doctor`, pelas configurações de modelos do Desktop e na inicialização do agente. Cada diagnóstico indica a entrada de modelo à qual se refere.

| Código | Significado | O que fazer |
| - | - | - |
| `MDL001` | O arquivo não é um JSON válido para o schema v0, o que inclui campos desconhecidos. | Corrija o JSON; remova os campos que não constam no [schema](/pt-BR/federal/air-gapped/models-file#schema-reference-version-0). |
| `MDL002` | `schema_version` não suportado. | Defina `"schema_version": 0`. |
| `MDL003` | `models` está vazio. | Adicione pelo menos uma entrada de modelo. |
| `MDL004` | Um modelo tem `name` vazio. | Atribua um `name` único a cada entrada. |
| `MDL005` | `name` de modelo duplicado. | Renomeie uma das entradas. |
| `MDL006` | `base_url` vazio. | Defina a URL do endpoint. |
| `MDL007` | `api_key.env` vazio. | Informe o nome da variável de ambiente que contém a chave. |
| `MDL008` | `max_context_tokens` é zero. | Defina a janela de contexto do modelo. |
| `MDL009` | Mais de um modelo marcado como `default`. | Mantenha `default: true` em apenas uma entrada. |
| `MDL010` | `base_url` não é uma URL `https://` com host (`http://` só é aceito para endereços de loopback). | Use `https://` ou um endereço de loopback para um servidor no mesmo host. |
| `MDL011` | `max_output_tokens` excede `max_context_tokens`. | Reduza `max_output_tokens`. |
| `MDL012` | O arquivo existe, mas não pôde ser lido (permissões ou UTF-8 inválido). | Corrija a permissão de leitura do usuário que executa o Devin; salve o arquivo em UTF-8. |
| `MDL013` | `max_output_tokens` é zero. | Remova o campo ou defina um valor positivo. |
| `MDL014` | O arquivo pertence a outro usuário, por isso o Desktop se recusa a substituí-lo. | Edite o arquivo no disco como proprietário dele ou aponte `DEVIN_MODELS_FILE` para um arquivo seu. |

## `IDP` SSO e provedor de identidade

Reportados por `devin auth login`, `devin auth status`, na inicialização do agente e pelo fluxo de login do Desktop. `IDP004` e `IDP005` também são gravados no registro de auditoria em eventos `sso_login_denied`, e qualquer código `IDP` pode aparecer em `sso_revalidation_failed`.

| Código | Significado | O que fazer |
| - | - | - |
| `IDP001` | O arquivo de autenticação está ilegível ou é inválido. | Corrija `/etc/devin/auth.json` (`C:\ProgramData\Devin\auth.json` no Windows) ou o arquivo no caminho definido em `DEVIN_AUTH_FILE`; a mensagem indica o campo com problema. |
| `IDP002` | Não há login em cache para o emissor configurado. | Execute `devin auth login`. |
| `IDP003` | O login é inválido ou expirou e não pôde ser renovado em segundo plano (inclusive quando o IdP retorna `invalid_grant`). | Execute `devin auth login` novamente. |
| `IDP004` | O login foi feito, mas o usuário não é membro de `required_group`. | Adicione o usuário ao grupo no IdP ou corrija `required_group` / `groups_claim` no arquivo de autenticação. |
| `IDP005` | Não foi possível acessar o IdP, ou ele retornou um erro ou um ID token que não passou na validação. | Verifique a conectividade de rede, a confiança TLS (`DEVIN_CA_BUNDLE`), o valor de `issuer` e os logs do próprio IdP. |
| `IDP006` | O cache local de tokens SSO está ilegível, corrompido ou não é privado do usuário atual. | Execute `devin auth login`; um novo login regrava o cache com permissões restritas ao proprietário. |

## `NET` Rede

Reportados pelas sondagens de endpoint do `devin airgap doctor` e por requisições de inferência e ao IdP. Cada falha `NET` inclui a cadeia de erros subjacente.

| Código | Significado | O que fazer |
| - | - | - |
| `NET001` | Falha na resolução DNS do host do endpoint. | Verifique o nome do host no arquivo de modelos ou no arquivo de autenticação, além do DNS da estação de trabalho. |
| `NET002` | Não foi possível estabelecer a conexão TCP (recusada, redefinida ou sem rota). | Verifique se o endpoint está escutando na porta e se as regras de firewall ou de proxy permitem que a estação de trabalho o acesse. |
| `NET003` | Falha no handshake TLS: certificado não confiável, expirado ou incompatível. O `devin airgap doctor` exibe o certificado apresentado pelo servidor (subject, emissor, validade), quando possível, e informa se o `DEVIN_CA_BUNDLE` estava em vigor. | Configure a confiança na CA privada com [`DEVIN_CA_BUNDLE`](/pt-BR/federal/air-gapped/network-and-certificates#trust-a-private-ca-with-devin_ca_bundle) ou corrija o certificado do servidor (nome, cadeia, validade). |
| `NET004` | O endpoint retornou um status HTTP de erro diferente de 401/403. Um `404` em `GET {base_url}/models` é reportado como aviso, já que alguns servidores compatíveis com OpenAI não implementam `/models`. | Verifique os logs do próprio endpoint e o caminho do `base_url` (por exemplo, a falta de `/v1`). |
| `NET005` | A requisição excedeu o tempo limite (10 s para as sondagens do doctor, 30 s para requisições ao IdP, 30 s de conexão / 300 s de leitura para inferência). | Verifique a carga no endpoint e em qualquer proxy intermediário; consulte [tempos limite](/pt-BR/federal/air-gapped/network-and-certificates#timeouts). |
| `NET006` | O endpoint rejeitou as credenciais configuradas (HTTP 401/403). | Verifique o valor na variável `api_key.env` e se a chave é válida para o endpoint. |

## Configuração `CFG`

Reportados pelo `devin airgap doctor` e na inicialização.

| Código | Significado | O que fazer |
| - | - | - |
| `CFG001` | Um diretório de configuração ou de estado obrigatório está ausente ou sem permissão de escrita (`~/.config/devin`, `~/.local/share/devin` ou o diretório do produto `cli-federal`; no Windows, `%APPDATA%\devin` ou seu subdiretório `cli-federal`). | Crie o diretório ou corrija o proprietário e as permissões para o usuário que executa o Devin. |
| `CFG002` | Uma variável de ambiente referenciada pela configuração (o `api_key.env` de um modelo) não está definida no ambiente do agente. | Exporte a variável ou defina-a pela configuração `devin.acp.agentEnv` do Desktop; consulte [Variáveis de ambiente da chave de API](/pt-BR/federal/air-gapped/models-file#api-key-environment-variables). |
| `CFG003` | O arquivo de modelos não foi encontrado em `/etc/devin/models.json` (`C:\ProgramData\Devin\models.json` no Windows) nem no override `DEVIN_MODELS_FILE`. | Instale o arquivo de modelos; consulte [Arquivo de modelos](/pt-BR/federal/air-gapped/models-file). |
| `CFG004` | O arquivo `DEVIN_CA_BUNDLE` está ausente, ilegível ou não contém certificados PEM válidos. | Corrija o caminho ou o conteúdo do arquivo; consulte [Rede e certificados](/pt-BR/federal/air-gapped/network-and-certificates). |
| `CFG005` | Não foi possível fazer o parsing da definição de um subagente personalizado (`agents/**/AGENT.md` ou um `agents/<name>.md` simples), geralmente por causa de frontmatter YAML inválido; o perfil é ignorado. Também é reportado como aviso quando uma definição declara chaves de frontmatter que o Devin não lê (por exemplo, `allowed_tools` em vez de `allowed-tools`); nesse caso, o perfil ainda é carregado. | Corrija o arquivo indicado e o erro de parsing exibido pelo `devin doctor`. |
| `CFG006` | Há uma variável de ambiente `OTEL_EXPORTER_OTLP_*` definida que a exportação OTLP ignora (qualquer campo diferente de `ENDPOINT`, `HEADERS`, `TIMEOUT` e `PROTOCOL`; qualquer variável `TRACES_`; ou um `PROTOCOL` não suportado). É apenas um aviso; o nome da variável é exibido, mas nunca o seu valor. | Remova ou corrija a variável. |

`CFG005` e `CFG006` vêm das verificações padrão do `devin doctor` e não são exclusivos do build air-gapped.

## Interpretando uma falha

Uma falha típica de validação:

```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])
```

Localize o código nas tabelas acima, aplique a ação indicada e execute `devin airgap doctor` novamente até que todas as verificações sejam aprovadas. Se um código não estiver listado aqui, seu build é mais recente que esta página. Nesse caso, execute `devin --version` e inclua a mensagem completa na sua requisição de suporte, conforme descrito em [Solução de problemas](/pt-BR/federal/air-gapped/troubleshooting).


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