Resolución de problemas

Problemas de instalación

El comando de instalación falla (macOS / Linux / WSL)

Si no se puede descargar el script de instalación:

Comprueba tu conexión a internet
Verifica que curl esté instalado: which curl
Prueba con salida detallada: curl -fsSL -v https://cli.devin.ai/install.sh | bash

Si estás detrás de un proxy corporativo, puede que necesites configurar el proxy:

export https_proxy=http://your-proxy:port
curl -fsSL https://cli.devin.ai/install.sh | bash

El comando de instalación falla (Windows)

Si falla el script de instalación de PowerShell:

Comprueba tu conexión a internet
Asegúrate de ejecutar PowerShell como un usuario normal (no como Administrador, salvo que sea necesario)

Si ves un error de política de ejecución, prueba:

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
irm https://static.devin.ai/cli/setup.ps1 | iex

Si estás detrás de un proxy corporativo, configura el proxy en PowerShell antes de ejecutar el comando de instalación

Como alternativa al script de PowerShell, puedes descargar y ejecutar directamente el instalador independiente:

x86_64
ARM64

Permiso denegado durante la instalación

El instalador necesita acceso de escritura para instalar el binario. Si ves errores de permisos:

Comprueba que la ubicación de instalación tenga permisos de escritura
No ejecutes el instalador con sudo — esto puede provocar problemas de propiedad
Si vas a instalar en un directorio del sistema, asegúrate de que tu usuario tenga los permisos adecuados

No se encuentra el binario después de la instalación

Si la instalación se completa pero no se encuentra devin:macOS / Linux / WSL:

Reinicia la terminal o ejecuta source ~/.bashrc (o ~/.zshrc)
Comprueba si la ubicación del binario está en tu PATH: echo $PATH
Verifica que el binario exista: ls -la ~/.local/bin/devin (o en la ubicación de instalación que se muestra durante la configuración inicial)

Windows:

Reinicia tu sesión de PowerShell
Comprueba si la ubicación del binario está en tu PATH: $env:PATH -split ';'
Verifica que el binario exista en la ubicación de instalación que se muestra durante la configuración inicial

No se encuentra el comando 'irm' o 'iex' (Windows)

irm e iex son alias de PowerShell. Si ves este error, estás ejecutando el comando de instalación en Git Bash o CMD en lugar de PowerShell.Solución: Abre PowerShell y ejecuta allí el comando de instalación:

irm https://static.devin.ai/cli/setup.ps1 | iex

Como alternativa, desde Git Bash o CMD puedes invocar PowerShell explícitamente:

powershell -Command "irm https://cli.devin.ai/install.ps1 | iex"

Después de la instalación, puedes usar Devin CLI desde PowerShell, Windows Terminal o Git Bash.

Problemas de autenticación

El inicio de sesión falla o se agota el tiempo de espera

Si el inicio de sesión desde el navegador no funciona:

Prueba el flujo manual con token para sesiones remotas/SSH:
```
devin auth login --force-manual-token-flow
```
Comprueba que tu navegador pueda acceder a la URL de autenticación
Verifica que tu cuenta Enterprise tenga habilitado el acceso a Devin CLI

'No autorizado' o errores de permiso

Si ves errores de autorización después de iniciar sesión:

Verifica que tu cuenta tenga el permiso correcto para acceder a Devin CLI. Puede que necesites pedir ayuda a tu Admin. En Enterprise, consulta Devin Auth o Windsurf Auth para ver cómo configurar el acceso.
Intenta cerrar sesión y volver a iniciarla: devin auth logout && devin auth login
Comprueba tu estado de autenticación: devin auth status

El token ha expirado

Los tokens de autenticación caducan periódicamente. Simplemente ejecuta:

devin auth login

para actualizar tus credenciales.

Problemas de red y proxy

Las conexiones fallan detrás de un proxy corporativo

La CLI enruta su propio tráfico HTTPS saliente (autenticación, actualizaciones, llamadas a la API del modelo, servidor MCP) a través de un proxy cuando hay uno configurado. Hay dos formas de configurarlo:Variables de entorno — el modo de proxy system predeterminado respeta estas variables:

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

config.json — se aplica independientemente del entorno:

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

Consulta la referencia de configuración de proxy para ver todas las opciones. En macOS y Windows, el modo system también respeta la configuración PAC (configuración automática de proxy) nativa de la plataforma.Si tu proxy realiza inspección TLS, la CLI usa el almacén de certificados de tu sistema operativo, así que instala la CA raíz del proxy a nivel del sistema operativo (Keychain en macOS, el almacén de certificados de Windows o el paquete de CA de tu distribución en Linux).

Captura registros HTTP completos para depuración

Para obtener visibilidad completa del ciclo de vida de la solicitud (DNS, agrupación de conexiones, protocolo de enlace TLS, headers, redireccionamientos y reintentos), aumenta el nivel de registro con RUST_LOG y duplica los registros en tu terminal con 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

Lo que agrega cada destino:

chisel, windsurf_api_client, connect_rpc — el registro propio de solicitudes y autenticación de la CLI
reqwest=trace — manejo de solicitudes/respuestas y redireccionamientos de alto nivel
hyper=trace / hyper_util=trace — establecimiento y agrupación de conexiones, y entramado de HTTP/1.1 y HTTP/2
rustls=trace — detalles del protocolo de enlace TLS (útil para problemas con proxies y certificados)

Usa CHISEL_LOG_STDERR=1 en lugar de CHISEL_LOG_STDOUT=1 si no quieres que los registros se entremezclen con la salida del comando. (El registro en stdout se suprime automáticamente en el REPL interactivo y en el modo ACP para evitar corromper la salida).Los registros también se escriben siempre en un archivo de registro por ejecución dentro del directorio de datos de la CLI, independientemente de estas variables de entorno:

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

Los registros de nivel trace pueden incluir datos sensibles, como headers Authorization y tokens. Elimina la información sensible de la salida del registro antes de compartirla.

Inspecciona cuerpos completos de solicitudes y respuestas

RUST_LOG expone el ciclo de vida de la solicitud, pero no los payloads completos. Para capturar cuerpos completos de solicitudes y respuestas, enruta la CLI a través de un proxy de interceptación como mitmproxy:

# Terminal 1 — inicia el proxy de interceptación:
mitmproxy --listen-port 8080

# Terminal 2 — apunta la CLI hacia él:
export HTTPS_PROXY=http://127.0.0.1:8080
devin auth login

Como la CLI confía en el almacén de certificados del sistema operativo, primero instala el certificado de CA de mitmproxy (~/.mitmproxy/mitmproxy-ca-cert.pem) en el almacén de confianza del sistema; de lo contrario, la conexión TLS al proxy fallará.

Problemas de ejecución

Modelo no disponible

Si ves errores que indican que un modelo no está disponible:

Comprueba si tu Enterprise restringe los modelos disponibles en Team Settings
Verifica que el nombre del modelo sea correcto — usa /model para ver las opciones disponibles
Prueba con otro modelo: devin --model sonnet -- your prompt

Límite de tasa o cuota excedida

Si alcanzas los límites de uso:

Espera unos minutos antes de volver a intentarlo
Revisa el panel de uso de tu organización para consultar el estado de la cuota
Ponte en contacto con tu admin si necesitas límites más altos

El agente parece atascado o no responde

Si el agente deja de responder:

Pulsa Ctrl+C para interrumpir la operación actual
Prueba /clear para iniciar una sesión nueva
Comprueba tu conexión de red
Reinicia Devin CLI

Problemas con el servidor MCP

El servidor no se inicia

Si un servidor MCP no se inicia:

Verifica que el comando funcione fuera de Devin CLI:
```
npx -y @modelcontextprotocol/server-github
```
Comprueba que todas las variables de entorno requeridas estén definidas
Busca mensajes de error en la salida del servidor

Las herramientas no aparecen

Si las herramientas MCP no aparecen:

Es posible que el servidor necesite un momento para inicializarse — espera unos segundos
Comprueba que el servidor esté configurado correctamente en tu archivo de configuración
Verifica que tu Enterprise permita servidores MCP en Team Settings

Permiso denegado para las herramientas MCP

Las herramientas MCP solicitan aprobación de forma predeterminada. Para aprobar automáticamente herramientas específicas, agrégalas a tu configuración de permisos:

{
  "permissions": {
    "allow": ["mcp__github__list_issues"]
  }
}

Obtener ayuda

Si sigues teniendo problemas:

Soporte por correo: support@cognition.ai
Enviar un reporte de bug: Usa el comando /bug en Devin CLI para reportar problemas directamente a los desarrolladores de Devin CLI
Comprobar actualizaciones: Ejecuta devin update para asegurarte de que estás usando la versión más reciente

​Problemas de instalación

​Problemas de autenticación

​Problemas de red y proxy

​Problemas de ejecución

​Problemas con el servidor MCP

​Obtener ayuda

Problemas de instalación

Problemas de autenticación

Problemas de red y proxy

Problemas de ejecución

Problemas con el servidor MCP

Obtener ayuda