Saltar al contenido principal
Devin funciona cargando una instantánea de una máquina virtual al inicio de cada sesión. Para que Devin sea lo más efectivo posible, esta instantánea debe incluir todos los repositorios con los que quieras que Devin trabaje, así como todas las herramientas o dependencias que pueda necesitar para trabajar en tu base de código. De esta manera, Devin puede concentrarse en escribir código en lugar de tener que configurar su entorno cada vez. En esta guía, veremos cómo integrar a Devin en uno de tus repositorios y configurar el espacio de trabajo de Devin (la instantánea de la máquina virtual). Puedes pensar en esto como configurar la máquina de Devin para su primer día de trabajo.
Configurar correctamente el espacio de trabajo de Devin mejorará significativamente el rendimiento de Devin en tu base de código. Imagina que cada vez que comienzas una tarea, tu portátil y parte de tu memoria se borraran: ¡eso es lo que le ocurre a Devin con una configuración incorrecta o incompleta!

​
Configurar un repositorio

Primero, asegúrate de que Devin tenga acceso a tus repositorios. Puedes añadir repositorios en cualquier momento yendo a Settings > Integrations y configurando el acceso de Devin.
Consulta la Guía de integración con GitHub para obtener más información.
Ahora, ve a Settings > Devin’s Workspace y haz clic en un repositorio en el que quieras que Devin trabaje. Deberías ver la siguiente pantalla.
Devin
Ahora puedes usar el VS Code integrado en la parte derecha para editar la máquina virtual de Devin. Cada repositorio estará en su propio directorio bajo ~/repos. No muevas ni elimines esos directorios. El repositorio que estás configurando actualmente ya ha sido clonado, y la máquina también contiene los demás repositorios que hayas configurado anteriormente. Después de terminar la configuración del repositorio, se guardará una instantánea de la máquina virtual. Las futuras sesiones de Devin comenzarán desde esta instantánea e incluirán cualquier herramienta o dependencia que hayas instalado durante el proceso de configuración. Sigue los pasos a continuación y las instrucciones en pantalla para configurar el repositorio. Siempre puedes volver y editar la configuración del repositorio después de guardarla. También puedes seguir nuestra guía en video a continuación.
1

git pull

Especifica el comando que Devin debe ejecutar al inicio de cada sesión para obtener los cambios más recientes del repositorio. En la mayoría de los casos, conviene mantener el comando predeterminado. Asegúrate de que Devin tenga acceso a los submódulos del repositorio.
2

Configurar secretos

Configura los secretos que Devin vaya a necesitar. Siempre que sea posible, recomendamos añadir directamente un archivo .env al workspace de Devin. Este ejemplo muestra cómo hacerlo con direnv.Otros secretos, como las contraseñas, se pueden añadir en el panel de secrets.
3

Instalar dependencias

Usa VS Code para configurar todas las herramientas y dependencias que Devin necesitará para trabajar en el repositorio. Después de este paso, Devin debería poder ejecutar todos los comandos que necesite (por ejemplo, lint, test, build, etc.) sin pasos de instalación adicionales. La máquina de Devin ejecuta Ubuntu 22.04 (x86_64).
Prueba a pulsar Ctrl+K o Cmd+K (Mac) en la terminal para generar automáticamente un comando de instalación.
Sugerencias:
  • Instala compiladores, intérpretes, herramientas de compilación, gestores de paquetes, linters, formateadores, ejecutores de pruebas, etc.
  • Instala las dependencias de paquetes (por ejemplo, npm install, pip install -r requirements.txt, etc.)
Ten en cuenta que los cambios que hagas se aplicarán también cuando Devin esté trabajando en otros repositorios. Ten cuidado con las instalaciones globales de paquetes y considera usar un entorno virtual si es posible.
Devin ejecutará sus comandos en un shell de bash. Para probar tu configuración, puedes crear una terminal nueva en VS Code.Para una configuración más avanzada, como definir versiones de intérpretes personalizadas para cada repositorio o configurar variables de entorno, consulta la sección de ejemplos.
4

Mantener las dependencias

Introduce el comando que Devin debe ejecutar al comienzo de cada sesión para mantener las dependencias actualizadas. Probablemente debería ser el mismo comando que usaste para instalar manualmente las dependencias (por ejemplo, npm install, pip install -r requirements.txt, etc.).El propósito de esto es garantizar que Devin pueda actualizar sus dependencias locales cuando se agreguen al repositorio de Git.
5

Configurar Lint

Introduce los comandos que Devin debe ejecutar para hacer lint del repositorio. Devin revisará la salida de estos comandos antes de confirmar cambios.Estos comandos deben terminar en 5 minutos o menos para que Devin no tenga que esperar demasiado. Haz clic en verify para comprobar que los comandos funcionan.Consejos:
  • Si es necesario, primero puedes ejecutar los comandos en la terminal de VS Code para precalentar la caché.
  • Si el comando debe ejecutarse en un directorio específico, puedes usar cd de la siguiente forma: cd <directory> && <lint command>.
  • Si tu proyecto no tiene un comando de lint, puedes incluir tu comando de build para que Devin compruebe errores de compilación.
  • También puedes incluir aquí un comando que compruebe el estilo de formato del código.
  • Si el procedimiento de lint de tu flujo es complejo, puedes omitir este paso y explicarle el linting a Devin en el paso de Notas adicionales más abajo.
    Consulta la sección de resolución de problemas si encuentras problemas al verificar tus comandos.
6

Configurar pruebas

Introduce los comandos que Devin debe ejecutar para probar el repositorio. Al igual que con los comandos de lint, Devin revisará la salida de estos comandos antes de hacer commit de los cambios. Estos comandos también tienen un límite de tiempo de 5 minutos. Haz clic en Verify para comprobar que los comandos funcionan correctamente.Consejos:
  • Si es necesario, primero puedes ejecutar los comandos en la terminal de VS Code para aprovechar la caché.
  • Si el comando necesita ejecutarse en un directorio específico, puedes usar cd de la siguiente manera: cd <directory> && <test command>.
  • Si el procedimiento de pruebas de tu proyecto es complejo, puedes omitir este paso y explicarle las pruebas a Devin en el paso de Notas adicionales más abajo.
    Consulta la sección de solución de problemas si encuentras problemas al verificar tus comandos.
7

Configurar la app local

Indícale a Devin cómo ejecutar tu código en tu entorno local. Esto es útil si Devin necesita ejecutar tu código para probar o depurar cambios.
Prueba los comandos tú mismo en la terminal integrada de VS Code para asegurarte de que Devin realmente pueda ejecutarlos.
8

Notas adicionales

Agrega cualquier nota adicional que consideres importante para que Devin las tenga en cuenta al trabajar en este repositorio.
Recomendamos automatizar todo lo posible del proceso de configuración inicial. Consulta la sección de ejemplos para ver algunas formas de hacerlo. Esto permitirá que Devin comience a trabajar más rápido en tu base de código en sesiones futuras.
Una vez que hayas completado todos los pasos, haz clic en Finish. Verificaremos que todos los comandos estén funcionando y luego guardaremos el snapshot. Esto puede tardar unos minutos. Una vez que se guarde el snapshot, las futuras sesiones de Devin podrán usar la configuración que has configurado.
Recomendamos configurar un archivo .gitignore para el repositorio si aún no tienes uno. Esto ayudará a evitar que Devin cometa errores al hacer commits de archivos y también facilitará que puedas ver los cambios de Devin cuando trabajes con él en el IDE.

​
Ejemplos

A continuación se muestran algunos ejemplos de cómo configurar el espacio de trabajo de Devin para distintos casos de uso. Como Devin ejecuta todos los comandos en bash, un patrón común consiste en editar el archivo ~/.bashrc para configurar automáticamente el shell de Devin. Puedes ejecutar devin ~/.bashrc en la terminal para editar el archivo en VS Code.

​
Configuración automática de entornos para diferentes repositorios

Después del 24 de abril de 2025, los equipos que se registren en Devin deberían ver la sección custom_cd ya incluida en su ~/.bashrc. Solo tendrán que actualizar esa sección para sus propios repositorios.
Supongamos que tienes dos repositorios que requieren diferentes versiones de Node y quieres que Devin use automáticamente la versión correcta para cada repositorio. Usaremos nvm para instalar y administrar las versiones de Node. nvm ya debería estar instalado en la máquina de Devin. Primero, instalaremos las dos versiones de Node ejecutando los siguientes comandos en la terminal de VS Code: 
nvm install 18
nvm install 20
A continuación, abre ~/.bashrc ejecutando devin ~/.bashrc en la terminal. Añade lo siguiente al final de ~/.bashrc. 
function custom_cd() {
  builtin cd "$@"

  if [[ "$PWD" == "$HOME/repos/node18"* ]]; then
    nvm use 18 >/dev/null 2>&1
  elif [[ "$PWD" == "$HOME/repos/node20"* ]]; then
    nvm use 20 >/dev/null 2>&1
  fi
}

alias cd='custom_cd'
cd $PWD
Esto ejecutará nvm use 18 cada vez que Devin esté en el repositorio node18 y nvm use 20 cada vez que Devin esté en el repositorio node20.

​
Configuración de variables de entorno

Veremos cómo usar direnv para gestionar variables de entorno. Primero, seguiremos las instrucciones de instalación de direnv para instalarlo en la máquina de Devin. A partir del 24 de abril de 2025, direnv debería instalarse automáticamente en las máquinas de los equipos nuevos. A continuación, instalaremos direnv ejecutando el siguiente comando en la terminal de VS Code: 
sudo apt install direnv
Luego añadiremos lo siguiente a ~/.bashrc para configurar el hook de direnv. Puedes abrir ~/.bashrc ejecutando devin ~/.bashrc en la terminal. 
eval "$(direnv hook bash)"
Ahora podemos crear un archivo .envrc en la raíz de nuestro repositorio que podría tener un contenido similar al siguiente. 
export ENV_VAR=1
export ANOTHER_ENV_VAR=2
Finalmente, ejecutaremos direnv allow en la terminal para cargar las variables de entorno. Devin ahora tendrá disponibles en su entorno las variables definidas en nuestro archivo .envrc cuando trabaje en nuestro repositorio en sesiones futuras.
Recomendamos agregar .envrc a tu archivo .gitignore para que Devin no lo suba accidentalmente al repositorio.

​
Agregar directorios al PATH del sistema

Podemos editar ~/.bashrc para agregar directorios al PATH del sistema. Esto facilitará que Devin pueda ejecutar los ejecutables ubicados en esos directorios. Por ejemplo, podemos agregar lo siguiente a ~/.bashrc, lo que añadirá el directorio ~/bin al PATH del sistema. 
export PATH="$HOME/bin:$PATH"
Ahora Devin podrá ejecutar los archivos ejecutables del directorio ~/bin sin tener que especificar la ruta completa.

​
Iniciar sesión en sitios web

Durante la configuración del repositorio, puedes usar la pestaña Browser para iniciar sesión en cualquier sitio web con el que quieras que Devin interactúe. Estas cookies de sesión se almacenarán en el espacio de trabajo de Devin y estarán disponibles para Devin en futuras sesiones. Si usas un sitio web que cierra tu sesión con frecuencia por inactividad, también querrás configurar a Devin con credenciales en tu panel de Secrets.

​
Solución de problemas

​
¿Qué hago si rompo algo accidentalmente durante la configuración del repositorio?

Si durante la configuración del repositorio introduces accidentalmente un cambio que rompe la compatibilidad, siempre puedes volver a una imagen de máquina anterior. Ve a Settings > Devin’s Workspace y haz clic en Version History para ver una lista de imágenes de máquina anteriores. Luego haz clic en la imagen de máquina que sabes que funcionaba correctamente y haz clic en Restore version.

​
¿Por qué no se verifican mis comandos?

Si encuentras un error al verificar uno de los comandos, intenta inspeccionar su salida en la terminal de VS Code y también intenta ejecutar el comando tú mismo en una terminal nueva.
  1. Verifica la ruta del ejecutable que estás usando. Recomendamos encarecidamente usar rutas absolutas o agregar los ejecutables al PATH del sistema.
  2. Asegúrate de haber instalado las herramientas y dependencias necesarias para ejecutar el comando. Si no lo has hecho, utiliza la terminal para instalarlas y vuelve a verificar.
  3. Comprueba que los comandos se estén ejecutando en el directorio correcto. Si los comandos necesitan ejecutarse en un directorio específico, puedes usar cd de la siguiente manera: cd <directory> && <command>.
  4. Verifica que estás usando las versiones correctas de los lenguajes de programación (por ejemplo, las versiones correctas de Node, Python, etc.).
  5. Es posible que quieras modificar tu ~/.bashrc para usar automáticamente el entorno correcto. Consulta nuestra guía para ver un ejemplo de cómo usar la versión correcta del lenguaje de programación para distintos repositorios.

​
Mis comandos funcionan cuando los ejecuto manualmente

Comprueba que hayas configurado tu archivo bashrc para que una nueva shell de Bash tenga acceso a las herramientas necesarias. Intenta ejecutar tus comandos en una terminal nueva. Si no funcionan, probablemente tendrás que editar tu bashrc, por ejemplo ejecutando ciertos comandos de configuración o editando la variable PATH del sistema. Consulta nuestra guía para ver un ejemplo de cómo usar la versión de lenguaje correcta para diferentes repositorios. Los comandos se cancelan por tiempo de espera después de 5 minutos. Puedes forzar el almacenamiento en caché ejecutando los comandos en la terminal de VS Code antes de verificar. No recomendamos darle a Devin comandos que tarden más de 5 minutos en ejecutarse, ya que esto lo ralentizará significativamente.

​
Homebrew me pide una contraseña

Este es un error de Homebrew en Linux. En su lugar, ejecuta CI=1 brew install <package>.

​
Devin no puede ejecutar mis comandos de lint/pruebas durante las sesiones

Revisa la salida de la terminal de Devin para ver si puedes detectar algún error. También puedes intentar ejecutar los comandos tú mismo en una terminal nueva para comprobar si funcionan. Si es necesario, puedes volver al proceso de configuración del repositorio para hacer cambios en el espacio de trabajo de Devin.

​
El paso de git pull no funciona

Verifica que Devin tenga acceso al repositorio y a sus submódulos. Revisa también la documentación de la integración con GitHub si tienes algún problema de permisos.

​
¿Necesitas editar algo?

Siempre puedes editar o añadir un nuevo repositorio en Settings > Devin’s Workspace. Para editar un repositorio existente, haz clic en él en Devin’s Workspace > haz clic en “edit” > haz clic en “Set up in VSCode”.
Devin
También puedes restablecer por completo el estado de la máquina de Devin desde la pestaña Settings > Devin’s Workspace, abriendo el menú desplegable Danger Zone y usando la opción “Reset machine setup”. Ten en cuenta que esto eliminará todos los repositorios que hayas configurado.

​
¡Todo listo!

¡Felicitaciones! Ya integraste a Devin y pueden empezar a trabajar juntos. Es momento de iniciar tu primera sesión. Ten en cuenta que Devin funciona mejor cuando:
  • Le indicas cómo revisar su progreso
  • Divides las tareas grandes
  • Compartes requisitos detallados desde el inicio
  • Ejecutas múltiples sesiones en paralelo
Si necesitas ayuda, no dudes en enviarnos un correo electrónico a [email protected].