Pular para o conteúdo principal
O Devin funciona carregando um snapshot de uma máquina virtual no início de cada sessão. Para que seja o mais eficaz possível, esse snapshot deve incluir todos os repositórios nos quais você quer que o Devin trabalhe, bem como quaisquer ferramentas ou dependências de que ele possa precisar para trabalhar na sua base de código. Assim, o Devin pode se concentrar em escrever código em vez de ter que configurar o ambiente toda vez! Neste guia, veremos como integrar o Devin a um dos seus repositórios e configurar o workspace do Devin (o snapshot da máquina virtual). Você pode encarar isso como configurar a máquina do Devin para o primeiro dia de trabalho.
Configurar corretamente o workspace do Devin melhorará significativamente o desempenho dele na sua base de código. Imagine se, toda vez que você começasse uma tarefa, seu notebook e parte da sua memória fossem apagados — é isso que acontece com o Devin com uma configuração incorreta ou incompleta!

​
Configurar um repositório

Primeiro, verifique se o Devin tem acesso aos seus repositórios. Você pode adicionar repositórios a qualquer momento acessando Settings > Integrations e configurando o acesso do Devin.
Consulte o Guia de Integração com o GitHub para mais informações
Agora, vá para Settings > Devin’s Workspace e clique em um repositório no qual você quer que o Devin trabalhe. Você verá a tela a seguir.
Devin
Agora você pode usar o VS Code integrado no lado direito para editar a máquina virtual do Devin. Cada repositório ficará em seu próprio diretório em ~/repos. Não mova nem exclua esses diretórios. O repositório que você está configurando no momento já foi clonado, e a máquina também contém quaisquer outros repositórios que você tenha configurado anteriormente. Depois que você terminar a configuração do repositório, um snapshot da máquina virtual será salvo. Futuras sessões do Devin começarão a partir desse snapshot e incluirão quaisquer ferramentas ou dependências que você tiver instalado durante o processo de configuração. Siga as etapas abaixo e as instruções na tela para configurar o repositório. Você sempre pode voltar e editar a configuração do repositório depois de salvar. Você também pode acompanhar o nosso vídeo de instruções abaixo.
1

Git Pull

Insira o comando que o Devin deve executar no início de cada sessão para obter as alterações mais recentes do repositório. Na maioria dos casos, é recomendável manter o comando padrão. Certifique-se de que o Devin tenha acesso aos submódulos do repositório.
2

Configurar segredos

Configure todos os segredos de que o Devin vai precisar. Quando possível, recomendamos adicionar diretamente um arquivo .env ao workspace do Devin. Este exemplo mostra como fazer isso com direnv.Outros segredos, como senhas, podem ser adicionados no painel de secrets.
3

Instalar dependências

Use o VS Code para configurar todas as ferramentas e dependências de que o Devin precisará para trabalhar no repositório. Depois desta etapa, o Devin deverá conseguir executar todos os comandos de que precisa (por exemplo, lint, test, build etc.) sem etapas adicionais de instalação. A máquina do Devin está rodando Ubuntu 22.04 (x86_64).
Tente pressionar Ctrl+K ou Cmd+K (Mac) no terminal para gerar automaticamente um comando de instalação.
Sugestões:
  • Instale compiladores, interpretadores, ferramentas de build, gerenciadores de pacotes, linters, formatadores, test runners etc.
  • Instale dependências de pacotes (por exemplo, npm install, pip install -r requirements.txt, etc.)
Lembre-se de que as alterações que você fizer serão aplicadas quando o Devin estiver trabalhando em outros repositórios também. Tenha cuidado com instalações globais de pacotes e considere usar um ambiente virtual, se possível.
O Devin executará seus comandos em um shell Bash. Para testar sua configuração, você pode criar um novo terminal no VS Code.Para configurações mais avançadas, como definir versões personalizadas de interpretadores para cada repositório ou configurar variáveis de ambiente, consulte a seção de exemplos.
4

Gerenciar dependências

Insira o comando que Devin deve executar no início de cada sessão para manter as dependências atualizadas. Esse comando provavelmente será o mesmo que você usou para instalar as dependências manualmente (por exemplo, npm install, pip install -r requirements.txt, etc.).O objetivo é garantir que Devin possa atualizar suas dependências locais caso novas dependências sejam adicionadas ao repositório Git.
5

Configurar o Lint

Insira os comandos que Devin deve executar para fazer lint no repositório. Devin analisará a saída desses comandos antes de fazer commit das alterações.Esses comandos devem terminar em 5 minutos ou menos para que Devin não precise esperar muito por eles. Clique em Verify para conferir se os comandos estão funcionando.Dicas:
  • Se necessário, você pode primeiro executar os comandos no terminal do VS Code para preparar o cache.
  • Se o comando precisar ser executado em um diretório específico, você pode usar cd assim: cd <directory> && <lint command>.
  • Se o seu projeto não tiver um comando de lint, você pode incluir seu comando de build para que Devin verifique erros de compilação.
  • Você também pode incluir aqui um comando que verifique o estilo de formatação do código.
  • Se o procedimento de lint do seu processo for complexo, você pode pular esta etapa e explicar o processo de lint para Devin na etapa de Additional Notes abaixo.
    Consulte a seção de solução de problemas se encontrar problemas ao verificar seus comandos.
6

Configurar testes

Insira os comandos que o Devin deve executar para testar o repositório. Assim como com os comandos de lint, o Devin analisará a saída desses comandos antes de fazer commits. Esses comandos também têm um limite de tempo de 5 minutos. Clique em verify para conferir se os comandos estão funcionando.Dicas:
  • Se necessário, você pode primeiro executar os comandos no terminal do VS Code para aproveitar o cache.
  • Se o comando precisar ser executado em um diretório específico, você pode usar cd desta forma: cd <directory> && <test command>.
  • Se o procedimento de testes do seu processo for complexo, você pode pular esta etapa e explicar os testes para o Devin na etapa Additional Notes abaixo.
    Veja a seção de troubleshooting se você encontrar problemas ao verificar seus comandos.
7

Configurar o app local

Informe ao Devin como executar seu código localmente. Isso é útil caso o Devin precise executar seu código para testar ou depurar alterações.
Teste os comandos você mesmo no terminal do VS Code para garantir que o Devin realmente consiga executá-los.
8

Notas adicionais

Adicione quaisquer observações adicionais que você considere importantes para o Devin saber ao trabalhar neste repositório.
Recomendamos automatizar ao máximo possível o processo de configuração. Confira a seção de exemplos para ver algumas maneiras de fazer isso. Isso permitirá que o Devin comece a trabalhar imediatamente na sua base de código em sessões futuras.
Depois de concluir todas as etapas, clique em Finish. Vamos verificar se todos os comandos estão funcionando e, em seguida, salvar o snapshot. Isso pode levar alguns minutos. Depois que o snapshot for salvo, futuras sessões do Devin poderão usar a configuração que você criou.
Recomendamos configurar um arquivo .gitignore para o repositório, caso você ainda não tenha um. Isso ajudará a evitar que o Devin cometa erros ao fazer commits de arquivos e também tornará mais fácil visualizar as alterações feitas pelo Devin quando você estiver trabalhando com ele no IDE.

​
Exemplos

Abaixo estão alguns exemplos de como configurar o workspace do Devin para diferentes casos de uso. Como o Devin executa todos os comandos usando bash, uma prática comum é editar o arquivo ~/.bashrc para configurar automaticamente o shell do Devin. Você pode executar devin ~/.bashrc no terminal para editar o arquivo no VS Code.

​
Configurando ambientes automaticamente para diferentes repositórios

Após 24 de abril de 2025, as equipes que se inscreverem no Devin devem ver a seção custom_cd já presente no arquivo ~/.bashrc. Você só precisará atualizar essa seção para os seus próprios repositórios.
Suponha que você tenha dois repositórios que exijam versões diferentes do Node e queira que o Devin use automaticamente a versão correta para cada repositório. Usaremos o nvm para instalar e gerenciar as versões do Node. O nvm já deve estar instalado na máquina do Devin. Primeiro, vamos instalar as duas versões do Node executando os seguintes comandos no terminal do VS Code: 
nvm install 18
nvm install 20
Em seguida, abra o arquivo ~/.bashrc executando devin ~/.bashrc no terminal. Adicione o seguinte ao arquivo ~/.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
Isso executará nvm use 18 sempre que Devin estiver no repositório node18 e nvm use 20 sempre que Devin estiver no repositório node20.

​
Configurando variáveis de ambiente

Vamos ver como usar direnv para gerenciar variáveis de ambiente. Primeiro, vamos seguir as instruções de instalação do direnv para instalá‑lo na máquina do Devin. Após 24 de abril de 2025, o direnv deve ser instalado automaticamente nas máquinas de novas equipes. Primeiro, vamos instalar o direnv executando o seguinte comando no terminal do VS Code: 
sudo apt install direnv
Em seguida, vamos acrescentar o seguinte ao ~/.bashrc para configurar o hook do direnv. Você pode abrir o ~/.bashrc rodando devin ~/.bashrc no terminal. 
eval "$(direnv hook bash)"
Agora podemos criar um arquivo .envrc na raiz do nosso repositório que ficará mais ou menos assim. 
export ENV_VAR=1
export ANOTHER_ENV_VAR=2
Por fim, vamos executar direnv allow no terminal para carregar as variáveis de ambiente. Agora o Devin terá as variáveis de ambiente do nosso arquivo .envrc adicionadas ao seu ambiente ao trabalhar em nosso repositório em sessões futuras.
Recomendamos adicionar .envrc ao seu arquivo .gitignore para que o Devin não faça commit desse arquivo acidentalmente no repositório.

​
Adicionando diretórios ao PATH do sistema

Podemos editar ~/.bashrc para adicionar diretórios ao PATH do sistema. Isso facilitará para o Devin executar os executáveis nesses diretórios. Por exemplo, podemos acrescentar o seguinte ao ~/.bashrc, o que adicionará o diretório ~/bin ao PATH do sistema. 
export PATH="$HOME/bin:$PATH"
Agora, Devin poderá executar os arquivos executáveis no diretório ~/bin sem precisar especificar o caminho completo.

​
Fazendo login em sites

Durante a configuração do repositório, você pode usar a guia Browser para fazer login em qualquer site com o qual queira que o Devin interaja. Esses cookies de sessão serão armazenados no workspace do Devin e estarão disponíveis para o Devin em sessões futuras. Se você estiver usando um site que encerra sua sessão com frequência, também é recomendável configurar credenciais para o Devin no seu painel de Secrets.

​
Resolução de problemas

​
O que faço se eu quebrar algo acidentalmente durante a configuração do repositório?

Se, durante a configuração do repositório, você acidentalmente introduzir uma alteração que cause problemas, sempre poderá reverter para uma imagem de máquina anterior. Acesse Settings > Devin’s Workspace e clique em Version History para ver uma lista das imagens de máquina anteriores. Em seguida, clique na imagem de máquina que você sabe que funcionava corretamente e clique em Restore version.

​
Por que meus comandos não estão sendo verificados?

Se você encontrar um erro ao verificar um dos comandos, tente inspecionar a saída dele no terminal do VS Code e também tente executar o comando você mesmo em um novo terminal.
  1. Verifique o caminho do executável que você está executando. Recomendamos fortemente usar caminhos absolutos ou adicionar executáveis ao PATH do sistema.
  2. Certifique-se de que você instalou as ferramentas e dependências necessárias para executar o comando. Se ainda não tiver feito isso, use o terminal para instalá-las e tente verificar novamente.
  3. Verifique se os comandos estão sendo executados no diretório correto. Se os comandos precisarem ser executados em um diretório específico, você pode usar cd desta forma: cd <directory> && <command>.
  4. Verifique se você está usando as versões corretas das linguagens de programação (por exemplo, versões corretas de Node, Python, etc.).
  5. Talvez você queira modificar seu ~/.bashrc para usar automaticamente o ambiente correto. Consulte nosso guia para ver um exemplo de como usar a versão correta da linguagem para repositórios diferentes.

​
Meus comandos funcionam quando eu os executo manualmente

Verifique se você configurou seu .bashrc para que um novo shell Bash tenha acesso às ferramentas necessárias. Tente executar seus comandos em um novo terminal. Se eles não funcionarem, você provavelmente precisará editar seu .bashrc, por exemplo, executando certos comandos de configuração ou ajustando o PATH do sistema. Confira nosso guia para um exemplo de como usar a versão correta da linguagem para diferentes repositórios. Os comandos expiram (timeout) após 5 minutos. Você pode aquecer o cache executando os comandos no terminal do VS Code antes de verificar. Não recomendamos passar ao Devin comandos que demorem mais de 5 minutos para executar, pois isso o deixará significativamente mais lento.

​
O Homebrew está me pedindo uma senha

Isso é um erro no Homebrew para Linux. Em vez disso, execute CI=1 brew install <package>.

​
Devin não consegue executar meus comandos de lint/test em sessões

Verifique a saída do terminal do Devin para ver se você consegue identificar algum erro. Você também pode tentar executar os comandos em um novo terminal para verificar se eles funcionam. Se necessário, você pode refazer o processo de configuração do repositório para fazer alterações no workspace do Devin.

​
A etapa de git pull não está funcionando

Confira se o Devin tem acesso ao repositório e aos submódulos do repositório. Consulte também a documentação da integração com o GitHub caso encontre algum problema de permissão.

​
Precisa editar?

Você sempre pode editar ou adicionar um novo repositório em Settings > Devin’s Workspace. Para editar um repositório existente, clique nele em Devin’s Workspace > clique em “edit” > clique em “Set up in VSCode”.
Devin
Também é possível redefinir completamente o estado da máquina do Devin indo até a aba Settings > Devin’s Workspace, abrindo o menu suspenso Danger Zone e usando a opção ‘Reset machine setup’. Observe que isso removerá todos os repositórios que você configurou.

​
Tudo pronto!

Parabéns! Você concluiu a configuração do Devin e já pode começar a construir juntos. É hora de iniciar sua primeira sessão. Lembre-se de que o Devin funciona melhor quando você:
  • Diz ao Devin como verificar seu progresso
  • Divide tarefas grandes em partes menores
  • Compartilha requisitos detalhados desde o início
  • Executa várias sessões em paralelo
Se precisar de suporte, não hesite em nos enviar um e-mail para [email protected].