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

# Solução de problemas

> Problemas comuns e como resolvê-los

<div id="installation-issues">
  ## Problemas de instalação
</div>

<AccordionGroup>
  <Accordion title="O comando de instalação falha (macOS / Linux / WSL)">
    Se o script de instalação não conseguir baixar:

    1. Verifique sua conexão com a internet
    2. Verifique se o curl está instalado: `which curl`
    3. Tente com saída detalhada: `curl -fsSL -v https://cli.devin.ai/install.sh | bash`

    Se você estiver atrás de um proxy corporativo, talvez seja necessário configurar as configurações de proxy:

    ```bash theme={null}
    export https_proxy=http://your-proxy:port
    curl -fsSL https://cli.devin.ai/install.sh | bash
    ```
  </Accordion>

  <Accordion title="O comando de instalação falha (Windows)">
    Se o script de instalação do PowerShell falhar:

    1. Verifique sua conexão com a internet
    2. Certifique-se de que você está executando o PowerShell como um usuário comum (não como Administrador, a menos que seja necessário)
    3. Se aparecer um erro de política de execução, tente:
       ```powershell theme={null}
       Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
       irm https://static.devin.ai/cli/setup.ps1 | iex
       ```
    4. Se você estiver atrás de um proxy corporativo, configure as configurações de proxy no PowerShell antes de executar o comando de instalação

    Como alternativa ao script do PowerShell, você pode baixar e executar diretamente o instalador independente:

    * [x86\_64](https://static.devin.ai/cli/devin-updater-x86_64-pc-windows.exe)
    * [ARM64](https://static.devin.ai/cli/devin-updater-aarch64-pc-windows.exe)
  </Accordion>

  <Accordion title="Permissão negada durante a instalação">
    O instalador precisa de permissão de gravação para instalar o binário. Se aparecerem erros de permissão:

    1. Verifique se o local de instalação tem permissão de gravação
    2. Não execute o instalador com `sudo` — isso pode causar problemas de propriedade
    3. Se estiver instalando em um diretório do sistema, certifique-se de que seu usuário tenha as permissões adequadas
  </Accordion>

  <Accordion title="Binário não encontrado após a instalação">
    Se a instalação for concluída, mas `devin` não for encontrado:

    **macOS / Linux / WSL:**

    1. Reinicie o terminal ou execute `source ~/.bashrc` (ou `~/.zshrc`)
    2. Verifique se o local do binário está no seu PATH: `echo $PATH`
    3. Confirme se o binário existe: `ls -la ~/.local/bin/devin` (ou no local de instalação mostrado durante a configuração)

    **Windows:**

    1. Reinicie sua sessão do PowerShell
    2. Verifique se o local do binário está no seu PATH: `$env:PATH -split ';'`
    3. Confirme se o binário existe no local de instalação mostrado durante a configuração
  </Accordion>

  <Accordion title="'irm' ou 'iex' não encontrado (Windows)">
    `irm` e `iex` são aliases do PowerShell. Se esse erro aparecer, você está executando o comando de instalação no Git Bash ou no CMD em vez do PowerShell.

    **Correção:** Abra o **PowerShell** e execute o comando de instalação nele:

    ```powershell theme={null}
    irm https://static.devin.ai/cli/setup.ps1 | iex
    ```

    Como alternativa, no Git Bash ou no CMD, você pode invocar o PowerShell explicitamente:

    ```bash theme={null}
    powershell -Command "irm https://cli.devin.ai/install.ps1 | iex"
    ```

    Após a instalação, você pode usar o Devin CLI no **PowerShell**, **Windows Terminal** ou **Git Bash**.
  </Accordion>
</AccordionGroup>

***

<div id="authentication-issues">
  ## Problemas de autenticação
</div>

<AccordionGroup>
  <Accordion title="Falha no login ou timeout">
    Se o login pelo navegador não funcionar:

    1. Tente o fluxo manual com token para sessões remotas/SSH:
       ```bash theme={null}
       devin auth login --force-manual-token-flow
       ```
    2. Verifique se o navegador consegue acessar a URL de autenticação
    3. Confirme se o acesso ao Devin CLI está ativado na sua conta Enterprise
  </Accordion>

  <Accordion title="'Não autorizado' ou erros de permissão">
    Se aparecerem erros de autorização após o login:

    1. Verifique se a sua conta tem a permissão necessária para acessar o Devin CLI. Talvez seja necessário pedir ajuda ao seu administrador. Em ambientes Enterprise, consulte [Devin Auth](/pt-BR/cli/enterprise/devin-auth#configuring-access) ou [Legacy Windsurf Auth](/pt-BR/cli/enterprise/windsurf-auth#prerequisites) para saber como configurar o acesso.
    2. Tente sair e fazer login novamente: `devin auth logout && devin auth login`
    3. Verifique seu status de autenticação: `devin auth status`
  </Accordion>

  <Accordion title="Token rejeitado ou revogado">
    Os tokens de API do Devin CLI não expiram por padrão. Se um token armazenado tiver sido revogado ou não for mais aceito, remova-o antes de fazer login novamente:

    ```bash theme={null}
    devin auth logout && devin auth login
    ```

    para substituir suas credenciais armazenadas.
  </Accordion>
</AccordionGroup>

***

<div id="network-proxy-issues">
  ## Problemas de rede e proxy
</div>

<AccordionGroup>
  <Accordion title="As conexões falham atrás de um proxy corporativo">
    A CLI roteia seu próprio tráfego HTTPS de saída (autenticação, atualizações, chamadas à API do modelo, servidores MCP) por um proxy quando ele está configurado. Há duas formas de defini-lo:

    **Variáveis de ambiente** — o modo de proxy `system` padrão respeita estas variáveis:

    ```bash theme={null}
    export HTTPS_PROXY=http://proxy.corp.example.com:8080
    export HTTP_PROXY=http://proxy.corp.example.com:8080
    export ALL_PROXY=socks5://proxy.corp.example.com:1080   # opcional, SOCKS5
    export NO_PROXY=localhost,127.0.0.1,.internal.corp      # hosts que ignoram o proxy
    ```

    **`config.json`** — se aplica independentemente do ambiente:

    ```json theme={null}
    {
      "proxy": {
        "mode": "manual",
        "url": "http://proxy.corp.example.com:8080",
        "no_proxy": "localhost,127.0.0.1,.internal.corp"
      }
    }
    ```

    Consulte a [referência de configuração de `proxy`](/pt-BR/cli/reference/configuration/config-file#proxy) para ver todas as opções. No macOS e no Windows, o modo `system` também respeita as configurações nativas de PAC (Configuração Automática de Proxy) da plataforma.

    Se o seu proxy faz inspeção de TLS, a CLI usa o repositório de certificados do sistema operacional. Portanto, instale a CA raiz do proxy no nível do sistema operacional (Keychain no macOS, o repositório de certificados do Windows ou o pacote de CAs da sua distribuição no Linux).
  </Accordion>

  <Accordion title="Capture logs completos de requisições HTTP para depuração">
    Para ter visibilidade total do ciclo de vida da requisição (DNS, pool de conexões, handshake TLS, cabeçalhos, redirecionamentos e novas tentativas), aumente o nível de log com `RUST_LOG` e espelhe os logs no terminal com `CHISEL_LOG_STDOUT`:

    ```bash theme={null}
    RUST_LOG="chisel=trace,windsurf_api_client=trace,connect_rpc=trace,reqwest=trace,hyper=trace,hyper_util=trace,rustls=trace" \
      CHISEL_LOG_STDOUT=1 \
      devin auth login
    ```

    O que cada alvo adiciona:

    * `chisel`, `windsurf_api_client`, `connect_rpc` — logs de requisição e autenticação da própria CLI
    * `reqwest=trace` — tratamento de requisição/resposta em alto nível e de redirecionamentos
    * `hyper=trace` / `hyper_util=trace` — estabelecimento de conexão, pooling e framing de HTTP/1.1 e HTTP/2
    * `rustls=trace` — detalhes do handshake TLS (útil para problemas com proxy e certificados)

    Use `CHISEL_LOG_STDERR=1` em vez de `CHISEL_LOG_STDOUT=1` se não quiser os logs intercalados com a saída do comando. (O log em stdout é suprimido automaticamente no REPL interativo e no modo ACP para evitar corromper a saída.)

    Os logs também são sempre gravados em um arquivo por execução no diretório de dados da CLI, independentemente destas variáveis de ambiente:

    * **macOS / Linux:** `~/.local/share/devin/cli/logs/devin_<timestamp>_<pid>.log`
    * **Windows:** `%APPDATA%\devin\cli\logs\devin_<timestamp>_<pid>.log`

    <Warning>
      Logs no nível trace podem incluir dados sensíveis, como cabeçalhos `Authorization` e tokens. Oculte informações sensíveis da saída de log antes de compartilhá-la.
    </Warning>
  </Accordion>

  <Accordion title="Inspecione corpos completos de requisições e respostas">
    `RUST_LOG` expõe o ciclo de vida da requisição, mas não os payloads completos. Para capturar os corpos completos de requisições e respostas, roteie a CLI por um proxy de interceptação, como o [mitmproxy](https://mitmproxy.org/):

    ```bash theme={null}
    # Terminal 1 — inicie o proxy de interceptação:
    mitmproxy --listen-port 8080

    # Terminal 2 — aponte a CLI para ele:
    export HTTPS_PROXY=http://127.0.0.1:8080
    devin auth login
    ```

    Como a CLI confia no repositório de certificados do sistema operacional, instale primeiro o certificado de CA do mitmproxy (`~/.mitmproxy/mitmproxy-ca-cert.pem`) no repositório de confiança do sistema. Caso contrário, a conexão TLS com o proxy falhará.
  </Accordion>
</AccordionGroup>

***

<div id="runtime-issues">
  ## Problemas de runtime
</div>

<AccordionGroup>
  <Accordion title="Modelo não disponível">
    Se você vir erros informando que um modelo não está disponível:

    1. Verifique se sua Enterprise restringe os modelos disponíveis em [Configurações da equipe](/pt-BR/cli/enterprise/team-settings)
    2. Confirme se o nome do modelo está correto — use `/model` para ver as opções disponíveis
    3. Tente um modelo diferente: `devin --model sonnet -- your prompt`
  </Accordion>

  <Accordion title="Limite de taxa ou cota excedida">
    Se você atingir os limites de uso:

    1. Aguarde alguns minutos antes de tentar novamente
    2. Verifique o painel de uso da sua organização para conferir o status da cota
    3. Entre em contato com seu administrador se precisar de limites mais altos
  </Accordion>

  <Accordion title="O agente parece travado ou não responde">
    Se o agente parar de responder:

    1. Pressione `Ctrl+C` para interromper a operação atual
    2. Tente `/clear` para iniciar uma nova sessão
    3. Verifique sua conexão de rede
    4. Reinicie o Devin CLI
  </Accordion>
</AccordionGroup>

***

<div id="mcp-server-issues">
  ## Problemas com o servidor MCP
</div>

<AccordionGroup>
  <Accordion title="O servidor não inicia">
    Se um servidor MCP não iniciar:

    1. Verifique se o comando funciona fora do Devin CLI:
       ```bash theme={null}
       npx -y @modelcontextprotocol/server-github
       ```
    2. Verifique se todas as variáveis de ambiente necessárias estão definidas
    3. Procure mensagens de erro na saída do servidor
  </Accordion>

  <Accordion title="Ferramentas não aparecem">
    Se as ferramentas MCP não aparecerem:

    1. O servidor pode precisar de um momento para inicializar — aguarde alguns segundos
    2. Verifique se o servidor está configurado corretamente no seu arquivo de configuração
    3. Verifique se a sua Enterprise permite servidores MCP em [Configurações da equipe](/pt-BR/cli/enterprise/team-settings)
  </Accordion>

  <Accordion title="Permissão negada para ferramentas MCP">
    As ferramentas MCP, por padrão, solicitam aprovação. Para aprovar automaticamente ferramentas específicas, adicione-as à sua configuração de permissões:

    ```json theme={null}
    {
      "permissions": {
        "allow": ["mcp__github__list_issues"]
      }
    }
    ```
  </Accordion>
</AccordionGroup>

***

<div id="getting-help">
  ## Como obter ajuda
</div>

Se você ainda estiver enfrentando problemas:

* **Envie um e-mail para o suporte:** [support@cognition.ai](mailto:support@cognition.ai)
* **Envie um relatório de bug:** use o comando `/bug` no Devin CLI para relatar problemas diretamente aos desenvolvedores do Devin CLI
* **Verifique se há atualizações:** execute `devin update` para garantir que você esteja usando a versão mais recente