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

# Modos do Devin Local

> Alterne o agente local do Devin no Devin Desktop entre os modos Code, Inteligente, Ask, Plan e Bypass Permissions, e planeje antes de implementar.

As sessões do Devin Local oferecem cinco modos. Cada modo define o que o agente pode fazer e com que frequência ele pede confirmação antes de agir.

| Modo | Caso de uso | O que o agente faz |
| - | - | - |
| [Code](#code-mode) | Recursos, refatoração, correções | Escreve e edita código; aprova automaticamente edições dentro do workspace |
| [Inteligente](#smart-mode) | Menos interrupções em tarefas rotineiras | Funciona como o Code, e um modelo rápido também aprova automaticamente outras ações que considerar seguras |
| [Ask](#ask-mode) | Aprendizado, perguntas, exploração | Responde a perguntas sem alterar o código |
| [Plan](#plan-mode) | Recursos complexos que exigem planejamento prévio | Explora em modo somente leitura e escreve um plano para sua aprovação |
| [Bypass Permissions](#bypass-permissions) | Execuções não supervisionadas nas quais você confia totalmente | Aprova automaticamente todas as chamadas de ferramentas, a menos que a política da sua organização exija aprovação |

Alterne entre os modos com o seletor de modo abaixo da caixa de texto. O Devin Local compartilha a infraestrutura de agente com o Devin CLI, e seus modos correspondem aos modos do agente e aos [modos de permissão](https://docs.devin.ai/pt-BR/cli/reference/permissions.md) do Devin CLI. Você também pode digitar `/code`, `/smart`, `/ask`, `/plan` ou `/bypass` na caixa de texto do Devin Local para trocar de modo.

Seja qual for o modo, suas [regras de permissão](https://docs.devin.ai/pt-BR/desktop/devin-local/permissions.md) e quaisquer regras impostas pela organização continuam valendo. As regras de negação e de confirmação impostas pelo seu administrador têm prioridade, mesmo no modo Bypass Permissions.

## Modo Code

O **modo Code** é o modo padrão para fazer alterações na sua base de código.

No modo Code, o agente pode:

* Criar, editar e excluir arquivos
* Executar comandos no terminal
* Pesquisar e analisar sua base de código
* Instalar dependências
* Executar tarefas multi-step de forma autônoma

Edições dentro do workspace são aprovadas automaticamente. Comandos de shell, operações de obtenção na web e ferramentas MCP pedem aprovação, a menos que sejam cobertos por uma regra de permissão. Se sua organização não permitir edições aprovadas automaticamente, o modo Code também pedirá aprovação para as edições.

> [!TIP]
>
> Recomendamos usar o modo Code como padrão na maioria das tarefas.

## Modo Inteligente

O **modo Inteligente** mantém as edições aprovadas automaticamente do modo Code e adiciona um modelo rápido que decide, para cada uma das demais ações, se é seguro executá-la sem pedir confirmação. Tudo o que ele não considerar claramente seguro continua exigindo aprovação, e as categorias de alto risco (instalação de pacotes, comandos `git` que fazem alterações, `rm`, `sudo`, operações destrutivas em CLIs de nuvem, arquivos sensíveis) sempre exigem aprovação.

> [!NOTE]
>
> O modo Inteligente está sendo liberado gradualmente, então talvez ainda não apareça no seu seletor de modo. Consulte [Modo Inteligente](https://docs.devin.ai/pt-BR/cli/reference/permissions.md#smart-mode) para ver o comportamento completo.

## Modo Ask

O **modo Ask** é um modo somente leitura, otimizado para perguntas e exploração.

No modo Ask, o agente pode pesquisar e analisar sua base de código, mas não pode fazer alterações.

## Modo Plan

O **modo Plan** ajuda você a estruturar tarefas complexas, elaborando um plano de implementação detalhado antes de escrever qualquer código.

No modo Plan, o agente vai:

* Explorar sua base de código para entender o estado atual
* Fazer perguntas para esclarecer dúvidas e garantir que o plano esteja alinhado aos seus objetivos
* Oferecer múltiplas opções para você escolher em uma interface interativa
* Apresentar um plano detalhado, com as etapas de implementação, em um arquivo Markdown externo

O arquivo do plano fica fora do seu repositório e é mantido durante toda a sessão, então o planejamento pode se estender por várias mensagens. Quando o agente terminar, ele pedirá para iniciar a implementação — ou você mesmo pode clicar em **Implement** no arquivo do plano para mudar para o modo Code e começar.

### Planejamento mais aprofundado

Ao incluir a palavra-chave `megaplan`, `ultraplan` ou `masterplan` em qualquer parte da sua mensagem, a conversa muda para o modo Plan e o agente passa a planejar de forma mais abrangente, fazendo pelo menos uma pergunta de esclarecimento antes de escrever o plano. O modo anterior é restaurado assim que você remove a palavra-chave.

### Continuando a partir de um plano

O arquivo Markdown criado no modo Plan pode ser especialmente útil para dar continuidade ao trabalho em múltiplas sessões.

Os planos são armazenados em `~/.devin/plans/` e ficam disponíveis no menu de [@menções](https://docs.devin.ai/pt-BR/desktop/chat/overview.md#%40-mentions). Ao mencionar um arquivo do plano, você pode continuar a implementação com um contexto limpo.

Isso é especialmente útil quando uma implementação inicial não saiu como esperado: descarte as alterações originais, ajuste o arquivo do plano e clique em **Implement** para tentar a implementação novamente em uma nova conversa.

### Saindo do modo Plan

Há múltiplas maneiras de passar do planejamento para a implementação:

* Clique no botão **Implement** no arquivo do plano
* Aprove a requisição do agente para sair do modo Plan quando o plano estiver pronto
* Mude para o modo Code na caixa de texto

## Bypass Permissions

O modo **Bypass Permissions** aprova automaticamente todas as chamadas de ferramentas, incluindo gravações de arquivos e comandos de shell.

> [!WARNING]
>
> Use o Bypass Permissions somente em trabalhos nos quais você confia totalmente. Ele nunca se sobrepõe às permissões no nível da organização configuradas pelo seu administrador: as regras de negação (deny) e de confirmação (ask) impostas pelo administrador sempre têm prioridade.

## Sessões em sandbox

Quando o [sandboxing](https://docs.devin.ai/pt-BR/desktop/devin-local/overview.md#sandboxing) está ativado, a sessão é executada no modo **Autonomous**, e não nos modos acima: o sandbox no nível do sistema operacional restringe o que os comandos podem acessar, e as solicitações de permissão passam a ser feitas por capacidade (como acesso à rede), e não por comando individual. Consulte [Modo autônomo](https://docs.devin.ai/pt-BR/cli/reference/permissions.md#autonomous-mode).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.