Pular para o conteúdo principal

​
Problemas de instalação

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:
export https_proxy=http://your-proxy:port
curl -fsSL https://cli.devin.ai/install.sh | bash
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: 
    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:
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
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
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:
irm https://static.devin.ai/cli/setup.ps1 | iex
Como alternativa, no Git Bash ou no CMD, você pode invocar o PowerShell explicitamente:
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.

​
Problemas de autenticação

Se o login pelo navegador não funcionar:
  1. Tente o fluxo manual com token para sessões remotas/SSH: 
    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
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 ou Windsurf Auth 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
Os tokens de autenticação expiram periodicamente. Basta executar:
devin auth login
para renovar suas credenciais.

​
Problemas de rede e proxy

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:
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:
{
  "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 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).
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:
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
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.
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:
# 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á.

​
Problemas de runtime

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

​
Problemas com o servidor MCP

Se um servidor MCP não iniciar:
  1. Verifique se o comando funciona fora do Devin CLI: 
    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
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
As ferramentas MCP, por padrão, solicitam aprovação. Para aprovar automaticamente ferramentas específicas, adicione-as à sua configuração de permissões:
{
  "permissions": {
    "allow": ["mcp__github__list_issues"]
  }
}

​
Como obter ajuda

Se você ainda estiver enfrentando problemas:
  • Envie um e-mail para o suporte: 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