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

# Resolución de problemas

> Problemas comunes y cómo solucionarlos

<div id="installation-issues">
  ## Problemas de instalación
</div>

<AccordionGroup>
  <Accordion title="El comando de instalación falla (macOS / Linux / WSL)">
    Si no se puede descargar el script de instalación:

    1. Comprueba tu conexión a internet
    2. Verifica que curl esté instalado: `which curl`
    3. 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:

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

  <Accordion title="El comando de instalación falla (Windows)">
    Si falla el script de instalación de PowerShell:

    1. Comprueba tu conexión a internet
    2. Asegúrate de ejecutar PowerShell como un usuario normal (no como Administrador, salvo que sea necesario)
    3. Si ves un error de política de ejecución, prueba:
       ```powershell theme={null}
       Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
       irm https://static.devin.ai/cli/setup.ps1 | iex
       ```
    4. 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](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="Permiso denegado durante la instalación">
    El instalador necesita acceso de escritura para instalar el binario. Si ves errores de permisos:

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

  <Accordion title="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:**

    1. Reinicia la terminal o ejecuta `source ~/.bashrc` (o `~/.zshrc`)
    2. Comprueba si la ubicación del binario está en tu PATH: `echo $PATH`
    3. 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:**

    1. Reinicia tu sesión de PowerShell
    2. Comprueba si la ubicación del binario está en tu PATH: `$env:PATH -split ';'`
    3. Verifica que el binario exista en la ubicación de instalación que se muestra durante la configuración inicial
  </Accordion>

  <Accordion title="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:

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

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

    ```bash theme={null}
    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**.
  </Accordion>
</AccordionGroup>

***

<div id="authentication-issues">
  ## Problemas de autenticación
</div>

<AccordionGroup>
  <Accordion title="El inicio de sesión falla o se agota el tiempo de espera">
    Si el inicio de sesión desde el navegador no funciona:

    1. Prueba el flujo manual con token para sesiones remotas/SSH:
       ```bash theme={null}
       devin auth login --force-manual-token-flow
       ```
    2. Comprueba que tu navegador pueda acceder a la URL de autenticación
    3. Verifica que tu cuenta Enterprise tenga habilitado el acceso a Devin CLI
  </Accordion>

  <Accordion title="'No autorizado' o errores de permiso">
    Si ves errores de autorización después de iniciar sesión:

    1. 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](/es/cli/enterprise/devin-auth#configuring-access) o [Legacy Windsurf Auth](/es/cli/enterprise/windsurf-auth#prerequisites) para ver cómo configurar el acceso.
    2. Intenta cerrar sesión y volver a iniciarla: `devin auth logout && devin auth login`
    3. Comprueba tu estado de autenticación: `devin auth status`
  </Accordion>

  <Accordion title="Token rechazado o revocado">
    Los tokens de API de Devin CLI no caducan de forma predeterminada. Si un token almacenado ha sido revocado o ya no se acepta, elimínalo antes de volver a iniciar sesión:

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

    para reemplazar tus credenciales almacenadas.
  </Accordion>
</AccordionGroup>

***

<div id="network-proxy-issues">
  ## Problemas de red y proxy
</div>

<AccordionGroup>
  <Accordion title="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:

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

    **`config.json`** — se aplica independientemente del entorno:

    ```json theme={null}
    {
      "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`](/es/cli/reference/configuration/config-file#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).
  </Accordion>

  <Accordion title="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`:

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

    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`

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

  <Accordion title="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](https://mitmproxy.org/):

    ```bash theme={null}
    # 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á.
  </Accordion>
</AccordionGroup>

***

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

<AccordionGroup>
  <Accordion title="Modelo no disponible">
    Si ves errores que indican que un modelo no está disponible:

    1. Comprueba si tu Enterprise restringe los modelos disponibles en [Team Settings](/es/cli/enterprise/team-settings)
    2. Verifica que el nombre del modelo sea correcto — usa `/model` para ver las opciones disponibles
    3. Prueba con otro modelo: `devin --model sonnet -- your prompt`
  </Accordion>

  <Accordion title="Límite de tasa o cuota excedida">
    Si alcanzas los límites de uso:

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

  <Accordion title="El agente parece atascado o no responde">
    Si el agente deja de responder:

    1. Pulsa `Ctrl+C` para interrumpir la operación actual
    2. Prueba `/clear` para iniciar una sesión nueva
    3. Comprueba tu conexión de red
    4. Reinicia Devin CLI
  </Accordion>
</AccordionGroup>

***

<div id="mcp-server-issues">
  ## Problemas con el servidor MCP
</div>

<AccordionGroup>
  <Accordion title="El servidor no se inicia">
    Si un servidor MCP no se inicia:

    1. Verifica que el comando funcione fuera de Devin CLI:
       ```bash theme={null}
       npx -y @modelcontextprotocol/server-github
       ```
    2. Comprueba que todas las variables de entorno requeridas estén definidas
    3. Busca mensajes de error en la salida del servidor
  </Accordion>

  <Accordion title="Las herramientas no aparecen">
    Si las herramientas MCP no aparecen:

    1. Es posible que el servidor necesite un momento para inicializarse — espera unos segundos
    2. Comprueba que el servidor esté configurado correctamente en tu archivo de configuración
    3. Verifica que tu Enterprise permita servidores MCP en [Team Settings](/es/cli/enterprise/team-settings)
  </Accordion>

  <Accordion title="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:

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

***

<div id="getting-help">
  ## Obtener ayuda
</div>

Si sigues teniendo problemas:

* **Soporte por correo:** [support@cognition.ai](mailto: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