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 entorno de Devin (la instantánea de la máquina virtual). Puedes pensar en esto como configurar el portátil de Devin para su primer día de trabajo.
Configurar correctamente el entorno 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!
Primero, asegúrate de que Devin tenga acceso a tus repositorios. Puedes agregar repositorios en cualquier momento configurando el acceso de Devin en:
Ahora, dentro de una Organización, ve a Devin’s Machine y haz clic en Add repository. Selecciona los repositorios que quieres agregar al entorno de Devin y luego haz clic en Start para empezar a configurarlos.
La máquina de Devin está ejecutando Ubuntu 22.04 (x86_64). Prueba pulsar Ctrl+K en la terminal para generar automáticamente un comando de instalación.
Configurar el repositorio y el entorno de desarrollo
Una vez en Repo Setup, verás tres paneles:
- Pasos de configuración del repositorio: Muestra los 8 pasos de configuración en orden, junto con los comandos resultantes que se guardarán en tu configuración.
- Agente de configuración Devin AI: Devin puede sugerir qué hacer en cada paso en función de tu repositorio específico e iterar sobre la configuración hasta que esté lista para guardarse.
- Terminal de VSCode: Te permite ejecutar cualquier comando o explorar el sistema de archivos directamente en el entorno integrado de VSCode.
Sugerencias generadas por IA
Cuando añades un repositorio, Devin genera automáticamente sugerencias de configuración para cada paso a partir del análisis de tu base de código. Puedes aceptar o rechazar cada sugerencia de forma individual, o refinarlas con Devin AI Setup Agent.
Pasos de configuración del repositorio
Git Pull
El comando que Devin ejecuta al inicio de cada sesión para extraer los cambios más recientes del repositorio. En la mayoría de los casos, deberías mantener el comando predeterminado. Asegúrate de que Devin tenga acceso a cualquier submódulo del repositorio.
Configurar secretos
Configura los secretos o variables de entorno que Devin necesita para trabajar con tu repositorio. Consulta Configuración de secretos para más detalles. Instalar dependencias
Comandos para instalar las dependencias iniciales de tu repositorio. Esto se ejecuta una vez durante la configuración para preparar el entorno de Devin.
Mantener dependencias
Comandos que Devin ejecuta después de git pull durante el inicio de la sesión en caso de que se hayan agregado nuevas dependencias. Normalmente, este debería ser el mismo comando que utilizas para instalar dependencias (por ejemplo, npm install, pip install -r requirements.txt, etc.).
Configurar lint
Comandos que Devin debe usar para ejecutar lint o verificar errores de sintaxis. Devin revisará la salida de estos comandos antes de hacer commit de los cambios.
Configurar tests
Comandos que Devin debe usar para ejecutar tests. Al igual que con los comandos de lint, Devin revisará la salida de estos comandos antes de hacer commit de los cambios.
Ejecutar aplicación local
Indica a Devin cómo ejecutar tu código en local. Esto es útil si Devin necesita ejecutar tu código para probar o depurar cambios. Puedes usar el navegador de Devin para iniciar sesión en los sitios web que quieras que Devin use. Agrega las credenciales de inicio de sesión a secrets si la sesión caduca. Notas adicionales
Agrega cualquier instrucción adicional para Devin al trabajar en este repositorio.
Finalizar o guardar la configuración
Cuando estés satisfecho con la configuración, haz clic en Finish Setup para guardarla. Esto volverá a reproducir todos los comandos de los pasos de configuración para preparar el entorno de Devin.
Si aún no has terminado tus cambios, haz clic en Finish Later para guardar la configuración. Esto mantendrá la configuración en curso y te permitirá retomarla más tarde. Sin embargo, ten en cuenta que solo puede haber una configuración en curso a la vez, por lo que no recomendamos usar esta opción a menos que sea absolutamente necesario.
Consejos para configurar comandos:
- Ejecuta primero los comandos en la terminal de VS Code para precalentar la caché antes de verificarlos.
- Si un comando debe ejecutarse en un directorio específico, usa
cd de esta manera: cd <directory> && <command>.
- Si tu proyecto no tiene un comando de lint, puedes incluir tu comando de build para que Devin compruebe si hay errores de compilación.
- Si el procedimiento de lint o de pruebas de tu proyecto es complejo, puedes omitir esos pasos y explicárselos a Devin en el paso Additional Notes.
- Consulta la sección de resolución de problemas si encuentras problemas al verificar tus comandos.
En cualquier momento puedes editar o agregar un nuevo repositorio en Settings > Devin’s Machine.
Para editar un repositorio existente, haz clic en Configure en la esquina superior derecha de la página, selecciona Add/Modify/Remove repo, elige el repositorio que quieres editar y haz clic en Submit.
También puedes seleccionar el repositorio existente que quieres editar de la lista y hacer clic en Modify repo setup para editar los pasos de configuración.
Historial de versiones de la máquina
Si durante la configuración introduces accidentalmente un cambio incompatible, puedes volver a una instantánea anterior del entorno. Ve a Settings > Devin’s Machine, cambia a la pestaña Version History y restaura una instantánea anterior del entorno que sepas que funcionaba correctamente.
Configuración de secretos
Los secretos como API keys, contraseñas y tokens pueden agregarse en el panel de secrets. Cuando sea posible, recomendamos usar un archivo .env en el entorno de Devin con direnv para gestionar automáticamente las variables de entorno. Consulta el ejemplo de configuración de variables de entorno a continuación para obtener más detalles.
A continuación se muestran algunos ejemplos de cómo configurar el entorno 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
direnv está preinstalado en la máquina de Devin y puede utilizarse para gestionar las variables de entorno de cada repositorio. El hook de direnv ya está configurado en ~/.bashrc.
Para configurar las variables de entorno de un repositorio, crea un archivo .envrc en la raíz del repositorio. Por ejemplo:
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 entorno, 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 entorno 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.
¿Por qué no se verifican mis comandos?
Si encuentras un error al verificar uno de los comandos, intenta inspeccionar su salida y también intenta ejecutar el comando tú mismo en una terminal nueva.
- Verifica la ruta del ejecutable que estás usando. Recomendamos encarecidamente usar rutas absolutas o agregar los ejecutables al PATH del sistema.
- Asegúrate de haber instalado las herramientas y dependencias necesarias para ejecutar el comando. Si no lo has hecho, utiliza Setup Agent o la terminal de VS Code para instalarlas y vuelve a verificar.
- 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>.
- Verifica que estás usando las versiones correctas de los lenguajes de programación (por ejemplo, las versiones correctas de Node, Python, etc.).
- 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.
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 entorno 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.
¡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 support@cognition.ai.