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

# Configuração do ambiente

> Configure o ambiente do Devin para que cada sessão comece com seus repositórios clonados, ferramentas instaladas e dependências prontas.

<Tip>**O Devin pode configurar seu próprio ambiente para você.** Basta iniciar uma sessão e pedir. [Saiba mais →](/pt-BR/onboard-devin/environment/blueprints#getting-started)</Tip>

<div id="what-is-devins-environment">
  ## O que é o ambiente do Devin?
</div>

O ambiente do Devin é o workspace em que o Devin opera: uma máquina virtual baseada em Linux com seus repositórios clonados, ferramentas instaladas, dependências resolvidas e configurações aplicadas. É o equivalente ao notebook de um desenvolvedor: o sistema operacional, o terminal, a toolchain instalada, os repositórios clonados.

A configuração do seu ambiente é salva como um **snapshot**, uma imagem congelada e inicializável a partir da qual cada sessão é iniciada. Configure-o uma vez, e toda sessão será iniciada nesse estado conhecido e confiável.

<div id="why-environment-configuration-matters">
  ## Por que a configuração do ambiente é importante
</div>

O Devin funciona da mesma forma que qualquer desenvolvedor: clona repositórios, instala dependências, executa lint, compila código e roda testes. Para fazer qualquer uma dessas coisas, ele precisa de um ambiente funcional. Sem isso, o Devin não consegue fazer o build do seu projeto, não consegue rodar seus testes e não consegue verificar o próprio trabalho. Seria como contratar um desenvolvedor e não dar a ele um laptop.

A configuração do ambiente dá ao Devin as ferramentas, runtimes, credenciais e o conhecimento do projeto de que ele precisa para ser produtivo desde a primeira sessão. Ela também torna as sessões mais rápidas: seu snapshot já tem repositórios clonados e dependências instaladas, então o Devin entra direto em trabalho produtivo, em vez de configurar tudo do zero toda vez.

**Esta é, de longe, a ação de maior impacto que você pode tomar para melhorar a eficácia do Devin na sua base de código.**

<div id="how-sessions-work">
  ## Como as sessões funcionam
</div>

Toda sessão é iniciada a partir de um **snapshot**, uma imagem congelada e inicializável do ambiente.

1. **Snapshot**: Uma imagem pré-criada que contém seus repositórios, ferramentas e dependências. É preparada antecipadamente por meio da configuração.
2. **Sessão**: O Devin inicia uma nova cópia do snapshot. Toda sessão começa no mesmo estado limpo. As alterações feitas na sessão não são persistidas no snapshot.

Quando sua configuração muda, um novo snapshot é criado automaticamente. Cada organização tem exatamente um snapshot ativo. Toda sessão nessa org é iniciada a partir do mesmo snapshot.

<div id="before-you-start">
  ## Antes de começar
</div>

Antes de configurar o ambiente do Devin, verifique se ele pode acessar seus repositórios:

<AccordionGroup>
  <Accordion title="Usuários não Enterprise">
    1. **Conecte seu provedor de SCM.** Vá para **Configurações > Connections** e conecte GitHub, GitLab, Bitbucket ou Azure DevOps. Selecione quais repositórios o Devin poderá acessar durante a configuração. Consulte os [guias de integração](/pt-BR/integrations/overview) para instruções detalhadas.

    É isso. Depois de conectar, você pode prosseguir para a configuração do ambiente.
  </Accordion>

  <Accordion title="Usuários Enterprise">
    1. **Conecte seu provedor de SCM (administrador Enterprise).** Vá para **Enterprise Settings > Integrations** e conecte seu provedor de SCM. Consulte [Git Integrations](/pt-BR/enterprise/integrations/git-integrations) para ver as instruções de configuração.
    2. **Conceda a cada org acesso aos seus repositórios (administrador Enterprise).** Vá para **Enterprise Settings > Repository Permissions** e atribua repositórios a cada organização. As orgs não podem ver nem usar repositórios até que você conceda esse acesso explicitamente. Consulte [Repository Permissions](/pt-BR/enterprise/integrations/git-integrations#repository-permissions).
    3. **Configure o ambiente (administrador da org).** Quando uma org tiver acesso aos repositórios, prossiga para a configuração do ambiente abaixo.
  </Accordion>
</AccordionGroup>

<Warning>Se você pular essas etapas, os repositórios não aparecerão quando você tentar adicioná-los ao seu ambiente. O Devin precisa de acesso aos repositórios por meio da sua integração com Git antes de poder clonar e fazer o build.</Warning>

<div id="choose-your-approach">
  ## Escolha sua abordagem
</div>

Há duas maneiras de configurar o ambiente do Devin:

<CardGroup cols={2}>
  <Card title="Configuração declarativa" icon="file-code" href="/pt-BR/onboard-devin/environment/blueprints">
    **Recomendado.** Defina a configuração do ambiente em formato YAML (blueprint). Especifique o que instalar, como configurar dependências e o que o Devin deve saber sobre seu projeto. As builds são executadas automaticamente para gerar snapshots.

    * Com controle de versão
    * Atualização automática
    * Componível entre camadas
    * Reproduzível
  </Card>

  <Card title="Configuração clássica" icon="wand-magic-sparkles" href="/pt-BR/onboard-devin/repo-setup">
    Configure o ambiente do Devin por meio de um assistente interativo na interface web. Siga telas guiadas (segredos, dependências, lint, teste, execução) usando um terminal integrado.

    * Visual, etapa por etapa
    * Sem necessidade de YAML
    * [Migrar para a configuração declarativa →](/pt-BR/onboard-devin/environment/migration)
  </Card>
</CardGroup>

<div id="related-pages">
  ## Páginas relacionadas
</div>

<CardGroup cols={2}>
  <Card title="Referência de blueprints" icon="book" href="/pt-BR/onboard-devin/environment/blueprint-reference">
    Especificação completa dos campos de blueprints: seções, suporte a GitHub Actions, variáveis de ambiente e anexos de arquivos.
  </Card>

  <Card title="Biblioteca de templates" icon="copy" href="/pt-BR/onboard-devin/environment/templates">
    Blueprints prontos para copiar e colar para Python, Node.js, Go, Java, Ruby, Rust e padrões avançados.
  </Card>

  <Card title="Migração da configuração clássica" icon="arrow-right" href="/pt-BR/onboard-devin/environment/migration">
    Guia em etapas para migrar do assistente interativo para blueprints declarativos.
  </Card>

  <Card title="Gerenciamento de ambientes Enterprise" icon="building" href="/pt-BR/enterprise/environment-management/overview">
    Gerenciamento de ambientes em toda a Enterprise: hierarquia de 3 níveis, segredos e configuração entre orgs.
  </Card>
</CardGroup>
